第三册 Codex 提示词卡片

使用原则

第三册不是让 Codex 替你乱点部署平台，也不是让 AI 一次性重写项目。

第三册和 Codex 协作时，先记住五句话：

请先不要改代码。
请先判断我的项目适合怎样上线。
请告诉我依据来自哪些文件。
请不要让我公开真实 API Key、Token 或密码。
请一次只处理一个上线问题。

部署上线时，最容易犯的错不是不会写代码，而是信息给不完整：

• 没说项目类型。
• 没说运行命令。
• 没说部署平台。
• 没贴完整构建日志。
• 把真实密钥发给 AI。
• 平台显示成功后没有让别人测试。

这套卡片的目标，是让你把上线过程说清楚、做小步、能验收。

复制前检查

每次复制提示词前，先补齐这些信息：

我的项目名称：
我的项目现在能否本地运行：
本地运行地址：
我使用的部署平台：
我刚才做了什么：
我期待发生什么：
实际发生了什么：
我看到的网址、日志或报错：

如果涉及环境变量，只写变量名和用途，不要粘贴真实值。

8 课提示词对照表

课次	推荐卡片	使用目的	产出
第 1 课：本地和线上不是一回事	卡片 1、2	解释本地、线上、localhost 和公开网址	本地/线上区别卡
第 2 课：部署到底是什么	卡片 3、4	拆出从本地到线上路径	我的部署路径图
第 3 课：选择最简单的部署方式	卡片 5、6	判断项目类型和部署方式	部署方式选择卡
第 4 课：构建命令和输出目录	卡片 7、8、9	判断 install/build/output/start 配置	部署配置填写卡
第 5 课：线上环境变量和 API Key	卡片 10、11、12	列变量名、检查安全、准备线上配置	线上环境变量检查表
第 6 课：第一次发布小工具	卡片 13、14	发布前检查和发布陪跑	第一次发布记录表
第 7 课：本地能跑，线上为什么会坏	卡片 15、16、17	收集线上证据，分类报错，最小修复	线上报错描述卡
第 8 课：第三册验收	卡片 18、19、20	上线验收、测试反馈、复盘收束	上线验收清单和复盘卡

卡片使用格式

每张卡片建议按这个顺序使用：

1. 先复制卡片。
2. 把【填写】部分补完整。
3. 如果还没准备好，明确写“请先不要改代码”。
4. 如果要执行，明确写“只改和这个目标有关的文件”。
5. 执行后，用验收卡片检查结果。

如果 AI 开始讲服务器、Docker、Nginx、CI/CD、复杂数据库迁移，先停下来，用卡片 6 缩小范围。

卡片 1：解释本地和线上

使用场景：

第 1 课刚开始，你可能只知道自己的小工具能在电脑上打开，但不知道别人为什么打不开。

请你先不要改代码。

请根据这个项目，用完全不会代码的新手也能听懂的话解释：
1. 什么是本地；
2. 什么是线上；
3. localhost 为什么通常只有我自己能打开；
4. 公开网址和 localhost 有什么不同；
5. 如果我想让别人也能打开，大概要经历哪些步骤。

请不要讲复杂服务器知识。
请最后帮我整理成“本地/线上区别卡”。

卡片 2：判断我的项目现在处在哪一步

使用场景：

你不知道自己的项目是“还在本地”，还是“已经上线但没验收”。

请你先不要改代码。

请根据我提供的信息，判断我的项目现在处在哪一步：

本地运行地址：
【填写】

是否有公开网址：
【填写】

公开网址是：
【填写，没有就写没有】

别人是否测试过：
【填写】

请你判断它属于：
1. 只在本地；
2. 已经部署但还没验收；
3. 已经上线并通过外部测试；
4. 信息不足，还不能判断。

请说明判断理由，并告诉我下一步最小动作。

卡片 3：解释部署路径

使用场景：

第 2 课，把“部署”理解成一条路径。

请你先不要改代码。

请阅读这个项目，并用小白能听懂的话说明：
1. 如果我要部署这个项目，它从本地到线上大概要经历哪些步骤；
2. 哪些步骤是部署平台会帮我做的；
3. 哪些信息需要我自己提供；
4. 哪些步骤可能失败；
5. 失败时我应该复制哪些信息给你。

请按这个顺序解释：
本地项目 -> 上传或连接平台 -> 安装依赖 -> 构建 -> 发布 -> 公开网址。

卡片 4：把部署路径填成表

使用场景：

你听懂部署路径后，要填“我的部署路径图”。

请你先不要改代码。

请帮我把当前项目的部署路径整理成一张表：

| 步骤 | 这一步在做什么 | 我需要准备什么 | 可能出错在哪里 |

请覆盖：
1. 本地项目；
2. 上传或连接部署平台；
3. 安装依赖；
4. 构建项目；
5. 发布；
6. 获得公开网址；
7. 验收。

请不要推荐复杂服务器方案。

卡片 5：判断项目类型和最简单部署方式

使用场景：

