增加每章节 README 文件
This commit is contained in:
+9
-6
@@ -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 才是可执行代码。
|
||||
|
||||
## 配套参考
|
||||
|
||||
|
||||
Reference in New Issue
Block a user