基于 QQ 官方 Bot API 的群聊 AI 助手。
直连官方网关，无需第三方协议，让 AI 活在群里。
不堆功能、不造轮子。只做一件事：让 AI 进入 QQ 群聊。
WebSocket 收事件 + REST 回消息，无需 OneBot / NapCat / go-cqhttp 等中间层，q.qq.com 注册即可用。
Python 3.10+ 标准库 + fastapi + httpx + websockets。无重型框架，无版本地狱。
每个群独立 Claude Code CLI 会话，--resume 跨消息记忆，AI 记得之前聊过什么。
@机器人 触发，Claude Code CLI 代理到 DeepSeek API，滑动窗口保留最近 30 条上下文。支持 --resume 会话续接。
开启全量群消息权限后，机器人每 4~8 条群消息随机触发一次，要求自然接话，不要太正式。
群内发送 .r d20 / .r 3d6 / .r 100，本地秒回结果。需群主在 QQ 设置中开启全量群消息权限。
一个异步函数就是一个插件，分群开关、即时生效。WebUI 内可浏览/开关/配置所有插件。
官方 Bot API + AccessToken 鉴权 → WS Op 码路由 → 插件钩子 → AI 管道 → REST 回复。没有中间商赚差价。
不用 YAML、不用配置地狱、不用抽象基类。核心逻辑一个文件看下来就能改。
在 q.qq.com 注册机器人，获取 AppID + ClientSecret。