第8课：第三册验收

用公开网址、外部测试、核心功能、环境变量和反馈清单判断是否真的上线成功。

先看一张直觉图

请先看这张图：

这张图想告诉你一件事：

上线验收不是平台显示成功，而是别人真的能打开、能使用、能给你反馈。

第三册的终点不是完美产品。

第三册的终点是：

一个可分享、可测试、可继续改的第一版。

开始之前

请把第三册前面几张卡拿出来。

你应该已经有：

本地/线上区别卡。
我的部署路径图。
部署方式选择卡。
部署配置填写卡。
线上环境变量检查表。
第一次发布记录表。
线上报错描述卡。

如果你的小工具已经能打开，很好。

如果你的小工具还有错误，也可以上这一课。

因为验收不只是判断成功。

验收也包括：

清楚记录现在还差什么。

先看一个小故事

小林终于把“小红书标题助手”发布到了线上。

他自己打开网址，能看到页面。

他输入一句话，点击按钮，也能生成标题。

他很开心，说：

我做完了。

先问：

别人打开过吗？
别人知道怎么用吗？
别人点按钮能不能成功？
别人看不看得懂结果？

小林愣住了。

他把链接发给同桌。

同桌打开后说：

我不知道这里应该输入什么。
生成出来的标题挺好，但按钮文案有点不清楚。
手机上第二行文字有点挤。

小林这才发现：

自己能用，不等于别人能顺利用。

这不是坏事。

这是第一版真正开始被使用。

第 8 课要做的，就是把这种使用结果记录下来。

一、第三册验收不是追求完美

很多人到最后一课，会有一种冲动：

我再加一个功能。
我再美化一下。
我再接一个数据库。
我再做登录。
我再换一个平台。

先停一下。

第三册不是无限优化课。

第三册的验收标准不是：

我的小工具已经像成熟产品一样完美。

第三册的验收标准是：

我的小工具第一版已经能被别人打开、使用、反馈。

第一版可以很小。

第一版可以很朴素。

第一版可以还有下一步。

但它必须有真实验收记录。

二、上线验收要看 5 件事

请按顺序检查。

验收项	要判断什么
公开网址	网址不是 `localhost`，别人也能打开
页面打开	页面能正常显示，没有明显空白或 404
核心功能	输入、点击、输出能完成一次最小流程
外部测试	至少 1 个别人打开并试用过
反馈记录	记录别人哪里看懂、哪里卡住、哪里建议改

这 5 件事都通过，第三册就可以收口。

如果有一项没通过，也不是失败。

你只要写清楚：

哪一项没通过，下一步准备处理什么。

三、公开网址检查

第一项，检查公开网址。

请确认你的网址不是：

http://localhost:3000
http://127.0.0.1:3000

这些是你自己电脑上的地址。

别人打不开。

公开网址通常长得像：

https://你的项目名.某个平台.app
https://你的项目名.某个平台.dev
https://你的项目名.某个平台.com

你不需要背平台后缀。

你只要记住：

能复制给别人打开的，才是第三册要验收的网址。

四、自己先跑一遍最小流程

把自己当成第一次使用的人。

不要只看首页。

请你真的做一遍。

例如 AI 标题助手：

打开公开网址。
看页面是否正常出现。
在输入框输入一句话。
点击生成按钮。
等待结果。
检查结果是否显示。
刷新页面，再看是否还能使用。

如果你的小工具不是标题助手，就换成自己的核心流程。

一个小工具至少要有：

输入 -> 点击/处理 -> 输出

如果没有输入，也可以是：

打开 -> 查看 -> 选择 -> 得到结果

五、换一个环境测试

自己电脑能打开，还不够。

至少再做一个测试：

换一个浏览器。
用手机打开。
用无痕窗口打开。
请别人打开。

不需要每一项都做。

至少做一项。

原因很简单：

有些问题只在别人那里出现。

比如：

你自己登录过，所以能用，别人不能用。
你自己浏览器缓存了，别人看到旧页面。
手机屏幕太窄，文字挤在一起。
别人不知道该点哪里。

这些问题只有外部测试才容易发现。

六、请别人测试，不是让别人夸你

找别人测试时，不要只问：

你觉得怎么样？

这个问题太大。

别人通常会回答：

挺好的。

这对你帮助不大。

更好的问法是：

你能不能打开这个网址？
你看得懂这个工具是做什么的吗？
你知道第一步要点哪里吗？
你能不能完成一次使用？
哪里让你卡住？
你觉得最应该先改哪一个地方？

这些问题更具体。

别人也更容易回答。

七、发给测试者的说明

你可以复制下面这段发给朋友或同事。

我做了一个小工具第一版，想请你帮我测试一下。

公开网址：____

它的用途是：____

请你帮我做 4 件事：
1. 看看这个网址能不能打开。
2. 看看你是否知道这个工具是做什么的。
3. 尝试完成一次使用。
4. 告诉我哪里看不懂、哪里卡住、哪里最应该先改。

