sunny-335
72726da9b8
- 修复草稿模式下仍自动发布评论的Bug - 新增草稿模式下编辑AI回复内容功能 - 新增3个Prompt预设(技术解答型/鼓励型/知识科普型) - 新增多语言回复指令 - 新增日志页面时间范围筛选 - 新增AI角色排序功能 - 新增配置导入/导出功能 - 修复processingLocks内存泄漏 - 修复OptimisticLockingFailureException缺少重试 - 修复publishReply空Mono导致审核挂起 - 移除近7日回复趋势卡片 - 版本号更新至0.0.0-ygkszvd - 全面更新插件文档
4.4 KiB
常见问题
安装后没有自动回复？
- 确认插件已启用
- 确认 自动回复 开关已开启
- 确认 AI Foundation 插件已安装并正确配置（如果使用AI Foundation）
- 检查文章的 启用AI回评 开关是否开启（文章默认开启，页面默认关闭）
- 查看插件日志是否有错误信息
AI回复头像不显示？
::: info 由于 Halo 评论系统的限制，AI角色头像仅支持通过 Gravatar 邮箱方式设置，不支持自定义上传头像。 :::
评论没有触发AI回复？
可能的原因：
- 文章/页面开关关闭 — 检查编辑器中的"启用AI回评"开关
- 评论者在黑名单中 — 检查基本设置中的评论者黑名单
- 已有AI回复记录 — 同一评论不会重复触发
- 历史评论 — 插件启动前的评论不会自动触发，可使用手动触发
- AI生成失败 — 检查AI模型配置和日志
- 速率限制 — 检查是否触发了每分钟回复数量限制
- 对话轮次上限 — 检查是否达到了最大对话轮次
如何对历史评论触发AI回复？
- 进入后台 评论 管理页面
- 找到目标评论
- 点击右侧 更多（…） → 触发AI回复
草稿模式的回复在哪里审核？
在插件管理页面的 AI回复日志 中，草稿状态的记录会显示"编辑"、"审核通过"和"拒绝"按钮。
如何在发布前编辑AI回复？
- 确保草稿模式已启用（关闭"自动发布"开关）
- 在AI回复日志页面找到状态为"通过"且未发布的记录
- 点击 编辑 按钮修改回复内容
- 修改完成后点击"审核通过"发布
::: tip 编辑功能仅在草稿状态（通过但未发布）下可用。 :::
如何修改AI回复的语气风格？
- 在插件设置中修改 AI角色人格提示词
- 或修改 自定义Prompt模板
- 或选择不同的 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角色头像。