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

# 群聊监控

本页决定**当前这个群**要不要监控、用哪些方案、以及去哪里看触发结果。关键词规则怎么写、处理方式怎么选，在[监控方案](03_监控方案.md)维护；本页不改规则内容。

入口：**侧边栏 → 群设置 → 群聊监控**。页面上的开关、方案引用和触发记录都只对顶部选中的那个群生效。

## 开始前确认

- 群要先出现在群列表里（机器人已入群并完成同步），否则选不到它。
- 本页的群级总开关**默认关闭**；新同步的群、没有从别的群复制监控设置的群，都要在这里手动打开才会监控。
- 绑定方案不等于立刻处罚：方案里的规则可能包含警告、禁言、踢出。绑定前先点 **查看详情** 看清里面的规则。

## 总开关管什么，不管什么

“启用群聊监控”是**关键词与刷屏执法、识别、撤回、消息留存**的总闸：

| 关闭总开关后停止 | 关不掉的其他功能 |
| --- | --- |
| 关键词规则不再匹配和执行 | 指令与问答照常 |
| 刷屏监控不再处理 | 消息转发照常 |
| 图片文字、二维码、语音识别不再做 | 文件监控（有自己的开关） |
| 不再自动撤回违规消息 | 群员事件监控（入群禁言、退群拉黑等） |
| 不再保存新的消息记录 | 智能名片、入群审核 |

