设计文档
one-api 采用分期开发，每期有独立的设计文档（spec）与实现计划（plan）。本页是设计资料的索引。
总览
- 设计总览 — 定位、核心决策、数据库设计、技术栈选型。
各期设计
| Phase | 主题 | 设计文档 |
|---|---|---|
| 1 | shared + engine（纯逻辑数据引擎） | spec |
| 2 | HTTP API 服务（apps/server） | spec |
| 3 | 管理界面（apps/web） | spec |
| 4 | MCP 服务（/mcp） | spec |
| 5 | SDK + CLI | spec |
| 6 | 生态分发 | spec |
分期依赖
Phase 1（shared+engine）——地基
↑
Phase 2（server HTTP） ← Phase 3（web 管理界面）
↑
Phase 4（MCP，依赖 Phase 1+2）
Phase 5（SDK+CLI，依赖 Phase 1+2）
Phase 6（分发，依赖 Phase 1+5）每期独立 spec → plan → 实现 → review，可独立交付验证，不跨期并行实现。
实现计划
每个 spec 对应一份 TDD 小步骤的实现计划（plan），见仓库 docs/superpowers/plans/。