# 插件介绍

AI回评（Comment AI Autopilot）是一个 Halo 博客系统的插件，能够自动为博客评论生成AI回复。

## 核心功能

- **自动回复** — 监听新评论，自动调用AI生成回复，支持多轮对话上下文
- **多语言适配** — 根据评论语言自动用对应语言回复（中文、英文、日文、韩文等）
- **情感分析** — 分析评论情感倾向（正面/中性/负面），根据情感调整回复语气
- **草稿模式** — AI回复先存为草稿，管理员审核后再发布，支持发布前编辑回复内容
- **失败重试** — AI生成失败时自动重试，指数退避策略
- **批量操作** — 草稿模式下支持批量通过/拒绝/删除
- **文章/页面级开关** — 在文章编辑器中直接控制是否启用AI回复，文章默认开启，页面默认关闭
- **评论者黑名单** — 屏蔽指定评论者，支持名称、邮箱和正则表达式匹配
- **手动触发** — 在评论管理页面对历史评论手动触发AI回复
- **AI角色** — 自定义AI回复者的昵称、人格提示词和Gravatar头像，支持多角色管理和排序
- **安全审核** — AI生成的内容经过安全审核，不合规内容自动拒绝
- **仪表盘统计** — 显示回复数、情感分布、通过率、平均审核评分等统计信息
- **日志筛选搜索** — 按状态、情感筛选，关键词搜索，时间范围过滤，支持分页
- **配置导入/导出** — 支持导出和导入插件配置，方便迁移和备份
- **数据清理** — 自动清理超过指定天数的旧记录
- **AI Foundation 集成** — 必须安装 Halo AI Foundation 插件，使用其提供的AI模型能力

## 工作流程

```
新评论 → 过滤检查 → 情感分析 → 构建Prompt → AI生成 → 安全审核 → 发布/草稿
                                                          ↓ (失败)
                                                        重试 → ... → 最终失败
```

1. **新评论到达** — Reconciler 监听到新评论创建事件
2. **过滤检查** — 检查文章/页面是否启用AI回复、评论者是否在黑名单中
3. **情感分析** — 调用AI分析评论情感倾向
4. **构建Prompt** — 结合AI角色人格、情感提示、文章内容、评论上下文构建Prompt
5. **AI生成** — 调用AI模型生成回复内容
6. **安全审核** — 对生成内容进行安全审核
7. **发布/草稿** — 根据设置自动发布或存为草稿等待审核
8. **重试** — 如果AI生成失败，系统会自动重试（最多 maxRetryCount 次），每次重试间隔递增

## 前置要求

- Halo 2.23+
- AI Foundation 插件（必须） — 本插件依赖 AI Foundation 提供的AI模型能力

## 技术栈

- **后端**：Java + Spring WebFlux + Reactive
- **前端**：Vue 3 + @halo-dev/components
- **AI**：支持 AI Foundation 插件集成