# 常见问题

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

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

## AI回复头像不显示？

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

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

可能的原因：

1. **文章/页面开关关闭** — 检查编辑器中的"启用AI回评"开关
2. **评论者在黑名单中** — 检查基本设置中的评论者黑名单
3. **已有AI回复记录** — 同一评论不会重复触发
4. **历史评论** — 插件启动前的评论不会自动触发，可使用手动触发
5. **AI生成失败** — 检查AI模型配置和日志
6. **被前置过滤拦截** — 若启用"前置过滤"，违规评论会被拦截，可在日志页通过"已拦截"状态筛选查看

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

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

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

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

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

1. 在插件设置中修改 **AI角色的人格提示词**
2. 或修改提示词设置中的 **角色身份提示词（personaIdentity）**

::: tip
AI角色的人格提示词留空时自动使用基础配置中的角色身份提示词（personaIdentity），无需重复填写。
:::

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

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

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

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

::: tip 全局页面AI回复开关
在 **基本设置** 中有 **启用页面AI回复** 开关，开启后所有页面（包括新建页面）一键启用AI回复，关闭则一键关闭所有页面。默认为关闭。
:::

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

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

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

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

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

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

## 旧记录太多怎么办？

在插件设置的"数据清理"页面，可以配置自动清理超过指定天数的记录（默认30天），也可以手动清理。手动清理支持自定义时间节点（默认清理7天前的记录），执行前会弹出二次确认弹窗。

## 黑名单支持邮箱吗？

支持。黑名单同时匹配评论者的显示名称和邮箱地址，不区分大小写。你也可以在设置页面点击"添加评论者"按钮从评论列表中选择。

## 对话窗口中的头像是怎么来的？

对话窗口中每条消息的头像通过 [Gravatar](https://gravatar.com) 服务生成（使用 [Cravatar](https://cn.cravatar.com) 镜像）。头像基于评论者或 AI 角色的邮箱自动匹配。如果未设置邮箱，则显示默认图标。

## 对话窗口中的引用框是什么？

当一条回复是针对另一条回复的（即层级回复），对话窗口会在该消息气泡内显示一个引用摘要框，标明该回复引用了谁的什么内容。引用内容会截断显示（最多35个字符），方便快速了解对话脉络。

## 如何备份和迁移插件配置？

在插件设置页面顶部点击 **导出** 按钮，将当前配置导出为 JSON 文件。在目标实例中点击 **导入** 按钮选择该文件即可恢复配置。导入会覆盖当前配置，请谨慎操作。

## AI Foundation 显示"未安装"或"未启用"怎么办？

插件首页会自动检测 AI Foundation 的状态并显示对应的警告卡片：

| 状态 | 提示 | 解决方案 |
|------|------|---------|
| 未安装 | AI Foundation 未安装 | 前往插件页面或应用商店安装 |
| 已安装未启用 | AI Foundation 未启用 | 前往插件页面启用 |
| 已启用未配置模型 | 未配置默认模型 | 在 AI Foundation 中添加模型并设置默认模型 |

点击警告卡片上的快捷按钮可直接跳转到对应页面。

## 前置过滤会误伤正常评论吗？

前置过滤默认启用。AI 会对评论进行分类判断，若 AI 服务不可用或分类失败，为安全起见会拦截评论而非放行。如果你发现正常评论被误拦截，可以在设置中关闭"启用前置过滤"开关。被拦截的评论会在日志页生成一条"已拦截"状态的记录，可查看具体分类标签和拦截原因。

## 所有评论都显示"AI分类服务不可用，安全拦截"怎么办？

这表示 AI 分类调用链路存在问题，可能的原因：

1. **AI Foundation 插件未安装或未启用** — 请确保 AI Foundation 插件已正确安装并启用
2. **AI Foundation 中未配置模型** — 请在 AI Foundation 中配置至少一个 AI 模型
3. **模型名称配置错误** — 检查插件设置中的模型名称是否与 AI Foundation 中的 AiModel 资源名称一致，留空则使用默认模型
4. **AI Foundation 版本过旧** — 请确保使用最新版本的 AI Foundation 插件

::: tip 排查步骤
1. 检查插件设置页面顶部的 AI Foundation 连接状态
2. 查看插件日志中 `[Delegate]` 和 `[PreFilter]` 前缀的诊断信息
3. 确认 AI 回复功能（非前置过滤）是否正常工作 — 如果 AI 回复也无法生成，说明是 AI Foundation 连接问题
:::

## 被前置过滤拦截的评论会怎样？

1. **停止生成 AI 回复** — 不会消耗后续 Token
2. **创建拦截记录** — 在日志页显示为"已拦截"状态，标注分类标签（如"辱骂攻击"）和详细原因（含评论内容摘要）
3. **自动设为待审核** — 原评论的 `approved` 会被置为 `false`，前端不再展示该评论，需人工判断后审核通过

## 被误拦截的评论怎么处理？

在日志页的"已拦截"记录右侧，点击 **误报反馈** 按钮，可选择：

- **AI 回复** — 标记为误报 + 自动通过评论 + 触发 AI 生成回复
- **仅通过** — 仅标记为误报 + 自动通过评论，不生成 AI 回复

选择"仅通过"后，记录状态变为"误报通过"，可随时点击 **触发AI回复** 按钮补生成 AI 回复。
