fix: 修复 NameError/状态污染/类型标注/统计; 补全练习与 main; 新增 config/.gitignore/requirements; 文档统一

README.md

@@ -9,17 +9,15 @@
 
 ## 🎯 这是什么？
 
-一个渐进式的 AI Agent 开发学习项目，通过 **7 个 Step** 带你从零掌握 AI Agent 的核心概念：
+一个渐进式的 AI Agent 开发学习项目，通过 **5 个阶段（7 个主题）** 带你从零掌握 AI Agent 的核心概念：
 
-| Step | 主题 | 你将学会 |
+| 阶段 | 主题 | 你将学会 |
 |------|------|---------|
-| 01 | Tool 工具系统 | 如何定义和注册工具 |
-| 02 | State 状态管理 | 如何管理 Agent 的状态 |
-| 03 | Simple Agent | 如何构建 Agent 循环 |
-| 04 | Memory 记忆 | 如何让 Agent 记住对话 |
-| 05 | RAG 知识检索 | 如何让 Agent 查阅知识库 |
-| 06 | Self-Correction | 如何让 Agent 自我修正 |
-| 07 | Multi-Agent | 如何构建多 Agent 协作 |
+| Step 01 | Tool 工具系统 | 如何定义和注册工具 |
+| Step 02 | State 状态管理 | 如何管理 Agent 的状态 |
+| Step 03 | Simple Agent | 如何构建 Agent 循环 |
+| Step 04 | Memory 记忆 | 如何让 Agent 记住对话 |
+| Step 05~07 | RAG / Self-Correction / Multi-Agent | 进阶能力（同一目录） |
 
 ---
 
@@ -30,11 +28,11 @@
 - Day 3-4: 掌握 State 管理
 - Day 5-7: 构建简单 Agent
 
-### 第 2 周：进阶（Step 04-07）
+### 第 2 周：进阶（Step 04 + 进阶包）
 - Day 8-9: 多级记忆系统
-- Day 10-11: RAG 与知识增强
-- Day 12-13: 自我修正模式
-- Day 14: 多 Agent 协作
+- Day 10-11: RAG 与知识增强（Step 05）
+- Day 12-13: 自我修正模式（Step 06）
+- Day 14: 多 Agent 协作（Step 07）
 
 ---
 
@@ -42,7 +40,7 @@
 
 ### 1. 克隆项目
 ```bash
-git clone https://www.1415243231.top/gitea/panda/jaspersoft-agent-learn.git
+git clone https://gitea.1415243231.top/panda/jaspersoft-agent-learn.git
 cd jaspersoft-agent-learn
 ```
 
@@ -51,7 +49,7 @@ cd jaspersoft-agent-learn
 python -m venv venv
 source venv/bin/activate  # Linux/Mac
 .\venv\Scripts\activate   # Windows
-pip install python-dotenv
+pip install -r requirements.txt
 ```
 
 ### 3. 开始学习
@@ -115,9 +113,9 @@ while not done:
 - ✅ 掌握 State 的设计模式
 - ✅ 能够构建简单的 Agent 循环
 - ✅ 实现多级记忆系统
-- ✅ 理解 RAG 架构
-- ✅ 掌握 Self-Correction 模式
-- ✅ 设计 Multi-Agent 协作系统
+- ✅ 理解 RAG 架构（Step 05）
+- ✅ 掌握 Self-Correction 模式（Step 06）
+- ✅ 设计 Multi-Agent 协作系统（Step 07）
 
 ---
 
@@ -133,7 +131,9 @@ jaspersoft-agent-learn/
 ├── step_02_state/        # 状态管理
 ├── step_03_simple_agent/ # 简单 Agent
 ├── step_04_memory/       # 记忆系统
-└── step_05_07_advanced/  # RAG/修正/多Agent
+├── step_05_07_advanced/  # RAG（05）/ Self-Correction（06）/ Multi-Agent（07）
+├── config.py             # 集中读取 .env（LLM key、RAG 路径等）
+└── requirements.txt      # 可选依赖清单
 ```
 
 ---
@@ -141,8 +141,8 @@ jaspersoft-agent-learn/
 ## 🔗 相关链接
 
 - 📂 **详细学习指南**: [LEARN_GUIDE.md](./LEARN_GUIDE.md)
-- 🏠 **主项目**: [JasperSoft](https://www.1415243231.top/gitea/panda/jaspersoft)
-- 📊 **日报系统**: [Daily On Work](https://www.1415243231.top)
+- 🏠 **主项目**: [JasperSoft](https://gitea.1415243231.top/panda/jaspersoft)
+- 📊 **日报系统**: [Daily On Work](https://gitea.1415243231.top)
 
 ---