群聊监控
本页决定当前这个群要不要监控、用哪些方案、以及去哪里看触发结果。关键词规则怎么写、处理方式怎么选，在监控方案维护；本页不改规则内容。
入口：侧边栏 → 群设置 → 群聊监控。页面上的开关、方案引用和触发记录都只对顶部选中的那个群生效。
开始前确认
- 群要先出现在群列表里（机器人已入群并完成同步），否则选不到它。
- 本页的群级总开关默认关闭；新同步的群、没有从别的群复制监控设置的群，都要在这里手动打开才会监控。
- 绑定方案不等于立刻处罚：方案里的规则可能包含警告、禁言、踢出。绑定前先点 查看详情 看清里面的规则。
总开关管什么，不管什么
“启用群聊监控”是关键词与刷屏执法、识别、撤回、消息留存的总闸：
| 关闭总开关后停止 | 关不掉的其他功能 |
|---|---|
| 关键词规则不再匹配和执行 | 指令与问答照常 |
| 刷屏监控不再处理 | 消息转发照常 |
| 图片文字、二维码、语音识别不再做 | 文件监控（有自己的开关） |
| 不再自动撤回违规消息 | 群员事件监控（入群禁言、退群拉黑等） |
| 不再保存新的消息记录 | 智能名片、入群审核 |
它只影响当前群；其他群各自独立。想知道某个动作为什么没停，按来源查，不要假设一个开关能停全部处罚（见工作方式与作用范围）。
绑定监控方案
- 顶部先选群。
- 在 启用监控方案 里勾选一个或多个方案。
- 普通方案选中即写入绑定；选择未安装的云方案会先弹出确认框。确认后系统完成安装和本群绑定，之后官方修改规则会自动同步到本群。只想自己改规则时，先复制成普通方案再用。
- 已启用方案卡片可以 查看详情 / 编辑 / 移除；移除 只解除本群与该方案的引用，不影响其他群。
- 确认成功：选择后提示“已启用 N 个监控方案”，卡片列出正确方案；刷新页面引用仍在。
两点容易误解：
- 方案引用是选中就保存的，不像下面的开关需要点“保存”。
- 已停用的方案会标注“已停用，当前不执行”。把它绑定到群不会自动重新启用它，仍要去方案管理打开。
监控开关设置
改完这些开关要点击顶部群选择框旁的 保存 才写入。
| 开关 | 作用 | 前提与说明 |
|---|---|---|
| 启用群聊监控 | 本群监控总闸，范围见上表 | 默认关闭；关闭时下面几项灰显、改不动 |
| 识别图片文字 | 图片经识别出的文字也参与关键词匹配 | 需在 AI 功能 配置服务并启用“图片文字提取”任务 |
| 识别二维码 | 图片里识别出二维码时，直接撤回该图片消息（不经过关键词规则、不使用 AI，也不依赖下面的“撤回违规消息”开关） | 还需在 应用设置 → 高级设置 打开全局“启用二维码识别”（默认关闭），两处都开才生效 |
| 识别语音 | 语音转成文字后参与关键词匹配 | 需在 AI 功能 启用“语音转文字”任务 |
| 撤回违规消息 | 警告、禁言、踢出执行成功后，撤回触发它的那条消息 | 撤回失败不影响处罚本身；撤回是单独一次平台请求 |
| 消息记录留存 | 保存本群消息，供日志中心的群消息记录搜索和 AI 总结使用 | 关闭期间的消息不会补录；已保存的记录不会被删除 |
识别类开关只是“允许本群做这件事”，不等于识别一定成功：图片文字和语音依赖 AI 服务、任务开关、额度和网络，任何一处不满足都会识别不到内容、也就不会触发；二维码只依赖本机解码和两个开关，识别失败同样只是没有结果。
指令分类开关
同一页下半部分的“指令分类开关”按分类列出本群指令（分类代码如 basic、manage、settings、system），卡片上标注该分类下的指令数量。
- 关掉某一类后，该分类下的指令消息不再被识别执行；与上面的监控总开关互不影响，也不会停掉关键词规则。
- 没有设置过的分类默认启用；同一张卡里的开关切换即保存。
- 需要恢复时，在这里重新打开，或在群里使用“启用类目”指令（要求群内等级 8 及以上）。
查看触发记录
监控统计 卡片显示启用方案数、总关键词数、云方案/普通方案数和触发次数，点 刷新 更新：
- “今日”是当天自然日；
- “本周”从 7 天前日期的零点起统计；“本月”从向前推 1 个月所得日期的零点起统计。都不是自然周/自然月，也不是精确到当前时刻的 168 小时/若干小时窗口。
最近触发记录 可按触发类型（关键词、频率、广告检测、手动、二维码、图片文字、语音）、处理方式（警告、禁言、踢出、仅记录）、关键词和时间范围筛选，支持分页。点 详情 查看触发消息、处理方式、动作终态、命中规则标识和用户。
用“动作终态”判断实际结果
| 动作终态 | 说明 |
|---|---|
| 平台已执行 | 平台返回成功，群里的动作已完成 |
| 平台已拒绝 | 平台明确拒绝（权限不足、目标不存在等） |
| 未派发 | 请求没有发出（本地准备、入队或连接写入失败） |
| 规划失败 | 请求没有形成（没有可用机器人、目标被过滤） |
| 派发结果未知 | 已发出但没拿到结果，不能当作已执行，也不要直接重复处罚 |
| 仅记录（零出站） | 这条规则本来就不发任何群内动作 |
处理方式只是“规则要求做什么”，动作终态才是“实际走到哪一步”。排查一律以动作终态为准；更多结果入口见结果判断与排障。
怎样确认真的生效
- 保存后刷新页面，开关保持你改的状态（保存失败会自动恢复原值并提示）。
- 需要实际触发且已获测试群授权时，先核对其他启用来源，再用不受本条等级规避影响的测试身份发匹配消息，在“最近触发记录”核对群、关键词和本次时间。仅准备配置时不必发消息。
- 该条记录的动作终态是否为“平台已执行”；如果只看到“仅记录”，说明这条规则本来就是观察模式。
- 群内实际表现与记录一致（有警告提示、成员被禁言等）。
只是准备配置、还没想让规则影响真实成员时，先不要绑到正式群，或用“仅记录”规则练习。
没成功先检查什么
- 规则启用了但群里没反应：本页总开关是否打开 → 本群是否引用了方案 → 方案本身是否启用 → 机器人在线且在该群。完整链路见常见问题。
- 消息被指令或刷屏先处理了：这类消息不会留下关键词命中记录。先看群里是否有对应的指令回复或刷屏处置，再判断是不是这一条被前序环节接走。
- 识别类开关灰着调不动：先打开总开关。
- 二维码识别不生效：确认 应用设置 → 高级设置 的全局开关也打开了；两处缺一都不识别。
- 图片文字、语音识别一直不成功：检查 AI 功能 的服务配置、任务开关和额度。
- 有处罚记录但群里没动静：看该条的 动作终态，多为“平台已拒绝”“未派发”或“派发结果未知”，分别对应没有执行成功和结果不确定，不要直接重试处罚。
- 关掉总开关还有动作：确认那个动作是不是来自指令、转发、文件监控或群员事件监控——这些不受本页总开关控制。
关闭或改回
- 停止本页总开关覆盖的关键词、刷屏和识别等功能：关闭 启用群聊监控 并 保存；文件、群员事件、名片及清退等独立来源需另行停用。
- 只停某个方案：在已启用方案卡片点 移除，或到方案管理停用该方案（会影响所有引用它的群）。
- 只停某条规则：在监控方案禁用该规则。
- 关掉“消息记录留存”只停止后续记录，已保存的消息记录仍在，需要另行在日志中心处理。
- 以上操作都不会撤销已经发出的消息或已经执行的处罚。