Files
plugin-comment-ai-autopilot/docs/guide/settings.md
T
sunny-335 72726da9b8 feat: 草稿模式修复、回复编辑、预设扩展、多语言回复、文档全面更新
- 修复草稿模式下仍自动发布评论的Bug
- 新增草稿模式下编辑AI回复内容功能
- 新增3个Prompt预设(技术解答型/鼓励型/知识科普型)
- 新增多语言回复指令
- 新增日志页面时间范围筛选
- 新增AI角色排序功能
- 新增配置导入/导出功能
- 修复processingLocks内存泄漏
- 修复OptimisticLockingFailureException缺少重试
- 修复publishReply空Mono导致审核挂起
- 移除近7日回复趋势卡片
- 版本号更新至0.0.0-ygkszvd
- 全面更新插件文档
2026-06-16 18:52:42 +08:00

113 lines
4.0 KiB
Markdown

# 插件设置
插件设置页面位于 **AI回评****插件设置**,包含以下配置组:
## 基本设置
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 自动回复 | 是否启用自动回复功能 | 开启 |
| 自动发布 | AI回复是否自动发布,关闭则存为草稿 | 开启 |
| 最大对话轮次 | 同一评论线程中AI最多自动回复的轮次 | 8 |
| 速率限制 | 每分钟最大AI回复数量 | 10 |
| 最大重试次数 | AI生成失败时的最大重试次数 | 3 |
| 评论者黑名单 | 不触发AI回复的评论者,支持名称、邮箱和正则表达式 | 空 |
::: tip 评论者黑名单
黑名单支持三种匹配方式:
- **名称匹配**:直接输入评论者显示名称,如 `张三`
- **邮箱匹配**:输入邮箱地址,如 `spam@example.com`
- **正则表达式**:以 `regex:` 开头,如 `regex:^spam.*`
多个条目用逗号分隔。也可以点击"添加评论者"按钮从评论列表中选择。
:::
## AI角色设置
AI角色支持多角色管理,每个角色有独立的昵称、人格提示词和Gravatar头像。
### 角色管理
- **添加角色** — 点击"添加角色"按钮创建新的AI角色
- **编辑角色** — 点击角色卡片上的编辑图标修改角色信息
- **删除角色** — 点击删除图标移除角色(默认角色不可删除)
- **设为默认** — 点击星标图标将角色设为默认角色(用于没有指定角色的场景)
- **角色排序** — 使用 ▲▼ 按钮调整角色顺序
### 角色配置项
| 配置项 | 说明 |
|--------|------|
| 昵称 | AI回复者的显示名称 |
| 邮箱 | 用于Gravatar头像服务展示头像 |
| 人格提示词 | 定义AI角色的人格和回复风格 |
| 设为默认角色 | 是否作为默认角色使用 |
::: tip Gravatar头像
填写邮箱后,AI回复者的头像将通过 [Cravatar](https://cravatar.cn)(Gravatar 镜像)服务自动生成。在角色编辑对话框中输入邮箱后,会实时显示 Gravatar 头像预览。如果不填写邮箱,将使用默认头像。
:::
## 模型设置
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| AI模型名称 | 留空使用AI Foundation默认模型,填写AiModel资源名称可指定模型 | 空 |
::: warning
模型设置需要先安装 AI Foundation 插件。AI Foundation 是本插件的必要依赖,请确保已正确安装和配置。
:::
## Prompt设置
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| Prompt预设 | 选择预设风格,可多选 | 无 |
| 自定义Prompt模板 | AI生成回复时使用的Prompt模板 | 见下方 |
### 预设风格
| 预设 | 说明 |
|------|------|
| 友好型 | 热情友好,像朋友聊天 |
| 专业型 | 严谨正式,有逻辑性 |
| 幽默型 | 轻松诙谐,适当幽默 |
| 简洁型 | 一两句话,简洁明了 |
| 技术解答型 | 深入浅出,专业解答技术问题 |
| 鼓励型 | 积极正面,给予鼓励和支持 |
| 知识科普型 | 通俗易懂,普及相关知识 |
### 模板变量
| 变量 | 说明 |
|------|------|
| `{{persona_prompt}}` | AI角色人格提示词 |
| `{{safety_prompt}}` | 安全规范提示词 |
| `{{sentiment_prompt}}` | 情感语气提示词(自动注入) |
| `{{article}}` | 文章内容 |
| `{{comment}}` | 评论内容 |
| `{{post_title}}` | 文章标题 |
| `{{post_date}}` | 文章发布日期 |
| `{{comment_count}}` | 评论数 |
## 数据清理
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 启用自动清理 | 是否自动清理过期的AI回复记录 | 开启 |
| 保留天数 | 超过此天数的记录将被自动清理 | 30 |
::: tip
你也可以在数据清理区域点击"立即清理"按钮手动触发清理操作。
:::
## 配置导入/导出
设置页面右上角提供配置导入/导出功能:
- **导出配置** — 将当前插件设置和AI角色导出为 JSON 文件
- **导入配置** — 从 JSON 文件导入配置,导入前会显示确认对话框,包含配置内容预览
::: warning
导入配置将覆盖当前配置,此操作不可撤销。
:::