详细设计：DeepTraining 教学网站

{
  "tracks": [
    {
      "id": "G", "name": "LangGraph Agent 编排", "color": "#7c5cff",
      "stages": [
        { "id": "G0", "title": "环境搭建与验证", "difficulty": "入门",
          "lessons": [
            { "id": "G0-01", "title": "环境搭建：一个能跑 Agent 的最小工作台",
              "file": "../doc/LangGraph/G0-环境搭建与验证/01-环境搭建-最小工作台.md",
              "status": "done", "est_min": 60 },
            { "id": "G0-02", "title": "Studio 可视化调试台", "status": "done" }
          ] }
      ]
    },
    { "id": "S", "name": "模型训练", "color": "#2f8fff" },
    { "id": "M", "name": "AI 开发基建九模块", "color": "#12b76a" }
  ],
  "current": { "G": "G1-01", "S": "S1-02" }
}

W1-W2   G1 心智模型 ── S1 基础概念          ← 你在这
W3      G2 控制流   ── S2 数据处理
W4      G3 持久化   ── M8 Git(30min) + M1 原理直觉
W5-W6   G4 生态     ── S3/S4 ── M4 本地推理
W7      G5 多智能体 ── S5 调优 ── M3 RAG进阶
W8-W9   G6 工程化   ── S6/S7 ── M6 pandas/SQL
W10-W12 G7 实战 + M5/M7 ── S8 综合 ── G8 毕业

┌──────────────────────────────────────────────────────────┐
│ 🎓 DeepTraining 学习中心        [🔍搜索] [导出进度] [🌙]   │
├──────────────────────────────────────────────────────────┤
│ 📍 你现在的位置                                           │
│  ┌───────────────────────┐  ┌───────────────────────┐    │
│  │ G 编排线 ▶ G1-01      │  │ S 训练线 ▶ S1-02      │    │
│  │ 解剖第一个 Agent       │  │ 训练观察记录           │    │
│  │ G0 ✅ → G1 🔶 → G2 ⬜ │  │ S0 ✅ → S1 🔶 → S2 ⬜ │    │
│  │ [继续学习]            │  │ [继续学习]            │    │
│  └───────────────────────┘  └───────────────────────┘    │
│  💡 下一步建议：先听我讲 G1-01（30min）→ 再做 S1 三个改动实验│
├──────────────────────────────────────────────────────────┤
│ 📊 三条线总进度                                           │
│  G 编排 ████████░░░░░░░░  2/24 课    8%                  │
│  S 训练 ████░░░░░░░░░░░░  3/26 课   12%                  │
│  M 基建 ░░░░░░░░░░░░░░░░  0/9 模块   0%   （预告中）       │
├──────────────────────────────────────────────────────────┤
│ 🗓 12 周穿插时间线（横条，当前周高亮）                       │
│ 🚫 防走偏：8 类不学的东西 [查看]  ｜  📖 术语表 [查看]        │
└──────────────────────────────────────────────────────────┘
   页脚：本页构建于 2026-11-11 00:50 ｜ 教材改动后重跑 build_site.py

┌────────────┬─────────────────────────────────────────────┐
│ 📚 侧栏(树) │ 面包屑：LangGraph › G1 核心心智模型 › 01       │
│            │ ╔═══════════════════════════════════════╗    │
│ G 编排      │ ║ 01-解剖第一个 Agent     [状态按钮 🔶→✅] ║    │
│ ├ G0 ✅    │ ║ 难度🟡入门 ｜ 预计60min ｜ 前置: G0-02  ║    │
│ │ ├ 01 ✅  │ ╚═══════════════════════════════════════╝    │
│ │ └ 02 ✅  │ 🎯 学习目标（卡片）                            │
│ ├ G1 ◀     │ 📖 核心知识                                  │
│ │ ├ 01 🔶◀ │   ……markdown 正文……                          │
│ │ └ 02 ⬜  │   ……代码块（右上角复制按钮）……                 │
│ ├ G2 ⬜    │ 🧪 实验任务                                   │
│ │ …        │   ☐ 改动实验1：换模型  ☐ 改动实验2：加工具     │
│ S 训练(折)  │ ✅ 验收标准                                   │
│ M 基建(折)  │   ☑ 五条消息 trace 说得出每步干了啥            │
│            │   ⚠ 全部勾满 → 提示"回对话找我验收"            │
│            │ 📝 小测验（3 题选择题，见 6.3）                 │
│            │ 🔗 下一阶段衔接卡片  [← 上一篇] [下一篇 →]      │
└────────────┴─────────────────────────────────────────────┘

⬜ 未开始 ──点"开始学"──▶ 🔶 学习中 ──实验跑完──▶ 🟡 待验收 ──我验收──▶ ✅ 已验收

// site/data/quizzes/G1.json
{ "lesson": "G1-02",
  "questions": [
    { "q": "LangGraph 里两个节点同时更新同一字段，为什么必须加 Reducer？",
      "options": ["不加会报错", "不加是覆盖，一边结果会丢", "不加就变串行"],
      "answer": 1,
      "explain": "默认行为是整体覆盖 state——G1-02 实验里你亲眼见过 'B 丢了'。" }
  ] }

读 data/courses.json 注册表
  → 遍历每课 .md：python-markdown 渲染（扩展：tables / fenced_code / toc / admonition / codehilite）
  → 解析文内 "- [ ]" 清单项 → 转交互复选框（键=课程ID+项序号）
  → 注入 lesson.html 模板 → 输出 output/<track>/<stage>/<NN>.html
  → 生成 index / path / review / glossary / dont-learn
  → 生成 data.js（课程树快照）+ search_index.js
  → 校验：注册表里每个 file 字段必须存在，缺失即构建失败（防链接腐烂）
  → 复制 assets/，打印统计（页数/体积/耗时）

# 构建（教材更新后重跑，实测目标 <10 秒）
E:/zcode/DeepTraining/langgraph-learn/.venv/Scripts/python.exe Prj/AIKnows/build_site.py

# 浏览（二选一）
#   a) 资源管理器双击 Prj/AIKnows/output/index.html（file:// 直开）
#   b) 手机同 WiFi 访问：
E:/zcode/DeepTraining/langgraph-learn/.venv/Scripts/python.exe -m http.server 8080 --directory Prj/AIKnows/output

E:\zcode\DeepTraining\
├── doc\                        # 教材唯一事实源（一条不改）
├── model-learn\                # S 线代码（不动）
├── langgraph-learn\            # G 线代码（不动）
├── site\                       # ★ 新增：网站工程
│   ├── build_site.py           # 构建脚本（唯一入口，我来写并维护）
│   ├── requirements.txt        # markdown、pygments
│   ├── templates\              # base / dashboard / lesson / path / review / glossary
│   ├── assets\
│   │   ├── style.css           # 全站样式（含暗色模式）
│   │   ├── app.js              # 进度/测验/搜索/主题切换（原生 JS，无框架）
│   │   ├── data.js             # 构建生成：课程树快照
│   │   └── search_index.js     # 构建生成：搜索索引
│   ├── data\
│   │   ├── courses.json        # 课程注册表（现状种子我来填，验收后我更新）
│   │   └── quizzes\            # G0.json … S8.json（每阶段 3 题，我出题）
│   └── output\                 # 构建产物 → 浏览器只看这个目录
│       ├── index.html / path.html / review.html / glossary.html / dont-learn.html
│       ├── G\G0\01.html …      # ~24 课
│       └── S\S0\01.html …      # ~26 课
└── (其余全部不动)