sunny-335
72726da9b8
- 修复草稿模式下仍自动发布评论的Bug - 新增草稿模式下编辑AI回复内容功能 - 新增3个Prompt预设(技术解答型/鼓励型/知识科普型) - 新增多语言回复指令 - 新增日志页面时间范围筛选 - 新增AI角色排序功能 - 新增配置导入/导出功能 - 修复processingLocks内存泄漏 - 修复OptimisticLockingFailureException缺少重试 - 修复publishReply空Mono导致审核挂起 - 移除近7日回复趋势卡片 - 版本号更新至0.0.0-ygkszvd - 全面更新插件文档
108 lines
4.4 KiB
Markdown
108 lines
4.4 KiB
Markdown
# 常见问题
|
||
|
||
## 安装后没有自动回复？
|
||
|
||
1. 确认插件已启用
|
||
2. 确认 **自动回复** 开关已开启
|
||
3. 确认 AI Foundation 插件已安装并正确配置（如果使用AI Foundation）
|
||
4. 检查文章的 **启用AI回评** 开关是否开启（文章默认开启，页面默认关闭）
|
||
5. 查看插件日志是否有错误信息
|
||
|
||
## AI回复头像不显示？
|
||
|
||
1. 确认在AI角色设置中填写了邮箱
|
||
2. 邮箱需要在 [Gravatar](https://gravatar.com) 上注册并设置头像
|
||
3. 插件使用 [Cravatar](https://cravatar.cn) 作为Gravatar镜像服务
|
||
|
||
::: info
|
||
由于 Halo 评论系统的限制，AI角色头像仅支持通过 Gravatar 邮箱方式设置，不支持自定义上传头像。
|
||
:::
|
||
|
||
## 评论没有触发AI回复？
|
||
|
||
可能的原因：
|
||
|
||
1. **文章/页面开关关闭** — 检查编辑器中的"启用AI回评"开关
|
||
2. **评论者在黑名单中** — 检查基本设置中的评论者黑名单
|
||
3. **已有AI回复记录** — 同一评论不会重复触发
|
||
4. **历史评论** — 插件启动前的评论不会自动触发，可使用手动触发
|
||
5. **AI生成失败** — 检查AI模型配置和日志
|
||
6. **速率限制** — 检查是否触发了每分钟回复数量限制
|
||
7. **对话轮次上限** — 检查是否达到了最大对话轮次
|
||
|
||
## 如何对历史评论触发AI回复？
|
||
|
||
1. 进入后台 **评论** 管理页面
|
||
2. 找到目标评论
|
||
3. 点击右侧 **更多（…）** → **触发AI回复**
|
||
|
||
## 草稿模式的回复在哪里审核？
|
||
|
||
在插件管理页面的 **AI回复日志** 中，草稿状态的记录会显示"编辑"、"审核通过"和"拒绝"按钮。
|
||
|
||
## 如何在发布前编辑AI回复？
|
||
|
||
1. 确保草稿模式已启用（关闭"自动发布"开关）
|
||
2. 在AI回复日志页面找到状态为"通过"且未发布的记录
|
||
3. 点击 **编辑** 按钮修改回复内容
|
||
4. 修改完成后点击"审核通过"发布
|
||
|
||
::: tip
|
||
编辑功能仅在草稿状态（通过但未发布）下可用。
|
||
:::
|
||
|
||
## 如何修改AI回复的语气风格？
|
||
|
||
1. 在插件设置中修改 **AI角色人格提示词**
|
||
2. 或修改 **自定义Prompt模板**
|
||
3. 或选择不同的 **Prompt预设** 风格组合
|
||
|
||
## AI Foundation 插件是必须的吗？
|
||
|
||
是的，AI Foundation 是本插件的必要依赖。本插件通过 AI Foundation 提供的 `AiModelService` 扩展点调用AI模型，请确保已安装并正确配置 AI Foundation 插件。
|
||
|
||
## 如何完全禁用某个页面的AI回复？
|
||
|
||
编辑页面，在元数据区域关闭 **启用AI回评** 开关。页面默认就是关闭的。
|
||
|
||
## 插件升级后设置丢失了？
|
||
|
||
插件升级不会丢失设置。如果遇到问题，请检查 ConfigMap 是否正确迁移。
|
||
|
||
## AI生成失败后会怎样？
|
||
|
||
插件会自动重试，重试次数由"最大重试次数"配置控制（默认3次）。重试间隔递增（5秒、15秒、30秒）。超过最大重试次数后标记为失败。
|
||
|
||
## 如何批量审核草稿回复？
|
||
|
||
在AI回复日志页面，勾选多条记录后，使用顶部的批量操作工具栏进行批量通过、拒绝或删除。
|
||
|
||
## 旧记录太多怎么办？
|
||
|
||
在插件设置的"数据清理"页面，可以配置自动清理超过指定天数的记录（默认30天），也可以点击"立即清理"手动触发。
|
||
|
||
## 黑名单支持正则表达式吗？
|
||
|
||
支持。黑名单支持三种匹配方式：
|
||
- **名称匹配**：直接输入评论者显示名称
|
||
- **邮箱匹配**：输入邮箱地址
|
||
- **正则表达式**：以 `regex:` 开头，如 `regex:^spam.*`
|
||
|
||
## 如何管理多个AI角色？
|
||
|
||
在插件设置的 **AI角色设置** 区域，可以添加、编辑、删除AI角色，也可以使用 ▲▼ 按钮调整角色顺序。每个角色有独立的昵称、人格提示词和Gravatar头像。
|
||
|
||
## 如何导入/导出配置？
|
||
|
||
在插件设置页面右上角：
|
||
- 点击 **导出配置** 将当前设置和AI角色导出为 JSON 文件
|
||
- 点击 **导入配置** 从 JSON 文件导入配置（导入前会显示确认对话框）
|
||
|
||
## 日志页面如何按时间筛选？
|
||
|
||
在日志页面的筛选栏中，使用日期选择器设置起始日期和结束日期，即可筛选指定时间范围内的记录。
|
||
|
||
## 为什么AI角色不支持自定义上传头像？
|
||
|
||
Halo 的评论组件对匿名评论者（kind=Email）始终使用 `email-hash` 注解生成 Gravatar 头像，会忽略自定义头像 URL。这是 Halo 评论系统的设计限制，因此插件只支持通过 Gravatar 邮箱方式设置AI角色头像。
|