不用夸我，直接说问题就可以。
谢谢。

注意：

测试说明越清楚，别人越容易给你有用反馈。

八、填写：上线验收清单

请你填写下面这张卡。

上线验收清单

验收项	结果	证据或备注
公开网址不是 localhost	通过 / 未通过 / 不确定
我自己能打开页面	通过 / 未通过 / 不确定
页面没有明显空白或 404	通过 / 未通过 / 不确定
核心功能能完成一次	通过 / 未通过 / 不确定
刷新后仍然能使用	通过 / 未通过 / 不确定
至少一个别人能打开	通过 / 未通过 / 不确定
至少一个别人完成试用	通过 / 未通过 / 不确定
我记录了测试反馈	通过 / 未通过 / 不确定
我知道下一步先改什么	通过 / 未通过 / 不确定

最后写一句话：

我的第三册验收结果是：通过 / 暂未通过 / 需要补充测试。
原因是：____。

九、填写：测试者反馈表

请至少找 1 个测试者。

如果有条件，找 3 个更好。

测试者反馈表

项目	记录
测试者
使用设备	手机 / 电脑 / 平板
使用浏览器
是否能打开网址	能 / 不能 / 不确定
是否知道工具用途	知道 / 不知道 / 不确定
是否完成一次使用	完成 / 未完成 / 不确定
卡在哪里
看不懂哪里
最有用的地方
最应该先改的地方
我准备采纳的建议

这张表不是为了证明你做得好。

它是为了证明：

你的第一版已经进入真实使用场景。

十、填写：第三册复盘卡

第三册最后，请写一张复盘卡。

第三册复盘卡

问题	我的回答
我的小工具名称
我的公开网址
它解决了什么小问题
本地和线上最大的区别是什么
我选择了什么部署方式
我配置了哪些部署信息
我遇到过什么线上问题
我怎样把错误交给 Codex
现在验收结果	通过 / 暂未通过 / 需要补充测试
我最有成就感的一步
我下一步只改哪一件事

最后一栏很重要。

不要写 10 件事。

只写 1 件事。

因为第三册已经结束。

下一步应该是小步优化，不是重新开一个大坑。

十一、给 Codex 的验收提示词

你可以直接复制下面这段。

我正在做《AI 小工具创造入门》第三册验收。

这是我的小工具信息：
- 小工具名称：____
- 公开网址：____
- 用途：____
- 核心使用流程：____

这是我的上线验收清单：
____

这是测试者反馈：
____

请你帮我做 4 件事：
1. 判断我的第三册验收是否可以通过。
2. 如果不能通过，请指出最关键的一项缺失。
3. 帮我把测试反馈整理成“必须改 / 可以改 / 以后再说”三类。
4. 只建议我下一步先改一件事，不要给我一长串优化计划。

请用完全小白能看懂的话回答。

十二、什么情况算通过

下面这种情况，可以算通过：

有公开网址。
自己能打开并完成核心流程。
至少一个别人能打开并试用。
有测试反馈记录。
知道下一步优先改什么。

下面这种情况，暂时不算通过：

只有 localhost。
只有部署平台截图，没有公开网址。
自己没跑核心流程。
别人没有测试过。
完全没有记录问题和反馈。

下面这种情况，可以算“需要补充测试”：

公开网址能打开。
自己能用。
但还没有别人测试。

这不是失败。

只要补一次外部测试，就能继续验收。

十五、常见误区

误区 1：平台显示成功，就算第三册完成

不够。

还要公开网址、功能测试和别人测试。

误区 2：自己能用，就代表别人能用

不一定。

别人可能打不开，也可能看不懂。

误区 3：别人说“挺好”就够了

不够。

要问具体问题。

误区 4：最后一课应该继续加功能

不建议。

最后一课应该收口。

误区 5：反馈越多，下一步越要全改

不要这样。

先选一件最重要的。

本课最低标准

完成本课，只要做到下面 5 件事：

写出公开网址，或明确说明为什么还没有公开网址。
自己完成一次核心流程测试。
至少邀请 1 个别人测试，或写明还需要补充测试。
填写上线验收清单和测试者反馈表。
写出下一步只改一件事。

如果这 5 件事都完成，第三册就可以收口。

十七、课后任务

提交第三册验收包。

包含：

公开网址。
上线验收清单。
测试者反馈表。
第三册复盘卡。
发给 Codex 的验收提示词。
Codex 给出的下一步建议。

任务最后写一句话：

我的第三册验收结果是：____。
我下一步先改：____。

第三册结束语

第三册结束时，请记住：

你不是只在自己电脑里做了一个小工具。
你已经把它带到了别人可以打开的地方。

这是一件很重要的事。

你不需要马上成为程序员。

你也不需要马上理解所有部署技术。

但你已经知道：

本地和线上不同。
部署是一条路径。
线上问题可以被描述。
第一版可以被别人测试。

这就够了。

一个小白真正开始做项目，不是从掌握所有代码开始。

而是从能把自己的想法做成一个别人能打开的小工具开始。