它只影响当前群；其他群各自独立。想知道某个动作为什么没停，按来源查，不要假设一个开关能停全部处罚（见[工作方式与作用范围](../核心概念/工作方式与作用范围.md#消息处理)）。

## 绑定监控方案

1. 顶部先选群。
2. 在 **启用监控方案** 里勾选一个或多个方案。
3. 普通方案选中即写入绑定；选择未安装的云方案会先弹出确认框。确认后系统完成安装和本群绑定，之后官方修改规则会自动同步到本群。只想自己改规则时，先复制成普通方案再用。
4. 已启用方案卡片可以 **查看详情 / 编辑 / 移除**；**移除** 只解除本群与该方案的引用，不影响其他群。
5. 确认成功：选择后提示“已启用 N 个监控方案”，卡片列出正确方案；刷新页面引用仍在。

两点容易误解：

- **方案引用是选中就保存的**，不像下面的开关需要点“保存”。
- 已停用的方案会标注“已停用，当前不执行”。把它绑定到群**不会**自动重新启用它，仍要去[方案管理](20_方案管理.md)打开。

## 监控开关设置

改完这些开关要点击顶部群选择框旁的 **保存** 才写入。

| 开关 | 作用 | 前提与说明 |
| --- | --- | --- |
| 启用群聊监控 | 本群监控总闸，范围见上表 | 默认关闭；关闭时下面几项灰显、改不动 |
| 识别图片文字 | 图片经识别出的文字也参与关键词匹配 | 需在 [AI 功能](28_AI%20功能.md) 配置服务并启用“图片文字提取”任务 |
| 识别二维码 | 图片里识别出二维码时，直接撤回该图片消息（不经过关键词规则、不使用 AI，也不依赖下面的“撤回违规消息”开关） | 还需在 **应用设置 → 高级设置** 打开全局“启用二维码识别”（默认关闭），两处都开才生效 |
| 识别语音 | 语音转成文字后参与关键词匹配 | 需在 [AI 功能](28_AI%20功能.md) 启用“语音转文字”任务 |
| 撤回违规消息 | 警告、禁言、踢出执行成功后，撤回触发它的那条消息 | 撤回失败不影响处罚本身；撤回是单独一次平台请求 |
| 消息记录留存 | 保存本群消息，供[日志中心](17_应用日志.md)的群消息记录搜索和 AI 总结使用 | 关闭期间的消息不会补录；已保存的记录不会被删除 |

识别类开关只是“允许本群做这件事”，不等于识别一定成功：图片文字和语音依赖 AI 服务、任务开关、额度和网络，任何一处不满足都会识别不到内容、也就不会触发；二维码只依赖本机解码和两个开关，识别失败同样只是没有结果。

## 指令分类开关

同一页下半部分的“指令分类开关”按分类列出本群指令（分类代码如 basic、manage、settings、system），卡片上标注该分类下的指令数量。

- 关掉某一类后，该分类下的指令消息不再被识别执行；**与上面的监控总开关互不影响**，也不会停掉关键词规则。
- 没有设置过的分类默认启用；同一张卡里的开关切换即保存。
- 需要恢复时，在这里重新打开，或在群里使用“启用类目”指令（要求群内等级 8 及以上）。

## 查看触发记录

**监控统计** 卡片显示启用方案数、总关键词数、云方案/普通方案数和触发次数，点 **刷新** 更新：

- “今日”是当天自然日；
- “本周”从 7 天前日期的零点起统计；“本月”从向前推 1 个月所得日期的零点起统计。都不是自然周/自然月，也不是精确到当前时刻的 168 小时/若干小时窗口。

**最近触发记录** 可按触发类型（关键词、频率、广告检测、手动、二维码、图片文字、语音）、处理方式（警告、禁言、踢出、仅记录）、关键词和时间范围筛选，支持分页。点 **详情** 查看触发消息、处理方式、动作终态、命中规则标识和用户。

### 用“动作终态”判断实际结果

| 动作终态 | 说明 |
| --- | --- |
| 平台已执行 | 平台返回成功，群里的动作已完成 |
| 平台已拒绝 | 平台明确拒绝（权限不足、目标不存在等） |
| 未派发 | 请求没有发出（本地准备、入队或连接写入失败） |
| 规划失败 | 请求没有形成（没有可用机器人、目标被过滤） |
| 派发结果未知 | 已发出但没拿到结果，**不能当作已执行，也不要直接重复处罚** |
| 仅记录（零出站） | 这条规则本来就不发任何群内动作 |

**处理方式**只是“规则要求做什么”，**动作终态**才是“实际走到哪一步”。排查一律以动作终态为准；更多结果入口见[结果判断与排障](../核心概念/结果判断与排障.md#结果入口)。

## 怎样确认真的生效

1. 保存后刷新页面，开关保持你改的状态（保存失败会自动恢复原值并提示）。
2. 需要实际触发且已获测试群授权时，先核对其他启用来源，再用不受本条等级规避影响的测试身份发匹配消息，在“最近触发记录”核对群、关键词和本次时间。仅准备配置时不必发消息。
3. 该条记录的动作终态是否为“平台已执行”；如果只看到“仅记录”，说明这条规则本来就是观察模式。
4. 群内实际表现与记录一致（有警告提示、成员被禁言等）。

只是准备配置、还没想让规则影响真实成员时，先不要绑到正式群，或用“仅记录”规则练习。

## 没成功先检查什么

- 规则启用了但群里没反应：本页总开关是否打开 → 本群是否引用了方案 → 方案本身是否启用 → 机器人在线且在该群。完整链路见[常见问题](../快速入门指南/常见问题.md)。
- 消息被指令或刷屏先处理了：这类消息不会留下关键词命中记录。先看群里是否有对应的指令回复或刷屏处置，再判断是不是这一条被前序环节接走。
- 识别类开关灰着调不动：先打开总开关。
- 二维码识别不生效：确认 **应用设置 → 高级设置** 的全局开关也打开了；两处缺一都不识别。
- 图片文字、语音识别一直不成功：检查 [AI 功能](28_AI%20功能.md) 的服务配置、任务开关和额度。
- 有处罚记录但群里没动静：看该条的 **动作终态**，多为“平台已拒绝”“未派发”或“派发结果未知”，分别对应没有执行成功和结果不确定，不要直接重试处罚。
- 关掉总开关还有动作：确认那个动作是不是来自指令、转发、文件监控或群员事件监控——这些不受本页总开关控制。

## 关闭或改回

- 停止本页总开关覆盖的关键词、刷屏和识别等功能：关闭 **启用群聊监控** 并 **保存**；文件、群员事件、名片及清退等独立来源需另行停用。
- 只停某个方案：在已启用方案卡片点 **移除**，或到[方案管理](20_方案管理.md)停用该方案（会影响所有引用它的群）。
- 只停某条规则：在[监控方案](03_监控方案.md)禁用该规则。
- 关掉“消息记录留存”只停止后续记录，已保存的消息记录仍在，需要另行在日志中心处理。
- 以上操作都不会撤销已经发出的消息或已经执行的处罚。

## 相关页面

- 写规则、选处理方式：[监控方案](03_监控方案.md)
- 新建、复制、共享或删除方案：[方案管理](20_方案管理.md)
- 使用官方维护的云方案：[云方案](21_云方案.md)
- 匹配与优先级细节：[监控方案高级用法](../高级功能/监控方案高级用法.md)
- 警告累计、信用分与升级处罚：[群基本设置 → 告警与信用分](群基本设置.md#告警与信用分)
- 日志与其他结果入口：[日志中心](17_应用日志.md)