OneBot V11 协议转换
将 QQ 官方 WebSocket 事件与 HTTP API 转换为 OneBot V11 事件和调用，降低现有机器人框架的迁移成本。
Gensokyo-NewQQQQ 官方机器人 API 到 OneBot V11 的协议网关
连接 QQ 开放平台与 NoneBot2、Koishi 等 OneBot V11 客户端，并集中处理事件转换、ID 映射和消息适配。
Skip to content
Gensokyo 在系统中的位置
text
QQ 开放平台
│ 官方事件与 API
▼
Gensokyo-NewQQ
│ OneBot V11 事件、WebSocket 与 HTTP
▼
NoneBot2 / Koishi / 其他 OneBot V11 客户端Gensokyo-NewQQ 负责协议转换与连接管理。命令解析、插件加载、业务权限和数据存储通常由下游机器人框架负责。
版本说明
本站用于整理主仓库能力和接入路径。QQ 官方平台权限、项目源码和 Release 可能持续变化；涉及具体字段、默认值和行为时，以当前版本自动生成的配置文件、源码和运行日志为准。
推荐阅读顺序
- 阅读项目概览，确认 Gensokyo 与下游框架的职责边界。
- 按快速开始完成机器人注册、下载和首次连接。
- 使用配置指南设置 Intent、WebSocket、HTTP 和 WebUI。
- 在能力矩阵中检索 API、CQ 码和项目扩展能力。
CQ 码转换演练场
在下方输入常见 OneBot CQ 码，查看网页端的解析和预览结果。该演练场用于理解语法，不代表当前 QQ 官方接口一定接受对应消息；实际支持情况请结合能力矩阵和运行版本验证。
GS
Gensokyo BOT
[
{
"type": "cq",
"cqType": "at",
"params": {
"qq": "10001"
}
},
{
"type": "text",
"content": " "
},
{
"type": "cq",
"cqType": "face",
"params": {
"id": "14"
}
},
{
"type": "text",
"content": " 你好，世界！"
}
]