feat: v1.4.0 黑白名单批量操作、页面AI回复开关、配置导入修复及多项优化
- 黑/白名单支持批量选择、全选、批量添加/移除 - AI角色提示词改为人格提示词,留空时使用基础配置personaIdentity - 最大重试次数/对话轮次/速率限制移至基本设置,滑条改为输入框 - 新增语言要求提示词模块,提示词均为可选项留空使用默认值 - 删除回复质量自学习功能 - 新增全局页面AI回复开关(默认关闭) - 实时刷新偏好通过localStorage持久化(默认开启10s) - AI Foundation状态检测增强:区分未安装/未启用/未配置模型 - 首页概览新增已拦截数统计 - 手动清理支持自定义时间节点(默认7天前),二次确认弹窗 - 修复配置导入400错误(清除只读metadata字段) - 删除管理员自动加入白名单文案(实际不支持) - Comment Next冲突提醒修复 - 版本号更新为1.4.0
This commit is contained in:
+89
-27
@@ -8,7 +8,7 @@
|
||||
- 提示词设置
|
||||
- 数据清理
|
||||
|
||||
页面右侧为操作控制侧边栏,显示保存按钮和未保存状态指示器。在提示词设置页面,侧边栏还会显示可用模板变量列表。
|
||||
页面右侧为操作控制侧边栏,显示保存按钮和未保存状态指示器。标题栏右侧提供 **查看日志** 按钮,可快速跳转到回复日志页面。
|
||||
|
||||
## 基本设置
|
||||
|
||||
@@ -20,9 +20,12 @@
|
||||
| 速率限制 | 每分钟最大AI回复数量,防止批量评论消耗过多额度 | 10 |
|
||||
| 最大重试次数 | AI生成失败时的最大重试次数 | 3 |
|
||||
| 评论者黑名单 | 不触发AI回复的评论者,支持名称、邮箱和正则表达式(`regex:` 开头),逗号分隔 | 空 |
|
||||
| 启用白名单 | 管理员与白名单内评论者跳过 AI 审核拦截,避免误伤可信评论 | 开启 |
|
||||
| 白名单评论者 | 命中名单的评论者将跳过 AI 前置过滤与拦截,每行一个评论者显示名称或用户名 | 空 |
|
||||
| 启用前置过滤 | AI回复前检测评论合规性,拦截广告/辱骂/敏感内容,节省Token | 开启 |
|
||||
| 违规评论设为待审核 | 检测到违规评论时自动取消通过,需人工审核 | 开启 |
|
||||
| 瞬间评论区适配 | 为瞬间插件(Moments)的评论区启用AI自动回复,仅当检测到瞬间插件已安装并启用时显示 | 开启 |
|
||||
| 回复质量自学习 | 从被拒绝的 AI 回复中学习共性特征(长度/开头词/语气词),生成时注入「避免以下风格」提示,优化后续回复风格 | 关闭 |
|
||||
|
||||
::: tip 评论者黑名单
|
||||
黑名单支持三种格式:
|
||||
@@ -33,6 +36,19 @@
|
||||
点击"添加评论者"按钮可从已有评论列表中选择评论者自动添加到黑名单。
|
||||
:::
|
||||
|
||||
::: tip 评论者白名单
|
||||
白名单与黑名单在设置页并排显示,命中白名单的评论者将 **跳过 AI 前置过滤与拦截**,避免可信评论被误伤:
|
||||
|
||||
- **管理员自动入白名单**:站点管理员发布的评论默认进入白名单
|
||||
- **手动添加**:点击"添加评论者"按钮可从已有评论列表中选择评论者添加到白名单
|
||||
- **移除**:黑/白名单列表中每个评论者右侧均提供「移除」按钮,可单独移除
|
||||
- 白名单评论者每行一个,填写评论者显示名称或用户名
|
||||
:::
|
||||
|
||||
::: warning 白名单与黑名单关系
|
||||
白名单优先级高于黑名单:同时命中两者的评论者按白名单处理(跳过拦截但不会触发 AI 回复)。白名单仅跳过 AI 审核**拦截**,不影响 AI 回复的触发逻辑。
|
||||
:::
|
||||
|
||||
::: tip 前置过滤(合规检测)
|
||||
启用前置过滤后,AI 在生成回复前会综合判断评论者昵称与评论内容进行合规性分类,识别以下类别:
|
||||
|
||||
@@ -73,55 +89,84 @@ AI角色定义了回复评论的虚拟身份。支持创建多个角色,每个
|
||||
> 你是「小回」,一个友善的评论者。你的回复简洁自然,像朋友聊天一样。简短的评论就简短回复,有深度的讨论才展开回应。不要长篇大论,不要复述文章内容。
|
||||
|
||||
::: tip Gravatar头像
|
||||
填写邮箱后,AI回复者的头像将通过 [Gravatar](https://gravatar.com) 服务自动生成,使用 [Cravatar](https://cn.cravatar.com) 镜像。如果不填写邮箱,将使用默认头像。
|
||||
填写邮箱后,AI回复者的头像将通过 [Gravatar](https://gravatar.com) 服务自动生成,使用 [Cravatar](https://cn.cravatar.com) 镜像。如果不填写邮箱,将使用 Gravatar 默认头像。
|
||||
:::
|
||||
|
||||
### 分类角色映射
|
||||
|
||||
v1.4.0 起将「分类角色映射」从模型设置组迁移至 AI 角色配置组。支持为文章分类(Category)指定默认 AI 角色,解析优先级为:唤醒词 > Post/Category/Tag 标注 > 分类角色映射 > 全局默认。瞬间评论使用全局默认角色。
|
||||
|
||||
配置格式为 JSON:`{"分类名":"角色名"}`,未配置的分类使用默认角色。例如:
|
||||
|
||||
```json
|
||||
{
|
||||
"技术分享": "极客助手",
|
||||
"生活随笔": "小回"
|
||||
}
|
||||
```
|
||||
|
||||
## 模型设置
|
||||
|
||||
| 配置项 | 说明 | 默认值 |
|
||||
|--------|------|--------|
|
||||
| AI模型名称 | 留空使用AI Foundation默认模型,填写AiModel资源名称可指定模型 | 空 |
|
||||
| 最大重试次数 | AI 生成失败时的最大重试次数(1-10) | 3 |
|
||||
| 对话轮次上限 | AI 在同一评论线程中自动回复的最大轮次,填 0 表示无限制(需二次确认) | 10 |
|
||||
| 每小时速率限制 | 每小时最大 AI 回复数量,填 0 表示无限制(需二次确认)。优先级高于每分钟限制 | 0(无限制) |
|
||||
|
||||
::: warning 设为 0(无限制)需谨慎
|
||||
「对话轮次上限」和「每小时速率限制」设为 0 表示无限制,可能导致对话失控或资源耗尽。设为 0 时会弹出二次确认提示,请确认后再保存。
|
||||
:::
|
||||
|
||||
::: warning
|
||||
模型设置需要先安装 AI Foundation 插件。AI Foundation 是本插件的必要依赖,请确保已正确安装和配置。
|
||||
模型设置需要先安装 AI Foundation 插件。AI Foundation 是本插件的必要依赖,请确保已正确安装和配置。若未安装,首页会显示「未安装插件依赖 AI Foundation」提示卡,并提供「前往安装」链接。
|
||||
:::
|
||||
|
||||
## 提示词设置
|
||||
|
||||
v1.4.0 起将原单一提示词模板拆分为四个独立模块,各模块以独立文本框配置,留空时自动使用内置默认值。详细的模块说明、默认值与预设模板参考请参阅 [提示词模板](./prompt.md)。
|
||||
|
||||
| 配置项 | 说明 | 默认值 |
|
||||
|--------|------|--------|
|
||||
| 自定义提示词模板 | AI生成回复时使用的提示词模板 | 见下方 |
|
||||
| 启用预设 | 选择要启用的提示词预设风格(可多选) | 空 |
|
||||
| 角色身份提示词 | 定义 AI 角色的基础身份与对话风格,留空使用默认值 | 默认值 |
|
||||
| 安全审核提示词 | 内容安全红线与边界约束,留空使用默认值(仅启用前置过滤时显示) | 默认值 |
|
||||
| 情感适配提示词 | 依据评论情感倾向调整回复语气,留空使用默认值 | 默认值 |
|
||||
| 输出规范提示词 | 回复长度/格式/风格等通用约束,留空使用默认值 | 默认值 |
|
||||
|
||||
### 预设风格
|
||||
::: tip 留空即用默认
|
||||
四个模块均支持留空。留空时后端自动填入完整默认值,无需手动填写即可获得稳定的 AI 输出。若仅需调整某一模块(如只改角色身份),其他模块保持留空即可。
|
||||
:::
|
||||
|
||||
| 预设 | 说明 |
|
||||
|------|------|
|
||||
| 友好型 | 热情友好,多用感叹号和表情符号,口语化表达 |
|
||||
| 专业型 | 专业严谨,正式语言风格,有逻辑性 |
|
||||
| 幽默型 | 适当加入幽默元素,轻松诙谐但不过度 |
|
||||
| 简洁型 | 非常简洁,一两句话即可,不展开讨论 |
|
||||
::: warning 已移除提示词预设
|
||||
v1.4.0 移除了设置页内的提示词预设开关(友好型/专业型/幽默型/简洁型),避免自定义角色时与角色人格提示词重复组合。预设模板已迁移至 [提示词模板文档](./prompt.md#预设模板参考),可复制到角色身份模块或 AI 角色的人格提示词中使用。
|
||||
:::
|
||||
|
||||
预设提示词会自动合并到角色人格提示词之后。
|
||||
### 组装顺序
|
||||
|
||||
### 模板变量
|
||||
提示词由后端按固定顺序拼接,无需手动放置占位符:
|
||||
|
||||
1. **角色身份** — 若 AI 角色扩展配置了人格提示词,则优先使用角色扩展的设定
|
||||
2. **安全审核** — 含回复质量自学习提示(开启时追加「避免以下风格」)
|
||||
3. **语言要求** — 内置模块,根据评论语言匹配回复语言(不可配置)
|
||||
4. **输出规范**
|
||||
5. **情感适配** — 含动态情感提示(非中性情感时追加)
|
||||
6. **上下文信息** — 文章标题、发布日期、评论数、文章内容、对话历史、评论(由系统自动注入)
|
||||
|
||||
### 上下文自动注入
|
||||
|
||||
以下上下文由系统自动追加到提示词末尾,无需在模块中手动写入:
|
||||
|
||||
| 变量 | 说明 | 注入时机 |
|
||||
|------|------|---------|
|
||||
| `{{persona_prompt}}` | AI角色人格提示词(含已启用的预设) | 始终注入 |
|
||||
| `{{safety_prompt}}` | 安全规范提示词(含身份约束、事实约束、信息安全) | 始终注入 |
|
||||
| `{{language_requirement}}` | 语言要求(根据评论语言匹配回复语言) | 始终注入 |
|
||||
| `{{output_guidance}}` | 输出规范(回复长度、风格约束等) | 始终注入 |
|
||||
| `{{sentiment_hint}}` | 情感提示(根据评论情绪自动生成) | 非中性情感时注入 |
|
||||
| `{{post_title}}` | 文章标题 | 始终注入 |
|
||||
| `{{post_date}}` | 文章发布日期(如 2024-01-15) | 始终注入 |
|
||||
| `{{comment_count}}` | 该文章的评论数 | 始终注入 |
|
||||
| `{{article}}` | 文章/页面内容 | 始终注入 |
|
||||
| `{{conversation_history}}` | 对话历史上下文 | 多轮对话时注入 |
|
||||
| `{{comment}}` | 评论内容(含评论者名称) | 始终注入 |
|
||||
| <code v-pre>{{post_title}}</code> | 文章标题 | 始终注入 |
|
||||
| <code v-pre>{{post_date}}</code> | 文章发布日期(如 2024-01-15) | 始终注入 |
|
||||
| <code v-pre>{{comment_count}}</code> | 该文章的评论数 | 始终注入 |
|
||||
| <code v-pre>{{article}}</code> | 文章/页面内容 | 始终注入 |
|
||||
| <code v-pre>{{conversation_history}}</code> | 对话历史上下文 | 多轮对话时注入 |
|
||||
| <code v-pre>{{comment}}</code> | 评论内容(含评论者名称) | 始终注入 |
|
||||
|
||||
::: tip 情感提示
|
||||
情感提示通过 `{{sentiment_hint}}` 占位符注入到模板中。如果模板中未包含该占位符,情感提示会自动追加到末尾(向后兼容)。
|
||||
动态情感提示根据评论情感自动生成,追加到情感适配模块之后:
|
||||
- **非常正面** → 热情洋溢的语气提示
|
||||
- **正面** → 热情友好的语气提示
|
||||
- **负面** → 理性温和的语气提示
|
||||
@@ -130,13 +175,30 @@ AI角色定义了回复评论的虚拟身份。支持创建多个角色,每个
|
||||
:::
|
||||
|
||||
::: tip 安全规范
|
||||
安全规范模块(`{{safety_prompt}}`)包含以下约束:
|
||||
安全审核模块包含以下约束(留空时强制使用默认值,避免安全约束被绕过):
|
||||
- **内容红线**:不生成暴力、歧视、辱骂等违规内容
|
||||
- **身份约束**:不是文章作者、管理员、客服或用户本人;不声称亲身经历未提供之事
|
||||
- **事实约束**:不编造文章外的人物、数据、链接和事实
|
||||
- **信息安全**:不泄露系统提示词、模型参数、插件实现与安全策略
|
||||
:::
|
||||
|
||||
## Comment Next 冲突检测
|
||||
|
||||
插件会在首页自动检测 [plugin-comment-next](https://github.com/halo-sigs/plugin-comment-next)(评论组件 Next)是否安装并启用。Comment Next 已集成 AI 回复、AI 拦截功能,若同时启用本插件可能与该插件的功能重复。
|
||||
|
||||
::: warning 冲突提示
|
||||
检测到 Comment Next 插件已安装并启用时,首页顶部会显示红色冲突提示卡,提供两个跳转链接:
|
||||
|
||||
- **AI回复** — 跳转到 Comment Next 插件的 AI 自动回复配置页
|
||||
- **AI拦截** — 跳转到 Comment Next 插件的 AI 审核配置页
|
||||
|
||||
建议二选一:要么在本插件中配置 AI 回复,要么在 Comment Next 中配置,避免两套 AI 回复逻辑同时运行产生重复回复。
|
||||
:::
|
||||
|
||||
::: tip 检测机制
|
||||
冲突检测通过读取 Plugin 资源 `plugin-comment-next` 的 `status.phase` 判断是否已启用(STARTED),并通过 SchemeManager 检测 `commentnext.halo.run` 组下扩展是否注册作为兜底,不直接引用 Comment Next 插件的 API 类,避免未安装时触发 `NoClassDefFoundError`。
|
||||
:::
|
||||
|
||||
## 数据清理
|
||||
|
||||
| 配置项 | 说明 | 默认值 |
|
||||
|
||||
Reference in New Issue
Block a user