hhhge/qqbotsdk
1
0 Fork 0
mirror of https://github.com/snowy-yang/qqbotsdk.git synced 2026-10-21 09:56:17 +00:00
Code Issues Packages Projects Releases Wiki Activity
46 Commits 1 Branch 2 Tags
706a39b07b6342d1126bc3c599c6aba8fd7158fd
Commit Graph
9 Commits
Author SHA1 Message Date
snowy-yang 0515c6e4c0 refactor!: Bot 门面接管启动，移除 main/run_loop 与控制台脚本入口 
bot.run() 同步启动、bot.start() 嵌入外部 asyncio 应用；
bot.call_api 通用 REST、bot.api 类型化 API 面、bot.services 自定义组件注入；
services 登记扩到 8 项（含 Bot 自身，可标注注入）。
 2026-10-03 19:12:06 +08:00
snowy-yang 0f3ed09233 refactor!: handler 参数只按模型/Event/组件注入，不再回退传原始 d 
解析不到的形参（无标注或标注三者皆非）在分发时抛 ValueError，经异常
隔离记日志；原始数据经 Event 的 .raw/.typed 自取。同步四处文档与测试。
 2026-09-24 22:40:37 +08:00
snowy-yang 13a1d971be feat: 连接寿命到点前主动重连（服务端约 1 小时会无预警断开） 
实测 QQ 服务端在一个连接建立约 1 小时后会自己断开。此前只能等它断：
要么被看门狗判成静默超时、要么等读写失败，都算"异常断开"，观感与恢复
路径都不理想。现改为临到期前主动收尾重连——是正常断开 + RESUME 续传，
期间消息由网关补发。

实现：receive_helper 记录寿命截止点（_SERVER_LIFETIME - _RECONNECT_MARGIN，
默认 60min - 10min = 50min），收帧超时取"静默阈值"与"寿命余量"两个截止里
的先到者——静默过久仍抛 TimeoutError 交给看门狗，寿命到点则 return 正常
结束本轮连接，run() 见存活超过 _STABLE_SECONDS 便立刻重连（沿用 b37a53f
的"健康断开零等待"路径），RESUME 带上 session_id 续传。

_connect 的存活秒数天然 >= 50min > _STABLE_SECONDS，主动重连必被判定为
健康断开，无需额外标志位。

测试：新增 test_proactive_reconnect_before_server_lifetime（真实 ws 端到端，
把寿命阈值调到 0.5s 让这一刻立即发生）；已验证把寿命阈值关掉后该测试会
超时失败，不是空转到通过。另给 tests/test_reconnect.py 补 CHANGELOG 条目
（b37a53f 漏记），并同步 connecter 模块 docstring / ARCHITECTURE / GUIDE。

90 测试全绿，ruff check/format + pyright 干净。
 2026-09-21 18:28:53 +08:00
snowy-yang 1552c5207b refactor: 工程化收尾——去 pyee、预计算解析计划与派生密钥、命名与接口一致化 
以「语义可读、逻辑清晰、减少心智负担」为目标，不追求极致速度：

- **移除 pyee 依赖**：EventEmitter 改为内置的 `事件名 → handler 列表` 注册表
  （on() 追加、emit() 顺序遍历）。SDK 用不到 pyee 的 once/new_listener/错误
  事件机制，去掉后少一个依赖、分发语义一眼可读。注册语义不变（同函数重复
  注册只生效一次），并补测试锁定「重复注册只生效一次」「按注册顺序执行」。
  破坏性：once/remove_listener 等装饰性 API 不再提供。

- **去掉热路径上的重复计算**（纯缓存，不改语义）：
  · payloads 按类缓存解析计划（字段名 + 是否嵌套 Author），不再每次事件重跑
    dataclasses.fields 与联合类型解包；未收录字段照旧忽略（新增回归测试，
    线上 payload 会带 author.union_openid 这类字段）。实测 7.5µs → 2.5µs。
  · crypto 按 AppSecret 缓存派生私钥（每个 webhook 请求都要验签，派生一次
    约 40µs）；公钥派生只差 3µs，不再多缓存一层。

- **命名与接口一致性**：
  · WebsocketConnecter.reply_helper → send_helper（它从出站缓冲取帧发送，
    原名会让人误以为还有 reply 队列；model.py 的对应注释同步）
  · Connecter 由 typing.Protocol 改为 abc.ABC，与 BaseProtocol 风格统一

