第三册练习册

使用说明

这本练习册不是部署命令手册，也不是平台操作说明。

它的作用是帮你把第三册的上线过程，整理成一张张可以填写、可以交给 AI、可以用来验收的小卡片。

你不需要把所有部署技术都学会。你只需要做到：

知道本地和线上有什么不同。
知道自己的项目适合怎样上线。
知道平台问配置时该看哪里。
知道环境变量不能乱公开。
知道线上报错要复制什么。
知道怎样证明别人真的能打开。

第三册练习册的最终目标是帮你完成：

一个别人能打开的小工具第一版

打印和使用方式

如果作为纸质材料使用，建议这样分发：

第 1-2 课：本地、线上和部署路径包。
第 3-5 课：部署方式、部署配置和环境变量包。
第 6-8 课：发布记录、线上报错、上线验收和复盘包。

每张表只要求你填写关键事实，不要求写成专业技术文档。

复盘时优先看四件事：

1. 是否知道自己的项目处在哪一步。
2. 是否能把部署信息完整交给 AI。
3. 是否保护了真实 API Key、Token、密码。
4. 是否真的拿到了公开网址并让别人测试。

8 课练习对照表

课次	对应练习	本课必须交	可以选交
第 1 课：本地和线上不是一回事	练习 1	本地/线上区别卡	localhost 解释摘要
第 2 课：部署到底是什么	练习 2	我的部署路径图	AI 给出的部署步骤摘要
第 3 课：选择最简单的部署方式	练习 3	部署方式选择卡	复杂方式暂缓清单
第 4 课：构建命令和输出目录	练习 4	部署配置填写卡	package.json 配置依据摘要
第 5 课：线上环境变量和 API Key	练习 5	线上环境变量检查表	密钥安全自查
第 6 课：第一次发布小工具	练习 6	第一次发布记录表、公开网址	发布步骤截图说明
第 7 课：本地能跑，线上为什么会坏	练习 7	线上报错描述卡	无报错记录
第 8 课：第三册验收	练习 8、练习 9、练习 10	上线验收清单、测试者反馈表、第三册复盘卡	小项目介绍草稿

练习 1：本地/线上区别卡

使用场景

第 1 课使用。

当你发现自己的小工具只能在自己电脑上打开时，先不要急着部署。先把“本地”和“线上”分清楚。

填写区

项目	我的填写
我的项目名称
我本地打开项目的地址
这个地址里有没有 localhost
localhost 用我的话解释是
别人为什么不能直接打开这个地址
我希望以后别人打开的网址应该是什么样
我的小工具现在属于本地、线上还是不确定

检查表

检查项	是	还不清楚
我知道 localhost 只代表我自己的电脑
我知道本地能跑不等于别人能打开
我知道公开网址不是 localhost
我知道第三册要做的是让别人也能访问

给 Codex 的提示词

请你先不要改代码。
请根据我这个项目，用小白能听懂的话解释：
1. 什么是本地；
2. 什么是线上；
3. 为什么 localhost 只能我自己打开；
4. 如果我想让别人打开这个小工具，大概要经历哪些步骤。
请不要讲复杂服务器知识，只讲到我能理解部署前的区别。

练习 2：我的部署路径图

使用场景

第 2 课使用。

部署不是神秘按钮。你要先知道自己的项目从本地到线上，大概要走哪条路。

填写区

问题	我的答案
我的项目现在在哪里
项目需要上传或连接到哪里
部署平台可能要先安装什么
部署平台可能要执行什么构建步骤
发布后我会得到什么
这条路径里我最不懂的一步是

路径图

本地项目
  ->
上传或连接到部署平台
  ->
安装依赖
  ->
构建项目
  ->
发布
  ->
公开网址

我能说清吗

检查项	是	还不清楚
我知道部署不是魔法
我知道部署通常包括上传、安装、构建、发布
我知道平台成功不等于最终验收完成
我知道公开网址要自己打开检查

给 Codex 的提示词

请你先不要改代码。
请阅读这个项目，并用小白能听懂的话说明：
1. 如果我要部署这个项目，它从本地到线上大概要经历哪些步骤；
2. 哪些步骤是部署平台会帮我做的；
3. 哪些信息需要我提供；
4. 哪些问题可能会导致部署失败。
请用“本地 -> 上传 -> 构建 -> 发布 -> 公开网址”的顺序解释。

