✨展示架 (Plugin Showcase)
一个面向 Halo 2 博主打造的轻量级、独立、个性化收藏展示插件
把看过的动漫、影视、书籍、游戏和喜爱的收藏装进独立的 /movie 页面，让每一次「看过」都值得被记住
 |
 |
 |
 |
演示站点：wangxinyang.top/movie ｜ 插件使用教程：点此查看
🧑💻 开发者碎碎念(๑•̀ㅂ•́)و✧
我是Wangxinyangヽ(✿ﾟ▽ﾟ)ノ，一个只会依靠AI写代码的编程小白🥺，这个插件全程借助Codex辅助开发✨。
这个小插件也许还不是那么完善，大家也可以自己魔改或者去俺的博客留言板提建议哈～
俺的博客地址：https://wangxinyang.top/ 欢迎互换友链或互访哦～(σ≧︎▽︎≦︎)σ
🖼️ 界面预览
📌 如需看完整交互，请前往演示站点 https://wangxinyang.top/movie。
📖 介绍
展示架（Showcase） 是一款为 Halo 2 博主打造的轻量、独立、个性化的收藏展示插件。它使用独立的 /movie 路由，不依赖任何 Halo 主题样式，前台保留站点名称、站点图标与返回博客入口，访客无需登录即可浏览全部已发布内容。
无论是记录看过的动画、整理读过的书籍和电影，还是展示玩过的 Steam 游戏，都可以在统一的卡片与详情弹窗内呈现。卡片使用固定封面比例，长简介和感受可在弹窗内独立滚动阅读；后台提供主题颜色、背景媒体、全页面动效、白天/黑夜模式与英文签名动画，让每一份收藏都拥有自己的展示风格。
🌐 演示站点
| 站点 | 说明 |
|---|---|
| wangxinyang.top/movie | 插件作者主用实例：动漫 / 影视 / 游戏 |
📦 安装
系统要求
- Halo >= 2.23.0
- 已在 Halo 2.26.0 完成完整测试，推荐 Halo 2.26.0 及以上版本
- 如需评论功能，可安装并启用 Halo 官方评论组件、评论组件 Next，或配置 Twikoo 评论系统
- 如需 Steam 联动，需要安装并启用「Steam 信息展示」插件
在线安装（推荐）
- Halo 应用商店搜索 「展示架」 或 「Showcase」 即可一键安装
手动安装
- 前往 Releases 下载最新版本的插件包（
.jar） - 进入「Halo 后台 → 插件 → 安装」，上传插件包
详细的配置说明可参考 插件文档。
⚙️ 核心功能
📝 内容与展示
- 独立的公开展示页面 — 使用独立的
/movie路由，不依赖任何 Halo 主题；前台保留站点名称、站点图标与返回博客入口 - 统一的卡片与详情弹窗 — 卡片使用固定封面比例，文字长度不会撑高卡片；点击卡片打开详情弹窗，较长的简介和感受可在右侧独立滚动
- Halo 附件库封面选择 — 封面支持从 Halo 附件库直接选择并实时预览，也支持粘贴外部图片 URL；顶部动图、页面背景媒体同样支持附件库选择
- Bangumi 一键解析 — 动漫影视内容支持粘贴 Bangumi（bgm.tv）条目链接或 ID，自动填入封面、标题、评分、简介与标签
- 可选字段自动隐藏 — 未填写观看链接时前台不显示「去观看」按钮；未填写观看感受时自动隐藏对应区域
- 外链离站确认 — 所有外部跳转（观看链接、其他链接）均先弹出确认框，降低误触风险
📋 内容管理
- 完整的展示字段 — 标题 / 分类 / 二级标题 / 封面 / 作品简介 / 观看后感受 / 观看状态 / 个人评分 / 观看链接 / 其他链接 / 封面标签 / 是否发布到前台
- 后台增删改查 — 后台可对展示内容进行新增、编辑、删除与发布状态切换
- 层级分组管理 — 「展示内容」支持按「大分类」及「二级标题」层级分组，前端完全同步后台的分类与显示顺序（1.4.7 新增）
- 拖拽排序 — 后台卡片支持同分组内自由拖拽调整顺序，松手即自动保存；新建卡片或跨组移动时默认追加至分组末尾（1.4.7 新增）
- 卡片 / 列表双视图 — 后台内容管理可在网格卡片和紧凑列表间切换，并记住当前浏览方式
- 后台实时搜索 — 展示内容管理支持按标题、作品简介、观看后感受、观看状态和封面标签实时过滤
- 新增位置设置 — 可选择新建展示内容默认添加到所属分组的开头或末尾
📂 分类与体系
- 灵活的分类与二级标题 — 默认提供「动漫」分类，支持自定义创建：影视 / 书籍 / 游戏 / 音乐 / 软件 / 旅行 / 其他自定义分类
- 支持年度与主题分组 — 每个分类可继续创建二级标题，适合整理年度记录、主题收藏、不同观看状态
- 分类模板与自定义字段 — 分类可绑定内容模板，支持文本、长文本、数字、日期、链接、图片、标签等字段，并设置必填、单位、提示文字及是否显示在卡片上
- 内置常用模板 — 提供动漫影视、美食探店、旅行打卡、书单笔记、运动记录、好物推荐等预设，也可创建和维护自己的模板
- 模板数据安全保留 — 切换分类或调整模板时保留已有自定义字段数据，前台按模板配置稳定展示
- TMDB 一键解析 — 在内容编辑弹窗粘贴
movie或tv链接，可自动填入封面、标题、评分、简介和标签；API Key 在后台设置中持久化保存，公开接口不会返回密钥 - Halo 原生模板渲染 —
/movie使用 Halo 原生模板渲染流程，主题与 Live2D 等插件资源可以正常注入 - 观看状态默认为空 — 新增内容不会自动填入“已看完”，清空状态后保存再次编辑也会保持为空
🎨 主题与个性化
- 主题颜色控制 — 后台支持颜色选择器、色相滑块、十六进制代码；颜色会同步作用于分类按钮、评分标记、返回博客按钮、详情弹窗滚动条、评论区、外部链接卡片与页面装饰元素
- 顶部与内容区独立背景 — 两个区域均可独立开关，支持图片背景、MP4 视频背景、Halo 附件库选择、URL 地址、透明度与饱和度调节
- 白天与黑夜模式 — 访客通过导航栏切换；明暗状态自动同步背景、卡片、文字、评论区与滚动条
- SVG 路径动画英文签名 — 后台自定义英文签名内容与开关；前台通过 SVG 路径动画从左到右"书写"，适合放置个人名言、昵称或英文短句
- 全页面背景动效 — 可在「樱花飘落」「繁星点点」中选择其一，随时开启或关闭；页面底部保留鱼群动态效果，增加轻量互动感
- 多种内容浏览方式 — 前台支持卡片 / 列表视图切换；卡片模式提供小、大、大大三档尺寸，默认使用四列布局并记住访客选择
🔗 联动能力
- 三种评论系统可选 — 支持 Halo 官方评论组件、评论组件 Next 与 Twikoo；可分别开启页面底部公共评论区和每个作品的独立详情评论区
- Halo 评论数据互通 — Halo 官方评论组件与评论组件 Next 共用 Halo 原生评论数据，后台切换组件只改变前端样式与编辑体验，不拆分、不重复存储评论
- 匿名邮箱适配 — 使用 Halo 官方评论组件或评论组件 Next 时，可开启「允许匿名邮箱评论」；访客填写昵称后，邮箱留空会由展示架生成匿名邮箱，同时保留组件原生提交、验证码、审核与通知流程
- 评论样式与主题联动 — 评论框、按钮及主要状态颜色跟随展示架主题色与昼夜模式；针对表情面板、管理提示、回复弹层和详情卡片的层级与裁切问题进行了兼容优化
- Steam 游戏联动 — 配合「Steam 信息展示」插件自动创建游戏分类；游戏卡片展示：游戏封面 / 名称 / 累计游玩时间 / 最近游玩日期 / Steam 商店入口；电脑端三列、手机端两列布局；插件未安装时显示明确的依赖提示，不影响其他内容分类
✨ 访客体验
- 轻量独立 — 不依赖任何 Halo 主题样式，切换或更换主题都不会影响展示架的展示效果
- 可选访客统计 — 可显示今日访客、今日访问、总访客和总访问，统计数据由展示架独立保存，关闭后不再进行相关统计
- 快速置顶 / 置底 — 页面右下角提供快速返回顶部和滚动到底部按钮，颜色跟随后台主题色，手机端自动缩小
- 移动端体验优化 — 优化详情弹窗尺寸与滚动、评论回复区域、表情面板显示方向及 Comment Next 表情分类横向滑动性能
- 评论切换自动同步 — 后台保存并切换 Halo 评论组件类型后，已打开的展示页面可轻量检测变更并刷新，不需要长期轮询
🖱️ 前台交互
| 交互 | 说明 |
|---|---|
| 分类切换 | 顶部分类按钮一键切换，独立路由加载 |
| 关键词搜索 | 实时按标题 / 标签筛选卡片 |
| 卡片点击 | 打开详情弹窗，独立滚动阅读 |
| 详情滚动 | 长简介 / 长感受可在弹窗内分区滚动 |
| 外链确认 | 所有外部跳转弹出离站确认 |
| 主题切换 | 白天 / 黑夜模式实时切换 |
| 展示方式 | 卡片 / 列表切换，卡片支持三档尺寸 |
| 快速滚动 | 一键返回页面顶部或滚动至底部 |
| 匿名邮箱评论 | 开启适配后，Halo 两种评论组件仅填昵称即可发言 |
| Steam 浏览 | 游戏分类专属页面与详情 |
🔌 插件支持
展示架与以下 Halo 插件深度集成，建议搭配使用以获得完整体验：
| 插件 | 说明 |
|---|---|
 Halo 官方评论组件 |
