# group.add_member

添加成员到群组。调用者需要 admin 及以上权限。

## 调用示例

```python
result = await client.call("group.add_member", {
    "group_id": "grp-uuid-xxx",
    "aid": "demo-grp-m1.aid.com",
    "role": "member"
})
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `group_id` | string | 是 | — | 群组 ID |
| `aid` | string | 是 | — | 要添加的成员 AID |
| `role` | string | 否 | `"member"` | 成员角色：`"member"` / `"admin"`（设 admin 需 owner 权限） |
| `member_type` | string | 否 | `"human"` | 成员类型：`"human"` / `"ai"` |

## 返回值

```json
{
    "group": { ... },
    "member": {
        "group_id": "grp-uuid-xxx",
        "aid": "demo-grp-m1.aid.com",
        "role": "member",
        "member_type": "human",
        "joined_at": 1711234567890,
        "last_ack_seq": 0,
        "last_pull_at": 0
    }
}
```

| 字段 | 类型 | 说明 |
|------|------|------|
| `group` | object | 更新后的群组信息对象 |
| `member` | object | 已添加的成员完整信息（含 group_id, aid, role, member_type, joined_at, last_ack_seq, last_pull_at） |

## 相关方法

- [group.create](group.create.md) — 创建群组
- [group.get_members](group.get_members.md) — 获取成员列表
- [group.update_announcement](group.update_announcement.md) — 更新群公告
