# 项目进度追踪

## 当前阶段：P0 — 全局优化

### Phase 1-3 — 全部完成 ✅

### P0 — 全局优化（当前阶段）
| 子项 | 说明 | 状态 |
|------|------|------|
| **P0a** | i18n 基础设施 + 翻译文件 + LanguageProvider + useT hook | ✅ 完成 |
| **P0b** | UI 统一 — Design Token + 共享组件库 | ⏳ 待开始 |
| **P0c** | 逐页翻译 + 语言切换 | ⏳ 待开始 |
| **P0d** | 会员定价页重构（用量可视化） | ⏳ 待开始 |
| **P0e** | 模型选择器升级（卡片式 + 能力标签） | ⏳ 待开始 |
| **P0f** | 会话分享链接 | ⏳ 待开始 |

### 参考来源
- opencode 源码克隆到 `/tmp/opencode-source/`（21 packages, 147MB）
- 关键参考模块: `packages/plugin`（hooks + tool 系统）、`packages/ui/i18n/`（20+ 语言）、`packages/llm`（provider 接口）

### 新页面
- `/learning/analytics` — 学情分析看板（对话分析→知识图谱→薄弱环节→推荐）
- `/learning/path` — 分阶段学习路径（4 阶段 12 任务，自动追踪完成进度）
- `/my` 首页添加了学情分析和学习路径入口链接

### 验证
- 后端 13 suites / 92 tests passed ✅
- 前端 60 页面构建无报错 ✅

### 今日修复项（2026-05-15）

#### 颜色约定修复（18 个文件）
- `page.tsx`（首页）、`dashboard/page.tsx`、`my/*`（4 个）、`models/page.tsx`
- `discover/*`（3 个）、`circles/*`（2 个）、`admin/*`（2 个）
- `courses/[id]/client.tsx`、`contents/[id]/client.tsx`
- `sandbox/compare/page.tsx`、`sandbox/code/page.tsx`
- 全部替换 `text-gray-*`/`bg-gray-*`/`border-gray-*` → CSS 变量

#### 模型列表统一
- 新建 `frontend/src/lib/models.ts` — 单数据源
- `sandbox/page.tsx`、`sandbox/compare/page.tsx`、`prompts/workshop/page.tsx` 统一导入

#### 对比实验室增强
- 修复硬编码颜色、更新 model ID 为后端支持的值
- 新增参数调节面板（temperature/top-p/max-tokens）

#### 清理
- 删除根目录 9 个残留文件（next-dev*.log、PROGRESS_FINAL* 等）
- 删除 `backend/src/e2e.spec.ts` 占位符

### 关键决策
- `frontend/src/lib/models.ts` 作为模型列表单数据源
- 所有颜色使用 CSS 变量（`text-foreground`/`text-muted-foreground`/`bg-card`/`bg-muted`/`border-border`）
- `nest build` 正常产出（`--tsc` 遗漏 prisma 模块）
- 沙盒 JWT 认证保留

### 相关文件
- `backend/src/modules/learning/` — 学习分析模块（service + controller + module）
- `frontend/src/app/learning/analytics/page.tsx` — 学情分析看板页面
- `frontend/src/app/learning/path/page.tsx` — 学习路径页面
- `frontend/src/lib/models.ts` — 模型列表单数据源（新建）
- `frontend/src/app/sandbox/compare/page.tsx` — 对比实验室（修复颜色+参数+model）
- `frontend/src/app/page.tsx`, `dashboard/`, `my/`, `discover/`, `circles/`, `admin/`, `courses/`, `contents/` — 颜色修复
- `docs/产品优化方向.md` — 完整优化方案