监控方案
监控方案是一组“消息里出现什么、机器人怎么处理”的关键词规则。每条规则只做一件事：命中后按你选的处理方式执行。规则归属于某个方案，方案再被群引用。
入口：监控方案 → 监控方案。本页写规则的增删改和规则自身启停；方案本身的新建、复制、删除在方案管理，某个群要不要用某个方案在群聊监控。
别把应用设置里的“自动化统计”当成关键词规则页。
共享方案与仅记录：先分清作用范围
- 规则属于方案，方案绑定到群。 在方案里写好规则不等于群里已经生效：还要方案启用、群引用该方案、该群监控总开关打开、机器人正常在群。
- 一个方案可以被多个群引用。 改共享方案里的规则，会影响所有引用它的群；只想改一个群，先复制方案再改副本。
- “仅记录”是观察模式，不是轻处罚。 命中后本条规则不发群消息、不禁言、不踢出、不撤回，也不累计警告、不扣信用分、不写名单；它不关闭其他独立功能，普通消息的后续阶段仍遵循受理后短路的顺序。
全新安装首次启动时，系统会写入几个示例方案：默认监控方案（已启用，“广告”“兼职”按警告处理，“加群”仅记录）以及 电商行业监控方案、游戏社群监控方案、教育培训群监控方案（默认停用）。它们都是普通方案，没有绑定任何群——想用哪个，先按自己的规则核对一遍。
这些示例方案由启动初始化按名称补齐：删掉或改名后，下次启动会重新出现同名的示例方案（“默认监控方案”仍为启用）。想彻底不用，请停用并清空规则，而不是删除或改名。
什么时候用它，什么时候换别的
| 你想要的效果 | 用哪里 |
|---|---|
| 消息里出现某词就警告、禁言或踢出 | 本页的关键词规则 |
| 先留一份命中记录、不处罚 | 本页规则，处理方式选“仅记录” |
| 一个问题对应固定回答 | 问答 |
| 成员发某句话触发管理动作 | 指令设置 |
| 短时间内刷屏、字数或链接异常 | 刷屏监控 |
| 上传的文件名不合规 | 文件监控 |
| 入群、退群、改名等成员事件 | 群员事件监控 |
关键词规则不需要成员“发指令”，也无法回答提问；它只判断消息文本（以及你开启的图片、语音识别结果）里有没有你配置的内容。
怎样选处理方式
| 处理方式 | 直接后果与联动 | 权限与停止边界 |
|---|---|---|
| 仅记录 | 本条规则零出站，不警告、不扣分、不写名单 | 不测试平台处罚权限；不关闭其他独立来源 |
| 警告 | 发群内提醒；启用警告规范时累计，可能升级禁言/踢出，并可能按扣分规则联动 | 不是“无后果提醒”；升级处罚仍需平台权限和目标保护检查 |
| 禁言 | 让成员一段时间不能发言；本页时长按分钟填，普通禁言不产生处罚联动扣分 | 需机器人管理员权限；到期解除，停规则不提前解除 |
| 踢出 | 移出本群；还可能被独立的群员事件“踢出拉黑”配置加入黑名单 | 需机器人管理员权限；停规则不能把成员拉回群 |
禁言/踢出和警告升级的保护条件见权限管理，累计与信用分细节集中在群基本设置。
实际怎么判断
一条普通群消息进来后，机器人按下列顺序审查，前一阶段已受理时就不再交给后续业务阶段：
- 指令（指令设置）：成员发的是指令，就按指令执行。
- 刷屏监控：频率、字数、行数、链接等判断。
- 识别类监控：图片文字和语音转文字的结果按关键词规则判断；二维码识别到即撤回那张图片，不看关键词（各自需开启）。
- 关键词规则（本页）：按优先级依次尝试，取最高优先级里最先命中的一条。 选中需处理的规则后，还会做 保护检查：受保护用户（白名单、代理管理员、群管理员、群主、高管、超级管理员，即群内等级 6 及以上）不执行处罚；保护状态查不清时同样不处罚。随后执行处理方式，并把结果写进触发记录。前面都未受理时，其后还有 问答 → 转发 → 其他自动化，完整分支见工作方式与作用范围。
规则层面前还有该群的监控总开关（见群聊监控）：关闭时关键词、刷屏和识别都不参与。
因此“规则没触发”不一定写错了：消息可能已被更靠前的环节处理，或发送者受保护。同一条普通消息最多得到一个审查结论：命中指令就不再按关键词处理，转发规则也不会与这个结论叠加。入群、名片变化、文件上传等独立事件各走自己的入口，不受这条顺序限制。
本页规则不会做的事：不修改群设置、不主动撤回你没开启撤回的消息、不因为命中次数多而自行加重处罚（是否升级由告警规则决定）。
一组正例和反例
正例（只观察，不处罚）：新建一个“观察用”方案，不绑定任何群。添加关键词 优惠券，处理方式“仅记录”，优先级保持默认 5。需要实际验证且已获得测试群授权时，先核对其他规则、刷屏和成员事件等来源，再把它绑定到专用测试群并打开该群监控总开关。用不受本条规则等级规避影响的测试身份发“优惠券链接”，确认消息未被前序阶段受理后，触发记录应出现一条处理方式“仅记录”、动作终态“仅记录（零出站）”的记录；群里没有警告消息，也没有禁言。
反例（以为在观察，其实会处罚）：把关键词 广告 的处理方式设为“警告”，因为“警告看起来比禁言轻”就直接绑到正式群。警告会向群里发提示，并计入告警次数，达到告警规则的阈值后可能自动升级为禁言或踢出。练习阶段请在未绑定任何群的独立方案中使用“仅记录”；实际触发只在已授权的专用测试群进行，并先核对其他启用来源。
添加一条规则
- 在顶部方案选择框选中目标方案。页面一次只显示一个方案的规则；群绑定了多个方案时会提示当前展示的是哪一个。
- 点 新增关键字。
- 填写各项（精确取值见下方设置项参考）：关键词（必填）、处理方式、禁言时长（选“禁言”才出现）、等级规避、规则优先级、正则表达式、免检词。
- 点 确认，提示“规则添加成功”。
- 回读确认：刷新页面（F5），规则仍在。练习时保持方案未绑定任何群，并在 操作 → 禁用 后刷新，确认状态为“禁用”。
设置项参考
每条规则填什么
| 设置项 | 含义与取值 | 默认／单位 |
|---|---|---|
| 关键词 | 每条规则一个关键词。普通模式为“消息包含该词”，不区分大小写；开启正则后按正则匹配 | 必填，表单最多 50 字 |
| 处理方式 | 警告 / 禁言 / 踢出 / 仅记录。“拉黑”选项已置灰停用，运行时也会跳过 | 新建默认“警告” |
| 禁言时长 | 仅“禁言”时可填；保存后按分钟换算成秒下发 | 默认 10 分钟；留空或填 0 时实际按 10 分钟执行 |
| 等级规避 | 群内等级达到或超过该值的成员，这条规则完全不适用（不命中、不处罚）；填 0 表示不设豁免 | 默认 1；普通成员等级为 0 |
| 规则优先级 | 1–10，数字越大越先尝试 | 默认 5 |
| 正则表达式 | 开启后关键词按正则匹配；写错的正则不会报错，这条规则永远不会命中 | 默认关闭 |
| 免检词 | 消息包含任一免检词时只跳过本条规则，不区分大小写 | 可填多个 |
| 启用状态 | 新建规则默认启用；禁用后不参与匹配，规则本身仍留在列表里 | 启用 |
补充说明：
- 警告会向群里发提示，并计入告警次数；是否升级、升级成什么，由群基本设置的告警规则决定。
- 本页规则的踢出直接把人移出本群。是否随后加入黑名单，取决于 群设置 → 其他监控 → 群员事件监控 里的“踢出拉黑”，不是这条规则的选项；其他功能里同名动作的限制以各页说明为准。
- 禁言和踢出都需要机器人在群内有对应权限；受保护用户即使命中也不会被执行。
改动什么时候生效
| 操作 | 影响范围 | 生效时机 |
|---|---|---|
| 新增、编辑、启用或禁用规则 | 该规则所在方案，以及引用它的所有群 | 保存后随下一次消息处理生效，无需重启 |
| 停用整个方案 | 所有引用该方案的群（词库仍可查看） | 同上 |
| 群绑定或解绑方案 | 仅该群 | 下一次消息处理生效 |
| 关闭群监控总开关 | 该群的关键词、刷屏、识别、撤回、消息留存 | 保存后生效，其他群不受影响 |
| 删除规则 | 不可恢复 | 立即 |
批量操作与导入导出
- 勾选多条后可用 批量操作：批量启用、禁用、删除。
- 批量修改 一次只改一个字段：处理方式、优先级、正则开关或免检词。免检词是整体覆盖，输入为空即清空。
- 批量添加 每行一个关键词，全部按“启用”创建。对话框里不显示处理方式、等级规避、优先级和正则，实际创建时沿用页面上一次在“新增关键字／编辑”里留下的这些值（刚打开页面时为：警告、等级规避 1、优先级 5、非正则），并且不带免检词。批量添加前先确认这些值符合预期。
- 导入 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 解析、非法动作或免检词格式错误发生在写入前；遇到其他写入错误仍须回读实际情况，不把报错推断成肯定零写入。更多导入类型见格式索引。
怎样确认真的生效
分三层看，任何一层通过都不代表下一层也通过：
- 配置已保存：刷新后规则仍在，状态正确。
- 规则已被匹配：在群聊监控的“最近触发记录”里出现这条规则的命中，处理方式符合预期。
- 动作已在群里完成：看记录的 动作终态。只有“平台已执行”代表群里的处罚实际完成；“仅记录（零出站）”表示这条规则本来就不发任何群内动作。
没成功先检查什么
- 保存报“请检查规则设置”：先确认关键词已填写。保存成功不是正则校验，写错的正则也会被保存，只是永远不命中。
- 规则启用但群里没反应：按 群聊监控 的排查链核对——该群总开关、方案引用、方案自身是否启用、机器人在线。
- 消息明显违规却没命中：确认消息是不是已被指令或刷屏环节先处理；确认发送者是否在等级规避范围或属于受保护用户；确认免检词是否恰好命中了这条消息。
- 批量添加出来的规则处理方式不对：多数是上一次编辑留下的表单值被沿用，批量添加不会提示。
- 导入后规则变多、出现重复：导入是追加，先确认是否重复导入，必要时手动清理。
停止与改回
- 只停这一条规则：在行内 操作 里禁用；恢复时再启用。
- 停止这套规则对所有群的影响：在方案管理停用该方案。
- 只想让某个群不用这套规则：在该群的群聊监控里移除方案。
- 删除规则或方案不可恢复；删除前先导出 CSV 备份。
- 停用规则或方案只阻止后续处理，不会撤销已经发出的消息或已执行的处罚。