群资料
这篇帮你做什么:查看一个群的档案(名称、人数、归属连接和机器人)和活跃统计,并决定某台机器人是否参与这个群。入口:群设置 → 群资料(页面顶部先选择群)。
这页回答"这个群在机器人眼里长什么样":资料来自连接同步记录,其中人数还会随已收到的进退群事件更新;统计来自机器人自己的事件记录。两者都不是 QQ 实时查询结果。
开始前确认
- 群要出现在顶部下拉里,需要机器人所在连接已同步到该群(机器人已在群里,或连接同步时带回了该群)。
- 本页资料是只读的:改群名、锁定群名、查改名历史在 群设置 → 基本设置。
- 统计数字来自机器人自己的记录,机器人未接入期间的活动不会统计。
看基本信息
基本信息 区展示:群组名称、群组简介、群头像、群人数、渠道、所属连接、群编码、所属机器人、创建时间。
- 群编码 是机器人在协议层识别这个群的唯一编号,排查"哪个群"问题时以它为准。
- 所属机器人 列出参与这个群的机器人及启用状态。
管理机器人参与
机器人分配与归因 卡片:多台机器人时可按群排除某台的参与资格。
- 在机器人列表中找到目标机器人。
- 切换其"排除参与"开关。
- 怎样判断成功:提示"机器人参与设置已更新",列表状态随之变化。
作用范围:这个开关只决定"这台机器人是否参与这一个群",不影响它在其他群的参与,也不改动机器人的启用状态和全局权重(那些在机器人管理配)。
注意:机器人的全局权重在 仪表盘 → 机器人管理 里修改,本页只能控制"这个群是否排除它"。列表为空时说明还没有机器人参与本群——先在机器人管理中绑定连接,等连接建立后群参与会自动出现。
看群信息统计
群信息统计 区。各数字都来自机器人自己的记录,机器人未接入期间的活动不会统计:
| 指标 | 口径 |
|---|---|
| 群人数 | 所选日期范围内每日统计"成员数"的合计;不是上方基本信息的当前快照,见下注 |
| 发言条数 | 所选日期范围内按天汇总 |
| 每日发言人数、进群人数、退群人数 | 范围内最近一天的数据;逐日数字以每日统计表为准 |
| 新人存留率 | 显示的是统计接口的"日均活跃率"——范围内各日活跃占比的平均值,不是按进退群记录算出的新成员留存;解读时以每日统计表的"活跃人数"列为准 |
两个"群人数"不是同一个数:上方 基本信息 区的人数来自连接同步记录,并随已收到的进退群事件增减;统计区这一格是所选日期范围内每日统计的合计。当前版本的统计事件不写入每日成员数,这一格通常显示 0;即使历史数据里有别的来源写入过值,它也仍然是日期合计,不能当成当前人数,更不能因为它是 0 就断定群里没有人。
注意最后一个指标的口径与它的标签不一致:看到"存留率"不要理解成"新人留下来的比例",它是活跃率均值。
- 日期范围选择器:默认最近 7 天,可改起止日期重新查询。改完日期后核对表格"日期"列是否已切到新范围;若没有变化,重新选择一次或刷新页面再查。
- 每日统计数据 表:按天列出上述各项,默认每页 10 条,可切换每页条数并翻页。
统计读取失败时,页面会显示"群统计数据读取失败"告警和 重试 按钮——此时概览卡片不显示数字,避免把 0 当成真实统计;重试成功后再核对下方表格是否已刷新。
没成功先检查什么
- 群不在下拉里:确认机器人已在目标群、连接已建立(见常见问题的连接链路)。
- 统计全是 0 或很少:发言、进群、退群等数字为 0,可能只是所选日期范围内机器人未接入该群,换一个范围试试;但统计区"群人数"一格为 0 是常态(口径见上文),既不代表机器人没接入,也不代表群里没人。看当前人数以 基本信息 区的快照为准(快照也可能滞后,见下一条)。
- 群名/人数和 QQ 里看到的不一致:群资料依赖连接同步,人数也依赖已收到的进退群事件;同步滞后或漏事件时可能不准,不能当作实时查询。需要改名或锁名见 群设置 → 基本设置 的群名维护。
- 页面打不开数据:点告警里的 重试;仍失败检查后端服务状态。
关闭或改回
本页以查看为主,唯一可改的是"排除参与"开关,切回即可恢复该机器人在本群的参与资格;其余资料无需也不会被本页修改。