mirror of
https://github.com/snowy-yang/qqbotsdk.git
synced 2026-10-21 08:44:48 +00:00
snowy-yang
7e7dcbaa94
删除 Event 的 user_id/group_id/content/message_id 四个属性：它们是 "兼容群（openid）与频道两套字段名"的映射层，其中 user_id 还带着 旧版群消息 payload 顶层 from_user_id 的回退（现行格式发言人标识在 author 里，该回退永远轮不到）。Event 只保留信封语义： .raw/.data/.typed/.type/.event_id，事件体字段一律标注 payload dataclass（如 msg: GroupAtMessage）获取解析结果。 破坏性变更：event.group_id → msg.group_openid、event.message_id → msg.id，以此类推；被动回复凭据分工不变——消息事件用事件体 d.id （msg_id），其余事件用信封顶层 event_id。 迁移：examples/group_bot 入群欢迎改标注 GroupAddRobot（已确认 MusicBot 未使用被删属性）；GUIDE/API 同步删除对应属性行；测试 重写为信封语义断言 + typed 解析断言。 107 测试全绿，ruff/pyright 干净。
示例
可运行的完整示例，均以仓库根目录为工作目录启动（.env、intents.toml 放在根目录）。
| 示例 | 接入方式 | 内容 |
|---|---|---|
group_bot/main.py |
WebSocket | @消息被动回复、/img 富媒体图片、/btn Markdown 按钮卡片与点击回调、入群欢迎、单聊回复 |
webhook_bot/main.py |
Webhook | HTTP 回调收群 @消息并被动回复的最小接入 |
运行前提
- 根目录
.env配好APPID/APPSECRET（webhook_bot需另设CONNECTER=webhook）； intents.toml订阅对应分组（group_bot需GROUP_AND_C2C_EVENT与INTERACTION，webhook_bot需GROUP_AND_C2C_EVENT；仓库默认配置已满足两者）；group_bot要求机器人已开通群聊能力并拉入测试群；webhook_bot要求公网 HTTPS 部署（平台仅支持 80/443/8080/8443 端口，本地调试可用内网穿透）。
运行
uv run python examples/group_bot/main.py
uv run python examples/webhook_bot/main.py
Webhook 示例启动后，把 https://<你的域名>:<端口>/qqbot/webhook 填到开放平台回调地址；保存时平台先发 op=13 验证请求，SDK 自动完成签名应答。
接入方式切换与 handler 写法详见 使用指南。