# 群聊历史

读企业微信群里的历史消息：先看最近有哪些群在说话，再拉某个群某段时间的消息明细，
需要时把群里发的图片和文件取下来。**只支持最近 7 天。**
这是整套能力里**隐私敏感度最高的一项**——读到的是别人的聊天原文，所以助手每次读之前都会先说明要读什么。

> ⚠️ **这一域的全部能力目前完全未验证。** 实测账号的机器人**未开通「群聊会话」品类**，
> 第一步就被企业微信拒绝，后面的所有能力都没有机会验证。详见下方「验证状态」。

## 你可以怎么说

> 「项目 A 群这两天聊了什么？」
> 「昨天群里说的那个事，帮我找一下」
> 「帮我总结一下产品群这周的讨论」
> 「把群里发的那个文件找出来」
> 「这周哪些群比较活跃？」

## 📋 验证状态

| 项 | 状态 |
|---|---|
| 列出最近有消息的群会话 | ❌ **未实测——被权限拦住** |
| 拉取某个群的消息明细 | ❌ **未实测** |
| 取群消息里的图片 / 文件 | ❌ **未实测** |
| 隐私说明、7 天窗口等行为约定 | ❌ **未实测** |

**卡在哪（这是唯一有据可查的事实）**：

```bash
wecom-cli chat groups list ...
# → 返回错误码 853006
```

`853006` 的含义是**同类未授权**——实测账号的机器人**没有开通「群聊会话」这个品类**。
第一次调用就被拒，所以从「有哪些群」开始的整条链路都没跑起来。

**因此本文档不含「实际效果」一节，也不含任何实测对话或返回值**
（下文出现的引用块都是**措辞示意**，不是跑出来的记录）。
下面「能力清单」与「注意事项」的内容来自接口定义与技能文档，**是设计意图，不是实测结论**。
真正跑通之前，它们只能当作「预期会这样」来看。

**要让它可用**：需要为机器人开通群聊会话品类。助手第一次碰到这个错误时，会把企业微信官方的
开通指引**原样转给你**（含链接，一字不改），然后停下来——**不会反复重试，也不会换个方法绕**。

## 能力清单

> 以下均**未实测**。

| 能做什么 | 命令 | 风险 |
|---|---|---|
| 列出最近 7 天有消息的群会话 | `wecom-cli chat groups list` | 读取（隐私敏感：暴露群名与活跃度） |
| 拉取指定会话在某时间段的消息明细 | `wecom-cli chat messages list` | 读取（**最高隐私敏感**：他人聊天原文） |
| 取消息里的图片 / 文件 / 语音 / 视频 | `wecom-cli message files get` | 读取（隐私敏感：他人发的文件内容） |

三个都是只读，对企业微信侧没有任何改动，所以不需要「高风险确认」那一套。
但因为读的是别人的内容，**执行前必须先说明要读什么**。

## 注意事项

**读之前会先告诉你要读什么。** 助手会先说一句类似这样的话，再动手：

> 我将读取「项目 A 群」2026-08-29 00:00 至 2026-08-31 23:59 的聊天记录，用于整理讨论要点。

范围必须具体到**哪个会话 + 哪个时间段 + 读来干什么**。你没指定群时，它会先把群列出来让你选，
**不会「先全都拉下来再说」**——不会为了省一次交互就批量遍历好几个群。

**它不做人物画像。** 拉下来的原文只用于回答你当前这个问题，不主动扩散、不统计
「谁说话最多」「谁最晚下班」这类对个人的行为分析，除非你明确要求且目的正当。

**敏感信息会被略去。** 聊天记录里出现身份证号、银行卡号、家庭住址、健康状况这类能识别到具体个人的信息，
助手**不摘录、不转述、不写进总结**，即使你要求。它会说明「记录中含敏感个人信息，已略去」。

**只有最近 7 天，而且越界时是「静默返回空」不是报错。**
这是最容易误判的一条：查 7 天以前的内容，企业微信不会告诉你「超范围了」，
而是给你一个**空列表**。所以——

- 你说「上个月群里那个事」时，助手会**先告诉你只能查最近 7 天**，而不是拉一次空结果再回你「没找到」。
  这两句话对你的意义完全不同。
- 拿到空结果时，它会先自查时间范围是不是越界了，再下「这段时间没有消息」的结论。
- 它不会用多次分段查询去凑 7 天以前的数据——服务端不给就是不给。

**只有群聊，没有单聊。** 「最近有哪些会话」这个列表**目前只返回群聊**。
你要看「我和张三的私聊记录」时，助手会先去通讯录把张三解析出来，再按人去拉，不会在群列表里找。

**图文混排的消息容易被漏掉。** 群里那种「一段文字配几张图」的消息，正文藏在嵌套结构里。
助手知道要去里面取，不会把它当成空消息漏掉——这一点在总结里最容易出现「消息凭空消失」。

**不会无限翻页。** 一个群一段时间的消息可能很多，助手会设一个页数上限，拉够了就停下来做总结，
并告诉你「还有更多历史消息，需要的话可以继续拉」。

**能读的群 ≠ 能发消息的会话。** 这两个是不同的集合，内部标识也不能互相搬运。
要往群里发东西，走 [03 消息与会话](03-消息与会话.md)，那边有它自己的一套限制。

### 三条通用边界在本域怎么体现

1. **只能改它自己建的东西**——这一域**完全只读**，本来就不写任何东西。
   助手不能替你在群里发言、不能撤回别人的消息、也不能编辑聊天记录。
2. **能力按品类逐项开通**——**本域正是这条规则最直接的受害者**：群聊会话品类未开通，
   整个能力就是黑的。助手会把官方开通指引原样转给你，然后停下。
3. **危险动作先问你**——这里没有「危险写入」，但有**隐私读取的说明义务**：
   读之前必须讲清读哪个会话、什么时间段、读来干什么。这条不因为「只是读一下」而放宽。

## 相关

- [03 消息与会话](03-消息与会话.md)——往群里发消息（与本域是两套独立的会话范围）
- [02 通讯录](02-通讯录.md)——想读某人的单聊记录时，先在这里把人解析出来
- [15 媒体文件](15-媒体文件.md)——把群里的图片、文件落到本地
- [99 风险与确认](99-风险与确认.md)——隐私敏感读取的完整规则
- [README 的验证进度](README.md#各能力的验证进度)——本域为什么被列为「完全未实测」