sunny-335
207a013239
- 重写README.md，精简结构，添加AI辅助开发声明(GLM/Qwen/Doubao/MIMO) - 清理6项死代码: WhitelistService.isSuperAdmin、PersonaResponse record、AiBadgeHeadProcessor空操作类、utils/api.ts、utils/gravatar.ts、canvas-confetti依赖 - 版本号更新为1.4.1 - 更新CHANGELOG.md添加v1.4.1条目
143 lines
6.2 KiB
Markdown
143 lines
6.2 KiB
Markdown
# AI回评 / Comment AI Autopilot
|
||
|
||
> 基于 AI 的 Halo 博客评论自动回复插件，支持多 AI 角色、合规检测、自动发布和对话式连续回复。
|
||
|
||
## 功能特性
|
||
|
||
- **多 AI 角色** — 独立昵称、人格提示词、性别、语气和 Gravatar 头像，支持按文章分类指定角色，人格提示词留空时使用基础配置
|
||
- **唤醒词** — 评论以唤醒词开头可唤醒指定角色，支持跨页面唤醒和二级评论
|
||
- **自动回复** — 监听新评论自动调用 AI 生成回复，支持多轮对话上下文
|
||
- **多语言适配** — 根据评论语言自动用对应语言回复，语言要求提示词可自定义
|
||
- **情感分析** — 5 级情感分类（非常正面/正面/中性/负面/非常负面），根据情感调整回复语气
|
||
- **前置过滤（合规检测）** — AI 回复前对评论进行合规性分类，自动拦截广告/辱骂/敏感/乱码内容，节省 Token
|
||
- **误报反馈** — 被误拦截的评论可进行误报反馈，支持"AI回复"和"仅通过"两种方式
|
||
- **草稿模式** — AI 回复先存为草稿，管理员审核后再发布，支持批量操作
|
||
- **失败重试** — AI 生成失败时自动重试，最大重试次数可配置（0-10 次，默认 3 次）
|
||
- **对话轮次限制** — 限制 AI 最多回复轮次，0 为不限制，默认 10 轮
|
||
- **速率限制** — 每小时最大 AI 回复数量，0 为不限制
|
||
- **文章/页面级开关** — 文章默认开启、页面默认关闭，支持全局页面 AI 回复开关一键控制
|
||
- **评论者黑/白名单** — 批量添加/移除评论者，白名单跳过前置过滤，黑名单不触发 AI 回复
|
||
- **手动触发** — 在评论管理页面对历史评论手动触发 AI 回复
|
||
- **模块化提示词** — 5 个独立模块（角色身份/安全审核/情感适配/输出规范/语言要求），均为可选，留空使用默认值
|
||
- **智能状态检测** — 自动检测 AI Foundation 安装/启用/模型配置状态，检测 Comment Next 冲突
|
||
- **日志与实时刷新** — 按状态、情感、角色筛选，关键词搜索，实时刷新偏好自动保存
|
||
- **数据清理** — 自动清理旧记录，手动清理支持自定义时间节点和二次确认
|
||
- **配置导入导出** — JSON 格式备份和迁移配置
|
||
|
||
## 前置要求
|
||
|
||
- Halo 2.25+
|
||
- [AI Foundation](https://www.halo.run/store/apps/app-acslk9nu) 插件（必须）
|
||
|
||
## 安装
|
||
|
||
### 应用商店
|
||
|
||
进入 **插件** → **安装** → 应用市场搜索 **AI回评** → 安装，或前往 [Halo 应用商店](https://www.halo.run/store/apps/app-mo5tivjt) 一键安装。
|
||
|
||
### 手动安装
|
||
|
||
1. 前往 [Releases](https://github.com/sunny-335/plugin-comment-ai-autopilot/releases) 下载最新的 `.jar` 文件
|
||
2. 登录 Halo 管理后台
|
||
3. 进入 **插件** → **安装** → **本地上传**
|
||
4. 选择下载的 `.jar` 文件上传
|
||
5. 安装完成后启用插件
|
||
|
||
## 首次使用
|
||
|
||
安装并启用插件后，请按以下步骤完成初始配置：
|
||
|
||
### 1. 安装 AI Foundation 插件
|
||
|
||
AI 回评依赖 AI Foundation 插件提供 AI 能力。请确保：
|
||
|
||
1. 已在 **插件** 页面安装并启用 AI Foundation 插件
|
||
2. 在 AI Foundation 中添加了至少一个 AI 模型（如 OpenAI、Ollama、DeepSeek 等）
|
||
3. 在 **AI Foundation → 默认模型** 页面设置了默认模型
|
||
|
||
> 插件首页会自动检测 AI Foundation 状态，如未安装/未启用/未配置模型，将显示对应的提示和快捷跳转按钮。
|
||
|
||
### 2. 配置基础设置
|
||
|
||
进入 **评论 → AI回评 → 设置**，在"基本设置"面板中：
|
||
|
||
- **自动回复**：默认开启，关闭则需手动触发
|
||
- **自动发布**：开启后 AI 回复直接发布，关闭则进入草稿待审核
|
||
- **最大重试次数**：默认 3 次（0-10）
|
||
- **最大对话轮次**：默认 10 轮，0 为不限制
|
||
- **速率限制（每小时）**：默认 0（不限制）
|
||
- **启用页面 AI 回复**：默认关闭，开启后所有页面一键启用
|
||
- **前置过滤**：建议开启，自动拦截广告/辱骂/敏感内容
|
||
- **白名单**：白名单内评论者跳过前置过滤
|
||
|
||
### 3. 配置提示词（可选）
|
||
|
||
切换到"提示词设置"面板，5 个模块均为可选，留空使用默认值：
|
||
|
||
- **角色身份提示词**：定义 AI 的基础身份和回复风格
|
||
- 其他模块（安全审核/情感适配/输出规范/语言要求）可按需调整
|
||
|
||
### 4. 创建 AI 角色（可选）
|
||
|
||
在"AI角色管理"面板点击"添加角色"：
|
||
|
||
- 设置昵称、邮箱（Gravatar 头像）、性别、语气风格
|
||
- **人格提示词**：留空则使用基础配置的角色身份提示词
|
||
- **唤醒词**：评论以唤醒词开头可召唤该角色
|
||
- 可为不同文章分类指定不同角色
|
||
|
||
### 5. 配置黑/白名单（可选）
|
||
|
||
在"基本设置"面板的评论者黑/白名单区域：
|
||
|
||
- 支持从历史评论者中多选批量添加，也支持手动输入
|
||
- 黑名单评论者不触发 AI 回复，白名单评论者跳过前置过滤
|
||
|
||
### 6. 开始使用
|
||
|
||
- 新评论会自动触发 AI 回复（如果文章/页面启用了 AI 回评）
|
||
- 在 **评论 → AI回评 → 回复日志** 中查看所有记录
|
||
- 如需临时关闭，在"基本设置"中关闭"自动回复"开关即可
|
||
|
||
> 编辑文章时，右侧设置面板中有"AI回评"开关，可单独控制每篇文章。
|
||
|
||
## 从源码构建
|
||
|
||
```bash
|
||
git clone https://github.com/sunny-335/plugin-comment-ai-autopilot.git
|
||
cd plugin-comment-ai-autopilot
|
||
./gradlew build -x test
|
||
# 构建产物位于 build/libs/ 目录
|
||
```
|
||
|
||
## 开发
|
||
|
||
```bash
|
||
./gradlew haloServer # 启动开发服务器
|
||
cd ui && pnpm install && pnpm dev # 前端开发
|
||
```
|
||
|
||
## 文档
|
||
|
||
完整文档及更新日志请访问 [AI回评文档站](https://nxxy335.top/comment-ai-autopilot)
|
||
|
||
## 许可证
|
||
|
||
[GPL-3.0](https://github.com/sunny-335/plugin-comment-ai-autopilot/blob/main/LICENSE) © 暖心向阳335
|
||
|
||
---
|
||
|
||
<details>
|
||
<summary>AI 辅助开发声明</summary>
|
||
|
||
本项目在开发过程中使用了以下 AI 模型辅助编码：
|
||
|
||
- **GLM-5.1 / GLM-5.2**（智谱AI）
|
||
- **Qwen3.6 / Qwen3.7 Plus**（阿里通义千问）
|
||
- **Doubao Seed 2.1 Pro**（字节豆包）
|
||
- **MIMO V2.5**（小米）
|
||
|
||
AI 辅助范围包括：代码生成、Bug 修复、代码审查、文档撰写。所有代码均经人工审查和测试验证后合并。
|
||
|
||
</details>
|