6.1 KiB
常见问题
安装后没有自动回复？
- 确认插件已启用
- 确认 自动回复 开关已开启
- 确认 AI Foundation 插件已安装并正确配置（如果使用AI Foundation）
- 检查文章的 启用AI回评 开关是否开启（文章默认开启，页面默认关闭）
- 查看插件日志是否有错误信息
AI回复头像不显示？
评论没有触发AI回复？
可能的原因：
- 文章/页面开关关闭 — 检查编辑器中的"启用AI回评"开关
- 评论者在黑名单中 — 检查基本设置中的评论者黑名单
- 已有AI回复记录 — 同一评论不会重复触发
- 历史评论 — 插件启动前的评论不会自动触发，可使用手动触发
- AI生成失败 — 检查AI模型配置和日志
- 被前置过滤拦截 — 若启用"前置过滤"，违规评论会被拦截，可在日志页通过"已拦截"状态筛选查看
如何对历史评论触发AI回复？
- 进入后台 评论 管理页面
- 找到目标评论
- 点击右侧 更多（…） → 触发AI回复
草稿模式的回复在哪里审核？
在插件管理页面的 AI回复日志 中，草稿状态的记录会显示"审核通过"和"拒绝"按钮。
如何修改AI回复的语气风格？
- 在插件设置中修改 AI角色人格提示词
- 或修改 自定义Prompt模板
AI Foundation 插件是必须的吗？
是的，AI Foundation 是本插件的必要依赖。本插件通过 AI Foundation 提供的 AiModelService 扩展点调用AI模型，请确保已安装并正确配置 AI Foundation 插件。
如何完全禁用某个页面的AI回复？
编辑页面，在元数据区域关闭 启用AI回评 开关。页面默认就是关闭的。
插件升级后设置丢失了？
插件升级不会丢失设置。如果遇到问题，请检查 ConfigMap 是否正确迁移。
AI生成失败后会怎样？
插件会自动重试，重试次数由"最大重试次数"配置控制（默认3次）。重试间隔递增（5秒、15秒、30秒）。超过最大重试次数后标记为失败。
如何批量审核草稿回复？
在AI回复日志页面，勾选多条记录后，使用顶部的批量操作工具栏进行批量通过、拒绝或删除。
旧记录太多怎么办？
在插件设置的"数据清理"页面，可以配置自动清理超过指定天数的记录（默认30天），也可以点击"立即清理"手动触发。
黑名单支持邮箱吗？
支持。黑名单同时匹配评论者的显示名称和邮箱地址，不区分大小写。你也可以在设置页面点击"添加评论者"按钮从评论列表中选择。
对话窗口中的头像是怎么来的？
对话窗口中每条消息的头像通过 Gravatar 服务生成（使用 Cravatar 镜像）。头像基于评论者或 AI 角色的邮箱自动匹配。如果未设置邮箱，则显示默认图标。
对话窗口中的引用框是什么？
当一条回复是针对另一条回复的（即层级回复），对话窗口会在该消息气泡内显示一个引用摘要框，标明该回复引用了谁的什么内容。引用内容会截断显示（最多35个字符），方便快速了解对话脉络。
如何备份和迁移插件配置？
在插件设置页面顶部点击 导出 按钮，将当前配置导出为 JSON 文件。在目标实例中点击 导入 按钮选择该文件即可恢复配置。导入会覆盖当前配置，请谨慎操作。
AI Foundation 显示"部分功能不可用"怎么办？
这通常表示 AI Foundation 插件未正确配置模型。请检查：
- AI Foundation 插件已安装并启用
- 在 AI Foundation 中配置了至少一个 AI 模型
- 如果回评插件未指定模型名称，将使用 AI Foundation 的默认模型
前置过滤会误伤正常评论吗？
前置过滤默认启用。AI 会对评论进行分类判断，若 AI 服务不可用或分类失败，为安全起见会拦截评论而非放行。如果你发现正常评论被误拦截，可以在设置中关闭"启用前置过滤"开关。被拦截的评论会在日志页生成一条"已拦截"状态的记录，可查看具体分类标签和拦截原因。
所有评论都显示"AI分类服务不可用，安全拦截"怎么办？
这表示 AI 分类调用链路存在问题，可能的原因：
- AI Foundation 插件未安装或未启用 — 请确保 AI Foundation 插件已正确安装并启用
- AI Foundation 中未配置模型 — 请在 AI Foundation 中配置至少一个 AI 模型
- 模型名称配置错误 — 检查插件设置中的模型名称是否与 AI Foundation 中的 AiModel 资源名称一致，留空则使用默认模型
- AI Foundation 版本过旧 — 请确保使用最新版本的 AI Foundation 插件
::: tip 排查步骤
- 检查插件设置页面顶部的 AI Foundation 连接状态
- 查看插件日志中
[Delegate]和[PreFilter]前缀的诊断信息 - 确认 AI 回复功能（非前置过滤）是否正常工作 — 如果 AI 回复也无法生成，说明是 AI Foundation 连接问题 :::
被前置过滤拦截的评论会怎样？
- 停止生成 AI 回复 — 不会消耗后续 Token
- 创建拦截记录 — 在日志页显示为"已拦截"状态，标注分类标签（如"辱骂攻击"）和详细原因（含评论内容摘要）
- 自动设为待审核 — 原评论的
approved会被置为false，前端不再展示该评论，需人工判断后审核通过
被误拦截的评论怎么处理？
在日志页的"已拦截"记录右侧，点击 误报反馈 按钮，可选择：
- AI 回复 — 标记为误报 + 自动通过评论 + 触发 AI 生成回复
- 仅通过 — 仅标记为误报 + 自动通过评论，不生成 AI 回复
选择"仅通过"后，记录状态变为"误报通过"，可随时点击 触发AI回复 按钮补生成 AI 回复。