# 常见问题

## 安装后没有自动回复？

1. 确认插件已启用
2. 确认 **自动回复** 开关已开启
3. 确认 AI Foundation 插件已安装并正确配置（如果使用AI Foundation）
4. 检查文章的 **启用AI回评** 开关是否开启（文章默认开启，页面默认关闭）
5. 查看插件日志是否有错误信息

## AI回复头像不显示？

1. 确认在AI角色设置中填写了邮箱
2. 邮箱需要在 [Gravatar](https://gravatar.com) 上注册并设置头像
3. 插件使用 [Cravatar](https://cravatar.cn) 作为Gravatar镜像服务

::: info
由于 Halo 评论系统的限制，AI角色头像仅支持通过 Gravatar 邮箱方式设置，不支持自定义上传头像。
:::

## 评论没有触发AI回复？

可能的原因：

1. **文章/页面开关关闭** — 检查编辑器中的"启用AI回评"开关
2. **评论者在黑名单中** — 检查基本设置中的评论者黑名单
3. **已有AI回复记录** — 同一评论不会重复触发
4. **历史评论** — 插件启动前的评论不会自动触发，可使用手动触发
5. **AI生成失败** — 检查AI模型配置和日志
6. **速率限制** — 检查是否触发了每分钟回复数量限制
7. **对话轮次上限** — 检查是否达到了最大对话轮次

## 如何对历史评论触发AI回复？

1. 进入后台 **评论** 管理页面
2. 找到目标评论
3. 点击右侧 **更多（…）** → **触发AI回复**

## 草稿模式的回复在哪里审核？

在插件管理页面的 **AI回复日志** 中，草稿状态的记录会显示"编辑"、"审核通过"和"拒绝"按钮。

## 如何在发布前编辑AI回复？

1. 确保草稿模式已启用（关闭"自动发布"开关）
2. 在AI回复日志页面找到状态为"通过"且未发布的记录
3. 点击 **编辑** 按钮修改回复内容
4. 修改完成后点击"审核通过"发布

::: tip
编辑功能仅在草稿状态（通过但未发布）下可用。
:::

## 如何修改AI回复的语气风格？

1. 在插件设置中修改 **AI角色人格提示词**
2. 或修改 **自定义Prompt模板**
3. 或选择不同的 **Prompt预设** 风格组合

## AI Foundation 插件是必须的吗？

是的，AI Foundation 是本插件的必要依赖。本插件通过 AI Foundation 提供的 `AiModelService` 扩展点调用AI模型，请确保已安装并正确配置 AI Foundation 插件。

## 如何完全禁用某个页面的AI回复？

编辑页面，在元数据区域关闭 **启用AI回评** 开关。页面默认就是关闭的。

## 插件升级后设置丢失了？

插件升级不会丢失设置。如果遇到问题，请检查 ConfigMap 是否正确迁移。

## AI生成失败后会怎样？

插件会自动重试，重试次数由"最大重试次数"配置控制（默认3次）。重试间隔递增（5秒、15秒、30秒）。超过最大重试次数后标记为失败。

## 如何批量审核草稿回复？

在AI回复日志页面，勾选多条记录后，使用顶部的批量操作工具栏进行批量通过、拒绝或删除。

## 旧记录太多怎么办？

在插件设置的"数据清理"页面，可以配置自动清理超过指定天数的记录（默认30天），也可以点击"立即清理"手动触发。

## 黑名单支持正则表达式吗？

支持。黑名单支持三种匹配方式：
- **名称匹配**：直接输入评论者显示名称
- **邮箱匹配**：输入邮箱地址
- **正则表达式**：以 `regex:` 开头，如 `regex:^spam.*`

## 如何管理多个AI角色？

在插件设置的 **AI角色设置** 区域，可以添加、编辑、删除AI角色，也可以使用 ▲▼ 按钮调整角色顺序。每个角色有独立的昵称、人格提示词和Gravatar头像。

## 如何导入/导出配置？

在插件设置页面右上角：
- 点击 **导出配置** 将当前设置和AI角色导出为 JSON 文件
- 点击 **导入配置** 从 JSON 文件导入配置（导入前会显示确认对话框）

## 日志页面如何按时间筛选？

在日志页面的筛选栏中，使用日期选择器设置起始日期和结束日期，即可筛选指定时间范围内的记录。

## 为什么AI角色不支持自定义上传头像？

Halo 的评论组件对匿名评论者（kind=Email）始终使用 `email-hash` 注解生成 Gravatar 头像，会忽略自定义头像 URL。这是 Halo 评论系统的设计限制，因此插件只支持通过 Gravatar 邮箱方式设置AI角色头像。