> 规范网页：https://docs.tensuu.com/功能模块详解/18_群资料管理.html ｜ Markdown：/功能模块详解/18_群资料管理.md ｜ 文档修订：2026.10.26

# 群资料

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

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

## 开始前确认

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

## 看基本信息

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

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

## 管理机器人参与

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

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

作用范围：这个开关只决定"**这台机器人是否参与这一个群**"，不影响它在其他群的参与，也不改动机器人的启用状态和全局权重（那些在[机器人管理](19_机器人管理.md)配）。

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

## 看群信息统计

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

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

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

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

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

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

## 没成功先检查什么

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

## 关闭或改回

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

## 和其他页面的关系

- 群与成员数据是各功能的事实来源：入群校验见[入群审核](10_入群审核.md)，成员触发的监控见[群聊监控](08_群聊监控.md)。