first commit

2026-06-14 22:28:19 +08:00
commit e03ba7a20d
67 changed files with 13400 additions and 0 deletions
@@ -0,0 +1,52 @@
+# 常见问题
+
+## 安装后没有自动回复？
+
+1. 确认插件已启用
+2. 确认 **自动回复** 开关已开启
+3. 确认 AI Foundation 插件已安装并正确配置（如果使用AI Foundation）
+4. 检查文章的 **启用AI回评** 开关是否开启（文章默认开启，页面默认关闭）
+5. 查看插件日志是否有错误信息
+
+## AI回复头像不显示？
+
+1. 确认在插件设置中填写了AI角色邮箱
+2. 邮箱需要在 [Gravatar](https://gravatar.com) 上注册并设置头像
+3. 插件使用 [Cravatar](https://cravatar.cn) 作为Gravatar镜像服务
+
+## 评论没有触发AI回复？
+
+可能的原因：
+
+1. **文章/页面开关关闭** — 检查编辑器中的"启用AI回评"开关
+2. **评论者在黑名单中** — 检查基本设置中的评论者黑名单
+3. **已有AI回复记录** — 同一评论不会重复触发
+4. **历史评论** — 插件启动前的评论不会自动触发，可使用手动触发
+5. **AI生成失败** — 检查AI模型配置和日志
+
+## 如何对历史评论触发AI回复？
+
+1. 进入后台 **评论** 管理页面
+2. 找到目标评论
+3. 点击右侧 **更多（…）** → **触发AI回复**
+
+## 草稿模式的回复在哪里审核？
+
+在插件管理页面的 **AI回复日志** 中，草稿状态的记录会显示"审核通过"和"拒绝"按钮。
+
+## 如何修改AI回复的语气风格？
+
+1. 在插件设置中修改 **AI角色人格提示词**
+2. 或修改 **自定义Prompt模板**
+
+## AI Foundation 插件是必须的吗？
+
+是的，AI Foundation 是本插件的必要依赖。本插件通过 AI Foundation 提供的 `AiModelService` 扩展点调用AI模型，请确保已安装并正确配置 AI Foundation 插件。
+
+## 如何完全禁用某个页面的AI回复？
+
+编辑页面，在元数据区域关闭 **启用AI回评** 开关。页面默认就是关闭的。
+
+## 插件升级后设置丢失了？
+
+插件升级不会丢失设置。如果遇到问题，请检查 ConfigMap 是否正确迁移。