第8课：第二册验收

本课目标

第二册最后一课，不继续加新功能。

这一课只做一件事：

检查我的小工具是不是已经从“小页面”变成了“小项目”。

第二册完成，不是功能越多越好。

第二册完成，是你能做到：

能力	说明
能运行	知道怎么启动项目
能保存	历史记录刷新后还在
能解释	说得清主要文件和改动
能继续改	有 Git 保存点，下一步只选一个小目标

如果这 4 件事都能做到，第二册就完成了。

开始之前

请准备好你的第二册项目。

你应该至少已经做过：

• 第 1 课：知道编辑器、项目文件夹和浏览器的关系。
• 第 2 课：会用终端启动项目，看懂 localhost。
• 第 3 课：知道 Node、npm 和 package.json 是什么。
• 第 4 课：知道依赖和环境变量为什么会影响项目启动。
• 第 5 课：理解临时显示和持久保存的区别。
• 第 6 课：给小工具加了历史记录。
• 第 7 课：留下了 Git 保存点。

如果你有某一课没完成，不需要假装完成。

第二册验收的目的不是打分。

它的目的，是帮你知道项目现在卡在哪里。

一个小故事

小林完成了“小红书标题助手”的历史记录功能。

它可以输入产品信息，生成标题，也可以保存历史记录。

小林马上想继续加：

收藏、搜索、导出、登录、云同步、手机端适配。

老师让他先停下。

老师只问了 8 个问题：

项目怎么启动？
浏览器地址是什么？
原来的生成功能还在吗？
历史记录刷新后还在吗？
能删除记录吗？
终端有没有报错？
Git 保存点留下了吗？
下一步只改一件事，你选什么？

小林发现，自己虽然做出了功能，但还不能完整回答所有问题。

这就是第二册第 8 课要补上的能力：

不是只会让 AI 改。
而是能验收 AI 改完后的项目。

第二册最终交付物

完成第二册，你手里应该有 5 样东西。

交付物	它证明什么
一个能打开的项目文件夹	项目不是只停留在想法里
一个能运行的启动命令	你知道怎样把项目跑起来
一个能保存的历史记录功能	小工具开始有数据
一张项目验收卡	你知道怎样判断做没做完
一个 Git 保存点	下一步改坏了也有安全边界

如果你只有页面，没有启动方式，不算完成。

如果你只有功能，没有验收表，也不算真正完成。

如果你没有保存点，下一步就容易越改越乱。

第一层验收：能运行

先检查项目能不能打开。

检查项	我的结果	证据
我知道项目文件夹在哪里	通过 / 不通过
我知道用哪个编辑器打开	通过 / 不通过
我知道启动命令	通过 / 不通过
终端能成功启动	通过 / 不通过
浏览器能打开页面	通过 / 不通过
我知道 localhost 地址	通过 / 不通过

这一层不过，不要继续验收功能。

先回到第 1-4 课。

第二层验收：原功能还在

AI 加新功能时，最常见的问题是：

新东西有了，旧东西坏了。

所以要检查第一册做出的核心功能还在不在。

检查项	我的结果	证据
输入框还在	通过 / 不通过
主要按钮还在	通过 / 不通过
能生成或整理结果	通过 / 不通过
输出内容能看懂	通过 / 不通过
页面没有明显错乱	通过 / 不通过

如果原功能坏了，不要先加新功能。

先让 AI 修回原来的主流程。

可以这样说：

请先不要加新功能。现在第一册原有功能出现问题，请帮我对比当前功能和原目标，优先恢复输入、生成、输出这条主流程。

第三层验收：历史记录真的保存了

第 6 课的核心功能，要用真实动作验收。

不要只看 AI 说“已经完成”。

你要自己做一遍。

测试动作	预期结果	我的结果
输入一条测试内容	页面能接收输入	通过 / 不通过
点击生成或处理	出现结果	通过 / 不通过
保存到历史记录	历史列表出现新记录	通过 / 不通过
刷新页面	历史记录还在	通过 / 不通过
删除这条记录	这条记录消失	通过 / 不通过
再刷新页面	被删除的记录不会回来	通过 / 不通过

这里最重要的是两句话：

刷新后还在，才叫保存。
删除后不回来，才叫删除成功。

如果刷新后记录丢了，回到第 5-6 课。

如果删除后又出现，说明保存逻辑还没有处理干净。

第四层验收：你能解释项目

第二册不是让你变成程序员。

但你至少要能用人话解释自己的项目。

请填写这张表。

问题	我的回答
这个小工具解决什么小问题
项目怎样启动
页面地址是什么
主要输入是什么
主要输出是什么
历史记录保存什么
历史记录大概保存在哪里
AI 这次主要改了哪些文件
我最不懂的地方是什么

