UniAI 是基于 CoAI 深度二次开发的全栈 AIGC 平台，定位为“可商用的多模型聚合 + 用户端聊天应用 + 管理后台 + OpenAI 兼容 API 网关”。

• 面向站长和团队：统一管理多家模型供应商与计费策略。
• 面向终端用户：提供完整聊天、预设、翻译、分享、订阅等前台体验。
• 面向开发者：提供 OpenAI 兼容接口，便于已有客户端快速接入。

• 多模型统一接入：OpenAI、Claude、Gemini、Midjourney、DeepSeek、Azure OpenAI 等。
• OpenAI 兼容中转：支持 /v1/chat/completions、/v1/images/generations、/v1/models 等。
• 渠道调度与负载：优先级、权重、失败重试、模型映射、分组可用性控制。
• 会话增强：会话分享、会话文件夹、拖拽排序、时间轴收藏（Starred Timeline）。
• 翻译工作台：独立 /translate 页面，支持模型翻译、历史记录、可配置系统提示词。
• Mini Apps 入口：/apps 聚合扩展工具入口。
• 管理后台：用户管理、渠道管理、订阅管理、公告广播、日志与分析仪表盘。
• 计费体系：点数计费 + 订阅计划并存。
• 文件解析能力：可对接 blob-service 处理 PDF/Office/图片/OCR/音频等。
• 多端支持：Web、PWA，保留 Tauri 桌面端工程。

• 前端：React 18 + TypeScript + Vite + Redux Toolkit + Tailwind + Radix UI
• 后端：Go + Gin + MySQL + Redis
• 通信：REST + SSE + WebSocket

• Go 1.20+
• Node.js 18+
• pnpm 8+
• MySQL 5.7+（或 8.x）
• Redis 6+

在项目根目录准备配置文件：

cp config.example.yaml config.yaml

至少确认以下配置可连接：

mysql:
  host: localhost
  port: 3306
  user: root
  password: your-password
  db: chatnio

redis:
  host: localhost
  port: 6379

开发模式推荐：

serve_static: false
server:
  port: 8094

go mod tidy
go run .

或使用热更新：

air

cd app
pnpm install
pnpm dev

默认访问地址：

• 前端：http://localhost:5173
• 后端：http://localhost:8094

当数据库为空时，系统会自动创建：

• 用户名：root
• 密码：chatnio123456

首次登录后请立即修改密码。

cd blob-service
pip install -r requirements.txt
uvicorn main:app --port 18432

然后在系统设置中把 Blob 地址配置为对应服务地址。

仓库提供 start-dev.bat，会尝试：

• 启动 Docker 容器 coai-dev-mysql、coai-dev-redis
• 启动 Blob Service
• 启动后端 air
• 启动前端 pnpm dev

如果你本地容器名不同，请先修改脚本中的容器名。

# 构建前端
cd app
pnpm install
pnpm build

# 构建后端
cd ..
go build -o uniai

# 运行
./uniai

建议通过环境变量覆盖生产配置（如 MYSQL_HOST、REDIS_HOST、SECRET、SERVE_STATIC）。

仓库包含 docker-compose.yaml / docker-compose.stable.yaml，可快速拉起 MySQL、Redis 和镜像服务。

注意：Compose 默认镜像为上游 programzmh/chatnio，如果你要部署 UniAI 的最新二开代码，请改为你自己的镜像。

后端会根据 serve_static 决定路由前缀：

• serve_static: true：接口前缀为 /api（例如 /api/login、/api/v1/models）
• serve_static: false：接口无 /api 前缀（例如 /login、/v1/models）

• 认证：POST /login、POST /register、GET /userinfo
• 对话：GET /chat（WebSocket）
• OpenAI 兼容：POST /v1/chat/completions、POST /v1/images/generations、GET /v1/models
• 会话管理：/conversation/list、/conversation/share、/conversation/folders、/conversation/move
• 管理后台：/admin/user/*、/admin/analytics/*、/admin/logger/*

app/                  前端工程
adapter/              模型适配层
auth/                 鉴权与计费
channel/              渠道调度与路由策略
manager/              对话与模型业务入口
manager/conversation/ 会话、分享、收藏、文件夹
admin/                后台管理接口
addition/             扩展功能（搜索/生成等）
blob-service/         文件解析服务（可选）
config.example.yaml   配置模板
main.go               服务入口

• 品牌改造：优先修改 app/src/conf/env.ts 中默认 appName 等站点配置。
• 新模型接入：在 adapter/ 新增厂商适配并在路由/分发处注册。
• 计费策略改造：重点看 auth/quota.go、manager/chat.go。
• 前端功能扩展：重点看 app/src/routes、app/src/components、app/src/store。

• 上游项目：CoAI / ChatNio
• 开源协议：Apache-2.0

基于开源协议进行二次开发时，请保留必要的版权与协议声明。