> 规范网页：https://docs.tensuu.com/功能模块详解/03_监控方案.html ｜ Markdown：/功能模块详解/03_监控方案.md ｜ 文档修订：2026.10.26

# 监控方案

监控方案是一组“消息里出现什么、机器人怎么处理”的关键词规则。每条规则只做一件事：命中后按你选的处理方式执行。规则归属于某个方案，方案再被群引用。

入口：**监控方案 → 监控方案**。本页写规则的增删改和规则自身启停；方案本身的新建、复制、删除在[方案管理](20_方案管理.md)，某个群要不要用某个方案在[群聊监控](08_群聊监控.md)。

> 别把应用设置里的“自动化统计”当成关键词规则页。

## 共享方案与仅记录：先分清作用范围 {#先分清三件容易混的事}

- **规则属于方案，方案绑定到群。** 在方案里写好规则不等于群里已经生效：还要方案启用、群引用该方案、该群监控总开关打开、机器人正常在群。
- **一个方案可以被多个群引用。** 改共享方案里的规则，会影响所有引用它的群；只想改一个群，先[复制方案](20_方案管理.md)再改副本。
- **“仅记录”是观察模式，不是轻处罚。** 命中后本条规则不发群消息、不禁言、不踢出、不撤回，也不累计警告、不扣信用分、不写名单；它不关闭其他独立功能，普通消息的后续阶段仍遵循受理后短路的顺序。

全新安装首次启动时，系统会写入几个示例方案：**默认监控方案**（已启用，“广告”“兼职”按警告处理，“加群”仅记录）以及 **电商行业监控方案、游戏社群监控方案、教育培训群监控方案**（默认停用）。它们都是普通方案，没有绑定任何群——想用哪个，先按自己的规则核对一遍。

这些示例方案由启动初始化按**名称**补齐：删掉或改名后，下次启动会重新出现同名的示例方案（“默认监控方案”仍为启用）。想彻底不用，请停用并清空规则，而不是删除或改名。

## 什么时候用它，什么时候换别的

