小白菜QQ云端机器人系统源码专业版（多框架集成版）

本套QQ机器人管理系统源码基于PHP8.1+Workerman框架开发，采用分布式架构设计。源码包内集成主流机器人框架对接模块与多实例管理功能，支持单服务器承载50+机器人实例并发运行（8核16G配置），适用于搭建群管机器人服务平台。

核心功能模块说明：

1. 多框架对接系统

• 支持框架清单：
  ▸ 小栗子框架（XLR2023协议）
  ▸ MYQQ框架（APIv5接口）
  ▸ MYQQA框架（WebSocket协议）
  ▸ 预留扩展接口（可对接新框架）

• 连接管理特性：
  ▸ 多实例隔离（Docker容器化部署）
  ▸ 心跳保活机制（30秒间隔检测）
  ▸ 异常自动重启（最大重试5次）

2. 分布式部署架构

• 节点管理模块：
  ▸ 主控节点：负责任务调度与负载均衡
  ▸ 工作节点：执行具体机器人任务
  ▸ 注册中心：Nacos 2.2服务发现

• 网络通信方案：
  ▸ 内部通信：gRPC协议（HTTP/2长连接）
  ▸ 外部API：RESTful接口（JWT鉴权）

3. 商业运营支持

• 分站管理系统：
  ▸ 泛解析支持（*.domain.com）
  ▸ 独立计费系统（按日/月/年结算）
  ▸ 价格策略配置（阶梯定价模板）

• 用户控制面板：
  ▸ QQ快捷登录（OAuth2.0协议）
  ▸ 机器人状态监控（实时CPU/内存数据）
  ▸ 消息日志查询（保留30天记录）

部署环境要求：
▌服务器基础配置

• Web服务：Nginx 1.22+（需配置SSL证书）

  nginx复制# 伪静态规则示例location / {    if (!-e $request_filename){        rewrite ^(.*)$ /index.php?s=$1 last;
      }
  }

• PHP环境：8.1.0-8.2.12
  ▸ 必须扩展：sockets/pcntl/redis
  ▸ 建议扩展：swoole（提升并发性能）

▌数据库配置

• MySQL 8.0.32+（InnoDB引擎）
  ▸ 建议配置：

  ini复制innodb_buffer_pool_size = 2Gmax_connections = 1000

• Redis 7.0.11+（集群模式建议3主3从）

安装配置流程：

1. 源码部署

bash复制unzip qqbot.zip -d /var/www/htmlchown -R www-data:www-data /var/www/html/runtimechmod 755 /var/www/html/install

2. 数据库初始化

sql复制CREATE DATABASE `qqbot` DEFAULT CHARSET=utf8mb4;
USE qqbot;
SOURCE /var/www/html/install/init.sql;

3. 框架对接配置
   修改/config/framework.php：

php复制return [    'xiao_lizi' => [        'api_key' => 'your_api_key',        'endpoint' => 'ws://127.0.0.1:8080'
    ],    'myqq' => [        'auth_key' => 'md5_hash_value',        'callback_url' => 'http://domain.com/callback'
    ]
];

系统管理功能：

• 机器人监控看板：
  ▸ 实时消息吞吐量（条/秒）
  ▸ 资源占用排行榜（CPU/MEM）
  ▸ 异常报警通知（钉钉/企业微信）

• 日志分析系统：
  ▸ 消息类型分布（文字/图片/文件）
  ▸ 高频词统计（词云展示）
  ▸ 用户行为分析（活跃时段统计）

二次开发支持：

1. 插件扩展接口

• 消息处理插件：
  ▸ 继承BasePlugin抽象类
  ▸ 实现onMessage方法
  ▸ 注册到/plugins目录

• 支付渠道扩展：
  ▸ 微信支付V3接口
  ▸ 支付宝当面付SDK
  ▸ USDT-TRC20协议

2. API接口文档

• 机器人控制接口：

  http复制POST /api/v1/bot/{bid}/sendContent-Type: application/json
  {
      "message_type": "text",
      "content": "Hello World"
  }

• 用户管理接口：

  http复制GET /api/v1/users?page=1&limit=50Authorization: Bearer {jwt_token}