目录结构说明

目录按学习阶段组织。学习路线页负责回答“学什么、为什么学”；阶段页负责进度、练习索引和复盘；专题页集中沉淀跨阶段反复查阅的知识；项目页保留完整工程过程。

目录总览

docs/
├─ index.md                         # 首页：阶段入口和使用方式
├─ plan.md                          # 完整的 12 个月学习路线
├─ learning/                        # 按路线阶段记录进度和阶段笔记
│  ├─ month-01-foundation/
│  ├─ month-02-03-math-assets/
│  ├─ month-04-05-webgl/
│  ├─ month-06-09-threejs/
│  ├─ month-10-cesium/
│  ├─ month-11-engineering/
│  └─ month-12-ai/
├─ javascript/                      # JavaScript 与实时数据专题
├─ vue/                             # Vue 与 TypeScript 专题
├─ threejs/                         # 3D 数学、资产、渲染专题
├─ projects/                        # 项目档案、设计取舍和踩坑记录
├─ journal/                         # 每日记录和每周复盘
└─ guide/                           # 使用说明和笔记模板

新笔记放哪里

• 正在学习某一阶段的练习和进度，放在相应的 docs/learning/... 目录。
• 需要反复查询的通用知识，放在 javascript、vue 或 threejs 专题目录。
• 涉及项目方案、排错证据、性能实验或架构取舍，放在 projects。
• 当天做了什么、卡在哪里、下次先做什么，写到 journal。

同一主题只保留一份主要笔记：阶段页可以链接到专题或项目笔记，避免在多个目录复制同一段内容。

添加文章

1. 在对应目录新建 .md 文件，文件名使用小写英文和连字符，例如 websocket-reconnect.md。
2. 复制知识笔记模板、实验记录模板或问题排查模板。
3. 在所在阶段页或专题首页的索引表中加一行链接。
4. 如果希望文章独立显示在左侧固定导航中，再编辑 docs/.vitepress/config.mts 对应分组；一般把链接加到阶段页索引就够用了。

Markdown 文件本身就是源数据。移动电脑时，备份整个“笔记文件”目录（可以不带 node_modules 和 VitePress 构建缓存）。