支持页面底部评论与作品详情评论 |
 评论组件 Next |
可切换使用增强版评论界面，与 Halo 官方评论组件共用评论数据 |
| Twikoo 评论系统 | 支持填写 Vercel、自建服务地址或腾讯云环境 ID，并可自定义客户端 JS 地址 |
 Steam 信息展示 |
启用后自动联动 Steam 游戏分类 |
 Floating Particles 插件 |
为 Halo 前台页面添加可配置的粒子漂浮和鼠标点击动效。 |
🚀 快速开始
- 安装并启用 展示架 插件。
- 打开「内容 → 展示架」。
- 在「分类管理」中确认或创建分类。
- 在「展示内容」中添加第一张卡片。
- 选择封面，填写标题与作品介绍。
- 根据需要填写评分、感受、标签与外部链接。
- 勾选「发布到前台 /movie」。
- 在「页面设置」中调整主题颜色、背景与动效。
- 根据需要选择评论系统、匿名邮箱评论和访客统计。
- 访问
/movie查看最终效果。
📋 项目信息
- 插件名称： 展示架（Plugin Showcase）
- 作者： Wangxinyang
- 贡献者： 魔皇地狱MHDY2233（为本项目提供功能改进）
- 当前版本： 1.7.3
- 插件标识：
showcase - 开源协议： MIT
- 源码仓库： https://github.com/WXY-333/show-shelf
- 问题反馈： https://github.com/WXY-333/show-shelf/issues
- 演示站点： https://wangxinyang.top/movie
- 插件使用教程： https://www.wangxinyang.top/archives/halo-zhan-shi-jia-da-zao-zi-ji-de-zhuan-shu-shou-cang-zhan-shi-ye-mian
📄 许可证
MIT License © 2026 Wangxinyang
展示架希望为 Halo 博主提供一个轻量、独立且有个性的收藏展示空间。无论你想记录看过的动画，还是整理书籍、电影和游戏，都可以从一张卡片开始，逐步建立自己的数字收藏馆。