# 项目进度追踪

> 最后更新: 2026-08-23

## 服务运行状态

| 服务 | 节点 | 状态 | 说明 |
|------|------|------|------|
| Nginx | 美国服务器（待申请） | ⏳ 未部署 | HTTPS 反向代理层 |
| LobeChat | 美国服务器（待申请） | ⏳ 未部署 | 前端对话界面 |
| One-API | 美国服务器（待申请） | ⏳ 未部署 | 网关聚合层 |
| MySQL | 美国服务器（待申请） | ⏳ 未部署 | One-API 数据存储 |

## 2026-08-23 项目启动：文档入库 + 仓库初始化

- **决策**：采用成熟开源组件（Nginx + LobeChat + One-API + MySQL）容器化搭建，不重复造轮子；网关对外统一暴露 `auto-vision` / `auto-text` 两个聚合模型名。
- **文档**：`docs/01-软件需求文档-SRS.md`（V1.0）+ `docs/02-软件设计文档-SDD.md`（V1.0）入库；README 汇总架构/服务器访问信息/提交规范。
- **安全**：Gemini 与 NVIDIA 的旧 API Key 不写入仓库（将申请新值）；所有 Key 计划通过服务器 `.env` 管理（已加入 .gitignore）。
- **仓库**：本地初始化，推送 Gitea `http://192.168.50.64:3000/ericwyuan/NexusAI`。

## 任务进度

### 已完成

| # | 任务 | 日期 |
|---|------|------|
| 1 | 软件需求文档（SRS V1.0）入库 | 2026-08-23 |
| 2 | 软件设计文档（SDD V1.0）入库 | 2026-08-23 |
| 3 | README（架构/服务器信息/提交规范） | 2026-08-23 |
| 4 | 仓库初始化 + 推送 Gitea | 2026-08-23 |

### 待完成

| # | 任务 | 依赖 | 优先级 |
|---|------|------|--------|
| 1 | 申请美国服务器（网关部署目标） | - | 高 |
| 2 | 申请新 Gemini / NVIDIA API Key | - | 高 |
| 3 | 生成部署骨架（docker-compose.yml / nginx.conf / .env.example） | 文档 | 高 |
| 4 | 实际部署 + One-API 渠道配置（5 家）+ Failover 验证 | 服务器/Key | 高 |
| 5 | HTTPS 域名与证书 | 服务器 | 中 |
| 6 | 确认 Server-Side 模式 / 管理端口访问方式 / 监控方案 | 决策 | 中 |

## 技术决策记录

1. **不重复造轮子** - 网关用 One-API、前端用 LobeChat，仅做配置层工作；前端、网关、各 AI 渠道间均走 OpenAI 兼容接口，任一组件可替换
2. **模型映射** - 前端只感知 `auto-vision`（图文）与 `auto-text`（纯文本）两个聚合模型名，多渠道不同模型映射到统一对外模型名
3. **优先级路由** - 渠道优先级数字越小越优先，同优先级内按权重轮询分摊负载
4. **冷却恢复** - 渠道连续失败超阈值（5 次/5 分钟）进入冷却禁用，冷却期（10 分钟）后自动恢复参与路由
5. **最小暴露面** - 仅 Nginx 80/443 对公网暴露，One-API 后台与 MySQL 端口仅容器内网可访问