如果你完全说不出来，说明项目已经变成黑盒。

这时不要急着进入后续新内容。

先让 AI 帮你解释项目。

请你不要改代码。请用完全不会代码的人也能听懂的话，解释这个项目现在由哪些部分组成，怎样启动，历史记录功能大概是怎样工作的。

第五层验收：能继续改

能继续改，不是指马上加很多功能。

能继续改，是指你有一个清楚、稳定、可恢复的下一步。

检查项	我的结果
当前项目已经留下 Git 保存点	通过 / 不通过
保存点说明我看得懂	通过 / 不通过
我知道下一步只改一件事	通过 / 不通过
我知道哪些事情暂时不做	通过 / 不通过
我知道如果改坏了要先问 AI 检查而不是乱回退	通过 / 不通过

第二册结束时，最好的状态不是“功能很多”。

最好的状态是：

项目小，但清楚。
功能少，但能跑。
下一步慢，但稳。

第二册总验收卡

请把前面的结果汇总到这里。

检查项	结果	证据
项目能正常启动	通过 / 不通过
页面能正常打开	通过 / 不通过
第一册原有功能还在	通过 / 不通过
能生成或整理结果	通过 / 不通过
能保存历史记录	通过 / 不通过
刷新后历史记录还在	通过 / 不通过
能删除不需要的记录	通过 / 不通过
删除后刷新不会回来	通过 / 不通过
能说清主要文件	通过 / 不通过
能说清运行命令	通过 / 不通过
留下 Git 保存点	通过 / 不通过
下一步只选一个小目标	通过 / 不通过

证据可以很简单。

比如：

终端显示启动成功。
浏览器地址是 http://localhost:3000。
保存一条记录后刷新，记录还在。
Git 保存点说明是：完成历史记录本地保存和删除。

三种验收结果

验收以后，把项目放进下面三种状态之一。

状态	说明	下一步
第二册完成	能运行、能保存、能解释、能留保存点	可以准备后续学习
主流程完成但有小问题	大部分可用，但还有一个明确问题	只修一个问题
还没完成第二册	跑不起来、保存不稳定或说不清项目	回到对应课程补齐

注意：

不要把“想继续加功能”当成“第二册完成”。

第二册完成，靠验收。

不是靠兴奋。

不通过时回到哪一课

如果验收不通过，不要慌。

按问题回到对应课程。

问题	回到哪一课
不知道编辑器和项目文件夹	第 1 课
不知道终端和 localhost	第 2 课
不知道启动命令在哪里	第 3 课
依赖安装或环境变量问题	第 4 课
不知道什么叫保存	第 5 课
历史记录功能不完整	第 6 课
不知道 AI 改了什么	第 7 课
没有保存点	第 7 课

这张表的意义是：

问题不是失败。
问题只是告诉你该回到哪一课。

给 AI 的一句话：第二册验收

请复制这句话给 Codex。

请你帮我做第二册项目验收。请不要建议新功能，先只检查：项目怎样运行、原功能是否还在、历史记录是否能保存和刷新保留、是否能删除记录、AI 改了哪些文件、是否适合留下 Git 保存点、下一步只改什么。请用表格给我验收结果，并把不通过的项目对应到第二册哪一课。

如果 AI 开始建议新功能，你要拉回来：

先不要进入新功能。请只做第二册验收，不讨论后续课程和上线。

第二册毕业说明

当你通过第二册验收后，可以用下面这段话介绍自己的项目：

我已经做出一个可以运行的小工具。
它有输入、输出和历史记录。
历史记录刷新后还在，也可以删除。
我知道项目怎样启动，知道 AI 主要改了哪些文件。
我已经留下 Git 保存点，下一步会只选择一个小目标继续改。

这段话比“我做了一个 AI 项目”更重要。

因为它说明你不是只靠运气做出来。

你开始有项目意识了。

本课小结

第二册不是为了让你学会很多专业名词。

第二册是为了让你的小工具从“能看见的页面”变成“能继续维护的小项目”。

你现在应该知道：

项目在哪里。
项目怎么启动。
项目为什么会报错。
数据怎样算保存。
历史记录怎样验收。
AI 改了什么要看。
重要节点要留下保存点。

这就是第二册的价值。

本课最低标准

完成本课后，你至少要能说出：

第二册完成 = 能运行、能保存、能解释、能继续改。

并且你完成了 4 件事：

最低动作	是否完成
完成第二册总验收卡	完成 / 未完成
用真实刷新测试验证历史记录	完成 / 未完成
让 AI 解释当前项目改动	完成 / 未完成
确认已有 Git 保存点和下一步小目标	完成 / 未完成