增加每章节 README 文件

This commit is contained in:
2026-09-22 15:57:59 +08:00
parent 8e86665096
commit 9445061c76
49 changed files with 3815 additions and 6 deletions
+9 -6
View File
@@ -5,9 +5,11 @@
## 总览
- 8 个阶段文件夹(`001_*` ~ `008_*`)
- 49 个子目录(48 个小点 + 8 个综合实战 = 56 个练习单元 — 其中阶段二/三/四/五/六/七/八 各含 1 个综合实战,共 7 个;外加 41 个小点子目录;总计 48 + 7 = 55 子目录,写错了,重数:48 + 7 = 55,按实际为准)
- **8 个阶段文件夹**(`001_*` ~ `008_*`)
- **47 个子目录**:41 个小点 + 7 个综合实战(阶段一没有综合实战;其余每阶段 1 个 `99_capstone_*`)
- **每个子目录都有一个 `README.md`**:写明学习目的、前置条件、主要内容、对应 docs 链接、建议练习与达成标准——既能占位让空目录入 git,又能当每章的「任务清单」用
- 所有 Python 文件统一在根目录的 `.venv` 里跑:`uv run python …`
- `_tools/`:放生成/维护本目录的脚本(如 `generate_readmes.py`),不属于学习内容
---
@@ -104,14 +106,15 @@
## 怎么用
1. **按编号顺序**进入对应子目录,跟 docs 里同名小点同步写练习。
2. 每个子目录建议最少 2~3 个 `.py` 文件做不同角度的练习(例如「最小实现 / 加日志 / 加单元测试」)。
3. 跑代码统一用 `uv run`(已经在根目录的 `.venv` 里):
1. **进入子目录先读它的 `README.md`**——里面写了本章的学习目的、前置条件、主要内容、对应 docs 路径、建议练习和达成标准。把它当作每章的「任务清单」用,逐项打勾。
2. **按编号顺序**进入对应子目录,跟 docs 里同名小点同步写练习。
3. 每个子目录建议最少 2~3 个 `.py` 文件做不同角度的练习(例如「最小实现 / 加日志 / 加单元测试」)。
4. 跑代码统一用 `uv run`(已经在根目录的 `.venv` 里):
```bash
cd code/003_phase3_frameworks/02_langgraph_core
uv run python my_first_graph.py
```
4. **不要把练习代码挪到 docs/**——docs 只放文档,code 才是可执行代码。
5. **不要把练习代码挪到 docs/**——docs 只放文档,code 才是可执行代码。
## 配套参考