hhhge/qqbotsdk
1
0 Fork 0
mirror of https://github.com/snowy-yang/qqbotsdk.git synced 2026-10-21 12:18:20 +00:00
Code Issues Packages Projects Releases Wiki Activity
30 Commits 1 Branch 2 Tags
badf5b35712dffd82734d08222d3a2268a4b2821
Commit Graph
12 Commits
Author SHA1 Message Date
snowy-yang badf5b3571 docs: README 瘦身——顶部加在线文档链接，删解释性内容与过时部署/CI 描述 2026-09-24 21:51:39 +08:00
snowy-yang 7603db7fd9 feat!: 文档部署改为 docs 分支自动同步，移除 Gitea 工作流与 wrangler 脚本 
Gitea 已配置为 GitHub 的镜像，主仓库落在 GitHub：

- 删除 .gitea/（runner 已弃用，六轮实跑不稳定）与
  scripts/deploy_docs.sh（wrangler Direct Upload 路径随之退役，
  CLOUDFLARE_* secrets 不再被 CI 需要）
- deploy-docs.yml 重写：main 的文档文件变更时自动把纯文档组装进
  docs 孤儿分支并强推——Cloudflare Pages 直连 GitHub、生产分支选
  docs、构建命令留空、输出目录 / 即完成零构建接入
- index.html 仓库链接与 README/GUIDE 安装命令补 GitHub 地址；
  CHANGELOG 合并原先两条 CI/部署条目
 2026-09-24 21:19:15 +08:00
snowy-yang f45299f92c docs: README/CHANGELOG 同步——方式三改写、CI 与文档站部署说明 
README 方式三示例从 event.user_id/group_id/content/message_id 改为
typed payload + 组件注入组合；开发节补 CI 与 Cloudflare Pages 部署
说明；CHANGELOG Unreleased 记录 Event 兼容属性移除（破坏性）、
Gitea Actions CI 与文档站部署三项。
 2026-09-24 20:18:46 +08:00
snowy-yang 1a7111973b docs: 修正 README 架构图与 API 模块表（协议分流后残留） 2026-09-20 22:16:05 +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 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 3237558128 feat!: api 拆包、心跳迁入传输层、限流重试与后台 handler 2026-09-20 21:26:55 +08:00
snowy-yang 750ed81d96 docs: 基于 docsify 搭建文档站点 2026-09-16 21:42:43 +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 953d44f62e feat: Markdown 与内嵌按钮一等支持 
- post_group_message/post_c2c_message 新增 markdown/keyboard 参数，自动置 msg_type=2（与 content 互斥）
 2026-09-16 19:17:05 +08:00
snowy-yang 7a1b8ac691 docs: 补全使用指南、API 参考、可运行示例与更新日志 2026-09-14 21:05:50 +08:00
snowy-yang 0c364bf803 qqbotsdk: QQ 官方机器人 SDK（协议层/DI/业务 API/测试/文档） 2026-09-11 19:49:17 +08:00