- **webhook 去重改摊还清理**：过期判定按当前 id 做（O(1)，且 TTL 外重发的
  同一 id 仍按新事件处理——原先的写法在阈值清理下会误判为重复，已由测试
  抓出并修正），整表清过期项只在表长到阈值时执行，不再每请求 O(n) 扫描。

测试 85 全绿（新增未知字段/解析计划缓存/注册语义/去重摊还与 TTL 过期），
ruff check/format + pyright 干净。文档 ARCHITECTURE/API/CHANGELOG 同步。
 2026-09-20 22:45:34 +08:00
snowy-yang 4d19db24e1 refactor!: EventQueue 收敛为单向业务事件通道，出站缓冲归 ws 适配器 
协议分流后 reply_queue 只剩 WebsocketConnecter 一个使用者（emitter 不再
回流应答、webhook 完全不用），它已不是"连接层与分发层之间的通道"，而是
ws 私有的出站缓冲，却仍挂在共享 EventQueue 上——queue.py 的模块注释
"连接层与分发层之间唯一的跨任务通道"对 reply_queue 不再成立。

删除 EventQueue.reply_queue 与 put_reply/get_reply，EventQueue 只承载
业务事件（op=0，单向）。ws 的出站帧改由 WebsocketConnecter 私有
_outbound 队列承载，heartbeat_helper 与协议应答生产者投递、reply_helper
单任务发送——维持 aiohttp ws 单写者不变量，生产者也不会被发送阻塞。

破坏性变更：EventQueue.reply_queue / put_reply / get_reply 不再存在
（这两个方法本就只由 SDK 内部使用，非用户面）。

文档同步 queue.py 注释、ARCHITECTURE（图与心跳/应答路径）、API 的
EventQueue 说明、CHANGELOG；测试 80 全绿，ruff/pyright 干净。
 2026-09-20 22:02:07 +08:00
snowy-yang 7accbd1ead refactor!: 协议帧与业务事件分流，各接入方式配专有协议处理器 
BaseProtocol 从 emitter.py 移入新模块 protocol.py，接口由 register(emitter)
改为 async on_frame(payload)（返回需回送的响应体）；协议处理器不再注册进
emitter，而由 run_loop 注入对应的 connecter，由适配器逐帧调用。

破坏性变更：只有 op=0 的业务事件进事件队列交给 EventEmitter 分发，
HELLO/READY/INVALID_SESSION/op=13 等协议帧在连接器内就地处理——用户 handler
不再收到协议帧（此前 HELLO/INVALID_SESSION 等会路由到 handler）。
EventEmitter.register_protocol()/handle() 与 emitter 持有协议层的机制删除，
协议类不再用 register() 注册 handler。

附带修掉一处时序耦合：INVALID_SESSION 的会话重置此前依赖分发泵在重连前
消费掉该事件（慢 handler 会推迟它，导致带着已死 session_id 去 RESUME），
现在连接器在 break 重连前同步完成重置。

同时做的事件流优化：
- emit() 先取事件名、无 listener 时不构造 Event（未订阅事件省一次对象与拷贝）
- Event.data 改为惰性拷贝（只用 .typed/.raw 的 handler 不再触发 dict(d)）
- ws 重连收尾 await 被取消的 reply/heartbeat 任务，避免异常无人取用
- EventQueue.put_event/put_reply 去掉多余的 return await

测试 80 全绿（新增协议帧处理测试组、ws 集成断言协议帧不触达 handler），
ruff/pyright 干净。文档 ARCHITECTURE/API/GUIDE/README/CHANGELOG 同步。
 2026-09-20 21:57:57 +08:00
snowy-yang 3237558128 feat!: api 拆包、心跳迁入传输层、限流重试与后台 handler 2026-09-20 21:26:55 +08:00
snowy-yang cff0c142c2 refactor!: 移除 dishka，改为内置裸标注参数注入 
- handler 形参直接标注组件类型（api: BotApi）即注入，解析为 emitter 内同步查表（payload dataclass / Event / services 登记类型 / 回退原始 dict）
 2026-09-16 19:18:06 +08:00
snowy-yang 0c364bf803 qqbotsdk: QQ 官方机器人 SDK（协议层/DI/业务 API/测试/文档） 2026-09-11 19:49:17 +08:00