> 规范网页：https://docs.tensuu.com/功能模块详解/11_邀请统计.html ｜ Markdown：/功能模块详解/11_邀请统计.md ｜ 文档修订：2026.10.26

# 邀请统计

这篇帮你做什么：记录 **某个群** 里"谁邀请了谁"——按邀请人汇总有效邀请数、退群数等，可导出成表格。它只说明已观察到的入群归因，不代表入群申请审核已获得同一信息。入口：**侧边栏 → 群设置 → 邀请统计**。

## 开始前确认

- 统计 **按群生效**，先在顶部选好群，并打开 **启用邀请统计** 开关（关闭期间发生的进群不会被补记）。
- **只有"成员A邀请成员B进群"这种 QQ 官方带邀请人的进群才能记到 A 头上**。扫码、搜索、主动申请等其它进群方式没有邀请人，只会记一条"未知归因"。
- 记录依赖 QQ 事件通知，机器人离线期间的进群和退群都会漏记：漏记的进群不会补记，漏记的退群也不会把对应记录改为退群，那条记录会继续按"有效"统计。

## 它怎么记账

- **记账时机**是被邀请人 **确认进群那一刻**：机器人收到进群事件、且事件里带有邀请人时，才记到邀请人名下。审核阶段（[入群审核](10_入群审核.md)）拿不到邀请人数据，两个功能互不影响。
- 归因由 QQ 事件决定，**不能手动修改**；没有邀请人的进群（扫码、搜索、主动申请）只累计到"未知归因"，不落到任何邀请人头上。
- 同一名下的每条记录独立保存：被邀请人退群后该条标记为"失败/已退群"，**不会**因其再次进群翻回"成功"；再次进群会产生一条新记录。
- "有效邀请数量"按 **已保存的邀请结果** 汇总，不实时核对成员此刻是否在群：只有机器人收到退群事件且统计开启等条件满足时，对应记录才改为退群；机器人离线、统计关闭或事件丢失期间的退群不会反映进来。因此这个数字可能高于当前真实在群的被邀请人数，用它发放邀请奖励或核对在群人数都会高估。

## 看懂列表

点开页面即为按邀请人分组的列表（分页）：

| 列 | 含义 |
| --- | --- |
| 邀请人名称 / 邀请人号码 | 邀请人是谁；没有归因到具体人时显示"未知邀请人" |
| 有效邀请数量 | 名下记录仍为"成功"的数量（按已保存结果统计，不实时核对是否仍在群） |
| 总邀请数量 | 该邀请人名下全部记录 |
| 失败/已退群数量 | 被邀请人后来退群（或被移出）的数量 |
| 未知归因数量 | 进群时无法确定邀请人的数量 |
| 邀请清单 | 点 **查看** 弹出该邀请人逐一邀请的成员及各自状态、邀请结果 |

"邀请结果"三种：成功（已进群，且未记录到退群）、失败（已记录退群或被移出）、未知（无法确认）。列表里各数量都按这些已保存的结果汇总，不等于此刻的群成员名单。

## 导出与清空

- **导出**：下载 CSV 文件，适合留档或用表格软件进一步统计。文件名以浏览器实际下载结果为准，不要只凭文件名判断所属群；导出前先核对顶部所选群，下载后核对文件内的成员与记录。导出的是全部明细，数量很大时以最新一万条为上限。
- **清空**：删除 **本群全部** 邀请统计记录，弹出确认框提示"此操作不可恢复"。清空后之前的有效邀请数全部归零，且 **无法找回**；只是想重新从今天开始统计时才需要用它。

**怎样确认成功**：打开开关后提示"已启用邀请统计"；刷新页面开关保持打开。真实效果要等之后有人被邀请进群：列表里出现对应邀请人和新成员，即记录正常。

## 没成功先检查什么

- 开关打开后列表一直为空：之后是否真的发生了"邀请进群"（主动申请不会计入邀请人）→ 机器人是否在线收到进群通知（按[常见问题](../快速入门指南/常见问题.md)核对）。
- 大量"未知归因"：这些进群事件里 QQ 没有提供邀请人，属于正常现象，不是故障。
- 被邀请人明明在群却显示失败：退群标记是终态，不会因再次进群自动翻回"成功"；再次进群会产生一条新记录（两条都在明细里），属已知行为。
- 被邀请人已退群却仍计"有效"：退群事件可能发生在机器人离线或统计关闭期间，没有被记录；本页不会自动纠正这类记录，判断真实在群情况以群成员实际状态为准。
- 开关关了又自己弹回：保存失败时页面会恢复原值并提示，重试即可。

## 关闭或改回

- 停止统计：关闭 **启用邀请统计** 开关即可，已有记录保留、页面仍可查询和导出。
- 彻底清掉本群数据：用 **清空**（不可恢复，慎用）。

## 和其他页面的关系

- [入群审核](10_入群审核.md)当前不支持采集"是否群成员邀请"评分指标，不能因为本页有统计记录就把该指标当成可用。
- 邀请产生的进群事件同样会经过受保护用户等前置检查，相关规则见[踢人禁言](13_踢人禁言.md)。