# 插件设置

插件设置页面位于 **AI回评** → **插件设置**，通过标签栏切换以下五个配置页面：

- 基本设置
- AI角色设置
- 模型设置
- Prompt设置
- 数据清理

## 基本设置

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 自动回复 | 是否启用自动回复功能 | 开启 |
| 自动发布 | AI回复是否自动发布，关闭则存为草稿 | 开启 |
| 最大对话轮次 | 同一评论线程中AI最多自动回复的轮次 | 8 |
| 速率限制 | 每分钟最大AI回复数量，防止批量评论消耗过多额度 | 10 |
| 最大重试次数 | AI生成失败时的最大重试次数 | 3 |
| 评论者黑名单 | 不触发AI回复的评论者，支持名称、邮箱和正则表达式（`regex:` 开头），逗号分隔 | 空 |

::: tip 评论者黑名单
黑名单支持三种格式：
- **名称**：如 `张三`
- **邮箱**：如 `spam@example.com`（不区分大小写）
- **正则表达式**：以 `regex:` 开头，如 `regex:^spam.*`

点击"添加评论者"按钮可从已有评论列表中选择评论者自动添加到黑名单。
:::

## AI角色设置

AI角色定义了回复评论的虚拟身份。支持创建多个角色，每个角色有独立的昵称、人格提示词和 Gravatar 头像，可指定一个为默认角色。

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 角色昵称 | AI回复者的显示名称 | 小回 |
| 人格提示词 | 定义AI角色的人格和回复风格 | 见下方 |
| 邮箱 | 用于 Gravatar 头像服务展示头像 | 空 |
| 设为默认 | 将该角色设为默认角色 | 第一个角色默认 |

默认人格提示词：

> 你是「小回」，一个友善的评论者。你的回复简洁自然，像朋友聊天一样。简短的评论就简短回复，有深度的讨论才展开回应。不要长篇大论，不要复述文章内容。

::: tip Gravatar头像
填写邮箱后，AI回复者的头像将通过 [Gravatar](https://gravatar.com) 服务自动生成，使用 [Cravatar](https://cn.cravatar.com) 镜像。如果不填写邮箱，将使用默认头像。
:::

## 模型设置

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| AI模型名称 | 留空使用AI Foundation默认模型，填写AiModel资源名称可指定模型 | 空 |

::: warning
模型设置需要先安装 AI Foundation 插件。AI Foundation 是本插件的必要依赖，请确保已正确安装和配置。
:::

## Prompt设置

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 自定义Prompt模板 | AI生成回复时使用的Prompt模板 | 见下方 |
| 启用预设 | 选择要启用的Prompt预设风格（可多选） | 空 |

### 预设风格

| 预设 | 说明 |
|------|------|
| 友好型 | 热情友好，多用感叹号和表情符号，口语化表达 |
| 专业型 | 专业严谨，正式语言风格，有逻辑性 |
| 幽默型 | 适当加入幽默元素，轻松诙谐但不过度 |
| 简洁型 | 非常简洁，一两句话即可，不展开讨论 |

预设提示词会自动合并到角色人格提示词之后。

### 模板变量

| 变量 | 说明 | 注入时机 |
|------|------|---------|
| `{{persona_prompt}}` | AI角色人格提示词（含已启用的预设） | 始终注入 |
| `{{safety_prompt}}` | 安全规范提示词 | 始终注入 |
| `{{post_title}}` | 文章标题 | 始终注入 |
| `{{post_date}}` | 文章发布日期（如 2024-01-15） | 始终注入 |
| `{{comment_count}}` | 该文章的评论数 | 始终注入 |
| `{{article}}` | 文章/页面内容（含标题） | 始终注入 |
| `{{conversation_history}}` | 对话历史上下文 | 多轮对话时注入 |
| `{{comment}}` | 评论内容（含评论者名称） | 始终注入 |

::: tip 情感提示
情感提示由插件根据情感分析结果自动追加到 Prompt 末尾，不需要在模板中手动添加：
- **正面** → 追加热情友好的语气提示
- **负面** → 追加理性温和的语气提示
- **中性** → 不追加额外提示
:::

## 数据清理

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 启用自动清理 | 是否自动清理过期的AI回复记录 | 开启 |
| 保留天数 | 超过此天数的记录将被自动清理 | 30 |

::: tip
你也可以在数据清理页面点击"立即清理"按钮手动触发清理操作。
:::

::: warning
清理操作仅删除 `AiCommentReply` 记录（插件内部的日志记录），不会删除已发布的 Halo Reply 评论。
:::
