100 lines
4.8 KiB
Markdown
100 lines
4.8 KiB
Markdown
# 常见问题
|
||
|
||
## 安装后没有自动回复？
|
||
|
||
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. 或修改 **自定义Prompt模板**
|
||
|
||
## AI Foundation 插件是必须的吗？
|
||
|
||
是的，AI Foundation 是本插件的必要依赖。本插件通过 AI Foundation 提供的 `AiModelService` 扩展点调用AI模型，请确保已安装并正确配置 AI Foundation 插件。
|
||
|
||
## 如何完全禁用某个页面的AI回复？
|
||
|
||
编辑页面，在元数据区域关闭 **启用AI回评** 开关。页面默认就是关闭的。
|
||
|
||
## 插件升级后设置丢失了？
|
||
|
||
插件升级不会丢失设置。如果遇到问题，请检查 ConfigMap 是否正确迁移。
|
||
|
||
## AI生成失败后会怎样？
|
||
|
||
插件会自动重试，重试次数由"最大重试次数"配置控制（默认3次）。重试间隔递增（5秒、15秒、30秒）。超过最大重试次数后标记为失败。
|
||
|
||
## 如何批量审核草稿回复？
|
||
|
||
在AI回复日志页面，勾选多条记录后，使用顶部的批量操作工具栏进行批量通过、拒绝或删除。
|
||
|
||
## 旧记录太多怎么办？
|
||
|
||
在插件设置的"数据清理"页面，可以配置自动清理超过指定天数的记录（默认30天），也可以点击"立即清理"手动触发。
|
||
|
||
## 黑名单支持邮箱吗？
|
||
|
||
支持。黑名单同时匹配评论者的显示名称和邮箱地址，不区分大小写。你也可以在设置页面点击"添加评论者"按钮从评论列表中选择。
|
||
|
||
## 对话窗口中的头像是怎么来的？
|
||
|
||
对话窗口中每条消息的头像通过 [Gravatar](https://gravatar.com) 服务生成（使用 [Cravatar](https://cn.cravatar.com) 镜像）。头像基于评论者或 AI 角色的邮箱自动匹配。如果未设置邮箱，则显示默认图标。
|
||
|
||
## 对话窗口中的引用框是什么？
|
||
|
||
当一条回复是针对另一条回复的（即层级回复），对话窗口会在该消息气泡内显示一个引用摘要框，标明该回复引用了谁的什么内容。引用内容会截断显示（最多35个字符），方便快速了解对话脉络。
|
||
|
||
## 如何备份和迁移插件配置？
|
||
|
||
在插件设置页面顶部点击 **导出** 按钮，将当前配置导出为 JSON 文件。在目标实例中点击 **导入** 按钮选择该文件即可恢复配置。导入会覆盖当前配置，请谨慎操作。
|
||
|
||
## AI Foundation 显示"部分功能不可用"怎么办？
|
||
|
||
这通常表示 AI Foundation 插件未正确配置模型。请检查：
|
||
|
||
1. AI Foundation 插件已安装并启用
|
||
2. 在 AI Foundation 中配置了至少一个 AI 模型
|
||
3. 如果回评插件未指定模型名称，将使用 AI Foundation 的默认模型
|
||
|
||
## 前置过滤会误伤正常评论吗？
|
||
|
||
前置过滤默认启用。AI 会对评论进行分类判断，若 AI 服务不可用或分类失败，为安全起见会拦截评论而非放行。如果你发现正常评论被误拦截，可以在设置中关闭"启用前置过滤"开关。被拦截的评论会在日志页生成一条"已拦截"状态的记录，可查看具体分类标签和拦截原因。
|
||
|
||
## 被前置过滤拦截的评论会怎样？
|
||
|
||
1. **停止生成 AI 回复** — 不会消耗后续 Token
|
||
2. **创建拦截记录** — 在日志页显示为"已拦截"状态，标注分类标签（如"辱骂攻击"）和详细原因（含评论内容摘要）
|
||
3. **自动设为待审核** — 原评论的 `approved` 会被置为 `false`，前端不再展示该评论，需人工判断后审核通过
|