轻量级 OpenAI 账号稳定调度后台。
让 Codex、OpenAI SDK、Cherry Studio、NextChat 等客户端固定一个/v1入口，把多账号、高并发调度、授权、审计和排障收进一个本地后台。
聚合 AI 解决的不是“再转发一次请求”，而是把 OpenAI 账号池变成一套 可管理、可授权、可观测、可恢复 的稳定服务。
客户端只需要一组配置：
Base URL: http://你的服务器:3000/v1
API Key : 聚合 AI 后台生成的本地 sk-... 密钥
OpenAI OAuth、OpenAI API Key、代理、分组、额度、高并发策略、失败切换、统计和审计都留在后台。账号换了、限流了、过期了、代理波动了，客户端尽量不用跟着改。
很多 OpenAI 中转只解决“能不能转发”。真正用起来，更麻烦的是这些事：
- 客户端里散落着上游 Key，换账号就要到处改。
- 多个 OpenAI 账号靠人工记状态，哪个限流、哪个到期、哪个代理慢，很难看清。
- 多人共享账号池时，权限、额度、分组和用量容易混在一起。
- Codex / OpenAI-compatible 客户端遇到断流、EOF、429 或上游异常时，很难判断问题来自客户端、网关、代理还是上游账号。
- 出问题后只有几行运行日志，缺少请求、账号命中、Token、耗时、错误摘要和原始链路审计。
聚合 AI 的重点是：让客户端入口稳定，让账号池后台可控，让故障链路查得明白。
| 能力 | 聚合 AI 怎么做 |
|---|---|
| 固定入口 | 客户端长期连接同一个根路径或 /v1，不用感知后台账号变化 |
| 账号池调度 | 按分组、授权、状态、并发、优先级、冷却、到期、代理和质量选择账号 |
| 高并发分组 | 个人分组保持稳定亲和，高并发分组支持软并发、分组短队列、每 Key 队列和可选单 IP 保护 |
| 双账号形态 | 同时支持 OpenAI OAuth 账号和 OpenAI API Key 账号 |
| 流式稳定 | 按 SSE 事件和可见输出边界处理失败，避免盲目重试破坏客户端状态 |
| 统一授权 | 系统账户、系统团队、AI 账户、分组和 API Key 形成清晰使用边界 |
| 可观测排障 | 使用记录、统计趋势、AI 性能、模型检测、运行日志、操作日志和原始审计分层追踪 |
| 轻量部署 | Node.js + SQLite 即可运行，不强制 Redis、Kafka 或 PostgreSQL |
普通中转更像一根管道：把客户端请求送到上游。
聚合 AI 更像一个账号稳定层：
- 上游凭据不散落：客户端拿本地 API Key，上游 OAuth token 和 OpenAI API Key 留在后台。
- 账号池不是轮询表：账号启停、代理、优先级、冷却、到期、错误策略和复测恢复都进入管理闭环。
- 授权不是发一个 Key 就完事：分组承接账号池，API Key 可绑定一个或多个调用方自有分组号池，用户和团队通过统一授权获得使用权。
- 失败不是只看状态码：请求异常、上游错误、未知失败、流式中断和 Codex 客户端策略分层处理。
- 排障不是猜：从使用记录到原始审计，可以追到哪个客户端、哪个 Key、哪个分组、哪个账号、哪个上游响应。
- OpenAI OAuth 账号、OpenAI API Key 账号统一管理。
- 支持账号启停、优先级、并发、代理、到期时间、冷却和错误策略。
- API Key 可绑定一个或多个调用方自有分组号池，并按优先级路由到可承接账号池，请求进入后自动选择可调度账号。
- 支持个人分组和高并发分组；高并发分组可配置最大单账户排队阈值、最大等待时间和单 IP 并发保护。
- OAuth token 支持请求前懒刷新和后台 worker 保活。
- 支持系统账户、系统团队和普通用户侧资源视图。
- AI 账户或分组可以授权给用户 / 团队使用。
- 授权只传递使用权，不暴露上游凭据管理权。
- 支持 API Key 和统一授权维度的本地额度控制与消耗统计。
- 支持 OpenAI 兼容协议透传和 SSE 流式响应。
- 流式失败按可见输出边界处理，减少重复输出、工具调用错乱和上下文分叉。
- 使用记录保存模型、Token、成本估算、耗时、错误摘要和账号命中。
- 模型检测复用本地网关链路，对 AI 账户执行可信度诊断，并保存脱敏、有界摘要。
- 原始审计记录客户端请求、网关处理、上游请求、上游响应和最终返回，便于定位复杂问题。
- Vue 3 + TypeScript + Ant Design Vue 中文管理后台。
- SQLite 本地存储，按业务库、统计数据集域和统计结果库三类职责拆分；统计数据集域由数据集目录库和 usage shard 文件组成，默认适合单机、小服务器、家用主机或轻量云主机。
- Web/网关主进程、background worker、本地 DB service 分离，减少统计、日志和高频 SQLite 访问对主链路的影响。
- 想给 Codex、OpenAI SDK 或 OpenAI-compatible 客户端提供稳定入口的个人用户。
- 有多个 OpenAI 账号，需要统一调度、代理、分组和排障的小团队。
- 想把上游 Key 收回后台，只给成员发本地 API Key 的工作室。
- 需要查看 Token、成本、耗时、错误、账号命中和原始链路的运维者。
- 想轻量部署，不想先搭 Redis、Kafka、PostgreSQL 和复杂网关集群的人。
- 你需要全供应商、多模型、充值支付和公开售卖平台。
- 你需要多实例分布式网关、跨机房队列或强一致计费系统。
- 你希望一个项目同时深度覆盖 OpenAI、Claude、Gemini、Realtime、支付、工单和渠道市场。
聚合 AI 当前选择更窄的路线：聚焦 OpenAI 账号接入、OpenAI 兼容网关、账号池调度、统一授权、统计审计和排障闭环。
环境要求：
- Node.js 官方 LTS：
22.x >= 22.13.0或24.x >= 24.11.0，且内置 SQLite 支持 FTS5 - pnpm
>= 9.0.0 - Windows 推荐使用 PowerShell 7
在项目根目录执行：
pnpm install
Copy-Item backend/.env.example backend/.env
Copy-Item frontend/.env.example frontend/.env
pnpm dev启动后访问：
- 管理后台：
http://127.0.0.1:5173/__aisys__/ - 后端系统 API：
http://127.0.0.1:3000/__aisys__/api - OpenAI 兼容入口：
http://127.0.0.1:3000/v1
默认超级管理员：
用户名：admin
密码：admin
首次登录后请立刻修改默认密码；未修改前只能访问当前用户、修改密码和退出登录接口，其他受保护 API 会被后端拦截。
- 登录后台。
- 在
AI 账户管理或我的 AI 账户添加 OpenAI OAuth 账号或 OpenAI API Key 账号。 - 在
API Key 管理或我的 API Key创建一个本地 API Key，并绑定一个或多个可用分组号池。 - 在客户端里填写：
Base URL: http://127.0.0.1:3000/v1
API Key : `API Key 管理` 或 `我的 API Key` 页面生成的本地 sk-... 密钥
注意：客户端填写的是聚合 AI 生成的本地 API Key，不是上游 OpenAI API Key。
Docker 单容器启动：
pnpm install
pnpm build
Set-Location docker
docker compose up -d --build启动后访问：
http://localhost:3000/__aisys__/
需要改端口、公网访问地址或复用旧数据时，复制并修改 docker/.env.example 为 docker/.env。完整说明见 Docker 部署指南。
发布包部署：
先在构建机器打包：
pnpm install
pnpm package:release:windows会生成：
release/juhe-ai-release.zip
release/juhe-ai-release.tar.gz
部署到 Windows：
Expand-Archive .\juhe-ai-release.zip -DestinationPath . -Force
Set-Location .\juhe-ai-release
pwsh .\start.ps1部署到 macOS / Linux：
tar -xzf juhe-ai-release.tar.gz
cd juhe-ai-release
bash ./start.sh启动后访问：
http://服务器IP:3000/__aisys__/
公网访问、反向代理、端口调整、开机自启和数据迁移见 部署指南。
# 开发启动
pnpm dev
# 类型检查
pnpm typecheck
# 构建
pnpm build
# 打包发布包
pnpm package:release:windows
# 真实网关烟测
pnpm test:smoke- 前端：Vue 3 + TypeScript + Vite + Ant Design Vue + ECharts
- 后端：Node.js + TypeScript + Express + Zod
- 存储：SQLite（
node:sqlite） - 日志：Pino + SQLite 搜索索引
- 包管理：pnpm workspace
- 开发安装说明
- 开发运行说明
- 测试与验证说明
- 构建指南
- 部署指南
- Docker 部署指南
- 整体架构
- 核心功能设计
- 高并发分组调度设计
- 模型检测设计
- 客户端稳定性竞品对比
- SQLite 存储说明
- 接口契约与权限矩阵
- 当前主要支持 OpenAI 供应商，其他供应商保留扩展空间。
- 当前定位是单机轻量部署，不默认引入 Redis、Kafka 或分布式任务队列。
- 默认使用 SQLite，业务库、数据集目录库、usage shard 目录和统计结果库位于
backend/data/；当前运行时只使用这四类存储入口。 - 管理后台和网关由同一个后端服务承载，前端静态资源在发布包中由后端托管。
- 当前已支持受保护的公开接口来源授权、公益站 IP 聚合读取、IP 管理和管理员封禁；暂不包含公益站用户维度榜单快照、公益站公网访问拦截、公益站用户 / IP 归属。
- 本项目不是支付平台、公开售卖平台或全供应商多模型资产平台；它优先服务 OpenAI 账号池稳定调度和可观测运维。
如果这个项目对你有帮助，欢迎点一个 Star：