课程页面使用说明
随着课程内容逐步丰富，同一个阶段里会出现阶段首页、学习指南、任务单、章节页和项目页。它们不是重复内容，而是服务于不同学习动作。你不需要每次都从头读完所有页面，可以按当前目标选择入口。
页面分工
| 页面类型 | 主要作用 | 什么时候看 |
|---|---|---|
| 首页 | 快速启动整门课 | 第一次进入课程，或不知道从哪里开始时 |
| 学习地图 | 理解路线、项目、术语、排障和作品集要求 | 开始学习前，或需要重新规划路线时 |
| 阶段首页 | 判断这个阶段学什么、为什么学、和前后阶段有什么关系 | 进入一个新阶段前 |
| 学习指南 | 安排章节学习顺序和学习方法 | 准备系统学习某个阶段时 |
| 阶段任务单 | 明确本阶段要完成的练习、项目和通关标准 | 学习过程中反复对照 |
| 章节页 | 学具体概念、代码和实践方法 | 按学习顺序逐章阅读或查漏补缺时 |
| 项目页 | 把知识点转成可运行作品 | 完成阶段练习或做作品集时 |
| 附录与术语表 | 查概念、资源、排障和补充资料 | 遇到卡点或陌生词时 |
如果你是第一次学，建议顺序是：首页 → 快速体验 → AI 全栈能力地图 → 推荐学习路线 → 阶段首页 → 阶段任务单 → 章节页 → 项目页。之后每进入一个新阶段，都重复“阶段首页 + 任务单 + 章节 + 项目”的节奏。
如何避免重复阅读
如果你只是想快速推进，就优先看任务单和项目页。任务单告诉你最低要交付什么，项目页告诉你如何把知识点做成作品。如果某个任务做不出来，再回到对应章节补概念和代码。
如果你已经有相关经验，可以先看阶段首页和任务单，然后直接跳到项目页。比如你已经会 Python，就不必逐字阅读所有 Python 基础章节，而是完成命令行工具、文件读写和 API 小项目，确认没有关键缺口即可。
如果你正在准备作品集，就优先看项目路线、AI 学习助手成长路线、作品集验收清单和毕业项目设计指南。章节内容作为支撑，项目交付物才是主线。
三类学习模式
快速体验模式适合想先跑起来的人。你只需要完成每个阶段任务单里的最小产出，不必深入所有理论。这个模式能帮助你尽快建立正反馈。
系统学习模式适合想完整建立 AI 全栈能 力的人。你应该按阶段首页和学习指南推进，每个阶段都完成任务单和至少一个阶段项目。
作品集模式适合以求职、转型或展示为目标的人。你应该围绕一个连续项目迭代，把每阶段产出都沉淀到 README、实验记录、截图、测试集和失败样本里。
页面维护原则
后续新增内容时，尽量保持这个分工。阶段首页负责定位，学习指南负责顺序，任务单负责交付，章节页负责知识，项目页负责作品，附录负责查阅。这样课程会随着内容增加而变丰富，而不是变混乱。
修改课程后的维护流程
每次修改课程内容、导航或新增页面后，建议先在项目根目录运行：
npm run validate:docs
这个命令会检查 Markdown 代码块、内部链接、sidebar 文档引用和 sidebars.js 语法。如果它失败，先根据 FAIL 输出修复问题，再继续提交。
验证通过后，再运行：
npm run clean
这个命令会清理 Docusaurus 生成缓存和构建产物，避免 .docusaurus 或 build 中残留旧路径、旧页面或本地临时路径。完成这两步后，再执行 Git 提交会更稳。