[插件更新] 本地评论 v0.2.6 使用说明

本文共计1410个字，预计阅读时长5.6分钟。

由于版本资料未注明具体更新内容，插件从 0.2.4 升级至 0.2.6，建议在更新前备份数据。

功能介绍

[annoying] 本地评论 是一个为 Xiuno BBS 设计的评论组件插件。它在帖子页面嵌入 Annoying ID 评论系统，完全替代原生的回复区域，并自带 OWO 表情包、后台审核与状态管理功能。

• 前台展示：在帖子页替换原有回复区，显示 Annoying ID 风格的评论列表与发表框。
• 表情支持：内置 Twikoo 风格 OWO 表情包（static/twikoo-owo.json），用户可快速插入表情。
• 后台管理：提供独立的评论管理页面，支持按状态（全部/待审核/已发布/已隐藏）筛选，并执行发布、隐藏、删除操作。
• 认证集成：依赖 Annoying ID 登录服务，需在服务器端配置允许的域名与回调地址。

使用教程

1. 前置配置（必须）

插件需要 Annoying ID 服务的配合。请在运行 Annoying ID 服务的服务器上，修改其环境变量，添加论坛域名：

BLOG_ORIGINS=https://你的论坛域名1,https://你的论坛域名2
BLOG_REDIRECT_URIS=https://你的论坛域名1/auth/callback/,https://你的论坛域名2/auth/callback/

修改完成后 重启 Annoying ID 服务，服务启动时会自动将新的回调地址合并到 OAuth 客户端配置中。

2. 部署插件

将插件文件夹 annoyingidcomments 上传至 Xiuno 插件的 plugin/ 目录，例如：

/var/www/happy/plugin/annoying_id_comments

然后，将插件内的 static/auth-callback.html 文件复制到论坛静态资源的指定路径：

/var/www/happy/auth/callback/index.html

确保该路径可通过浏览器访问（例如 https://你的论坛域名/auth/callback/）。

3. 启用插件

进入 Xiuno 后台 → 插件管理，找到 [annoying] 本地评论，点击启用。

4. 前台展示

启用后，打开任意帖子页面，原生回复区将被替换为 Annoying ID 评论组件。用户需通过 Annoying ID 登录后方可发表评论，评论内容会自动同步至后台管理。

后台设置

进入 Xiuno 后台 → 插件 → [annoying] 本地评论 → 设置（或直接在 admin/index 菜单中的“本地评论系统”入口），可管理所有评论。

界面布局

• 状态标签：顶部提供“全部”、“待审核”、“已发布”、“已隐藏”四个筛选按钮。
• 评论列表：每行显示 ID、状态（图标）、用户、内容、时间，以及操作按钮。
• 操作：
• 发布：将待审核或已隐藏的评论变为已发布状态。
• 隐藏：将已发布的评论隐藏，前台不再显示。
• 删除：彻底删除评论，不可恢复。

筛选与批量操作

目前操作按钮为单条评论独立操作，版本资料未注明支持批量操作。可通过筛选状态快速找到需要处理的评论。

注意事项

1. 必须配置 Annoying ID 服务的 BLOGORIGINS 和 BLOGREDIRECT_URIS，否则用户登录和评论提交可能失败。
2. auth-callback.html 务必复制到论坛根目录的 `auth/callback/index.html