# group.pull

增量拉取群消息和群事件。基于 `after_message_seq` / `after_event_seq` 游标获取增量数据。

## 调用示例

```python
result = await client.call("group.pull", {
    "group_id": "grp-uuid-xxx",
    "after_message_seq": 10,
    "after_event_seq": 5,
    "limit": 50
})
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `group_id` | string | 是 | — | 群组 ID |
| `after_message_seq` | integer | 否 | `0` | 消息起始序列号，返回 seq > after_message_seq 的消息 |
| `after_event_seq` | integer | 否 | `0` | 事件起始序列号，返回 seq > after_event_seq 的事件 |
| `limit` | integer | 否 | `50` | 返回消息数量上限（最大 100） |

## 返回值

```json
{
    "group_id": "grp-uuid-xxx",
    "messages": [
        {
            "group_id": "grp-uuid-xxx",
            "seq": 11,
            "message_id": "msg-uuid-xxx",
            "sender_aid": "demo-gm-member.aid.com",
            "message_type": "text",
            "payload": {"text": "收到"},
            "attachments": [],
            "created_at": 1711234567890
        }
    ],
    "events": [],
    "latest_message_seq": 11,
    "latest_event_seq": 5,
    "limit": 50
}
```

| 字段 | 类型 | 说明 |
|------|------|------|
| `group_id` | string | 群组 ID |
| `messages` | array | 消息列表，按 seq 升序 |
| `events` | array | 事件列表（成员变动等） |
| `latest_message_seq` | integer | 本次返回的最大消息 seq |
| `latest_event_seq` | integer | 本次返回的最大事件 seq |
| `limit` | integer | 实际使用的上限 |

## 相关方法

- [group.send](group.send.md) — 发送群消息
- [group.get_members](group.get_members.md) — 获取成员列表
