常见问题

安装后没有自动回复？

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

AI回复头像不显示？

1. 确认在插件设置中填写了AI角色邮箱
2. 邮箱需要在 Gravatar 上注册并设置头像
3. 插件使用 Cravatar 作为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回评 开关。页面默认就是关闭的。

全局页面AI回复开关

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

插件升级后设置丢失了？

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

AI生成失败后会怎样？

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

如何批量审核草稿回复？

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

旧记录太多怎么办？

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

黑名单支持邮箱吗？

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

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

对话窗口中每条消息的头像通过 Gravatar 服务生成（使用 Cravatar 镜像）。头像基于评论者或 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 插件

排查步骤

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

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

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

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

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

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

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