阶段学习任务单：Python 编程基础

这个阶段的目标是让你能用 Python 表达清楚一个小程序的输入、处理和输出。后续的数据分析、机器学习、RAG 和 Agent 都会依赖 Python，因此这里最重要的是写出可读、可运行、可调试的代码。

本阶段必须完成的任务

任务	产出物	通过标准
掌握基础语法	5 个小练习脚本	能使用变量、条件、循环、函数处理简单问题
熟悉数据结构	一个数据整理脚本	能选择 list、dict、set、tuple 并解释原因
编写函数	一个拆分成多个函数的小程序	每个函数职责清晰，有输入和返回值
处理文件	一个读取和写入文本或 JSON 的脚本	能把结果保存到文件并重新读取
完成阶段项目	一个命令行小工具	能通过 README 说明运行方式和示例输出

推荐学习顺序

先把变量、类型、条件、循环和函数跑通，再学习列表、字典和文件操作。面向对象、装饰器、生成器等进阶内容可以先理解用途，不必在第一遍追求熟练。

学习 Python 时不要只看语法解释。每学一个语法点，都应该立刻写一个小脚本，例如任务清单、文本统计、文件整理、API 响应解析或学习日志生成。

和 AI 学习助手项目的关系

本阶段对应 AI 学习助手的 v0.2 命令行交互版本。你可以让程序读取一个问题，保存到日志文件，并返回一个固定模板答案。此时仍然不需要调用大模型，重点是练习输入输出、函数拆分和文件记录。

建议实现功能：用户输入一个学习问题，程序把问题、时间和当前阶段写入 notes/questions.jsonl，然后返回“已记录，建议先查看对应章节”的提示。

常见卡点

初学者常见问题包括缩进错误、变量名覆盖、列表和字典混用、文件路径不对、函数只打印不返回、异常信息看不懂。遇到错误时，先定位是哪一行，再确认这一行用到的变量类型和值是否符合预期。

阶段通关问题

学完后，你应该能回答这些问题：什么时候应该写函数，什么时候应该用字典，文件路径相对谁计算，print 和 return 有什么区别，为什么真实项目里需要把逻辑拆成多个小函数。

完成状态 Checklist

• 我能用变量、条件、循环和函数写出一个完整小程序。
• 我能用 list 和 dict 组织任务、问题或学习记录。
• 我能读写文本、JSON 或 JSONL 文件。
• 我已经完成一个命令行学习助手或等价小工具。
• 我能解释 print、return、函数参数和文件路径的区别。