阶段学习任务单：开发者工具基础
这个阶段的目标不是记住所有命令，而是让你具备后续学习 AI 项目所需的基本开发工作流。学完后，你应该能创建项目、管理文件、安装依赖、使用 Git 保存版本，并把运行结果记录下来。
本阶段必须完成的任务
| 任务 | 产出物 | 通过标准 |
|---|---|---|
| 配置终端与常用命令 | 一份命令练习记录 | 能用命令创建、移动、查看和删除文件 |
| 配置 Python 开发环境 | 一个可运行的 Python 项目目录 | 能运行 python --version、安装依赖并执行脚本 |
| 配置 VS Code 或等价编辑器 | 项目截图或配置说明 | 能打开项目、运行文件、查看终端输出 |
| 掌握 Git 基础流程 | 至少 3 次 commit 记录 | 能解释 add、commit、status、log 的作用 |
| 连接远程仓库 | 一个远程仓库地址或截图 | 能 push，并能从远程确认文件存在 |
推荐学习顺序
先学习终端和文件操作，再配置 Python 环境，然后学习编辑器，最后学习 Git。不要一开始就纠结复杂分支模型，先把“本地改文件、提交、推送”这条主线跑通。
如果遇到环境问题，优先记录错误原文、操作系统、Python 版本、执行目录和完整命令。后续学习 RAG、Agent、部署时，大量问题本质上仍然是环境、路径和依赖问题。
和 AI 学习助手项目的关系
本阶段对应 AI 学习助手的 v0.1 项目骨架。你需要创建一个项目目录，准备 README，建立 Git 仓库，并写一个最简单的命令行入口。这个版本不需要 AI 能力，只需要让项目具备可持续迭代的工程基础。
推荐目录结构：
ai-learning-assistant/
README.md
src/
main.py
notes/
learning-log.md
requirements.txt
main.py 可以先只输出一行欢迎语。重点不是功能，而是你能否用固定命令运行它，并把结果写进 README。
常见卡点
最常见的问题包括命令执行目录不对、Python 版本混乱、依赖安装到错误环境、Git 没有配置用户名、远程仓库权限失败。解决这类问题时，不要只复制最后一行错误，要保留完整命令和完整输出。
轻松版 / 标准版 / 挑战版任 务
| 难度 | 你要完成什么 | 适合谁 |
|---|---|---|
| 轻松版 | 运行一个 Python 文件并完成一次 Git 提交 | 第一遍学习、时间少或刚入门的学习者 |
| 标准版 | 补 README、虚拟环境说明和命令记录 | 希望把本阶段放进作品集的学习者 |
| 挑战版 | 故意制造路径或命令错误并写排障记录 | 已有基础、想做更强项目证据的学习者 |
本阶段徽章与 Boss 战
| 类型 | 内容 |
|---|---|
| Boss 战 | 工作台守门人 |
| 可解锁徽章 | 终端生存者、Git 存档师 |
| 最小通关口号 | 先跑通、再解释、再记录失败 |
| 证据保存建议 | 把截图、日志、失败样本或评估表保存到 reports/、evals/ 或 logs/ |
完成轻松版就可以继续前进；完成标准版才建议写进作品集；挑战版只在你有余力时再做。
阶段作品集交付物
如果你想把本阶段成果沉淀到作品集，建议至少保留下面这些文件或等 价材料。
| 交付物 | 说明 |
|---|---|
README.md | 项目目标、环境要求、运行命令和示例输出 |
requirements.txt | 当前项目依赖，哪怕最初为空也可以保留 |
notes/learning-log.md | 记录每天做了什么、遇到什么环境问题 |
screenshots/ | 保存终端运行、编辑器和 Git 提交截图 |
| Git commit 记录 | 至少 3 次小步提交，能看出项目迭代过程 |
这些材料会证明你不是只会看教程，而是已经具备后续持续开发 AI 项目的基本工程习惯。
阶段通关问题
学完后，你应该能回答这些问题：当前终端在哪个目录，Python 脚本是用哪个解释器运行的，项目依赖记录在哪里，Git 当前有哪些未提交修改，为什么每次完成一个小功能都应该提交一次。
完成状态 Checklist
- 我能在终端进入项目目录，并说明当前命令在哪里执行。
- 我能创建、运行和修改一个 Python 文件。
- 我能用 Git 查看状态、提交变更，并理解 commit 记录的意义。
- 我已经为 AI 学习助手建立项目骨架、README 和运行截图。
- 我记录了至少一个环境或路径问题，以及自己的排查过程。