Go React TypeScript PostgreSQL License
Bot + Avatar 开放平台 — 让每个 AI 机器人都有自己的虚拟形象
English | 简体中文
UBotHub 是一个面向 AI 机器人生态的开放平台。我们提供从机器人接入、虚拟形象管理到实时交互的全链路基础设施,让开发者可以在几分钟内将自己的聊天机器人与 3D/Live2D 虚拟角色绑定,创造有温度的 AI 交互体验。
无论你是个人开发者、企业客户还是内容创作者,UBotHub 都能让你的 AI 从「纯文字对话」进化为「有形象、有表情、有动作」的虚拟伙伴。
| 能力 | 说明 |
|---|---|
| 一键接入 Bot | 注册平台账号,创建 Bot,获取 Access Token,即可通过 多种渠道 接入你的聊天机器人 |
| 上传虚拟形象 | 支持 VRM、glTF/GLB、FBX(3D)和 Cubism 2/3/4(Live2D)等主流格式 |
| 实时互动 | 用户发送消息 → Bot 回复 → 虚拟形象自动做出对应表情和动作,全程 WebSocket 实时推送 |
| Bot 广场 | 浏览和体验其他开发者创建的 Bot,发现有趣的 AI 角色 |
| 能力 | 说明 |
|---|---|
| 多框架适配 | 原生支持 AstrBot 等主流框架,也支持通用 Webhook |
| 收益变现 | 设置按次计费或订阅制定价,平台 80/20 分成直接结算到你的账户 |
| OpenAPI 文档 | 完整的 Swagger API 文档,集成只需几行代码 |
| 实时监控 | WebSocket 连接状态、消息吞吐量、调用计费一目了然 |
| 优势 | 说明 |
|---|---|
| 差异化定位 | 业内首个「Bot + 虚拟形象」开放平台,解决 AI 交互「只有文字没有形象」的痛点 |
| 开发者生态 | 通过 Bot 广场、收益分成、API 开放能力吸引 Bot 开发者入驻,形成内容飞轮 |
| 技术壁垒 | 自研动作映射引擎、高并发 WebSocket 网关、服务商模式支付体系 |
| 变现能力 | 平台抽成 + 虚拟形象资产交易 + 企业级 SaaS 定制,多元化收入模型 |
| 生产级架构 | 微服务分离部署、断路器容错、异步任务队列、水平扩展能力 |
┌──────────────────────────────────────────────────────────────────┐
│ UBotHub 架构 │
├──────────────┬───────────────────┬───────────────────────────────┤
│ Frontend │ React 19 + Vite │ Glassmorphic Dark UI │
│ │ Tailwind CSS │ Framer Motion 动画 │
│ │ Three.js │ 3D/Live2D 实时渲染 │
├──────────────┼───────────────────┼───────────────────────────────┤
│ API Layer │ Gin Framework │ JWT Auth + RBAC │
│ │ Swagger/OpenAPI │ 52+ 个 RESTful 端点 │
│ │ WebSocket Hub │ 万级并发连接 │
├──────────────┼───────────────────┼───────────────────────────────┤
│ Business │ Bot 管理/网关 │ 适配器工厂模式 │
│ │ 钱包/计费/分成 │ 服务商模式支付(微信/支付宝) │
│ │ 资产/形象管理 │ 动作映射引擎 │
├──────────────┼───────────────────┼───────────────────────────────┤
│ Infra │ PostgreSQL 16 │ GORM + 软删除 │
│ │ Redis 7 │ 缓存 / 限流 / 队列 │
│ │ MinIO / OSS │ S3 兼容对象存储 │
│ │ asynq │ 异步任务(邮件/资产处理) │
│ │ Docker Compose │ 生产 / 调试双环境部署 │
└──────────────┴───────────────────┴───────────────────────────────┘
- Go 1.25+
- Node.js 22+ (LTS)
- pnpm 9+
- Docker & Docker Compose
# 克隆仓库 git clone git@github.com:NickCharlie/ubothub.git cd ubothub # 启动基础设施(PostgreSQL, Redis, MinIO, asynqmon) make docker-up # 终端 1:启动后端(air 热重载) make dev-backend # 终端 2:启动前端(Vite HMR) make dev-frontend
# 一键启动全栈(含热重载 + Delve 远程调试) make docker-debug-up # 查看日志 make docker-debug-logs
# 配置环境变量 cp .env.example .env vim .env # 构建并启动(多阶段构建 + nginx 前端 + API/Worker 分离) make docker-prod-up
| 服务 | 本地开发 | Docker 调试 |
|---|---|---|
| 前端 | http://localhost:5173 | http://localhost:5173 |
| 后端 API | http://localhost:8080/api/v1 | http://localhost:8080/api/v1 |
| Swagger 文档 | http://localhost:8080/swagger/index.html | 同左 |
| MinIO 控制台 | http://localhost:9001 | http://localhost:9001 |
| asynqmon | http://localhost:8081 | http://localhost:8081 |
| Delve 调试 | — | localhost:2345 |
ubothub/
├── backend/ # Go 后端服务
│ ├── cmd/server/ # 应用入口(API / Worker / All 模式)
│ ├── internal/
│ │ ├── adapter/ # Bot 框架适配器(AstrBot, Webhook)
│ │ ├── config/ # 配置管理(Viper + 环境变量)
│ │ ├── handler/ # HTTP 处理器(12 个模块)
│ │ ├── middleware/ # 中间件(JWT, CORS, CSRF, 限流, 安全头)
│ │ ├── model/ # GORM 数据模型
│ │ ├── payment/ # 支付集成(微信/支付宝服务商模式)
│ │ ├── repository/ # 数据访问层
│ │ ├── router/ # 路由注册
│ │ ├── service/ # 业务逻辑层
│ │ ├── ws/ # WebSocket Hub(gorilla/websocket)
│ │ └── queue/ # 异步任务处理器
│ ├── pkg/ # 公共工具(JWT, 日志, 邮件, HTTP 连接池)
│ ├── configs/ # 配置文件(开发/调试/生产)
│ └── docs/ # Swagger 自动生成文档
├── frontend/ # React 前端
│ └── src/
│ ├── api/ # API 客户端
│ ├── components/ # 通用组件(Layout, Sidebar)
│ ├── pages/ # 页面(Auth, Dashboard, Bot, Avatar, Asset)
│ ├── stores/ # Zustand 状态管理
│ └── styles/ # 全局样式 + Glassmorphic 设计系统
├── .github/ # CI/CD(Commit Lint + AI Issue Triage)
├── docker-compose.yml # 本地基础设施
├── docker-compose.debug.yml # Docker 调试环境
├── docker-compose.prod.yml # Docker 生产环境
└── Makefile # 开发/构建/部署命令
启动后端后访问 Swagger UI:
http://localhost:8080/swagger/index.html
覆盖 52+ 个 API 端点,包括:认证、用户、Bot 管理、资产管理、虚拟形象、钱包计费、支付、网关、WebSocket、管理后台。
- 用户认证系统(JWT + 邮箱验证 + 密码重置)
- Bot 管理与网关(CRUD + Webhook + 消息推送)
- 3D/Live2D 资产与虚拟形象管理
- 钱包、计费、收益分成系统
- 微信/支付宝服务商模式支付
- WebSocket 实时消息网关
- 管理后台 API
- Swagger/OpenAPI 文档
- Docker 多环境部署(开发/调试/生产)
- 前端 Bot 广场与聊天界面
- 3D/Live2D 实时渲染引擎
- 官方支付分账 API 集成
- 创作者提现系统
- 管理后台前端
欢迎提交 Pull Request!请阅读 CONTRIBUTING.md 了解开发规范和提交约定。
本项目基于 PolyForm Noncommercial 1.0.0 许可证开源。
如发现安全漏洞,请参阅 SECURITY.md 进行负责任的披露。