阶段学习任务单：Python 编程基础
这个阶段的目标是让你能用 Python 表达清楚一个小程序的输入、处理和输出。后续的数据分析、机器学习、RAG 和 Agent 都会依赖 Python，因此这里最重 要的是写出可读、可运行、可调试的代码。
本阶段必须完成的任务
| 任务 | 产出物 | 通过标准 |
|---|---|---|
| 掌握基础语法 | 5 个小练习脚本 | 能使用变量、条件、循环、函数处理简单问题 |
| 熟悉数据结构 | 一个数据整理脚本 | 能选择 list、dict、set、tuple 并解释原因 |
| 编写函数 | 一个拆分成多个函数的小程序 | 每个函数职责清晰，有输入和返回值 |
| 处理文件 | 一个读取和写入文本或 JSON 的脚本 | 能把结果保存到文件并重新读取 |
| 完成阶段项目 | 一个命令行小工具 | 能通过 README 说明运行方式和示例输出 |
推荐学习顺序
先把变量、类型、条件、循环和函数跑通，再学习列表、字典和文件操作。面向对象、装饰器、生成器等进阶内容可以先理解用途，不必在第一遍追求熟练。
学习 Python 时不要只看语法解释。每学一个语法点，都应该立刻写一个小脚本，例如任务清单、文本统计、文件整理、API 响应解析或学习日志生成。
和 AI 学习助手项目的关系
本阶段对应 AI 学习助手的 v0.2 命令行交互版本。你可以让程序读取一个问题，保存到日志文件，并返回一个固定模板答案。此时仍然不需要调用大模型，重点是练习输入输出、函数拆分和文件记录。
建议实现功能：用户输入一个学习问题，程序把问题、时间和当前阶段写入 notes/questions.jsonl，然后返回“已记录，建议先查看对应章节”的提示。
常见卡点
初学者常见问题包括缩进错误、变量名覆盖、列表和字典混用、文件路径不对、函数只打印不返回、异常信息看不懂。遇到错误时，先定位是哪一行，再确认这一行用到的变量类型和值是否符合预期。
轻松版 / 标准版 / 挑战版任务
| 难度 | 你要完成什么 | 适合谁 |
|---|---|---|
| 轻松版 | 完成新增、查看、完成任务并保存 JSON | 第一遍学习、时间少或刚入门的学习者 |
| 标准版 | 支持分类、搜索和损坏文件提示 | 希望把本阶段放进作品集的学习者 |
| 挑战版 | 准备正常、空输入、损坏 JSON 三个测试样例 | 已有基础、想做更强项目证据的学习者 |
本阶段徽章与 Boss 战
| 类型 | 内容 |
|---|---|
| Boss 战 | JSON 地牢管理员 |
| 可解锁徽章 | JSON 驯服者、异常捕手 |
| 最小通关口号 | 先跑通、再解释、再记录失败 |
| 证据保存建议 | 把截图、日志、失败样本或评估表保存到 reports/、evals/ 或 logs/ |
完成轻松版就可以继续前进；完成标准版才建议写进作品集；挑战版只在你有余力时再做。
阶段作品集交付物
如果你想把本阶段成果沉淀到作品集，建议至少保留下面这些文件或等价材料。
| 交付物 | 说明 |
|---|---|
todo_cli.py 或项目目录 | 命令行任务管理器源码，支持新增、查看、完成和保存 |
data/tasks.json | 示例数据文件，展示文件读写和数据结构设计 |
api_demo.py | 一个 Web API 调用练习，包含错误处理和返回解析 |
README.md | 运行命令、示例输入输出、项目结构和已知限制 |
debug_notes.md | 记录至少 2 个 Python 报错、原因和修复过程 |
这些材料会让 Python 阶段从“语法练习”变成“能独立写小工具、能排错、能解释结构”的项目证 据。
阶段通关问题
学完后，你应该能回答这些问题：什么时候应该写函数，什么时候应该用字典，文件路径相对谁计算，print 和 return 有什么区别，为什么真实项目里需要把逻辑拆成多个小函数。
完成状态 Checklist
- 我能用变量、条件、循环和函数写出一个完整小程序。
- 我能用 list 和 dict 组织任务、问题或学习记录。
- 我能读写文本、JSON 或 JSONL 文件。
- 我已经完成一个命令行学习助手或等价小工具。
- 我能解释 print、return、函数参数和文件路径的区别。