练习 3：部署方式选择卡

使用场景

第 3 课使用。

不同项目适合不同上线方式。不要自己乱选，先让 AI 看项目结构。

填写区

项目	我的填写
我的项目名称
AI 判断我的项目类型	静态网站 / 前端项目 / Node 应用 / 其它 / 不确定
AI 推荐的部署方式
推荐理由
这个方式最简单在哪里
这个方式可能会遇到的问题
我暂时不选择的复杂方式
为什么暂时不选择

选择检查

检查项	是	否	备注
AI 已经看过项目结构
AI 已经看过 package.json
我知道项目是否需要构建
我知道是否需要环境变量
我没有选择需要复杂服务器配置的方式

给 Codex 的提示词

请你先不要改代码。
请根据这个项目的文件结构、package.json 和运行方式，判断：
1. 这个项目更像静态网站、前端项目，还是 Node 应用；
2. 它适合用哪一类最简单的部署方式；
3. 部署时大概需要哪些配置；
4. 哪些复杂部署方式现在不建议我碰。
请用表格告诉我，并给出你的推荐理由。

练习 4：部署配置填写卡

使用场景

第 4 课使用。

平台问构建命令、输出目录、安装命令时，不要猜。让 AI 根据项目文件判断。

填写区

项目	我的填写
项目名称
package.json 是否存在
scripts 里有哪些命令
安装命令
构建命令
输出目录
启动命令，如果需要
AI 的判断依据
我还不确定的配置

配置检查

配置项	已填写	不需要	还不确定	依据
install command
build command
output directory
start command
root directory

常见提醒

npm run dev 通常是本地开发命令，不一定是线上构建命令。
dist、out、build 都可能是输出目录，但不能靠猜。
如果某项不需要，要让 AI 明确说“不需要”。

给 Codex 的提示词

请你先不要改代码。
请根据这个项目的 package.json、文件结构和运行方式，帮我判断部署平台里这些配置应该怎么填：
1. install command；
2. build command；
3. output directory；
4. start command，如果需要的话；
5. root directory，如果需要的话。
请说明每一项的判断依据。
如果某一项不需要，请明确说“不需要”，不要猜。

练习 5：线上环境变量检查表

使用场景

第 5 课使用。

上线后，项目不在你电脑上运行。本地 .env 里的配置，需要检查哪些要放到部署平台。

安全提醒

变量名可以写出来。
真实 API Key、Token、密码不要写在这张公开表里。
如果必须记录真实值，请放在安全的密码管理工具里。

填写区

变量名	用途	本地是否有	线上是否已配置	是否包含真实密钥	是否可以公开

检查问题

问题	我的答案
我的项目是否使用 .env
哪些变量上线必须配置
哪些变量只是本地开发用
我有没有把真实密钥贴进公开聊天或公开文档
如果线上调用 AI 失败，可能和哪些变量有关

给 Codex 的提示词

请你先不要改代码。
请检查这个项目是否使用了环境变量或 .env。
请告诉我：
1. 项目需要哪些环境变量；
2. 每个变量大概负责什么；
3. 哪些变量上线时需要配置到部署平台；
4. 哪些值不能直接写进代码；
5. 我应该怎样检查线上是否缺少环境变量。
如果需要我提供真实 API Key，请只让我写变量名，不要让我把真实值贴出来。

练习 6：第一次发布记录表

使用场景

第 6 课使用。

第一次发布时，不要只记住“好像成功了”。你要把关键步骤和公开网址记录下来。

发布前检查

检查项	是	否	备注
本地项目能运行
部署方式已经选择
部署配置已经填写
环境变量已经检查
没有公开真实密钥

发布记录

项目	我的填写
部署平台
项目名称
部署方式
安装命令
构建命令
输出目录
环境变量是否已配置
第一次发布时间
公开网址
我第一次打开网址看到什么
平台是否显示发布成功
我自己是否已经打开检查

给 Codex 的提示词

我要第一次发布这个小工具。
请你先根据当前项目和我已经填写的部署配置，陪我一步一步检查：
1. 项目是否能本地运行；
2. package.json 里的命令是否清楚；
3. 部署平台需要填写哪些配置；
4. 哪些环境变量需要先配置；
5. 发布成功后我应该怎样验收。
请每次只给我下一步，不要一次性给太多步骤。

练习 7：线上报错描述卡

使用场景

