官机框架2.0：QQ机器人多用户管理平台（开源半成品）

前言

今天分享一个QQ机器人管理平台——官机框架2.0。这是一个基于 PHP + SQLite 的多用户SaaS平台，可以同时托管多个QQ机器人的回调服务。

⚠️ 本项目为半成品状态，不再继续开发，源码仅供参考学习。

项目来源

版本 作者 说明
原版 change-nx Cucko
二开（官机框架2.0） 富贵 单用户版
三开（本仓库） xbail 多用户商业化改造

基于富贵的官机框架2.0二次开发，将其从单用户改造为多用户商业化SaaS平台。

功能特性

  • 多用户系统 — 注册/登录，管理员可管理所有用户
  • 机器人管理 — 添加/删除机器人，自动获取机器人名称和头像
  • 回调服务 — 统一的Webhook入口，分发到各机器人的插件目录
  • 会员体系 — 卡密充值余额，余额购买机器人使用权（按月计费）
  • 插件系统 — 在线编辑插件代码，支持启用/禁用，插件热加载
  • 后台管理 — 用户管理、卡密管理、定价设置、系统配置
  • 白色主题UI — 响应式设计，支持移动端访问

技术栈

  • 后端: PHP 7.4+（纯原生，无框架依赖）
  • 数据库: SQLite3
  • 前端: HTML + CSS + Vanilla JavaScript
  • CDN: BootCDN（国内加速）

目录结构

├── admin/              # 后台管理界面
│   ├── api/            # API 接口
│   ├── assets/         # 共享 CSS/JS
│   ├── inc/            # 核心模块（数据库、用户认证）
│   ├── index.php       # 登录页
│   ├── main.php        # 用户中心
│   ├── admin.php       # 管理员后台
│   ├── plugin.php      # 插件管理
│   ├── users.php       # 用户管理
│   ├── cardkeys.php    # 卡密管理
│   ├── settings.php    # 系统设置
│   └── chat.php        # 对话日志
├── function/           # 工具库（图片处理、邮件、二维码等）
├── plugin/             # 插件目录
├── index.php           # 首页
├── docs.php            # 文档页
├── bot.php             # 机器人 API 入口
├── function.php        # 函数库
└── webhook.php         # Webhook 回调入口

使用方法

  1. 将源码部署到支持PHP的Web服务器
  2. 确保 data/ 目录可写（SQLite数据库自动创建）
  3. 访问站点，首次运行自动创建默认管理员账号
  4. 默认管理员：admin / admin123（登录后请立即修改密码）

注意事项

  • 需要PHP 7.4+且启用SQLite3扩展
  • data/ 目录需要Web服务器写入权限
  • 本项目为半成品，仅供学习参考

总结

这个框架虽然没做完，但已经实现了核心的多用户管理和插件系统。对于想学习PHP开发或者QQ机器人开发的朋友，可以参考一下架构设计。

源码已开源在GitHub：xbail/qqbot