Skip to content

邀请统计 ​

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

开始前确认 ​

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

它怎么记账 ​

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

看懂列表 ​

点开页面即为按邀请人分组的列表(分页):

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

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

导出与清空 ​

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

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

没成功先检查什么 ​

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

关闭或改回 ​

  • 停止统计:关闭 启用邀请统计 开关即可,已有记录保留、页面仍可查询和导出。
  • 彻底清掉本群数据:用 清空(不可恢复,慎用)。

和其他页面的关系 ​

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