feat: OpenAPI 全量对齐——对照新旧两版官方文档补齐全部接口与事件

- 新增 panel 域:指令面板(斜线指令)增删改查/关联对象 + /v2/menu 全局自定义菜单
- 新增 group 域:群信息/成员/机器人群内状态、入群申请列表与审批、群黑名单、
  群禁言状态、入群自动审批策略(增删改查/执行/白名单)
- v2 补充:流式单聊消息、群/单聊大文件分片上传(预上传+分片确认)、分享链接
- guild 补充:子频道增删改、机器人频道列表、身份组 CRUD 与成员授予/收回、
  成员列表/踢出、全员与批量禁言、接口权限、消息频率设置
- channel 补充:子频道用户/身份组权限、频道私信(建会话/发信/撤回)
- 新增 audio 域(播放控制、上/下麦)与 forum 域(帖子增删查)
- 事件补齐 GROUP_MEMBER_ADD/REMOVE、GROUP_JOIN_REQUEST、SUBSCRIBE_MESSAGE_STATUS;
  Intent 与 intents.toml 补 GROUP_MEMBER_EVENT (1<<24) 分组(默认 false)
This commit is contained in:
snowy-yang committed 2026-09-23 17:46:37 +08:00
1 parent 13a1d971be
commit 15e1f5e303
15 files changed
+1677 -16

No files matched your search

+56
View File
@@ -192,3 +192,59 @@ async def test_untyped_annotation_still_receives_raw_dict():
{"op": Opcode.DISPATCH, "t": "GROUP_AT_MESSAGE_CREATE", "d": {"content": "x"}}
)
assert received == [{"content": "x"}]
def test_parse_group_member_and_join_request_events():
from qqbotsdk.payloads import (
GroupJoinRequest,
GroupMemberChange,
SubscribeMessageStatus,
)
change = parse_event(
"GROUP_MEMBER_ADD",
{
"timestamp": 1784276757,
"group_openid": "G1",
"member_openid": "M1",
"user_openid": "U1",
},
)
assert isinstance(change, GroupMemberChange)
assert change.member_openid == "M1"
# 两事件 d 结构一致,共用 dataclass
remove = parse_event(
"GROUP_MEMBER_REMOVE",
{"timestamp": 1, "group_openid": "G1", "member_openid": "M2"},
)
assert isinstance(remove, GroupMemberChange)
assert remove.user_openid is None
req = parse_event(
"GROUP_JOIN_REQUEST",
{
"group_openid": "G1",
"join_request_id": "j1",
"member_openid": "M1",
"username": "小明",
"apply_source": "self_apply",
"verify_info": {"method": "verify_message", "verify_message": "来了"},
"auto_approved": {"strategy_id": "st1"},
"unknown_field": 1,
},
)
assert isinstance(req, GroupJoinRequest)
assert req.join_request_id == "j1"
assert req.verify_info == {"method": "verify_message", "verify_message": "来了"}
assert req.auto_approved == {"strategy_id": "st1"}
status = parse_event(
"SUBSCRIBE_MESSAGE_STATUS",
{
"openid": "U1",
"result": [{"template_id": 10001, "op": 1, "subscribe_id": "sub1"}],
},
)
assert isinstance(status, SubscribeMessageStatus)
assert status.group_openid is None
assert status.result[0]["subscribe_id"] == "sub1"