跳到主要内容

阶段学习任务单:开发者工具基础

这个阶段的目标不是记住所有命令,而是让你具备后续学习 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 和运行截图。
  • 我记录了至少一个环境或路径问题,以及自己的排查过程。