Skip to content

插件设置

插件设置页面位于 AI回评插件设置,通过标签栏切换以下五个配置页面:

  • 基本设置
  • AI角色设置
  • 模型设置
  • 提示词设置
  • 数据清理

页面右侧为操作控制侧边栏,显示保存按钮和未保存状态指示器。标题栏右侧提供 查看日志 按钮,可快速跳转到回复日志页面。

基本设置

配置项说明默认值
自动回复是否启用自动回复功能开启
自动发布AI回复是否自动发布,关闭则存为草稿开启
最大重试次数AI生成失败时的最大重试次数(0为不重试,最大10)3
最大对话轮次同一评论线程中AI最多自动回复的轮次(0为不限制,需二次确认)10
速率限制(每小时)每小时最大AI回复数量(0为不限制,需二次确认)0(不限制)
启用页面AI回复开启后所有独立页面一键启用AI回复(包括新建页面),关闭则一键关闭关闭
评论者黑名单不触发AI回复的评论者,支持名称、邮箱和正则表达式(regex: 开头)
启用白名单白名单内评论者跳过 AI 前置过滤与拦截开启
白名单评论者命中名单的评论者将跳过 AI 前置过滤与拦截
启用前置过滤AI回复前检测评论合规性,拦截广告/辱骂/敏感内容,节省Token开启
违规评论设为待审核检测到违规评论时自动取消通过,需人工审核开启
瞬间评论区适配为瞬间插件(Moments)的评论区启用AI自动回复,仅当检测到瞬间插件已安装并启用时显示开启

黑/白名单批量操作

黑名单和白名单均支持批量操作:

  • 批量添加:点击"添加评论者"按钮,弹出评论者列表对话框,支持搜索、多选、全选批量添加,也支持手动输入名称或邮箱
  • 批量移除:名单列表中支持多选后批量移除
  • 白名单内评论者跳过 AI 前置过滤与拦截,避免可信评论被误伤

白名单与黑名单关系

白名单优先级高于黑名单:同时命中两者的评论者按白名单处理(跳过拦截但不会触发 AI 回复)。白名单仅跳过 AI 审核拦截,不影响 AI 回复的触发逻辑。

前置过滤(合规检测)

启用前置过滤后,AI 在生成回复前会综合判断评论者昵称与评论内容进行合规性分类,识别以下类别:

  • 正常:放行,继续走 AI 回复流程
  • 广告:包含推广链接、产品推销、引流信息等;或评论者昵称本身即为广告
  • 辱骂攻击:包含辱骂、人身攻击、恶意挑衅、歧视性言论等
  • 敏感内容:涉及政治敏感、违法违规、色情暴力等
  • 无意义:纯乱码、无意义字符堆砌

对于非"正常"类别的评论,插件会:

  1. 停止生成 AI 回复,节省 Token 与 API 调用
  2. 创建一条 FILTERED 状态的日志记录(可在日志页通过"已拦截"状态筛选查看)
  3. 若启用"违规评论设为待审核",会自动将原评论的 approved 置为 false

被误拦截的评论可在日志页点击 误报反馈 按钮处理,支持"AI 回复"和"仅通过"两种方式。

WARNING

前置过滤依赖 AI Foundation 插件进行分类判断,会额外消耗少量 Token。若 AI 服务不可用或分类失败,为安全起见将拦截评论而非放行。

:::

AI角色设置

AI角色定义了回复评论的虚拟身份。支持创建多个角色,每个角色有独立的昵称、人格提示词、性别、语气风格和 Gravatar 头像,可指定一个为默认角色。

配置项说明默认值
角色昵称AI回复者的显示名称小回
性别与语气角色性别(男/女)+ 中性语气复选框女 + 中性语气
唤醒词评论以此词开头则唤醒该角色回复,留空不启用
人格提示词定义AI角色的人格和回复风格,留空则使用基础配置中的角色身份提示词(personaIdentity)见下方
邮箱用于 Gravatar 头像服务展示头像
设为默认将该角色设为默认角色第一个角色默认

人格提示词

人格提示词定义了AI角色的性格和回复风格。留空时自动使用基础配置中的角色身份提示词(personaIdentity),无需重复填写。如需为角色设置独特人格,在此填写即可覆盖默认值。

Gravatar头像

填写邮箱后,AI回复者的头像将通过 Gravatar 服务自动生成,使用 Cravatar 镜像。如果不填写邮箱,将使用 Gravatar 默认头像。

分类角色映射

支持为文章分类(Category)指定默认 AI 角色,解析优先级为:唤醒词 > Post/Category/Tag 标注 > 分类角色映射 > 全局默认。瞬间评论使用全局默认角色。

配置格式为 JSON:{"分类名":"角色名"},未配置的分类使用默认角色。例如:

