Skip to content

关于适配器

AuroraBot 基于 NoneBot2,当前通过 NapCat + OneBot v11 协议连接 QQ。

NapCat

NapCatQQ 是基于 NTQQ 的 Bot 协议端实现,运行环境支持:

部署方式适用场景说明
Windows 原生桌面 / 笔记本直接运行 exe,支持 LiteLoader 插件方式
Linux AppImage物理机 / VPS单文件运行,无需安装依赖
Linux 原生物理机 / VPS放入 QQ 安装目录运行
Docker服务器 (推荐)支持无头模式,内存占用极低,纯服务器环境无需桌面运行
macOSMac 用户原生支持
Android Termux移动端在安卓终端中运行

无头模式

NapCat 的无头模式 (headless) 不需要启动 QQ 图形界面即可在服务器上运行,资源占用极低,适合 Linux 服务器部署。

协议层面,NapCat 实现了 OneBot v11 标准协议。

NoneBot2 适配器

NoneBot2 采用适配器模式:框架核心平台无关,通过各种适配器连接不同平台。

适配器对应平台成熟度
nonebot-adapter-onebot v11QQ (NapCat / go-cqhttp / Shamrock 等)非常成熟
nonebot-adapter-onebot v12多平台统一标准稳定
nonebot-adapter-telegramTelegram成熟
nonebot-adapter-discordDiscord成熟
nonebot-adapter-qqQQ 官方 Bot API稳定
nonebot-adapter-qqguildQQ 频道稳定
nonebot-adapter-feishu飞书稳定
nonebot-adapter-dingtalk钉钉稳定
nonebot-adapter-kaiheilaKOOK (开黑啦)稳定
nonebot-adapter-redRed 协议社区维护

目前 NoneBot2 生态已有 20+ 平台适配器500+ 社区插件

NoneBot2 还提供多种通信驱动:FastAPIHTTPXWebSocket 等,AuroraBot 当前使用 ~fastapi 驱动。

当前状态

AuroraBot 目前仅加载 nonebot-adapter-onebot。虽然 NoneBot2 支持 20+ 平台,但 AuroraBot 尚未为其他平台编写对应的 App,也未加载其他适配器。

组件能力当前使用
NapCatWindows / Linux / macOS / Docker✅ 推荐协议端
NoneBot220+ 平台适配器仅加载 onebot v11
OneBot 协议多种实现可互换NapCat

Built with VitePress