sunny-335
60d938c1da
- index.md: 更新特性卡片(移除自学习,新增页面开关/状态检测/批量操作) - introduction.md: 更新核心功能列表(5模块提示词/页面开关/批量操作/智能检测) - settings.md: 重写设置文档(新配置项/白名单批量操作/页面开关/状态检测/手动清理) - prompt.md: 四模块改为五模块(新增语言要求),移除自学习引用,标注可选 - persona.md: 添加人格提示词留空使用基础配置说明 - filter.md: 添加全局页面开关和白名单批量操作说明 - cleanup.md: 添加手动清理时间节点和二次确认说明 - auto-reply.md: 更新配置项表格(重试/轮次/速率限制) - faq.md: 更新AI Foundation状态检测和清理问题 - CHANGELOG.md: 重写v1.4.0更新日志
136 lines
6.8 KiB
Markdown
136 lines
6.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. 或修改提示词设置中的 **角色身份提示词（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 回复。
|