保存一次版本

08-01 保存一次版本

课程定位

这一课进入「版本、发布和作品集」。项目已经能运行、能修改、能处理结果，现在要保存一次稳定版本。

版本记录会把当前成果钉在历史里。以后继续修改时，学员能看到哪里变了，也能更放心地尝试。

这一课的成果是一份「版本保存记录」。

本课目标

• 能查看项目当前改动。
• 能让 AI 用大白话解释改动。
• 能完成一次 Git 提交。
• 能写清楚提交信息。
• 能保存版本记录。

录制建议

• 建议时长：25 到 35 分钟。
• 接上一章已经稳定的项目继续演示。
• 先验收，再保存版本。
• 只讲最小 Git 动作：查看状态、查看改动、提交。
• 收尾把提交信息写进日志。

课前准备

• 已完成一轮验收的项目。
• Git 环境。
• README。
• 工作日志。
• AI 工作台工具。

讲稿正文

可以这样开场：

“项目现在已经有了一版稳定结果。这个时候要做一件很朴素但很重要的事：保存当前版本。”

先讲保存版本的意义：

“如果你继续让 AI 改项目，却没有保存当前稳定点，后面一旦改乱，你会不知道稳定版本在哪里。保存版本，就是给项目留一个可以回看的时间点。”

版本保存前先确认三件事。

第一，项目能运行。

保存版本前要确认当前状态是可用的。网页能打开，核心流程能走通，结果能带走。

第二，README 或日志已更新。

如果使用方式、文件结构、功能范围变了，README 要跟着变。普通修改也至少写进工作日志。

第三，知道本次改了什么。

可以让 AI 根据 Git 差异解释改动。学员不用逐行看代码，但要知道本次变化大概是什么。

提交信息要写清成果，比如：

完成 CSV 转 Markdown 第一版

或者：

增加结果复制功能和页面提示

避免写太空的词，比如：

update
fix
change

这里要强调：

“Commit 像在项目历史里钉一枚时间钉。以后项目继续长大，你还能回头看到这一刻。”

最后收束：

“保存版本，是在保护自己的劳动。AI 可以继续帮你试错，但这一刻的成果已经被你稳稳保存下来。”

屏幕演示流程

1. 打开项目运行结果。
2. 做一次核心流程验收。
3. 查看 README 和日志是否需要更新。
4. 查看 Git 状态。
5. 让 AI 解释本次改动。
6. 写提交信息。
7. 完成 Git 提交。
8. 把提交信息写入版本保存记录。

给 AI 的协作卡

我准备为当前项目保存一次版本。
请帮我做提交前检查：
1. 当前项目是否已经完成验收
2. README 或日志是否需要更新
3. 本次主要改动是什么
4. Git 提交信息建议怎么写
5. 提交后我应该记录哪些信息

请用普通人能看懂的话解释本次改动。

版本保存记录

• 项目名称：
• 保存日期：
• 本次稳定成果：
• 验收结论：
• README 是否更新：
• Git 提交信息：
• 提交后遗留问题：
• 下一步计划：

课堂练习

让学员为自己的主项目保存一次版本。

要求：

• 提交前完成一次验收。
• 让 AI 解释本次改动。
• 写清提交信息。
• 保存版本记录。

常见卡点

• 学员没验收就提交：先运行核心流程。
• 提交信息写“update”：改成具体成果。
• 看不懂 Git 差异：让 AI 用大白话解释。
• README 忘记更新：提交前检查使用方式是否变化。
• 改动太多才提交：以后每个稳定节点保存一次。

课后作业

完成主项目一次版本保存。

提交内容：

• Git 提交信息。
• 版本保存记录。
• 验收截图。
• AI 对本次改动的解释。

课件页建议

• 第 1 页：把当前成果钉在历史里
• 第 2 页：保存版本前先验收
• 第 3 页：提交前检查三件事
• 第 4 页：提交信息怎么写
• 第 5 页：AI 解释改动
• 第 6 页：版本保存记录