leave_group

当前账号主动退出群聊。v2.0.6 新增；已发布 v2.0.5 不支持此接口。

调用

await api.forProtocol('android').leave_group({ self_id: 1060221, group_id: 305977791 })
// Linux 会话使用 api.forProtocol('linuxqq')，不会借用 Android 会话。

{
  "action": "leave_group",
  "params": { "self_id": 1060221, "client_type": "android", "group_id": 305977791 }
}

参数	类型	必填	说明
self_id	number	是	当前在线账号 QQ
client_type	string	是	android 或 linuxqq
group_id	number	是	群号，1 至 4294967295

框架根据账号及协议选择实际运行节点，不传 node_id。操作前重新查询成员身份，仅允许普通成员和管理员退出；群主及无法确认的成员身份会被拒绝。本接口不提供解散群能力，群主需先完成所有权转让。

返回与事件

{ "group_id": 305977791, "submitted": true, "status": "submitted" }

该返回仅表示服务器确认请求，不证明成员变化事件已经送达。通过 get_group_member_list 回读成员关系，并监听真实原生通知产生的 group_member_left。包含明确原因的主动退群通知返回 reason: "left"；退群账号自己的简略通知可能只有群号，此时省略 reason 和操作者字段，不得根据字段缺失推断主动退出或被移除。API 不根据请求成功合成事件。

群主调用返回 GROUP_OWNER_CANNOT_LEAVE。网络超时返回 GROUP_LEAVE_RESULT_UNKNOWN，必须先查询群成员状态，不自动重试。业务拒绝保留服务器错误码；空响应、格式错误或缺少明确状态均不视作成功。

验证状态

参数、身份保护、原生响应和四份 SDK 的契约测试已通过。测试环境的两个账号已分别通过 Android/Linux 主动退群、群主侧双协议接收正确的 reason: left、重新申请、审批和四会话成员回读；群主自身调用均被拒绝。

自身入口修复后，上述范围另通过两个运行节点、两条正向 WS 加一条反向 WS 对照，以及反向连接重连后交换账号协议再次操作。两轮三通道共 120 次事件投递、40 个账号范围内事件标识逐条一致，包含退群者自身通知；这仅覆盖本页已列出的退群、申请与恢复入群路径。

v2.0.6 已包含推送顺序、旧登录会话取消与成员事件去重提交顺序的修复。受影响的踢出、拒绝、新申请及批准恢复路径已完成双账号、双协议、两节点和三 WS 回归。此前缺少完整抓包的历史漏发不能反推为单一原因；未覆盖的外部客户端通知模板仍不属于此验证范围。