| 你想要的效果 | 用哪里 |
| --- | --- |
| 消息里出现某词就警告、禁言或踢出 | 本页的关键词规则 |
| 先留一份命中记录、不处罚 | 本页规则，处理方式选“仅记录” |
| 一个问题对应固定回答 | [问答](15_问答.md) |
| 成员发某句话触发管理动作 | [指令设置](04_指令设置.md) |
| 短时间内刷屏、字数或链接异常 | [刷屏监控](27_文件监控.md#刷屏监控) |
| 上传的文件名不合规 | [文件监控](27_文件监控.md) |
| 入群、退群、改名等成员事件 | [群员事件监控](27_文件监控.md#群员事件监控) |

关键词规则不需要成员“发指令”，也无法回答提问；它只判断消息文本（以及你开启的图片、语音识别结果）里有没有你配置的内容。

## 怎样选处理方式 {#处理方式选择}

| 处理方式 | 直接后果与联动 | 权限与停止边界 |
| --- | --- | --- |
| 仅记录 | 本条规则零出站，不警告、不扣分、不写名单 | 不测试平台处罚权限；不关闭其他独立来源 |
| 警告 | 发群内提醒；启用警告规范时累计，可能升级禁言/踢出，并可能按扣分规则联动 | 不是“无后果提醒”；升级处罚仍需平台权限和目标保护检查 |
| 禁言 | 让成员一段时间不能发言；本页时长按分钟填，普通禁言不产生处罚联动扣分 | 需机器人管理员权限；到期解除，停规则不提前解除 |
| 踢出 | 移出本群；还可能被独立的群员事件“踢出拉黑”配置加入黑名单 | 需机器人管理员权限；停规则不能把成员拉回群 |

禁言/踢出和警告升级的保护条件见[权限管理](../高级功能/权限管理.md)，累计与信用分细节集中在[群基本设置](群基本设置.md#告警与信用分)。

## 实际怎么判断

一条普通群消息进来后，机器人按下列顺序审查，**前一阶段已受理时就不再交给后续业务阶段**：

1. **指令**（[指令设置](04_指令设置.md)）：成员发的是指令，就按指令执行。
2. **刷屏监控**：频率、字数、行数、链接等判断。
3. **识别类监控**：图片文字和语音转文字的结果按关键词规则判断；二维码识别到即撤回那张图片，不看关键词（各自需开启）。
4. **关键词规则（本页）**：按优先级依次尝试，取最高优先级里最先命中的一条。
选中需处理的规则后，还会做 **保护检查**：受保护用户（白名单、代理管理员、群管理员、群主、高管、超级管理员，即群内等级 6 及以上）不执行处罚；保护状态查不清时同样不处罚。随后执行处理方式，并把结果写进触发记录。前面都未受理时，其后还有 **问答 → 转发 → 其他自动化**，完整分支见[工作方式与作用范围](../核心概念/工作方式与作用范围.md#消息处理)。

规则层面前还有该群的监控总开关（见[群聊监控](08_群聊监控.md)）：关闭时关键词、刷屏和识别都不参与。

因此“规则没触发”不一定写错了：消息可能已被更靠前的环节处理，或发送者受保护。**同一条普通消息最多得到一个审查结论**：命中指令就不再按关键词处理，转发规则也不会与这个结论叠加。入群、名片变化、文件上传等独立事件各走自己的入口，不受这条顺序限制。

本页规则不会做的事：不修改群设置、不主动撤回你没开启撤回的消息、不因为命中次数多而自行加重处罚（是否升级由[告警规则](群基本设置.md#告警与信用分)决定）。

## 一组正例和反例

**正例（只观察，不处罚）**：新建一个“观察用”方案，不绑定任何群。添加关键词 `优惠券`，处理方式“仅记录”，优先级保持默认 5。需要实际验证且已获得测试群授权时，先核对其他规则、刷屏和成员事件等来源，再把它绑定到专用测试群并打开该群监控总开关。用不受本条规则等级规避影响的测试身份发“优惠券链接”，确认消息未被前序阶段受理后，触发记录应出现一条处理方式“仅记录”、动作终态“仅记录（零出站）”的记录；群里没有警告消息，也没有禁言。

**反例（以为在观察，其实会处罚）**：把关键词 `广告` 的处理方式设为“警告”，因为“警告看起来比禁言轻”就直接绑到正式群。警告会向群里发提示，并计入告警次数，达到[告警规则](群基本设置.md#告警与信用分)的阈值后可能自动升级为禁言或踢出。练习阶段请在未绑定任何群的独立方案中使用“仅记录”；实际触发只在已授权的专用测试群进行，并先核对其他启用来源。

## 添加一条规则

1. 在顶部方案选择框选中目标方案。页面一次只显示一个方案的规则；群绑定了多个方案时会提示当前展示的是哪一个。
2. 点 **新增关键字**。
3. 填写各项（精确取值见下方设置项参考）：关键词（必填）、处理方式、禁言时长（选“禁言”才出现）、等级规避、规则优先级、正则表达式、免检词。
4. 点 **确认**，提示“规则添加成功”。
5. 回读确认：刷新页面（F5），规则仍在。练习时保持方案未绑定任何群，并在 **操作 → 禁用** 后刷新，确认状态为“禁用”。

## 设置项参考

### 每条规则填什么

| 设置项 | 含义与取值 | 默认／单位 |
| --- | --- | --- |
| 关键词 | 每条规则一个关键词。普通模式为“消息包含该词”，不区分大小写；开启正则后按正则匹配 | 必填，表单最多 50 字 |
| 处理方式 | 警告 / 禁言 / 踢出 / 仅记录。“拉黑”选项已置灰停用，运行时也会跳过 | 新建默认“警告” |
| 禁言时长 | 仅“禁言”时可填；保存后按分钟换算成秒下发 | 默认 10 分钟；留空或填 0 时实际按 10 分钟执行 |
| 等级规避 | 群内等级达到或超过该值的成员，这条规则完全不适用（不命中、不处罚）；填 0 表示不设豁免 | 默认 1；普通成员等级为 0 |
| 规则优先级 | 1–10，数字越大越先尝试 | 默认 5 |
| 正则表达式 | 开启后关键词按正则匹配；写错的正则不会报错，这条规则永远不会命中 | 默认关闭 |
| 免检词 | 消息包含任一免检词时只跳过本条规则，不区分大小写 | 可填多个 |
| 启用状态 | 新建规则默认启用；禁用后不参与匹配，规则本身仍留在列表里 | 启用 |

补充说明：

- **警告**会向群里发提示，并计入告警次数；是否升级、升级成什么，由群基本设置的告警规则决定。
- **本页规则的踢出**直接把人移出本群。是否随后加入黑名单，取决于 **群设置 → 其他监控 → 群员事件监控** 里的“踢出拉黑”，不是这条规则的选项；其他功能里同名动作的限制以各页说明为准。
- 禁言和踢出都需要机器人在群内有对应权限；受保护用户即使命中也不会被执行。

### 改动什么时候生效

| 操作 | 影响范围 | 生效时机 |
| --- | --- | --- |
| 新增、编辑、启用或禁用规则 | 该规则所在方案，以及引用它的所有群 | 保存后随下一次消息处理生效，无需重启 |
| 停用整个方案 | 所有引用该方案的群（词库仍可查看） | 同上 |
| 群绑定或解绑方案 | 仅该群 | 下一次消息处理生效 |
| 关闭群监控总开关 | 该群的关键词、刷屏、识别、撤回、消息留存 | 保存后生效，其他群不受影响 |
| 删除规则 | 不可恢复 | 立即 |

## 批量操作与导入导出

- 勾选多条后可用 **批量操作**：批量启用、禁用、删除。
- **批量修改** 一次只改一个字段：处理方式、优先级、正则开关或免检词。免检词是整体覆盖，输入为空即清空。
- **批量添加** 每行一个关键词，全部按“启用”创建。对话框里不显示处理方式、等级规避、优先级和正则，实际创建时沿用页面上一次在“新增关键字／编辑”里留下的这些值（刚打开页面时为：警告、等级规避 1、优先级 5、非正则），并且不带免检词。批量添加前先确认这些值符合预期。
- **导入 CSV 是追加，不是覆盖**：每一条数据行会成为新规则，不会删除或替换已有规则，重复导入会产生重复规则。先核对下面的格式，导入后刷新回读实际条目与启停，不因结果不明重复导入。
- **导出 CSV** 用于备份或迁移。云方案的规则可以导出，但不能导入覆盖：云方案内容只读，需要改就先复制成普通方案。

### CSV 格式 {#csv格式}

导出为 **UTF-8 带 BOM** 的 CSV，按表头名识别列；使用页面导出的当前文件作模板。表头如下：

```csv
keyword,action,level_exemption,status,is_regex,mute_duration,priority,exempt_words,creator
观察词,record,1,disabled,false,,5,"[""演示豁免""]",example
```

这个示例按**禁用**状态导入，仅作格式演示，不会因导入就启用规则。CSV 的 `mute_duration` 按**分钟**填写，与页面输入一致；不要把其他接口或平台要求的秒数直接填入。

| 列 | 填写说明 |
| --- | --- |
| `keyword` | 关键词或正则内容 |
| `action` | `warn` / `mute` / `kick` / `record`；空值会按警告处理，`blacklist` 或未知值使整批校验失败 |
| `level_exemption` | 等级规避；空值或 0 表示不设置此项豁免 |
| `status` | `enabled` / `true` / `1` 为启用，其余值为禁用；建议只用 `enabled`、`disabled` |
| `is_regex` | `true` 或 `1` 才开启正则，其他值关闭 |
| `mute_duration` | 禁言分钟数；空值或 0 按规则的默认禁言时长执行 |
| `priority` | 规则优先级；空值或 0 会按 5 处理 |
| `exempt_words` | 可选列；空值表示无免检词，非空须为 JSON 字符串数组，再按 CSV 引号转义 |
| `creator` | 创建者备注；空值显示为 `import` |

除 `exempt_words` 外其余列名必须存在，未知额外列会被忽略，重复表头会被拒绝。CSV 解析、非法动作或免检词格式错误发生在写入前；遇到其他写入错误仍须回读实际情况，不把报错推断成肯定零写入。更多导入类型见[格式索引](../参考索引/配置与格式.md#导入格式)。

## 怎样确认真的生效

分三层看，任何一层通过都不代表下一层也通过：

1. **配置已保存**：刷新后规则仍在，状态正确。
2. **规则已被匹配**：在[群聊监控](08_群聊监控.md)的“最近触发记录”里出现这条规则的命中，处理方式符合预期。
3. **动作已在群里完成**：看记录的 **动作终态**。只有“平台已执行”代表群里的处罚实际完成；“仅记录（零出站）”表示这条规则本来就不发任何群内动作。

## 没成功先检查什么

- 保存报“请检查规则设置”：先确认关键词已填写。保存成功不是正则校验，写错的正则也会被保存，只是永远不命中。
- 规则启用但群里没反应：按 [群聊监控](08_群聊监控.md) 的排查链核对——该群总开关、方案引用、方案自身是否启用、机器人在线。
- 消息明显违规却没命中：确认消息是不是已被指令或刷屏环节先处理；确认发送者是否在等级规避范围或属于受保护用户；确认免检词是否恰好命中了这条消息。
- 批量添加出来的规则处理方式不对：多数是上一次编辑留下的表单值被沿用，批量添加不会提示。
- 导入后规则变多、出现重复：导入是追加，先确认是否重复导入，必要时手动清理。

## 停止与改回

- 只停这一条规则：在行内 **操作** 里禁用；恢复时再启用。
- 停止这套规则对所有群的影响：在[方案管理](20_方案管理.md)停用该方案。
- 只想让某个群不用这套规则：在该群的[群聊监控](08_群聊监控.md)里移除方案。
- 删除规则或方案不可恢复；删除前先导出 CSV 备份。
- 停用规则或方案只阻止后续处理，**不会撤销已经发出的消息或已执行的处罚**。

## 相关页面

- 想让规则在某个群真正生效：[群聊监控](08_群聊监控.md)
- 新建、复制、共享或删除方案：[方案管理](20_方案管理.md)
- 使用官方维护的云方案：[云方案](21_云方案.md)
- 匹配细节、优先级平手、转发过滤：[监控方案高级用法](../高级功能/监控方案高级用法.md)
- 警告累计、信用分和升级处罚：[群基本设置 → 告警与信用分](群基本设置.md#告警与信用分)
- 配置作用范围与结果判读：[工作方式与作用范围](../核心概念/工作方式与作用范围.md)、[结果判断与排障](../核心概念/结果判断与排障.md)