# 过滤规则

过滤规则控制哪些评论触发AI回复，包括文章/页面级开关、评论者黑/白名单。

## 文章/页面级开关

插件通过 Halo 的 AnnotationSetting 机制，在文章和页面编辑器的元数据区域添加了 **启用AI回评** 开关。

### 默认行为

| 类型 | 默认状态 |
|------|---------|
| 文章（Post） | 默认开启 |
| 页面（SinglePage） | 默认关闭 |

### 全局页面AI回复开关

在 **基本设置** 中新增 **启用页面AI回复** 开关：

- **开启**：所有独立页面一键启用AI回复（包括新建页面）
- **关闭**：所有页面一键关闭AI回复
- 默认为关闭

::: tip
开启全局页面AI回复后，无需逐个在页面编辑器中开启。新建页面也会自动启用AI回复。
:::

### 单独控制

1. 编辑文章或页面
2. 在编辑器侧边栏找到 **元数据** 区域
3. 找到 **启用AI回评** 开关
4. 根据需要开启或关闭

## 评论者黑名单

评论者黑名单功能可以屏蔽指定评论者，使其评论不触发AI回复。

### 支持的格式

| 格式 | 示例 | 说明 |
|------|------|------|
| 名称 | `张三` | 匹配评论者的显示名称 |
| 邮箱 | `spam@example.com` | 匹配评论者邮箱（不区分大小写） |
| 正则表达式 | `regex:^spam.*` | 以 `regex:` 开头，按正则匹配 |

### 批量操作

- **批量添加**：点击"添加评论者"按钮，弹出评论者列表对话框，支持搜索、多选、全选批量添加，也支持手动输入名称或邮箱
- **批量移除**：名单列表中支持多选后批量移除

::: tip
黑名单中的评论者发布评论时，插件会同时匹配显示名称和邮箱地址（不区分大小写），正则表达式则按模式匹配，匹配成功则跳过AI回复。
:::

## 评论者白名单

白名单功能让信任的评论者跳过 AI 前置过滤与拦截，避免可信评论被误伤。

### 配置方法

1. 在 **基本设置** 中开启 **启用白名单** 开关
2. 在白名单评论者区域添加评论者
3. 支持批量添加/移除，操作方式与黑名单一致

::: warning 白名单与黑名单关系
白名单优先级高于黑名单：同时命中两者的评论者按白名单处理（跳过拦截但不会触发 AI 回复）。白名单仅跳过 AI 审核**拦截**，不影响 AI 回复的触发逻辑。
:::
