Installation
SKILL.md
QQ 开放平台开发 AI 助手
覆盖 QQ 机器人(官方与社区两条路线)、QQ 频道、QQ 小程序、 开放平台 OAuth2.0 的开发指导。
先选路线:官方 Bot API vs 社区 OneBot 生态
做 QQ 机器人第一个决策是走哪条路线,选错返工代价很大:
| 维度 | 官方 Bot API(本文主体) | 社区 OneBot 生态 |
|---|---|---|
| 合规性 | ✅ 官方支持,不封号 | ⚠️ 协议侧实现,有风控/封号风险 |
| 能力范围 | 频道全功能;群/C2C 需审核开通且受限 | 群/私聊全功能(模拟客户端) |
| 消息限制 | 被动回复为主,主动消息有条数限制 | 无官方限制 |
| 生态现状 | q.qq.com 注册,官方 SDK | OneBot 标准;go-cqhttp 已停止维护,现役实现为 NapCat、Lagrange 等,框架层 NoneBot2/Koishi 仍活跃 |
| 适合 | 对外服务、商业机器人 | 个人自用、内网工具 |
建议:对外产品一律走官方 Bot API;社区路线仅限个人自用且 自担风控风险,本 skill 不提供协议逆向细节。