展示架

一个面向 Halo 博主的个人收藏展示插件。

展示架可以把你看过的动漫、影视、书籍、游戏和其他收藏内容，整理成一个独立的公开展示页面。你可以为每个作品添加封面、简介、观看感受、评分、标签和外部链接，并通过分类和二级标题整理自己的收藏。

安装并启用插件后，访客可以通过以下地址访问展示页面：

https://你的域名/movie

核心功能

独立的公开展示页面

展示架使用独立的 /movie 页面，不会随着 Halo 博客主题改变页面结构。前台保留站点名称、站点图标和返回博客入口，访客无需登录即可浏览已发布内容。

展示内容管理

后台可以新增、编辑和删除展示内容，支持填写：

• 标题
• 分类
• 二级标题
• 封面
• 作品简介
• 观看后感受
• 观看状态
• 个人评分
• 观看链接
• 其他链接
• 封面标签
• 是否发布到前台

观看链接和其他链接均为可选项。未填写观看链接时，前台不会显示“去观看”按钮；未填写观看感受时，前台会自动隐藏对应的感受区域。

Halo 附件库封面选择

封面支持从 Halo 附件库直接选择，选择后会立即显示预览，也支持粘贴外部图片 URL。

顶部 GIF 动图和页面背景媒体同样支持从 Halo 附件库选择。

【配图提示：Halo 附件库选择弹窗，以及选择封面后显示预览的后台界面】

灵活的分类和二级标题

插件默认提供动漫分类，同时支持自定义创建：

• 影视
• 书籍
• 游戏
• 音乐
• 软件
• 旅行
• 其他自定义分类

每个分类都可以继续创建二级标题，适合整理年度记录、主题收藏和不同观看状态。

【配图提示：后台分类管理页面，展示分类列表和二级标题管理按钮】

【配图提示：前台分类页面，展示二级标题和对应卡片区域】

统一的卡片和详情弹窗

前台卡片使用固定封面比例，内容文字不会改变卡片尺寸。点击卡片后打开详情弹窗，较长的简介和感受可以在右侧区域独立滚动阅读。

详情弹窗支持显示：

• 分类和二级标题
• 观看状态
• 评分和黄色星标
• 封面标签
• 作品简介
• 观看后感受
• 去观看按钮
• 打开其他链接卡片

所有外部跳转都会先显示离站确认提示，减少误触风险。

主题颜色控制

后台支持整体调整前台主题颜色，可以使用颜色选择器、色相滑块或十六进制颜色代码。

主题颜色会同步影响：

• 分类按钮
• 评分标记
• 返回博客按钮
• 详情弹窗滚动条
• 评论区域
• 外部链接卡片
• 页面装饰元素

默认主题色为樱花粉，也可以根据博客风格调整为其他颜色。

背景图片和 MP4 视频

顶部展示架区域和内容区域可以分别设置背景媒体。

每个区域都支持：

• 单独开启或关闭
• 图片背景
• MP4 视频背景
• Halo 附件库选择
• URL 地址填写
• 透明度调节
• 饱和度调节

这样可以让顶部区域和内容区域拥有不同的视觉氛围，同时避免背景影响文字阅读。

【配图提示：开启背景图片或视频后的前台效果】

页面动效

页面设置支持选择两种全页面背景动效：

• 樱花飘落
• 繁星点点

动效可以随时开启或关闭。页面底部还保留鱼群动态效果，为展示页面增加轻量的互动感。

白天和黑夜模式

访客可以通过导航栏切换白天和黑夜模式。模式切换只影响当前访客的浏览体验，不会改变后台保存的主题颜色设置。

页面会同步调整背景、卡片、文字、评论区和滚动条的明暗关系，保证夜间阅读效果。

英文手写签名

后台可以自定义英文个性签名，并选择是否开启。前台会使用 SVG 路径动画从左到右绘制签名，适合放置个人名言、昵称或英文短句。

Halo 评论系统联动

展示架底部可以开启公共评论区，并连接 Halo 评论组件。

展示架不会在启用时修改 Halo 全站评论设置，也不会自动开启匿名评论。评论开关、匿名访问、审核和通知规则仍由 Halo 系统设置及评论组件负责；停用展示架或关闭展示架评论区不会改动这些全局配置。

访客可以：

• 不登录发表评论
• 只填写昵称
• 选择填写邮箱
• 选择填写网站链接

填写邮箱后可用于头像显示，填写网站链接后，评论头像或用户信息可以跳转到访客网站。评论数据、审核和管理仍由 Halo 评论系统负责。展示架不会修改 Halo 全局评论设置

Steam 游戏联动

安装并启用“Steam 信息展示”插件后，展示架可以读取 Steam 游戏资料，并自动创建游戏分类。

游戏页面可以展示：

• 游戏封面
• 游戏名称
• 累计游玩时间
• 最近游玩日期
• Steam 商店入口

电脑端固定为三列布局，手机端固定为两列布局。Steam 插件未安装或未启用时，展示架会显示明确的依赖提示，不会影响其他内容分类。

前台交互效果

展示架前台支持以下交互：

• 分类切换
• 关键词搜索
• 卡片点击查看详情
• 详情内容滚动阅读
• 外部链接离站确认
• 白天/黑夜模式切换
• 匿名评论
• Steam 游戏分类浏览

安装要求

• Halo 2.23.0 或更高版本
• 测试Halo版本是2.26.0，所以推荐 Halo 2.26.0 及以上版本
• 如需评论功能，建议安装并启用 Halo 官方评论组件
• 如需 Steam 联动，需要安装并启用“Steam 信息展示”插件

快速开始

1. 安装并启用展示架插件。
2. 打开“内容 → 展示架”。
3. 在“分类管理”中确认或创建分类。
4. 在“展示内容”中添加第一张卡片。
5. 选择封面，填写标题和作品介绍。
6. 根据需要填写评分、感受、标签和外部链接。
7. 勾选“发布到前台 /movie”。
8. 在“页面设置”中调整主题颜色、背景和动效。
9. 访问 /movie 查看最终效果。

项目信息

• 插件名称：展示架
• 作者：Wangxinyang
• 当前版本：1.2.0
• 插件标识：showcase
• 开源协议：MIT
• 源码仓库：https://github.com/WXY-333/show-shelf
• 问题反馈：https://github.com/WXY-333/show-shelf/issues

展示架希望为 Halo 博主提供一个轻量、独立且有个性的收藏展示空间。无论是记录看过的动画，还是整理书籍、电影和游戏，都可以从一张卡片开始，逐步建立自己的数字收藏馆。