> 规范网页：https://docs.tensuu.com/功能模块详解/26_卧底线索.html ｜ Markdown：/功能模块详解/26_卧底线索.md ｜ 文档修订：2026.10.26

# 卧底线索

这篇帮你做什么：当 **某个群里的成员** 在群外发生了某些举动（私聊机器人、加/被加好友、收到群邀请）时，自动记一条审计线索，并可选私聊通知本群的代理管理员。用途是给管理员留观察材料。配置入口：**侧边栏 → 群设置 → 基本设置 → 卧底识别** 卡（见[群基本设置](群基本设置.md)；改完随该页顶部的 **保存** 一起生效）。

## 先说清楚它不是什么

- 它 **不识别谁是卧底**，不做风险评分，也 **不会处罚任何人**——只记录、只提醒，处置完全由人决定。
- 线索记在 **日志中心 → 审计日志**，不会发到群里公开。

## 记录哪些事件（三个开关）

总开关 **启用卧底线索审计** 打开后，可分别选择：

| 开关 | 记录什么 |
| --- | --- |
| 私聊消息 | 群成员给机器人发私聊消息 |
| 好友事件 | 群成员添加机器人为好友，或向机器人发起好友申请 |
| 群邀请请求 | 群成员邀请机器人进别的群 |
| 通知代理管理员 | 以上线索每次新增时，私聊通知本群代理管理员（接收名单在 **基本设置 → 代理管理员** 配置） |

## 归因规则（怎么算"本群成员"）

- 按 **事件主体当前仍在本群** 判定：这个人在本群的成员关系有效，才会为本群记一条线索。
- 一个人在多个群时，会在其所在的、且开启了对应开关的每个群各记一条。
- 有人 **邀请机器人进群** 时，线索记在 **邀请人所在的群**，不是被邀请进入的那个群。
- 同一群里同一人同一类事件，**24 小时内只记一条**；通知也只在真正新增线索时发送，不会刷屏。

## 怎样判断结果

1. 保存后提示"设置保存成功"；刷新后开关保持。
2. 事件发生后，到 **日志中心 → 审计日志** 按该群查询，能看到对应线索记录（含事件类型、成员、时间等）。
3. 开了通知的：代理管理员收到一条私聊提醒。**没收到先确认"通知代理管理员"已开、且基本设置里已配置代理管理员名单**——名单为空时系统会跳过通知（记日志说明原因）。
4. 真实群/私聊效果以群内、私聊的实际表现为准。

## 没成功先检查什么

- 有线索但没通知："通知代理管理员"是否打开 → 代理管理员名单是否已配（本群）。
- 完全没有线索：总开关和对应事件开关是否都开 → 该人当前是否还是本群成员 → 机器人是否在线收到事件（按[常见问题](../快速入门指南/常见问题.md)核对）。
- 同一件事第二天又记了一条：24 小时去重窗口已过，属正常。

## 关闭或改回

- 停止全部：关闭 **启用卧底线索审计** 并保存（事件开关会随之停用）。
- 只停某类事件：单独关闭对应开关。
- 已有线索记录保留在审计日志中，可按日志中心的保留策略自然清理。

## 和其他页面的关系

- 线索的查看入口是控制台侧边栏 **日志中心 → 审计日志**（日志中心的使用见[应用日志](17_应用日志.md)）；接收通知的名单在 **基本设置 → 代理管理员** 配置。
- 需要对成员采取处置时，请使用[踢人禁言](13_踢人禁言.md)所列的功能，本页不提供任何处置。