🎉 首个版本发布！

为 Halo 提供用户装饰、身份标识与前台展示能力的社区互动增强插件。站长管理勋章 / 头像框 / 称号 / 名片背景 / 昵称样式并授予用户，用户在个人中心佩戴，主题与其他插件可在前台展示。

在线演示：作者页（用户卡 + 装扮墙）

✨ 功能特性

• 装饰资产管理：5 类装饰（勋章、头像框、称号、名片背景、昵称样式），草稿 / 启用 / 停用 / 归档全生命周期，卡片 / 列表双视图，身份行与用户卡双场景实时预览
• 分类 / 标签 / 稀有度：自定义元数据组织装饰；首次启动自动创建 5 档稀有度（普通 / 稀有 / 史诗 / 传说 / 限定）
• 授予与撤销：单 / 多用户授予、按 Halo 角色快照批量授予、设有效期、续期（只延长不缩短）、撤销、保留历史；多来源并存（后台 / 角色快照 / 外部插件各自独立记账，持有 = 并集）
• 个人中心装扮：佩戴头像框 / 称号 / 主勋章 / 展示勋章（≤8）/ 名片背景 / 昵称样式，右侧实时预览；支持用户投稿；公开装扮墙可关
• 身份标识：把 Halo 角色映射成前台身份标牌（文字牌 / 图标 / 图片三选一 + 优先级），不进库存、不占佩戴槽
• 前台展示：hip-* Web Component + Finder API + 公开 HTTP API，供主题或插件前台页在评论区 / 作者行 / 装饰墙展示（不自动注入页面）
• 自定义模板：站长可贴 HTML / CSS 完全接管三个组件的渲染（仅超级管理员）
• 对外插件 API：发奖（DecorationGrantApi）/ 身份查询（PublicIdentityQueryApi）/ 统计贡献扩展点（UserStatContributor），可选依赖、缺席自动降级
• 站内通知：获得 / 撤销装饰、投稿通过 / 驳回、批量授予完成（发给操作者），走 Halo 原生通知

📋 环境要求

• Halo >= 2.25.0
• JDK 21

📦 安装方式

下载 plugin-interaction-plus-1.0.0.jar，在 Halo 后台 → 插件 → 安装 → 上传并启用。启用后左侧出现「互动」分组。

🔧 配置说明

1. 互动 → 装饰 → 资产：创建装饰、上传素材、启用（新建默认是草稿，未启用不能授予）
2. 互动 → 装饰 → 授予：选装饰 + 用户（或按角色快照），设有效期 / 原因
3. 被授予的用户到 用户中心 → 装扮 → 我的装扮 佩戴并保存，前台才会显示
4. 主题或评论插件需引入 Runtime 并写入 hip-* 标签，评论区 / 作者行才会出现装扮

⚠️ 注意事项

• 插件不会自动往主题页面塞任何东西。 装上之后后台就能管装饰，但评论区要出现头像框 / 身份行，需要主题（或评论插件）写入 hip-* 标签
• 授予 ≠ 佩戴。 授予只进库存，用户要自己到「我的装扮」里佩戴，前台才会显示
• 身份标识 ≠ 装饰。 身份标识按角色映射，无需授予、不进库存
• 首次启动会自动创建 5 个默认稀有度；删掉后重启不会重建
• 自定义组件只有超级管理员能进

📚 文档

• 站长使用指南
• 前台适配指南
• 对外插件 API 对接指南

反馈：BBS · 互动增强

查看版本详情