sunny-335
767efdccbb
- Replace cross-ClassLoader reflection with ExtensionGetter.getEnabledExtension(AiModelService.class) - Declare optional pluginDependencies (ai-foundation?: "*") and recommended-apps annotation - Use OutputSpec.choice for structured classification (sentiment, review safety/quality) - Use GenerateTextRequest with maxRetries=2 for reliable chat generation - Add multi-turn conversation context (conversation_history placeholder) - Fix RateLimitService thread leak (implement DisposableBean) - Two-stage AI review: safety check + 1-5 quality score mapped to 0-100 - Remove redundant dashboard cards (sentiment distribution, 7-day trend, avg score) - Redesign settings page with tabbed navigation (basic/persona/model/prompt/cleanup) - Fix settings layout (move tab bar out of grid container) - Fix button icon+text alignment via :deep(.btn-content) inline-flex - Add review score grade labels (excellent/good/fair/poor) in logs
128 lines
5.8 KiB
Markdown
128 lines
5.8 KiB
Markdown
# AI回评 / Comment AI Autopilot
|
|
|
|
基于 AI 的 Halo 博客评论自动回复插件，支持多 AI 角色、自审核、自动发布和对话式连续回复。
|
|
|
|
> **当前版本**: v1.0.0-beta.2
|
|
|
|
## 功能特性
|
|
|
|
- **多 AI 角色** — 支持创建多个 AI 角色，每个角色有独立的昵称、人格提示词和 Gravatar 头像，可为不同文章指定不同角色
|
|
- **自动回复** — 监听新评论，自动调用 AI 生成回复，支持多轮对话上下文
|
|
- **多语言适配** — 根据评论语言自动用对应语言回复
|
|
- **情感分析** — 分析评论情感倾向（正面/中性/负面），根据情感调整回复语气
|
|
- **草稿模式** — AI 回复先存为草稿，管理员审核后再发布，支持批量操作
|
|
- **失败重试** — AI 生成失败时自动重试，指数退避策略
|
|
- **对话轮次限制** — 同一评论线程中限制 AI 最多回复轮次，防止无限对话
|
|
- **速率限制** — 每分钟最大 AI 回复数量，防止批量评论消耗过多额度
|
|
- **文章/页面级开关** — 在文章编辑器中直接控制是否启用 AI 回复，文章默认开启，页面默认关闭
|
|
- **评论者黑名单** — 支持按名称、邮箱和正则表达式屏蔽指定评论者，可从评论列表选择
|
|
- **手动触发** — 在评论管理页面对历史评论手动触发 AI 回复
|
|
- **安全审核** — AI 生成的内容经过安全审核，不合规内容自动拒绝
|
|
- **Prompt 模板** — 支持自定义 Prompt 模板，提供多种模板变量（文章标题、发布日期、评论数等）
|
|
- **Prompt 预设** — 内置友好型、专业型、幽默型、简洁型预设风格，可多选组合
|
|
- **仪表盘统计** — 显示回复数、情感分布、每日回复趋势等图表，支持时间范围切换
|
|
- **插件健康检查** — 实时检测 AI Foundation 连接状态和模型可用性
|
|
- **日志筛选** — 按状态、情感筛选，关键词搜索
|
|
- **数据清理** — 自动清理超过指定天数的旧记录
|
|
- **AI Foundation 集成** — 必须安装 Halo AI Foundation 插件，使用其提供的 AI 模型能力
|
|
|
|
## 前置要求
|
|
|
|
- Halo 2.25+
|
|
- AI Foundation 插件（必须）
|
|
|
|
## 安装
|
|
|
|
1. 前往 [Releases](https://github.com/sunny-335/plugin-comment-ai-autopilot/releases) 下载最新的 `.jar` 文件
|
|
2. 登录 Halo 管理后台
|
|
3. 进入 **插件** → **已安装** → 点击右上角 **安装** 按钮
|
|
4. 选择下载的 `.jar` 文件上传
|
|
5. 安装完成后启用插件
|
|
|
|
## 从源码构建
|
|
|
|
```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)
|
|
|
|
## 更新日志
|
|
|
|
### v1.0.0-beta.2
|
|
|
|
**改进**
|
|
|
|
- 通过 Halo 官方推荐的 `ExtensionGetter` 获取 AI Foundation 的 `AiModelService`，替换原先的跨 ClassLoader 反射调用方式
|
|
- 在 `plugin.yaml` 中声明可选插件依赖 `ai-foundation?: "*"`，建立正确的插件依赖关系
|
|
- 新增 `store.halo.run/recommended-apps` 注解，安装后可在应用市场推荐安装 AI Foundation 插件
|
|
- 情感分析和内容审核改用 AI Foundation 结构化输出（`OutputSpec.choice`），分类更可靠
|
|
- AI 调用改用 `GenerateTextRequest` 并设置 `maxRetries=2`，由 SDK 自动重试瞬时错误
|
|
- AI 对话续接时自动获取之前的回复历史并注入到 Prompt 中，AI 能更好地理解对话上下文
|
|
- 优化 AI 自审核评分机制：改为两阶段评估（安全检查 + 质量评分 1-5 分），评分映射到 0-100 分，替代原先的二值评分
|
|
- 精简仪表盘：移除情感分布、近7日回复趋势、平均审核评分三个卡片，界面更简洁
|
|
- 优化设置页面布局：按钮统一排版并添加图标，侧边栏新增"未保存"状态指示器
|
|
- 优化日志页面评分显示：评分增加等级标签（优秀/良好/一般/较差）
|
|
|
|
**Bug 修复**
|
|
|
|
- 修复 RateLimitService 清理线程在插件停止时未关闭导致线程泄漏
|
|
- 修复内容审核提示词要求"重新生成"但代码未使用重新生成内容的问题
|
|
|
|
### v1.0.0-beta.1
|
|
|
|
**新功能**
|
|
|
|
- AI Foundation 反射集成：通过运行时反射调用 AI Foundation 插件的 `AiModelService`，无需 `pluginDependencies`，彻底解决跨 ClassLoader 类加载问题
|
|
- 草稿模式：关闭"自动发布"后，AI 回复将保存为草稿，需站长审核后才发布
|
|
- 多 AI 角色支持：支持配置多个 AI 虚拟角色，每个角色有独立的提示词、头像和模型
|
|
- 提示词预设：内置多种回复风格预设（专业型、幽默型、简洁型等），可自由组合
|
|
- 每日回复趋势图：首页新增每日回复数量柱状图，支持 7 天/30 天/全部切换
|
|
- 对话历史查看：支持查看 AI 回复的完整对话上下文
|
|
|
|
**Bug 修复**
|
|
|
|
- 修复草稿模式下审批失败（"AI回复已存在，无法重复发布"）的问题
|
|
- 修复批量审批时同样的去重检查冲突问题
|
|
- 修复 AI Foundation 不可用的问题（`PluginManager` 无法通过 Spring 依赖注入获取）
|
|
- 修复 `DefaultSpringPlugin` 包级私有类反射访问权限问题
|
|
- 修复 CI 构建失败（`gradlew` 缺少执行权限）
|
|
|
|
**改进**
|
|
|
|
- 审批逻辑优化：先查找已有 Reply 扩展再决定创建或更新
|
|
- 移除不必要的 `AiFoundationConfiguration` 配置类
|
|
- 前端 UI 优化：移除编辑功能、简化角色排序逻辑、清理无用代码
|
|
|
|
### v0.0.3
|
|
|
|
- 增强插件可靠性与可用性
|
|
- 多 AI 角色支持
|
|
- 草稿模式初步实现
|
|
- 文档全面更新
|
|
|
|
## 许可证
|
|
|
|
[GPL-3.0](https://github.com/sunny-335/plugin-comment-ai-autopilot/blob/main/LICENSE) © 暖心向阳335
|