完整的文档索引，快速找到您需要的信息

---

适合第一次接触本课程的学习者，快速了解课程并开始学习。

文档	说明	适合人群	阅读时间
快速入门	5分钟快速上手指南	🌟 所有用户	5分钟
环境配置	详细的环境安装和配置	首次安装	10分钟

快速链接：

• 立即开始学习
• 环境配置脚本
• 测试环境

---

适合深入学习的学习者，包含完整的学习路径和技术细节。

文档	说明	适用场景
课程学习指南	完整的学习指南，包含12课时详解	深入学习者
课程初始化说明	课程自动初始化和库导入详解	所有用户
CNB部署指南	CNB云原生部署完整指南	部署人员
环境配置指南	环境安装和配置详细说明	首次安装

---

适合技术开发者或维护者，了解项目的技术细节。

文档	说明	适用人群
脚本改进说明	启动脚本优化历史	开发者

---

了解项目的版本历史和功能更新。

文档	说明
CHANGELOG	完整的版本更新历史
v1.1.0-自动环境配置	本次自动环境配置功能详细说明

---

推荐阅读顺序：

1. 🚀 快速入门 - 5分钟快速上手
2. 📖 课程学习指南 - 了解完整课程
3. 🎓 开始学习第1课

关键链接：

• 运行环境配置
• 启动Jupyter

---

推荐阅读顺序：

1. 🚀 快速入门 - 了解项目
2. 🔧 技术文档 - 了解技术实现
3. 📝 CHANGELOG - 了解版本历史

关键链接：

• 环境配置
• 课程初始化
• CNB部署

---

推荐阅读顺序：

1. 🚀 快速入门 - 了解项目
2. 🔧 环境配置 - 环境配置说明
3. ☁️ CNB部署指南 - 云平台部署

关键链接：

• 自动环境配置脚本
• CNB部署脚本

---

• 🚀 快速入门 - 环境配置
• 📖 环境配置详细指南
• 📝 环境配置指南
• 🔧 脚本改进说明

• 📖 课程学习指南
• 🎓 第1课：Hello Python与变量
• 🎓 第2课：列表与循环
• ...（所有课程）

• 📝 课程初始化说明
• 📦 批量初始化脚本
• 🔧 课程工具模块

• ☁️ CNB部署指南
• 🐳 Docker部署
• 📋 自动环境配置

---

命令	说明
./scripts/auto_setup_env.sh	自动环境配置
./scripts/start.sh	本地启动
./scripts/start_docker.sh	Docker启动
./scripts/cnb_deploy.sh	CNB部署
python ../utils/course_utils.py	导入课程工具模块
python ../utils/test_environment.py	测试环境

类型	路径
课程文件	lessons/lesson*.ipynb
工具模块	utils/*.py
启动脚本	scripts/*.sh
文档	docs/**/*.md
部署配置	deployment/

---

1. 查看文档

   • 快速入门 - 快速上手
   • 环境配置 - 环境问题
   • 课程初始化 - 初始化问题

2. 运行诊断

   python utils/test_environment.py
   

3. 搜索错误信息

   • 通常能找到解决方案

4. 查看技术文档

   • 技术文档 - 了解技术细节
   • CHANGELOG - 查看版本历史

---

docs/
├── README.md                 # 本文档 - 文档索引
├── getting-started/          # 快速开始
│   ├── 快速入门.md           # 5分钟快速上手
│   └── 环境配置.md           # 环境配置详细指南
├── guides/                   # 详细指南
│   ├── 课程学习指南.md       # 完整学习指南
│   ├── 课程初始化说明.md     # 课程初始化详解
│   └── CNB部署指南.md        # CNB部署指南
├── technical/                # 技术文档
│   └── 脚本改进说明.md       # 脚本优化历史
└── changelog/                # 更新日志
    ├── CHANGELOG.md          # 版本更新历史
    └── v1.1.0-自动环境配置.md  # 详细更新说明

如果您想改进文档：

1. Fork 项目
2. 编辑文档
3. 提交 Pull Request

---

如有问题或建议，请通过以下方式联系：

• 📖 查看文档：docs/
• 🔍 搜索错误信息
• 📧 联系技术支持

---

• ⭐ 添加自动环境配置功能
• ⭐ 添加课程工具模块
• ⭐ 添加批量初始化脚本
• 🔧 优化文档结构
• 📁 重新组织文档目录

查看详细更新

---

文档最后更新: 2026-02-06