第 3 课，不请你自己猜部署方式。

请你先不要改代码。

请阅读这个项目的文件结构和配置文件，判断：
1. 这是静态网站、前端项目、Node 应用，还是其它类型；
2. 它是否有 package.json；
3. 它是否需要构建；
4. 它是否需要后端服务；
5. 它是否使用环境变量；
6. 它适合哪一类最简单的部署方式。

请给出推荐方式和理由。
请明确说明“我现在不建议使用哪些复杂方式”，例如云服务器、Docker、Nginx、CI/CD。

卡片 6：缩小部署范围

使用场景：

AI 给出太复杂的方案，或者开始讲一堆平台、服务器和企业部署。

请停止扩展复杂方案。

我的目标只是第三册最小上线：
让别人能打开我的小工具第一版。

请你把方案缩小到：
1. 最简单可行的部署路径；
2. 最少需要填写的配置；
3. 最少需要检查的环境变量；
4. 第一次发布后的验收步骤。

请不要讲：
Linux 服务器、Docker、Nginx、CI/CD、复杂数据库迁移、登录权限、支付、性能优化。

请重新给我一个小白可执行的最小方案。

卡片 7：判断部署配置

使用场景：

第 4 课，部署平台问 install command、build command、output directory、start command。

请你先不要改代码。

请根据这个项目的 package.json、文件结构和运行方式，帮我判断部署平台里这些配置应该怎么填：
1. Install Command；
2. Build Command；
3. Output Directory；
4. Start Command；
5. Root Directory；
6. Node Version 是否需要指定。

请说明每一项的依据来自哪里。
如果某一项不需要填写，请明确写“不需要”，不要让我乱猜。

卡片 8：解释 package.json 和部署的关系

使用场景：

你看不懂 scripts，不知道部署平台为什么要执行命令。

请你先不要改代码。

请打开 package.json，并只解释和部署有关的部分：
1. scripts 里有哪些命令；
2. 哪个命令用于本地运行；
3. 哪个命令用于构建线上版本；
4. dependencies 和 devDependencies 大概是什么；
5. 部署平台为什么要先安装依赖；
6. 如果 build 命令失败，通常应该看哪里。

请用小白能听懂的话解释。
最后帮我写一段可以填进“部署配置填写卡”的摘要。

卡片 9：检查部署配置是否合理

使用场景：

你已经填了部署配置，想让 AI 检查有没有明显问题。

请你先不要改代码。

这是我准备填写到部署平台的配置：

部署平台：
【填写】

Root Directory：
【填写】

Install Command：
【填写】

Build Command：
【填写】

Output Directory：
【填写】

Start Command：
【填写】

请根据项目文件判断这些配置是否合理。
如果不合理，请告诉我：
1. 哪一项可能错；
2. 为什么错；
3. 应该去哪个文件找依据；
4. 最小修改建议是什么。

卡片 10：检查项目需要哪些环境变量

使用场景：

第 5 课，准备线上环境变量。

请你先不要改代码。
请不要让我公开任何真实 API Key、Token、密码或数据库地址。

请检查这个项目是否使用了环境变量或 .env。
请告诉我：
1. 项目需要哪些环境变量名；
2. 每个变量大概负责什么；
3. 哪些变量上线时需要配置到部署平台；
4. 哪些变量不能公开；
5. 缺少这些变量时，线上可能出现什么现象。

如果项目里有 .env.example，请优先根据它判断。
请只列变量名，不要要求我粘贴真实值。

卡片 11：环境变量安全检查

使用场景：

你准备把配置发给 AI 或填到平台前，先检查是否泄露密钥。

请你帮我做环境变量安全检查。
请不要记录、复述或展示任何真实密钥。

我会只提供变量名，不提供真实值：

变量名清单：
【填写变量名，不填真实值】

请帮我判断：
1. 哪些变量看起来像密钥；
2. 哪些变量可以公开说明用途；
3. 哪些变量绝对不能发到公开聊天、截图或文档里；
4. 我在部署平台填写时应该注意什么；
5. 如果我不小心公开了密钥，应该立刻做什么。

请用新手能执行的语言回答。

卡片 12：线上环境变量配置前检查

使用场景：

你准备在部署平台填写环境变量。

请你先不要改代码。

我准备在部署平台配置环境变量。

部署平台：
【填写】

项目使用的变量名：
【填写变量名，不填真实值】

本地是否有 .env：
【填写】

是否有 .env.example：
【填写】

请帮我检查：
1. 哪些变量上线时必须配置；
2. 哪些变量可能只在本地开发需要；
3. 配置后是否需要重新部署；
4. 我应该怎样记录“已配置但不公开真实值”；
5. 发布后怎样判断是否因为环境变量出错。

卡片 13：第一次发布前检查

使用场景：

第 6 课，点击发布前做最后检查。

请你先不要改代码。

我准备第一次发布这个小工具。

请根据以下信息帮我做发布前检查：

项目是否能本地运行：
【填写】

部署方式：
【填写】

