 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
|
71cbfdaf5d
|
feat!: intents 只按大类订阅、群消息全量模式与事件流优化
破坏性变更：intents.toml 订阅粒度收敛到 Intents 大类（分组）——
配置从「[分组] 表内逐事件开关」改为「分组名 = true/false」。网关只接受
分组位掩码，组内事件本就无法单独订阅，此前的逐事件开关仅是「组内任一
为 true 即订阅整组」的装饰。旧格式不再兼容，与拼错的分组名、非布尔值
一样在启动时直接抛 ValueError，而非静默少订阅。
新增：
- GROUP_MESSAGE_CREATE 事件接收（群消息全量模式，与 GROUP_AT_MESSAGE_CREATE
共用 GroupAtMessage）；GroupAtMessage 补齐 message_type/message_scene/
attachments/mentions/ark_data/msg_elements 字段
优化：
- 形参注入缓存化：合并缓存 handler 签名与类型标注解析（此前每条事件都重跑
inspect.signature/get_type_hints），services 命中改为每条事件实时判定，
保证「先注册 handler、后登记组件」的既有装配顺序不受影响
- EventQueue.put_event/put_reply 去掉多余的 return await
- model.NoneType 联合成员顺序调整（None 置于末尾）
文档同步 GUIDE/API/README/CHANGELOG 与示例；测试 76 全绿，ruff/pyright 干净。
|
2026-09-20 21:39:25 +08:00 |
|
|
snowy-yang
|
097bc96d8b
|
feat: 按钮快捷构造、event_id 语义修正与 TokenError
|
2026-09-16 21:42:33 +08:00 |
|
|
snowy-yang
|
0c364bf803
|
qqbotsdk: QQ 官方机器人 SDK（协议层/DI/业务 API/测试/文档）
|
2026-09-11 19:49:17 +08:00 |
|