json
{
  "技术分享": "极客助手",
  "生活随笔": "小回"
}

模型设置

配置项说明默认值
AI模型名称留空使用AI Foundation默认模型,填写AiModel资源名称可指定模型
分类角色映射为文章分类指定默认AI角色,JSON格式

WARNING

模型设置需要先安装 AI Foundation 插件。若未安装或未配置模型,首页会显示对应的警告卡片并提供快捷跳转按钮。

提示词设置

提示词拆分为五个独立模块,各模块以独立文本框配置,均为可选项,留空时自动使用内置默认值。详细的模块说明、默认值与预设模板参考请参阅 提示词模板

配置项说明默认值
角色身份提示词(personaIdentity)定义 AI 角色的基础身份与对话风格,可选默认值
安全审核提示词(safetyReview)内容安全红线与边界约束,可选(仅启用前置过滤时显示)默认值
情感适配提示词(sentimentAdapter)依据评论情感倾向调整回复语气,可选默认值
输出规范提示词(outputGuidance)回复长度/格式/风格等通用约束,可选默认值
语言要求提示词(languageRequirement)根据评论语言自动匹配回复语言的约束规则,可选默认值

留空即用默认

五个模块均支持留空。留空时后端自动填入完整默认值,无需手动填写即可获得稳定的 AI 输出。若仅需调整某一模块(如只改角色身份),其他模块保持留空即可。

组装顺序

提示词由后端按固定顺序拼接,无需手动放置占位符:

  1. 角色身份 — 若 AI 角色配置了人格提示词,则优先使用角色的人格设定
  2. 安全审核 — 内容安全红线与边界约束
  3. 语言要求 — 根据评论语言匹配回复语言
  4. 输出规范 — 回复长度/格式/风格约束
  5. 情感适配 — 含动态情感提示(非中性情感时追加)
  6. 上下文信息 — 文章标题、发布日期、评论数、文章内容、对话历史、评论(由系统自动注入)

上下文自动注入

以下上下文由系统自动追加到提示词末尾,无需在模块中手动写入:

变量说明注入时机
{{post_title}}文章标题始终注入
{{post_date}}文章发布日期(如 2024-01-15)始终注入
{{comment_count}}该文章的评论数始终注入
{{article}}文章/页面内容始终注入
{{conversation_history}}对话历史上下文多轮对话时注入
{{comment}}评论内容(含评论者名称)始终注入

Comment Next 冲突检测

插件会在首页自动检测 plugin-comment-next(评论组件 Next)是否安装并启用。Comment Next 已集成 AI 回复、AI 拦截功能,若同时启用本插件可能与该插件的功能重复。

冲突提示

检测到 Comment Next 插件已安装并启用时,首页顶部会显示红色冲突提示卡,提供两个跳转链接:

  • AI回复 — 跳转到 Comment Next 插件的 AI 自动回复配置页
  • AI拦截 — 跳转到 Comment Next 插件的 AI 审核配置页

建议二选一:要么在本插件中配置 AI 回复,要么在 Comment Next 中配置,避免两套 AI 回复逻辑同时运行产生重复回复。

AI Foundation 状态检测

插件首页自动检测 AI Foundation 的安装、启用和模型配置状态,针对不同状态显示对应的警告卡片和快捷跳转按钮:

状态提示快捷操作
未安装AI Foundation 未安装前往插件页面、应用商店下载
已安装未启用AI Foundation 未启用前往启用
已启用未配置模型未配置默认模型添加模型、配置默认模型
正常AI Foundation 连接正常

数据清理

配置项说明默认值
启用自动清理是否自动清理过期的AI回复记录开启
保留天数超过此天数的记录将被自动清理30

手动清理

手动清理区域支持自定义清理时间节点:

  1. 在输入框中填写清理天数(默认7天前)
  2. 点击 立即清理 按钮
  3. 弹出二次确认弹窗,确认后执行清理
  4. 清理完成后显示删除的记录数量

WARNING

清理操作不可撤销,执行前会弹出确认弹窗。清理仅删除 AiCommentReply 记录(插件内部的日志记录),不会删除已发布的 Halo Reply 评论。

配置导入导出

插件设置页面顶部提供导入导出按钮,方便备份和迁移配置。

导出配置

点击 导出 按钮,将当前配置(包括 ConfigMap 数据和所有 AI 角色)导出为 JSON 文件。

导入配置

  1. 点击 导入 按钮,选择 JSON 配置文件
  2. 确认导入操作(导入会覆盖当前配置,不可撤销)
  3. 导入完成后自动刷新设置和角色列表

WARNING

导入操作会覆盖当前配置,请谨慎操作。建议在导入前先导出当前配置作为备份。

基于 GPL-3.0 许可发布