跳转到内容

简介

迪拉熊Bot前端架构简介

迪拉熊Bot是一个基于NoneBot2框架开发的复合型群聊机器人,面向舞萌DX玩家提供一站式服务。项目采用插件化架构,功能模块化设计,易于扩展和维护。

迪拉熊Bot是同一份代码、同一个进程,同时对接两种协议:

  • 普通侧:基于OneBot V11协议,连接Lagrange、go-cqhttp等客户端
  • 官B侧:基于QQ官方机器人平台适配器,直接对接QQ官方API

早期普通侧(原dxkuma-bot-ob11)与官B侧(原dxkuma-bot-qq)是两个独立仓库、独立部署。2026/8/10两者合并进同一个代码库,dxkuma-bot-ob11dxkuma-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协议开源。