Files
plugin-comment-ai-autopilot/README.md
T
sunny-335 207a013239 chore: v1.4.1 重写README、清理死代码、更新文档
- 重写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条目
2026-07-12 10:01:11 +08:00

6.2 KiB
Raw Blame History

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 格式备份和迁移配置

前置要求

安装

应用商店

进入 插件安装 → 应用市场搜索 AI回评 → 安装,或前往 Halo 应用商店 一键安装。

手动安装

  1. 前往 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回评"开关,可单独控制每篇文章。

从源码构建

git clone https://github.com/sunny-335/plugin-comment-ai-autopilot.git
cd plugin-comment-ai-autopilot
./gradlew build -x test
# 构建产物位于 build/libs/ 目录

开发

./gradlew haloServer    # 启动开发服务器
cd ui && pnpm install && pnpm dev    # 前端开发

文档

完整文档及更新日志请访问 AI回评文档站

许可证

GPL-3.0 © 暖心向阳335


AI 辅助开发声明

本项目在开发过程中使用了以下 AI 模型辅助编码:

  • GLM-5.1 / GLM-5.2(智谱AI
  • Qwen3.6 / Qwen3.7 Plus(阿里通义千问)
  • Doubao Seed 2.1 Pro(字节豆包)
  • MIMO V2.5(小米)

AI 辅助范围包括:代码生成、Bug 修复、代码审查、文档撰写。所有代码均经人工审查和测试验证后合并。