部署配置：
【填写】

环境变量是否已检查：
【填写】

Git 或项目保存点是否已准备：
【填写】

请告诉我：
1. 现在是否可以尝试第一次发布；
2. 发布前最应该确认的 5 件事；
3. 哪些信息要记录到“第一次发布记录表”；
4. 发布成功后第一步验收是什么；
5. 如果失败，应该先复制哪些日志。

卡片 14：发布陪跑

使用场景：

你正在按平台提示发布，希望 AI 一步步陪着检查，但不乱改项目。

请你作为第三册上线陪跑助手。
请一次只给我一步，不要一次给一大串操作。

我的部署平台是：
【填写】

我现在停在这一步：
【填写】

平台正在问我或显示的是：
【填写】

请你告诉我：
1. 这一步是什么意思；
2. 我需要从项目哪个文件找依据；
3. 我现在应该填写什么，或者应该先暂停；
4. 如果不确定，应该截图或复制哪段文字给你。

请不要让我公开真实密钥。

卡片 15：线上报错信息收集

使用场景：

第 7 课，线上坏了，但你不知道该贴什么给 AI。

请你先不要改代码。

我的线上项目出现问题了。
我先收集信息，请你帮我判断还缺什么。

公开网址：
【填写】

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

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

实际发生什么：
【填写】

页面错误或浏览器控制台信息：
【填写，没有就写没有】

部署日志：
【粘贴完整相关日志】

本地是否能正常运行：
【填写】

环境变量配置情况：
【只写是否配置和变量名，不写真实值】

请先告诉我信息是否足够。
如果不够，请告诉我还要补哪一项。

卡片 16：线上报错分类

使用场景：

你已经收集了网址、操作、日志和本地情况，想先分类。

请你先不要改代码。

请根据我提供的线上问题信息，先判断问题可能属于哪一类：
1. 构建失败；
2. 环境变量缺失；
3. 接口或 API 请求错误；
4. 路径或路由错误；
5. 浏览器端错误；
6. 依赖或版本问题；
7. 其它；
8. 信息不足。

请按可能性排序。
每一类请说明依据。
最后请给我最小排查步骤，不要直接重写项目。

卡片 17：线上问题最小修复

使用场景：

AI 已经判断出问题类别，准备修复。

现在可以开始处理这个线上问题，但请保持最小修改。

问题类别：
【填写】

相关日志：
【粘贴】

本地情况：
【填写】

请你先说明：
1. 准备改哪些文件；
2. 为什么只需要改这些文件；
3. 改完后我如何本地验证；
4. 改完后我如何重新部署验证；
5. 如果这次修不好，下一步看什么。

请不要顺手重构项目，不要加入新功能。
确认后再执行修改。

卡片 18：上线验收清单

使用场景：

第 8 课，平台说成功后，不能只相信平台提示。

请你帮我设计一张第三册上线验收清单。

我的项目核心功能是：
【填写】

公开网址是：
【填写】

请检查清单至少覆盖：
1. 网址是否能打开；
2. 首屏是否正常；
3. 输入是否可用；
4. 按钮或主要操作是否可用；
5. 输出是否正确；
6. 刷新后是否符合预期；
7. 手机或另一台设备是否能打开；
8. 是否有明显报错；
9. 是否有外部测试者反馈；
10. 是否记录了版本和部署时间。

请把清单做成“是 / 否 / 备注”格式。

卡片 19：整理给测试者的话

使用场景：

你要把公开网址发给朋友或同事测试。

请帮我写一段发给测试者的话。

我的小工具名称：
【填写】

公开网址：
【填写】

它主要帮人做什么：
【填写】

我希望测试者重点试：
【填写 1-3 件事】

请帮我写得简单、礼貌、清楚。
请包含：
1. 打开网址；
2. 做一个简单测试；
3. 告诉我是否能正常使用；
4. 如果出错，请发截图或描述操作步骤；
5. 不需要提复杂技术词。

卡片 20：第三册复盘

使用场景：

第三册最后收束，你要总结这次上线学到了什么。

请你根据我这次第三册上线记录，帮我整理一份复盘。

项目名称：
【填写】

公开网址：
【填写】

部署平台：
【填写】

部署方式：
【填写】

部署配置：
【填写】

环境变量情况：
【只写变量名和是否配置，不写真实值】

遇到的问题：
【填写】

最终验收结果：
【填写】

请帮我整理：
1. 我这次做成了什么；
2. 我现在能解释哪些上线概念；
3. 我还不懂什么；
4. 下次上线前我应该先检查什么；
5. 这个小工具下一步最小改进是什么。

请不要把下一步扩成大项目，只给一个最小改进建议。

最低合格标准

你不需要把 20 张卡片全部背下来。

第三册提示词卡片的最低合格标准是：

你能在部署前让 AI 判断项目类型和配置。
你能在环境变量处保护真实密钥。
你能在线上报错时复制完整证据。
你能在发布后用清单验收，而不是只看平台成功提示。