openteam · 大模型中转站

自托管的 LLM API 中转网关，功能对标 OpenRouter / one-api：统一 OpenAI 与 Anthropic 协议入口，背后对接多个上游渠道，内置用户体系、API Key 管理与用量计费。

规划文档见 PLANNING.md。当前进度：M0（基建）+ M1（用户+密钥+核心代理）已完成。

功能（当前）

• 代理端点（Bearer API Key）
  • POST /v1/chat/completions — OpenAI Chat（非流式 + 流式 SSE）
  • POST /v1/responses — OpenAI Responses API（非流式 + 流式事件）
  • GET /v1/models — 可用模型列表
  • 错误统一为 OpenAI 格式（401/402/404/429/502…）
• 用户体系：注册（开放/邀请码可切换）、登录（JWT access + HttpOnly refresh cookie）、argon2id 密码
• API Key：sk- 48 位 base62，仅存 SHA-256 哈希，明文一次性展示；支持限额/过期/白名单字段
• 用量计费：请求级 usage_logs 异步批量落库，按模型价格扣减余额，日粒度预聚合（usage_daily）
• 管理 API：用户列表/角色/状态/余额调整、系统配置
• 前端：Landing / 登录注册 / 控制台（仪表盘 + 密钥管理 + 用量明细）

快速开始（开发）

前置：Go 1.23+、Node 20+、pnpm。

# 1. 配置（复制并修改，至少设置上游 key）
cp .env.example .env

# 2. 启动后端（SQLite 起步，无需数据库）
cd server && go run ./cmd/server
# 默认管理员 admin / admin123（生产务必修改）

# 3. 启动前端
cd web && pnpm i && pnpm dev   # http://localhost:5173

# 4. 用 mock 上游联调（无需真实 key）
make mock-upstream   # :9000 起一个模拟 OpenAI 服务

冒烟测试（curl）

# 注册 → 登录 → 建 key
curl -s -X POST localhost:8080/api/v1/auth/register -H 'Content-Type: application/json' \
  -d '{"username":"alice","email":"a@b.com","password":"password123"}'
TOKEN=$(curl -s -X POST localhost:8080/api/v1/auth/login -H 'Content-Type: application/json' \
  -d '{"username":"alice","password":"password123"}' | jq -r .data.access_token)
KEY=$(curl -s -X POST localhost:8080/api/v1/keys -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -d '{"name":"dev"}' | jq -r .data.key)

# 对话（非流式 + 流式）
curl -s localhost:8080/v1/chat/completions -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hi"}]}'
curl -sN localhost:8080/v1/chat/completions -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' -d '{"model":"gpt-4o-mini","stream":true,"messages":[{"role":"user","content":"hi"}]}'

生产部署

cp .env.example .env   # 填写 JWT_SECRET / MASTER_KEY / 上游 key
docker compose -f deploy/docker-compose.yml up -d --build

nginx 托管前端静态资源并反代 /api 与 /v1（SSE 关闭缓冲）。

仓库结构

server/    Go 后端（cmd + internal/{api,proxy,channel,usage,store,pkg}）
web/       Vue 3 前端（Vite + Tailwind v4 + Pinia + ECharts）
deploy/    docker-compose / Dockerfile / nginx
scripts/   mock 上游（联调用）
docs/      文档

设计系统（taste-skill）

深色优先的开发者控制台：石墨墨底 + 暖白文本 + 单一信号铜色强调（信号灯意象）；UI 字体 Outfit，数据一律 JetBrains Mono（tabular numerals）。tokens 定义于 web/src/style.css（@theme），支持 data-theme="light" 切换。

路线图

里程碑	状态
M0 基建（结构/配置/DB/工具/CI 前身）	✅
M1 用户 + 密钥 + 核心代理（chat/responses 直通）	✅
M2 用量 + 计费（记账/价格/前端图表）	🟡 后端已备，前端图表就绪
M3 跨协议转换（/v1/messages、Responses↔Chat↔Messages）	⏳
M4 渠道系统（导入/绑定/LB/健康检查/重试）	⏳
M5 充值（暂停，表结构已预留）	⏸
M6 打磨上线（限流/监控/审计/全站复查）	⏳