Skip to content

群资料 ​

这篇帮你做什么:查看一个群的档案(名称、人数、归属连接和机器人)和活跃统计,并决定某台机器人是否参与这个群。入口:群设置 → 群资料(页面顶部先选择群)。

这页回答"这个群在机器人眼里长什么样":资料来自连接同步记录,其中人数还会随已收到的进退群事件更新;统计来自机器人自己的事件记录。两者都不是 QQ 实时查询结果。

开始前确认 ​

  • 群要出现在顶部下拉里,需要机器人所在连接已同步到该群(机器人已在群里,或连接同步时带回了该群)。
  • 本页资料是只读的:改群名、锁定群名、查改名历史在 群设置 → 基本设置。
  • 统计数字来自机器人自己的记录,机器人未接入期间的活动不会统计。

看基本信息 ​

基本信息 区展示:群组名称、群组简介、群头像、群人数、渠道、所属连接、群编码、所属机器人、创建时间。

  • 群编码 是机器人在协议层识别这个群的唯一编号,排查"哪个群"问题时以它为准。
  • 所属机器人 列出参与这个群的机器人及启用状态。

管理机器人参与 ​

机器人分配与归因 卡片:多台机器人时可按群排除某台的参与资格。

  1. 在机器人列表中找到目标机器人。
  2. 切换其"排除参与"开关。
  3. 怎样判断成功:提示"机器人参与设置已更新",列表状态随之变化。

作用范围:这个开关只决定"这台机器人是否参与这一个群",不影响它在其他群的参与,也不改动机器人的启用状态和全局权重(那些在机器人管理配)。

注意:机器人的全局权重在 仪表盘 → 机器人管理 里修改,本页只能控制"这个群是否排除它"。列表为空时说明还没有机器人参与本群——先在机器人管理中绑定连接,等连接建立后群参与会自动出现。

看群信息统计 ​

群信息统计 区。各数字都来自机器人自己的记录,机器人未接入期间的活动不会统计:

指标口径
群人数所选日期范围内每日统计"成员数"的合计;不是上方基本信息的当前快照,见下注
发言条数所选日期范围内按天汇总
每日发言人数、进群人数、退群人数范围内最近一天的数据;逐日数字以每日统计表为准
新人存留率显示的是统计接口的"日均活跃率"——范围内各日活跃占比的平均值,不是按进退群记录算出的新成员留存;解读时以每日统计表的"活跃人数"列为准

两个"群人数"不是同一个数:上方 基本信息 区的人数来自连接同步记录,并随已收到的进退群事件增减;统计区这一格是所选日期范围内每日统计的合计。当前版本的统计事件不写入每日成员数,这一格通常显示 0;即使历史数据里有别的来源写入过值,它也仍然是日期合计,不能当成当前人数,更不能因为它是 0 就断定群里没有人。

注意最后一个指标的口径与它的标签不一致:看到"存留率"不要理解成"新人留下来的比例",它是活跃率均值。

  • 日期范围选择器:默认最近 7 天,可改起止日期重新查询。改完日期后核对表格"日期"列是否已切到新范围;若没有变化,重新选择一次或刷新页面再查。
  • 每日统计数据 表:按天列出上述各项,默认每页 10 条,可切换每页条数并翻页。

统计读取失败时,页面会显示"群统计数据读取失败"告警和 重试 按钮——此时概览卡片不显示数字,避免把 0 当成真实统计;重试成功后再核对下方表格是否已刷新。

没成功先检查什么 ​

  • 群不在下拉里:确认机器人已在目标群、连接已建立(见常见问题的连接链路)。
  • 统计全是 0 或很少:发言、进群、退群等数字为 0,可能只是所选日期范围内机器人未接入该群,换一个范围试试;但统计区"群人数"一格为 0 是常态(口径见上文),既不代表机器人没接入,也不代表群里没人。看当前人数以 基本信息 区的快照为准(快照也可能滞后,见下一条)。
  • 群名/人数和 QQ 里看到的不一致:群资料依赖连接同步,人数也依赖已收到的进退群事件;同步滞后或漏事件时可能不准,不能当作实时查询。需要改名或锁名见 群设置 → 基本设置 的群名维护。
  • 页面打不开数据:点告警里的 重试;仍失败检查后端服务状态。

关闭或改回 ​

本页以查看为主,唯一可改的是"排除参与"开关,切回即可恢复该机器人在本群的参与资格;其余资料无需也不会被本页修改。

和其他页面的关系 ​