nxxy335/plugin-comment-ai-autopilot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 9 Wiki Activity

feat: streamline dashboard, fix docs, optimize UI width

Browse Source 
- Remove AI角色 quick action, keep only 回复日志/插件设置/刷新数据
- Fix LogsView filter/batch bar width to match content area (mx-4 mt-2 -> m-4 mb-0)
- Fix docs: Halo version 2.23->2.25, GitHub link nxxy335->sunny-335, Cravatar link, variable name {{conversation}}->{{conversation_history}}
- Add missing settings docs (maxConversationRounds, rateLimitPerMinute, enabledPresets)
- Update README: remove version display, update changelog
- Update version to 1.0.0-beta.2-r8k4n2
This commit is contained in:
sunny-335
2026-06-17 22:03:35 +08:00
parent be6a01a06e
commit c3e003a572
15 changed files with 154 additions and 87 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guide/auto-reply.md
+2
View File
@@ -31,6 +31,8 @@
|--------|------|--------|
| 自动回复 | 是否启用自动回复功能 | 开启 |
| 自动发布 | AI回复是否自动发布，关闭则存为草稿 | 开启 |
| 最大对话轮次 | 同一评论线程中AI最多自动回复的轮次 | 8 |
| 速率限制 | 每分钟最大AI回复数量 | 10 |
| 最大重试次数 | AI生成失败时的最大重试次数 | 3 |
## 重试机制
docs/guide/faq.md
+1 -1
View File
@@ -12,7 +12,7 @@
1. 确认在插件设置中填写了AI角色邮箱
2. 邮箱需要在 [Gravatar](https://gravatar.com) 上注册并设置头像
3. 插件使用 [Cravatar](https://cravatar.cn) 作为Gravatar镜像服务
3. 插件使用 [Cravatar](https://cn.cravatar.com) 作为Gravatar镜像服务
## 评论没有触发AI回复？
docs/guide/filter.md
+11 -3
View File
@@ -32,9 +32,17 @@
1. 进入插件设置页面
2. 在 **基本设置** 中找到 **评论者黑名单**
3. 输入评论者的显示名称或邮箱，多个用逗号分隔
3. 输入评论者的显示名称、邮箱或正则表达式，多个用逗号分隔
4. 保存设置
### 支持的格式
| 格式 | 示例 | 说明 |
|------|------|------|
| 名称 | `张三` | 匹配评论者的显示名称 |
| 邮箱 | `spam@example.com` | 匹配评论者邮箱（不区分大小写） |
| 正则表达式 | `regex:^spam.*` | 以 `regex:` 开头，按正则匹配 |
### 从评论列表选择
1. 在黑名单输入框旁点击 **添加评论者** 按钮
@@ -45,7 +53,7 @@
### 示例
```
张三,spam@example.com,李四
张三, spam@example.com, 李四, regex:^spam.*
```
黑名单中的评论者发布评论时，插件会同时匹配显示名称和邮箱地址（不区分大小写），匹配成功则跳过AI回复。
黑名单中的评论者发布评论时，插件会同时匹配显示名称和邮箱地址（不区分大小写），正则表达式则按模式匹配，匹配成功则跳过AI回复。
docs/guide/installation.md
+8 -4
View File
@@ -2,24 +2,28 @@
## 前置要求
- Halo 2.23+
- AI Foundation 插件（必须） — 本插件依赖 AI Foundation 提供的AI模型能力，请先安装并配置 AI Foundation
- Halo 2.25+
- AI Foundation 插件（必须） — 本插件通过 `ExtensionGetter` 调用 AI Foundation 提供的 `AiModelService` 扩展点，请先安装并配置 AI Foundation
## 安装
### 方式一：从 Release 下载
1. 前往 [GitHub Releases](https://github.com/nxxy335/plugin-comment-ai-autopilot/releases) 下载最新的 `.jar` 文件
1. 前往 [GitHub Releases](https://github.com/sunny-335/plugin-comment-ai-autopilot/releases) 下载最新的 `.jar` 文件
2. 登录 Halo 管理后台
3. 进入 **插件** → **已安装** → 点击右上角 **安装** 按钮
4. 选择下载的 `.jar` 文件上传
5. 安装完成后启用插件
::: tip 推荐安装
安装本插件后，应用市场会推荐安装 AI Foundation 插件（本插件的必要依赖）。
:::
### 方式二：从源码构建
```bash
# 克隆仓库
git clone https://github.com/nxxy335/plugin-comment-ai-autopilot.git
git clone https://github.com/sunny-335/plugin-comment-ai-autopilot.git
cd plugin-comment-ai-autopilot
# 构建
docs/guide/introduction.md
+11 -9
View File
@@ -5,20 +5,22 @@ AI回评（Comment AI Autopilot）是一个 Halo 博客系统的插件，能够
## 核心功能
- **自动回复** — 监听新评论，自动调用AI生成回复，支持多轮对话上下文
- **多 AI 角色** — 支持创建多个 AI 角色，每个角色有独立的昵称、人格提示词和 Gravatar 头像，可为不同文章指定不同角色
- **多语言适配** — 根据评论语言自动用对应语言回复
- **情感分析** — 分析评论情感倾向（正面/中性/负面），根据情感调整回复语气
- **草稿模式** — AI回复先存为草稿，管理员审核后再发布
- **失败重试** — AI生成失败时自动重试，指数退避策略
- **批量操作** — 草稿模式下支持批量通过/拒绝/删除
- **文章/页面级开关** — 在文章编辑器中直接控制是否启用AI回复，文章默认开启，页面默认关闭
- **评论者黑名单** — 屏蔽指定评论者，不触发AI回复
- **评论者黑名单** — 屏蔽指定评论者，不触发AI回复，支持名称、邮箱和正则表达式
- **手动触发** — 在评论管理页面对历史评论手动触发AI回复
- **AI角色** — 自定义AI回复者的昵称、人格提示词和Gravatar头像
- **安全审核** — AI生成的内容经过安全审核，不合规内容自动拒绝
- **仪表盘统计** — 显示回复数、情感分布、每日回复趋势等图表
- **安全审核** — AI生成的内容经过两阶段安全审核（安全检查 + 质量评分），不合规内容自动拒绝
- **Prompt 预设** — 内置友好型、专业型、幽默型、简洁型预设风格，可多选组合
- **对话轮次限制** — 同一评论线程中限制 AI 最多回复轮次，防止无限对话
- **速率限制** — 每分钟最大 AI 回复数量，防止批量评论消耗过多额度
- **日志筛选搜索** — 按状态、情感筛选，关键词搜索
- **数据清理** — 自动清理超过指定天数的旧记录
- **AI Foundation 集成** — 必须安装 Halo AI Foundation 插件，使用其提供的AI模型能力
- **AI Foundation 集成** — 通过 Halo 官方推荐的 `ExtensionGetter` 获取 AI 服务，需安装 AI Foundation 插件
## 工作流程
@@ -33,17 +35,17 @@ AI回评（Comment AI Autopilot）是一个 Halo 博客系统的插件，能够
3. **情感分析** — 调用AI分析评论情感倾向
4. **构建Prompt** — 结合AI角色人格、情感提示、文章内容、评论上下文构建Prompt
5. **AI生成** — 调用AI模型生成回复内容
6. **安全审核** — 对生成内容进行安全审核
6. **安全审核** — 对生成内容进行两阶段审核（安全检查 + 质量评分 1-5 分映射到 0-100）
7. **发布/草稿** — 根据设置自动发布或存为草稿等待审核
8. **重试** — 如果AI生成失败，系统会自动重试（最多 maxRetryCount 次），每次重试间隔递增
## 前置要求
- Halo 2.23+
- AI Foundation 插件（必须） — 本插件依赖 AI Foundation 提供的AI模型能力
- Halo 2.25+
- AI Foundation 插件（必须） — 本插件通过 `ExtensionGetter` 调用 AI Foundation 提供的 `AiModelService` 扩展点
## 技术栈
- **后端**：Java + Spring WebFlux + Reactive
- **前端**：Vue 3 + @halo-dev/components
- **AI**：支持 AI Foundation 插件集成
- **AI**：通过 AI Foundation 插件集成
docs/guide/persona.md
+1 -1
View File
@@ -31,7 +31,7 @@ AI回复者的显示名称，默认为「小回」。修改后新回复将使用
填写邮箱后，AI回复者的头像将通过 Gravatar 服务自动生成：
1. 插件根据邮箱生成 SHA-256 哈希
2. 构造 Gravatar URL：`https://cn.cravatar.com/avatar/{hash}`
2. 构造 Gravatar URL：`https://cn.cravatar.com/avatar/{hash}`（使用 [Cravatar](https://cn.cravatar.com) 镜像服务）
3. 头像URL存储在评论的 `owner.annotations["avatar"]` 中
::: warning
docs/guide/prompt.md
+28 -24
View File
@@ -9,6 +9,8 @@ Prompt模板控制AI生成回复时的完整提示词结构。
{{safety_prompt}}
【语言要求】请用评论所使用的语言回复。如果评论是英文，请用英文回复；如果是中文，请用中文回复；如果是日文，请用日文回复；以此类推。
请回复以下评论。注意：
- 回复长度应与评论长度匹配，简短问候简短回复
- 不要复述或总结文章内容
@@ -21,6 +23,7 @@ Prompt模板控制AI生成回复时的完整提示词结构。
文章（仅供理解上下文，不要复述）：
{{article}}
{{conversation_history}}
评论：
{{comment}}
```
@@ -29,23 +32,26 @@ Prompt模板控制AI生成回复时的完整提示词结构。
| 变量 | 说明 | 注入时机 |
|------|------|---------|
| `{{persona_prompt}}` | AI角色人格提示词 | 始终注入 |
| `{{persona_prompt}}` | AI角色人格提示词（含已启用的预设） | 始终注入 |
| `{{safety_prompt}}` | 安全规范提示词 | 始终注入 |
| `{{sentiment_prompt}}` | 情感语气提示词 | 情感分析后自动注入，不在模板中显式使用 |
| `{{post_title}}` | 文章标题 | 始终注入 |
| `{{post_date}}` | 文章发布日期（如 2024-01-15） | 始终注入 |
| `{{comment_count}}` | 该文章的评论数 | 始终注入 |
| `{{article}}` | 文章/页面内容（含标题） | 始终注入 |
| `{{conversation_history}}` | 对话历史上下文 | 多轮对话时注入 |
| `{{comment}}` | 评论内容（含评论者名称） | 始终注入 |
| `{{conversation}}` | 对话上下文 | 多轮对话时注入 |
::: warning 变量名注意
对话上下文变量是 `{{conversation_history}}`（不是 `{{conversation}}`）。如果模板中使用了错误的变量名，该变量不会被替换。
:::
## 情感提示
情感提示由插件根据情感分析结果自动注入到Prompt中，不需要在模板中手动添加：
情感提示由插件根据情感分析结果自动追加到 Prompt 末尾，不需要在模板中手动添加：
- **正面** → "评论者情绪积极友好，请用热情友好的语气回复，表达感谢和共鸣。"
- **负面** → "评论者情绪偏消极或不满，请用理性温和的语气回复，避免激化矛盾，适当表示理解。"
- **中性** → 不注入额外提示
- **正面** → 追加"评论者情绪正面积极，请用热情友好的语气回复，可以表达感谢和共鸣。"
- **负面** → 追加"评论者情绪偏负面，请用理性温和的语气回复，避免激化矛盾，展现理解和包容。"
- **中性** → 不追加额外提示
## 安全提示
@@ -56,6 +62,17 @@ Prompt模板控制AI生成回复时的完整提示词结构。
- 不生成虚假信息
- 回复内容与评论相关
## 预设风格
在 Prompt 设置页面可以多选启用预设风格，启用后预设提示词会自动合并到 `{{persona_prompt}}` 之后：
| 预设 | 说明 |
|------|------|
| 友好型 | 热情友好，多用感叹号和表情符号，口语化表达 |
| 专业型 | 专业严谨，正式语言风格，有逻辑性 |
| 幽默型 | 适当加入幽默元素，轻松诙谐但不过度 |
| 简洁型 | 非常简洁，一两句话即可，不展开讨论 |
## 自定义建议
自定义Prompt模板时，建议：
@@ -63,20 +80,7 @@ Prompt模板控制AI生成回复时的完整提示词结构。
1. 保留 `{{persona_prompt}}` 和 `{{safety_prompt}}` 变量
2. 保留 `{{article}}` 和 `{{comment}}` 变量
3. 利用 `{{post_title}}`、`{{post_date}}`、`{{comment_count}}` 提供更丰富的上下文
4. 在变量之间添加清晰的分隔和指令
5. 避免让AI复述文章内容
6. 控制回复长度和风格
## 变量使用示例
### 根据评论数调整回复风格
```
{{comment_count}}条评论说明这篇文章{{#if comment_count > 10}}很受欢迎{{/if}}。
```
### 利用发布日期
```
这篇文章发布于{{post_date}}，回复时请考虑时效性。
```
4. 保留 `{{conversation_history}}` 以支持多轮对话上下文
5. 在变量之间添加清晰的分隔和指令
6. 避免让AI复述文章内容
7. 控制回复长度和风格
docs/guide/sentiment.md
+2 -2
View File
@@ -13,9 +13,9 @@
## 工作原理
1. 评论通过过滤检查后，调用AI对评论内容进行情感分析
2. AI返回情感分类结果（POSITIVE / NEUTRAL / NEGATIVE）
2. AI 使用结构化输出（`OutputSpec.choice`）返回情感分类结果（POSITIVE / NEUTRAL / NEGATIVE）
3. 如果情感分析失败（如AI不可用），默认降级为 NEUTRAL
4. 情感结果传入 PromptBuilder，在生成Prompt时注入对应的语气提示
4. 情感结果传入 PromptBuilder，在生成Prompt时追加对应的语气提示
5. 情感结果同时记录在 `AiCommentReply` 的 `sentiment` 字段中
## 日志展示
docs/guide/settings.md
+60 -15
View File
@@ -1,30 +1,50 @@
# 插件设置
插件设置页面位于 **AI回评** → **插件设置**，包含以下配置组：
插件设置页面位于 **AI回评** → **插件设置**，通过标签栏切换以下五个配置页面：
- 基本设置
- AI角色设置
- 模型设置
- Prompt设置
- 数据清理
## 基本设置
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 自动回复 | 是否启用自动回复功能 | 开启 |
| 自动发布 | AI回复是否自动发布 | 开启 |
| 自动发布 | AI回复是否自动发布，关闭则存为草稿 | 开启 |
| 最大对话轮次 | 同一评论线程中AI最多自动回复的轮次 | 8 |
| 速率限制 | 每分钟最大AI回复数量，防止批量评论消耗过多额度 | 10 |
| 最大重试次数 | AI生成失败时的最大重试次数 | 3 |
| 评论者黑名单 | 不触发AI回复的评论者显示名称或邮箱，逗号分隔 | 空 |
| 评论者黑名单 | 不触发AI回复的评论者，支持名称、邮箱和正则表达式（`regex:` 开头），逗号分隔 | 空 |
::: tip 评论者黑名单
黑名单支持三种格式：
- **名称**：如 `张三`
- **邮箱**：如 `spam@example.com`（不区分大小写）
- **正则表达式**：以 `regex:` 开头，如 `regex:^spam.*`
点击"添加评论者"按钮可从已有评论列表中选择评论者自动添加到黑名单。
:::
## AI角色设置
AI角色定义了回复评论的虚拟身份。支持创建多个角色，每个角色有独立的昵称、人格提示词和 Gravatar 头像，可指定一个为默认角色。
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| AI角色昵称 | AI回复者的显示名称 | 小回 |
| AI角色人格提示词 | 定义AI角色的人格和回复风格 | 见下方 |
| AI角色邮箱 | 用于Gravatar头像服务展示头像 | 空 |
| 角色昵称 | AI回复者的显示名称 | 小回 |
| 人格提示词 | 定义AI角色的人格和回复风格 | 见下方 |
| 邮箱 | 用于 Gravatar 头像服务展示头像 | 空 |
| 设为默认 | 将该角色设为默认角色 | 第一个角色默认 |
默认人格提示词：
> 你是「小回」，一个友善的评论者。你的回复简洁自然，像朋友聊天一样。简短的评论就简短回复，有深度的讨论才展开回应。不要长篇大论，不要复述文章内容。
::: tip Gravatar头像
填写邮箱后，AI回复者的头像将通过 [Gravatar](https://gravatar.com) 服务自动生成。如果不填写邮箱，将使用默认头像。
填写邮箱后，AI回复者的头像将通过 [Gravatar](https://gravatar.com) 服务自动生成，使用 [Cravatar](https://cn.cravatar.com) 镜像。如果不填写邮箱，将使用默认头像。
:::
## 模型设置
@@ -42,17 +62,38 @@
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 自定义Prompt模板 | AI生成回复时使用的Prompt模板 | 见下方 |
| 启用预设 | 选择要启用的Prompt预设风格（可多选） | 空 |
### 预设风格
| 预设 | 说明 |
|------|------|
| 友好型 | 热情友好，多用感叹号和表情符号，口语化表达 |
| 专业型 | 专业严谨，正式语言风格，有逻辑性 |
| 幽默型 | 适当加入幽默元素，轻松诙谐但不过度 |
| 简洁型 | 非常简洁，一两句话即可，不展开讨论 |
预设提示词会自动合并到角色人格提示词之后。
### 模板变量
| 变量 | 说明 |
|------|------|
| `{{persona_prompt}}` | AI角色人格提示词 |
| `{{safety_prompt}}` | 安全规范提示词 |
| `{{sentiment_prompt}}` | 情感语气提示词（自动注入） |
| `{{article}}` | 文章内容 |
| `{{comment}}` | 评论内容 |
| `{{conversation}}` | 对话上下文（多轮对话时） |
| 变量 | 说明 | 注入时机 |
|------|------|---------|
| `{{persona_prompt}}` | AI角色人格提示词（含已启用的预设） | 始终注入 |
| `{{safety_prompt}}` | 安全规范提示词 | 始终注入 |
| `{{post_title}}` | 文章标题 | 始终注入 |
| `{{post_date}}` | 文章发布日期（如 2024-01-15） | 始终注入 |
| `{{comment_count}}` | 该文章的评论数 | 始终注入 |
| `{{article}}` | 文章/页面内容（含标题） | 始终注入 |
| `{{conversation_history}}` | 对话历史上下文 | 多轮对话时注入 |
| `{{comment}}` | 评论内容（含评论者名称） | 始终注入 |
::: tip 情感提示
情感提示由插件根据情感分析结果自动追加到 Prompt 末尾，不需要在模板中手动添加：
- **正面** → 追加热情友好的语气提示
- **负面** → 追加理性温和的语气提示
- **中性** → 不追加额外提示
:::
## 数据清理
@@ -64,3 +105,7 @@
::: tip
你也可以在数据清理页面点击"立即清理"按钮手动触发清理操作。
:::
::: warning
清理操作仅删除 `AiCommentReply` 记录（插件内部的日志记录），不会删除已发布的 Halo Reply 评论。
:::