第 7 课使用。

本地能跑，线上坏了，很常见。先不要慌，也不要让 AI 重写项目。先收集信息。

报错描述公式

网址 -> 操作 -> 期待 -> 实际 -> 日志 -> 本地情况 -> 环境变量 -> 请 AI 分类

填写区

项目	我的填写
线上网址
我做了什么操作
我期待发生什么
实际发生什么
部署日志里有什么
浏览器页面显示什么
浏览器控制台有没有错误
本地是否还能运行
环境变量是否配置
我最近改过什么
请 AI 判断的问题类别	构建失败 / 环境变量缺失 / 接口错误 / 路径错误 / 浏览器错误 / 其它 / 不确定

信息完整度检查

检查项	已提供	缺少
线上网址
操作步骤
期待结果
实际结果
部署日志
浏览器错误
本地运行情况
环境变量情况

给 Codex 的提示词

我的项目本地和线上表现不一样。

线上网址：
【填写】

我做了什么操作：
【填写】

我期待发生什么：
【填写】

实际发生什么：
【填写】

部署日志：
【粘贴完整日志或关键错误】

浏览器页面或控制台错误：
【粘贴】

本地运行情况：
【填写】

环境变量配置情况：
【填写】

请你先判断问题可能属于哪一类：构建失败、环境变量缺失、接口错误、路径错误、浏览器错误或其它。
请先定位原因，不要一次性重写项目。

练习 8：上线验收清单

使用场景

第 8 课使用。

平台说成功，不等于别人真的能用。你需要自己验收。

基础验收

检查项	通过	未通过	备注
有公开网址
网址不是 localhost
我自己能打开
页面不是空白
核心功能能使用
如果有历史记录，刷新后符合预期
没有明显报错
我知道项目部署在哪里
我知道线上环境变量是否配置

外部验收

项目	我的填写
测试者姓名或昵称
测试者设备
测试者是否能打开
测试者是否能完成核心操作
测试者遇到的问题
我准备下一步只改的一件事

给 Codex 的提示词

我已经有一个线上网址：
【填写】

我的小工具功能是：
【填写】

请你帮我设计一张第三册上线验收清单，检查：
1. 别人能否打开；
2. 页面是否正常显示；
3. 核心功能是否可用；
4. 如果有历史记录，刷新后是否符合预期；
5. 是否有明显报错；
6. 测试者应该反馈哪些内容。

请再帮我写一段发给测试者的简短说明。

练习 9：测试者反馈表

使用场景

第 8 课使用。

至少找 1 位不是你自己的测试者打开线上网址。

发给测试者的话

这是我用 AI 做的一个小工具第一版：
【填写网址】

请你帮我测试三件事：
1. 你能不能打开；
2. 你能不能完成一次核心操作；
3. 你觉得哪里看不懂或不好用。

它现在只是第一版，不需要评价它是否完美。

测试反馈记录

测试者	设备	能打开吗	能完成核心操作吗	遇到的问题	建议

反馈整理

问题	我的答案
最重要的问题
最容易改的一件事
暂时不改的建议
为什么暂时不改

练习 10：第三册复盘卡

使用场景

第三册结束时使用。

复盘不是写感想，而是把上线过程整理成下一次还能用的方法。

项目档案

项目	我的填写
项目名称
项目功能
本地地址
公开网址
部署平台
部署方式
构建命令
输出目录
是否使用环境变量
测试者数量

我学会了什么

问题	我的回答
本地和线上有什么不同
部署大概是什么
平台问配置时我应该看哪里
线上环境变量有什么用
线上报错时我应该复制什么
怎样判断别人真的能打开

第三册完成判断

标准	是	否	备注
我有公开网址
这个网址不是 localhost
至少一个别人能打开
核心功能能使用
我完成了上线验收清单
我记录了测试者反馈
我知道下一步只改一件事

下一步只改一件事

问题	我的答案
我最想改的一件事
为什么只改这一件
我准备怎样请 AI 帮我

最终交付清单

第三册结束时，你至少要留下：

• 本地/线上区别卡。
• 我的部署路径图。
• 部署方式选择卡。
• 部署配置填写卡。
• 线上环境变量检查表。
• 第一次发布记录表。
• 公开网址。
• 线上报错描述卡，或当前无报错记录。
• 上线验收清单。
• 测试者反馈表。
• 第三册复盘卡。