迪拉熊Bot是一个基于NoneBot2框架开发的复合型群聊机器人,面向舞萌DX玩家提供一站式服务。项目采用插件化架构,功能模块化设计,易于扩展和维护。
普通侧与官B侧
Section titled “普通侧与官B侧”迪拉熊Bot是同一份代码、同一个进程,同时对接两种协议:
- 普通侧:基于OneBot V11协议,连接Lagrange、go-cqhttp等客户端
- 官B侧:基于QQ官方机器人平台适配器,直接对接QQ官方API
早期普通侧(原dxkuma-bot-ob11)与官B侧(原dxkuma-bot-qq)是两个独立仓库、独立部署。2026/8/10两者合并进同一个代码库,dxkuma-bot-ob11与dxkuma-bot-qq均已脱离生产环境,不再是需要分别维护的两个机器人。2026/8/17官B侧功能补齐后,两侧指令集与功能覆盖已经高度一致,触发写法也完全相同:QQ官方机器人平台不再局限于只推送@了Bot的消息(开启了GROUP_MESSAGE_CREATE全量群消息事件),所以官B侧和普通侧一样可以裸文本直接触发指令(如dlx50),不需要先@迪拉熊。少数指令仍受协议本身限制只能单侧使用(例如戳一戳、被动退群回复),会在对应指令文档里单独标注。
- 核心框架:NoneBot2
- 协议:OneBot V11、QQ官方机器人平台
- 数据库:PostgreSQL(
nonebot-plugin-orm) - 对象存储:S3兼容存储(用于图库图片的公网访问)
- 包管理:uv
- 环境要求:Python >= 3.13
迪拉熊Bot采用前后端分离的架构:
- 前端(Bot):负责消息处理、指令解析和用户交互,普通侧与官B侧共用同一套插件逻辑
- 绘图后端(酸橙熊熊):基于.NET的gRPC微服务,负责生成成绩卡片等图片,详见绘图后端简介
- 查分器后端(柠檬熊熊):负责对接落雪与水鱼查分器数据源
项目源码托管在源域Code,采用AGPLv3协议开源。