QQbot

把 DeepSeek 接进 QQ 群，让它当一回群友。人格、记忆、群管全部是插件，主体只负责让这些插件在同一张桌子上说话。

作者 西莲寺紫 协议 SnowLuma 内核 AstrBot 3.x 文档更新今天待补 2 节

交给你的 AI

交接文档

把这一整份贴给 AI，它就知道这个项目怎么加插件、什么不能碰。

QQbot 是一个住在 QQ 群里的 AI。主体只负责三件事：连上 QQ、把消息分发给插件、把插件说的话发回去。人格、记忆、群管全部是插件。

所以二次开发基本不用碰主体。你要加的东西，九成是一个插件。

协议层：SnowLuma —— 一个 OneBot 实现，负责登录 QQ、把消息转成标准事件、把回复发回去。

内核：AstrBot 3.x —— 负责事件分发、插件加载、模型调用、会话状态。

换句话说：SnowLuma 管「怎么连上」，AstrBot 管「谁来处理」，你写的东西挂在 AstrBot 上。

待作者补充：插件放在哪个目录、入口函数叫什么、注册方式是什么。

这一节是整份文档最关键的——没有它，AI 也接不上。

待作者补充：消息对象、会话上下文、存储、模型调用的入口分别是什么。

不要绕过主体直接连协议端。登录、重连、心跳这些主体已经管了，插件再连一次会打架。

不要在插件里重复实现主体已有的能力（会话、模型调用、配置读写）。要什么先看主体给不给。

不要在插件里写死上游版本。升级时第一个坏的就是你。

四样：插件本体、权限声明（读消息 / 发消息 / 存数据 / 联网 / 管理权限）、你依赖的上游版本区间、一个联系方式。

缺任何一样，装的人不敢按。

交插件

还没有插件交上来。第一个就是空的，你可以占这个位置。