Vibe GuideBETA

准备部署脚本或安装包

安装包、静态网页和需要后端的网站,使用方法不同;让工具按你的项目准备。

做完这一节点,你会得到什么?
下一步能按记录找到同一份交付文件。
为什么要有这一节点?

按选好的方式准备文件,并照使用说明实际打开试一次。

开始操作共 2 个步骤 · 按顺序完成

0102准备交付物,并实际试运行待核对展开这一步收起这一步
准备用户要打开的网页或安装包
按选定方式试安装或部署一次
从实际入口检查项目能否使用
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

检查通过的交付准备清单。

做完后要留下什么?

下一步能按记录找到同一份交付文件。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/design.md · docs/delivery.md · docs/release.md

让 AI 将结果保存到:docs/release.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

按选好的方式准备文件,并照使用说明实际打开试一次。

弄懂原理,再试着自己判断

这个概念是什么意思?

安装包、静态网页和需要后端的网站,使用方法不同;让工具按你的项目准备。

换个情况,你会怎样判断?

安装包生成了,但没有在目标系统打开过,应记录成功还是待验证?

查看参考答案

产物生成可以记录成功,但目标系统试运行仍是待验证。两个状态分开写,不能推断安装可用。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

项目对话和测试环境

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 让工具按已选方式准备给使用者的文件。展开收起

    建议提示词:

    请读 docs/design.md、docs/delivery.md 和 docs/release.md。按已确认方式准备交付文件,告诉我保存位置、使用者需要安装什么以及怎样启动。只自用时可以提供源码和运行说明,不强行做安装包。

    完成后应该看到:找到真实文件和配套使用说明。

  2. 在独立测试目录或目标设备中,像接收者一样照说明打开并使用。展开收起

    建议提示词:

    请给出独立试运行的方法,不借用已经启动的开发服务。用测试资料检查打开、保存、读取和重开,保留原项目数据。

    完成后应该看到:接收者按说明可以使用主要功能。

  3. 把这次试运行记录保存下来。展开收起

    建议提示词:

    请将文件位置、版本、实际入口、试运行结果和出错后的恢复方法写入 docs/release.md。未测项保留,先不要正式发布。

    完成后应该看到:下一步能按记录找到同一份交付文件。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

让 Codex 准备启动说明和依赖文件,在独立测试副本试运行;数据库用测试数据,不复制私人记录。

做完这一步,应该看到什么?
从干净副本可以启动前后端、保存并读回一条记录。
做不下去时,先怎么办?
不能把当前电脑的 .venv 整个复制当通用安装包;应按依赖记录重新建立环境。

04不会具体操作?逐项跟着做

展开收起
  1. 让工具按已选方式准备给使用者的文件。

    操作后应该看到什么?
    找到真实文件和配套使用说明。
    没有看到这个结果时,怎么办?
    缺配置时用占位说明,不能把真实密码和用户数据库打进公开文件。
  2. 在独立测试目录或目标设备中,像接收者一样照说明打开并使用。

    操作后应该看到什么?
    接收者按说明可以使用主要功能。
    没有看到这个结果时,怎么办?
    仅在开发电脑可用时,核对依赖、配置和数据位置;缺设备就记未测试。
  3. 把这次试运行记录保存下来。

    操作后应该看到什么?
    下一步能按记录找到同一份交付文件。
    没有看到这个结果时,怎么办?
    测试失败先记问题并修复,不把“生成成功”当成“能用”。

05这一步出现的词

展开收起

构建 ↗

把源文件处理成可运行或发布的产物。

把材料加工成成品,还需实际验收。

构建产物 ↗

构建生成的文件或软件包。

出厂的实际成品。

代码签名 ↗

为软件附加可验证发布者与完整性的信息。

封条帮助核对来源,不保证产品没有缺陷。

06遇到问题时,应该怎么处理?

展开收起

安装包打不开或部署后启动失败

先检查哪里,确认问题的原因?
核对目标系统、构建版本和完整错误,不跳过系统安全提示。
按下面的方法处理问题
保留交付物和日志,返回反馈记录。请 AI 核对系统兼容、运行依赖和合法签名/平台要求,在测试环境修复再试,不覆盖现有可用版本。
恢复后应该看到
重新执行原操作,得到本页要求的实际结果;未执行的检查仍标为未验证。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

实际交付物试运行通过,有使用及恢复说明,正式发布仍需本人确认。

09没有看到预期结果,接下来怎么办?

展开收起

缺配置时用占位说明,不能把真实密码和用户数据库打进公开文件。

看结果对照(教学示意,不是你的项目结果)
仓库 → 项目实际构建命令 → 输出目录/安装包 → 测试目标 → 普通用户操作 → 试运行证据。
按我的项目类型,展开具体操作

只选择项目实际需要的分支。每次只做一项,使用该项下面的提示词;已逐项完成时,不必再发送末尾的完整模板。命令、配置值由AI读取当前项目确定;账号和渠道条件以当前官方说明为准。

只在自己电脑使用

不需要公开网址、商店或给别人安装。

  1. 打开 README,找到启动项目的说明,按顺序操作一次。

    建议提示词:

    我正在做“只在自己电脑使用”。现在只做这一项:打开 README,找到启动项目的说明,按顺序操作一次。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 如果想双击打开,请工具为自己的电脑准备启动入口。

    建议提示词:

    我正在做“只在自己电脑使用”。现在只做这一项:如果想双击打开,请工具为自己的电脑准备启动入口。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 找到数据保存位置,复制一份备份,再用副本试恢复。

    建议提示词:

    我正在做“只在自己电脑使用”。现在只做这一项:找到数据保存位置,复制一份备份,再用副本试恢复。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?本人按说明可再次打开使用,知道资料位置和恢复方法。

本分支提示词

只在自己电脑使用

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

Web:纯静态网站

没有需运行的后端进程;构建输出为网页和静态资源。

  1. 先让工具确认:这个网站是否只需要网页文件。

    建议提示词:

    我正在做“Web:纯静态网站”。现在只做这一项:先让工具确认:这个网站是否只需要网页文件。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 让工具生成可交付的网页文件,并告诉你在哪里打开检查。

    建议提示词:

    我正在做“Web:纯静态网站”。现在只做这一项:让工具生成可交付的网页文件,并告诉你在哪里打开检查。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 在所选托管平台建立测试站点,按工具说明填写设置,再打开临时网址试用。

    建议提示词:

    我正在做“Web:纯静态网站”。现在只做这一项:在所选托管平台建立测试站点,按工具说明填写设置,再打开临时网址试用。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?产物与正式构建一致;临时网址完整流程、资源与刷新均正常。

本分支提示词

Web:纯静态网站

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

核对当前官方操作条件 ↗

Web:网页加云数据或外部API

网页托管之外还依赖数据、登录或API服务。

  1. 让工具列出网站依赖哪些外部服务,每个服务需要什么账号。

    建议提示词:

    我正在做“Web:网页加云数据或外部API”。现在只做这一项:让工具列出网站依赖哪些外部服务,每个服务需要什么账号。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 打开各服务后台,按照工具给出的位置填写网站地址和连接设置。

    建议提示词:

    我正在做“Web:网页加云数据或外部API”。现在只做这一项:打开各服务后台,按照工具给出的位置填写网站地址和连接设置。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 用普通测试账号试一次登录、保存和读取,检查费用和失败提示。

    建议提示词:

    我正在做“Web:网页加云数据或外部API”。现在只做这一项:用普通测试账号试一次登录、保存和读取,检查费用和失败提示。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?新环境能完整使用且不依赖开发机;配置和权限正确。

本分支提示词

Web:网页加云数据或外部API

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

Web:需要后端运行的应用

需要持续运行服务端代码、任务或数据库。

  1. 请工具说明服务器要运行什么,以及预估费用。

    建议提示词:

    我正在做“Web:需要后端运行的应用”。现在只做这一项:请工具说明服务器要运行什么,以及预估费用。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 选定测试服务器后,让工具一步一步说明上传、配置和启动方法。

    建议提示词:

    我正在做“Web:需要后端运行的应用”。现在只做这一项:选定测试服务器后,让工具一步一步说明上传、配置和启动方法。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 打开测试网址完成一次操作,再重启服务检查数据是否还在。

    建议提示词:

    我正在做“Web:需要后端运行的应用”。现在只做这一项:打开测试网址完成一次操作,再重启服务检查数据是否还在。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?目标环境独立运行,重启不丢应保留数据,核心流程与恢复办法已验证。

本分支提示词

Web:需要后端运行的应用

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

Android:直接下载或应用商店

目标是Android设备;先选分发渠道。

  1. 先确定给什么安卓设备使用,以及直接下载还是上架商店。

    建议提示词:

    我正在做“Android:直接下载或应用商店”。现在只做这一项:先确定给什么安卓设备使用,以及直接下载还是上架商店。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 请工具按这个渠道准备正式安装文件,说明如何保管签名密钥。

    建议提示词:

    我正在做“Android:直接下载或应用商店”。现在只做这一项:请工具按这个渠道准备正式安装文件,说明如何保管签名密钥。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 在目标手机上安装试用,再试升级后原来的数据是否还在。

    建议提示词:

    我正在做“Android:直接下载或应用商店”。现在只做这一项:在目标手机上安装试用,再试升级后原来的数据是否还在。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?所选渠道产物可用,真机测试有证据;待审核不记上线。

本分支提示词

Android:直接下载或应用商店

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

核对当前官方操作条件 ↗

iPhone/iPad:测试与正式分发

目标是iOS/iPadOS,不能套用Android下载方式。

  1. 先请工具列出所需电脑、开发者账号和设备,再核对自己是否具备。

    建议提示词:

    我正在做“iPhone/iPad:测试与正式分发”。现在只做这一项:先请工具列出所需电脑、开发者账号和设备,再核对自己是否具备。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 按当前 Apple 官方说明配置账号和签名,再让工具准备测试版本。

    建议提示词:

    我正在做“iPhone/iPad:测试与正式分发”。现在只做这一项:按当前 Apple 官方说明配置账号和签名,再让工具准备测试版本。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 在自己的 iPhone 或 iPad 上安装试用;准备公开时再核对上架资料。

    建议提示词:

    我正在做“iPhone/iPad:测试与正式分发”。现在只做这一项:在自己的 iPhone 或 iPad 上安装试用;准备公开时再核对上架资料。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?所选合法可用渠道明确;真机试用与审核状态分别记录。

本分支提示词

iPhone/iPad:测试与正式分发

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

其他渠道示例:Apple网页分发资格(非所有用户适用)

核对当前官方操作条件 ↗

桌面:Windows / macOS / Linux

用户要安装到电脑,而非只打开网页。

  1. 写清要支持 Windows、macOS 还是 Linux,以及电脑型号。

    建议提示词:

    我正在做“桌面:Windows / macOS / Linux”。现在只做这一项:写清要支持 Windows、macOS 还是 Linux,以及电脑型号。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 请工具生成对应系统的安装文件,并说明签名和分发要求。

    建议提示词:

    我正在做“桌面:Windows / macOS / Linux”。现在只做这一项:请工具生成对应系统的安装文件,并说明签名和分发要求。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 在目标电脑上试安装、启动和升级,检查资料是否保留。

    建议提示词:

    我正在做“桌面:Windows / macOS / Linux”。现在只做这一项:在目标电脑上试安装、启动和升级,检查资料是否保留。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?普通目标电脑按说明可安装运行,升级不破坏应保留数据。

本分支提示词

桌面:Windows / macOS / Linux

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

核对当前官方操作条件 ↗

小程序:按已选平台准备

例如微信;不同平台账号与发布流程不能互相套用。

  1. 进入所选小程序平台的官网,核对注册和发布需要哪些资格。

    建议提示词:

    我正在做“小程序:按已选平台准备”。现在只做这一项:进入所选小程序平台的官网,核对注册和发布需要哪些资格。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  2. 在平台开发工具中打开项目,核对项目编号和服务地址。

    建议提示词:

    我正在做“小程序:按已选平台准备”。现在只做这一项:在平台开发工具中打开项目,核对项目编号和服务地址。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。
  3. 准备体验版本,用获准的手机账号试完整流程,再整理审核资料。

    建议提示词:

    我正在做“小程序:按已选平台准备”。现在只做这一项:准备体验版本,用获准的手机账号试完整流程,再整理审核资料。请先查看我的项目,告诉我在哪里操作、具体怎么做、完成后应看到什么。需要我操作账号时,一次只说明一个动作,等我完成再继续。不要跳到下一项或正式发布。

怎样检查这个分支已经完成?体验版用真实目标账号可用;平台资格与审核材料齐全;未发布不标上线。

本分支提示词

小程序:按已选平台准备

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

打开平台官方后台,核对自己的账号资格和审核要求,再按页面提示准备资料。

核对当前官方操作条件 ↗

记录本次核对结论与版本

这是本人的记录,不是网站自动检测。改动项目后旧结论不能证明新版本通过;未测试或失败时先补测/反馈。

0202可选:把简单网页放到 GitHub Pages可选待核对展开这一步收起这一步

可选 · 只适用于不含私密资料、不需要服务器的静态网站;只准备设置方案,做完回到本节点

检查准备发布的网页文件
确认项目是否适合 GitHub Pages
让 AI 说明需要怎样设置
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

项目文件和已经确认的技术方案。

做完后要留下什么?

有能逐项照做的准备说明。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/delivery.md

让 AI 将结果保存到:只检查,不改文件

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

先判断自己的网页是否适合放到 GitHub Pages,再决定下一步。

弄懂原理,再试着自己判断

这个概念是什么意思?

Git 是记录版本的工具;GitHub 是保存和分享代码的网站;GitHub Pages 是它提供的静态网页托管功能。

换个情况,你会怎样判断?

为什么换了正式网址后看不到原本的本机记录?

查看参考答案

浏览器本地数据常按网址来源隔离,正式域名是另一个来源。需要迁移时先导出备份,再按实际数据方案导入,不能期待自动出现。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

只适用于不含私密资料、无需服务器的静态网页

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 先判断是否适合 GitHub Pages。它可以托管静态网页,但不会替你运行后端和数据库。展开收起

    建议提示词:

    请读 docs/delivery.md,检查项目能否直接导出静态网页。如果依赖后端或私密服务端配置,请说明原因并建议回到交付方式选择。现在只判断,不发布。

    完成后应该看到:知道自己的项目是否适合。

  2. 适合时让工具写出实际设置方法,再回准备交付步骤试运行。展开收起

    建议提示词:

    请列本项目生成静态文件的方法、输出目录和 GitHub Pages 设置步骤,解释每一步在哪里操作。先只提供方案,不创建远程仓库、不推送、不发布。

    完成后应该看到:有能逐项照做的准备说明。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

这个动作是静态网站的可选参考。本全栈练习直接继续维护,不把 Python 和数据库上传 Pages。

做完这一步,应该看到什么?
明确 Pages 不能运行本练习后端,数据库不公开。
做不下去时,先怎么办?
若有人只发布页面,保存会失败;回到交付方案选择能运行后端并保留数据的方案。

04不会具体操作?逐项跟着做

展开收起
  1. 先判断是否适合 GitHub Pages。它可以托管静态网页,但不会替你运行后端和数据库。

    操作后应该看到什么?
    知道自己的项目是否适合。
    没有看到这个结果时,怎么办?
    学习记录全栈示例有后端和数据库,不能只上传页面就当作完整上线。
  2. 适合时让工具写出实际设置方法,再回准备交付步骤试运行。

    操作后应该看到什么?
    有能逐项照做的准备说明。
    没有看到这个结果时,怎么办?
    仓库或页面会公开时,先检查文件是否含密码、私密内容,再决定是否发布。

05这一步出现的词

展开收起

静态网站 ↗

主要直接提供预先生成文件的网站。

印好的宣传册直接递给读者。

静态网站 ↗

主要直接提供预先生成文件的网站。

印好的宣传册直接递给读者。

06遇到问题时,应该怎么处理?

展开收起

正式网址显示 404

先检查哪里,确认问题的原因?
确认仓库 Pages 显示发布成功,所选分支根目录存在 index.html。
按下面的方法处理问题
核对部署状态和实际 Visit site 地址;部署未结束先等状态,失败则保留日志交给 AI 检查。不要根据仓库地址猜网站地址。
恢复后应该看到
重新打开官方显示的站点地址,看到目标页面。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

有经过核对的 Pages 适用结论和设置方案;尚未发布也不能记为上线。

09没有看到预期结果,接下来怎么办?

展开收起

学习记录全栈示例有后端和数据库,不能只上传页面就当作完整上线。

看结果对照(教学示意,不是你的项目结果)
介绍页/静态文档可评估;需要服务端保管密钥的AI接口不能把密钥放进网页产物。
看示例或查资料

先确认公开:只上传网页文件,不上传密钥、聊天记录或自己的学习资料。首次打开新网址是另一份本地保存空间。

打开官方操作入口 ↗

没通过?沿这条路修好再继续测试或上线评估发现问题时,按这三步修好,再回到上面的节点。

0103把试用结果记录成反馈待核对展开这一步收起这一步
写下从哪里开始、做了什么
写下应该看到什么、实际看到了什么
把问题记录保存到项目文件中
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

出现问题时的操作顺序、画面或报错。

做完后要留下什么?

反馈文件有问题编号、重现步骤和证据。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:当前已确认材料与项目位置

让 AI 将结果保存到:docs/feedback.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

把哪里出错写具体,工具才能找到同一个问题。

弄懂原理,再试着自己判断

这个概念是什么意思?

反馈先写你做了什么、看到了什么,不需要自己猜代码哪里错了。

换个情况,你会怎样判断?

“按钮没反应”和“数据库坏了”,哪一个是观察,哪一个需要证据?

查看参考答案

“按钮没反应”是观察;“数据库坏了”是原因判断,需要日志或检查支持。先写动作、预期和实际结果。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

实际作品、本页模板与项目对话

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 选一个问题,写下从哪里开始、输入什么、点哪里、出现什么。展开收起

    完成后应该看到:别人能照着描述走到同一问题。

  2. 把操作记录和报错填进下方模板,确认后复制给工具。展开收起

    建议提示词:

    请把以下问题整理到 docs/feedback.md,给每项编号,写清预期与实际:【粘贴记录】。先记录和检查原因,不修改代码;还没查明的原因不要写成事实。

    完成后应该看到:反馈文件有问题编号、重现步骤和证据。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

把失败时输入的测试内容、点击顺序、时间、页面提示和报错放在一起;截图不要含私人资料。

做完这一步,应该看到什么?
别人能照记录复现,不只有“保存坏了”。
做不下去时,先怎么办?
不知道什么是日志时,让 Codex 指出本项目服务输出的位置并只提取对应时间的错误。

04不会具体操作?逐项跟着做

展开收起
  1. 选一个问题,写下从哪里开始、输入什么、点哪里、出现什么。

    操作后应该看到什么?
    别人能照着描述走到同一问题。
    没有看到这个结果时,怎么办?
    不要只写“不能用”;不懂原因没关系,记录现象即可。
  2. 把操作记录和报错填进下方模板,确认后复制给工具。

    操作后应该看到什么?
    反馈文件有问题编号、重现步骤和证据。
    没有看到这个结果时,怎么办?
    截图含密码或个人信息时先遮住再发送。

05这一步出现的词

展开收起

程序缺陷 ↗

导致行为不符合预期的程序问题。

按电灯开关却启动风扇。

日志 ↗

程序运行时记录的事件信息。

值班记录写下时间与发生的事。

06遇到问题时,应该怎么处理?

展开收起

问题偶尔出现,不能稳定重现

先检查哪里,确认问题的原因?
记录出现次数、设备、版本和最近一次完整操作。
按下面的方法处理问题
只收集当前现象、操作、版本与报错原文,必要时只读排查;本步不修代码。失败记录到反馈,按“先确定怎么修、怎样算修好”确认计划后再修复。
恢复后应该看到
有可核对的实际记录,未执行仍标未测试,失败仍标失败。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

有能让别人重复操作的反馈记录,事实、猜测和新增需求分开。

09没有看到预期结果,接下来怎么办?

展开收起

不要只写“不能用”;不懂原因没关系,记录现象即可。

看结果对照(教学示意,不是你的项目结果)
F01 / 取消后刷新 / 预期余位+1 / 实际未变 / 版本abc / 两次均复现。
0203先确定怎么修、怎样算修好待核对展开这一步收起这一步
按记录再做一次,确认问题会出现
明确这次只修哪些问题
写清修好后怎样检查
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

刚才保存的问题反馈记录。

做完后要留下什么?

修复计划有具体改动和检查方法。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/feedback.md · docs/requirements.md

让 AI 将结果保存到:docs/repair-plan.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

先看懂工具准备怎么修,再让它动手。

弄懂原理,再试着自己判断

这个概念是什么意思?

修复计划说明改哪里、会影响什么,以及怎样再次检查。

换个情况,你会怎样判断?

修好了保存按钮,为什么还需要试一下读取历史记录?

查看参考答案

保存与读取可能共用数据结构或接口,修一个可能影响另一个。原问题复测与相关正常功能回归都要做。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

项目对话与 docs/repair-plan.md

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 先让工具解释为什么出问题。展开收起

    建议提示词:

    请读 docs/feedback.md 和需求,先检查问题原因,不改代码。把已查明的事实和还要验证的猜测分开,告诉我下一项最小检查。

    完成后应该看到:得到能对应实际问题的解释。

  2. 让工具写清准备改哪里、怎么确认改好了,然后自己读一遍。展开收起

    建议提示词:

    请保存 docs/repair-plan.md:每个问题改哪些文件、会影响哪些原功能、怎样重走失败步骤、修好应该看到什么。涉及数据库先写备份和恢复方法,等我确认再执行。

    完成后应该看到:修复计划有具体改动和检查方法。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

让 Codex 先复现,再说明只改哪一层,改完重跑哪条失败操作。

做完这一步,应该看到什么?
修复计划包括数据保护及原本正常保存的回归检查。
做不下去时,先怎么办?
建议删库时先停止,要求备份和非破坏性方案;缺证据就先补诊断。

04不会具体操作?逐项跟着做

展开收起
  1. 先让工具解释为什么出问题。

    操作后应该看到什么?
    得到能对应实际问题的解释。
    没有看到这个结果时,怎么办?
    原因不明就继续小范围检查,不默认重装或删库。
  2. 让工具写清准备改哪里、怎么确认改好了,然后自己读一遍。

    操作后应该看到什么?
    修复计划有具体改动和检查方法。
    没有看到这个结果时,怎么办?
    只有“优化一下”就要求写具体,不直接批准。

05这一步出现的词

展开收起

根因 ↗

导致问题的基础原因而非表面现象。

灯不亮可能是线路断了,不只是灯泡坏。

回归测试 ↗

修改后检查已有能力是否被破坏。

修完厨房灯,再看其他灯是否仍正常。

06遇到问题时,应该怎么处理?

展开收起

AI 没给计划就开始修改

先检查哪里,确认问题的原因?
检查当前改动与反馈编号是否对应。
按下面的方法处理问题
暂停后续修改,先让 AI 汇报已经改过什么、保存当前状态,再补修复范围和通过条件。不为回到计划阶段强行丢弃现有改动。
恢复后应该看到
重新执行原操作,得到本页要求的实际结果;未执行的检查仍标为未验证。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

每项修复对应反馈编号和可重复的通过条件。

09没有看到预期结果,接下来怎么办?

展开收起

原因不明就继续小范围检查,不默认重装或删库。

看结果对照(教学示意,不是你的项目结果)
F01:修正取消释放名额;复测原步骤;回归报名和重复取消;不改页面样式。
0303按计划修复,再交给本人复测待核对展开这一步收起这一步
执行修复
检查原本能用的相关功能有没有被改坏
亲手重复出错时的操作
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

你已确认的修复计划,以及原来失败的操作。

做完后要留下什么?

问题状态与本人实际结果一致。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/repair-plan.md · docs/feedback.md

让 AI 将结果保存到:docs/checks.md · docs/feedback.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

让工具修好已确认的问题,然后自己重做原来失败的操作。

弄懂原理,再试着自己判断

这个概念是什么意思?

复测是重新试原问题;再检查原本正常的功能,可以发现有没有顺带改坏别的地方。

换个情况,你会怎样判断?

如果 AI 自测通过,但同样的操作仍失败,下一步应该记录哪个事实?

查看参考答案

记录同一版本、相同步骤下本人仍失败的实际结果,沿用问题编号追加证据,不能以AI自测覆盖它。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

当前项目对话及实际预览

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 确认修复计划后,让工具只改这一项问题。展开收起

    建议提示词:

    请按已确认的 docs/repair-plan.md 修复【问题编号】。保护已有数据,只改必要文件,完成后报告实际检查结果和我该怎样复测。

    完成后应该看到:工具说明改了哪里和怎样再试。

  2. 亲自重走原来失败的那组操作,再试原本正常的功能。展开收起

    完成后应该看到:原问题解决,原来的保存和读取仍正常。

  3. 把自己的复测结果交给工具保存。展开收起

    建议提示词:

    我的复测结果:【填写】。请更新 docs/checks.md 和 docs/feedback.md;只有我实际验证通过的问题才关闭,未测项保留。

    完成后应该看到:问题状态与本人实际结果一致。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

执行确认过的一项修复,自己重做原失败操作,再确认旧记录还在。

做完这一步,应该看到什么?
原问题通过,正常新增/读取及已有数据也通过。
做不下去时,先怎么办?
测试状态被 AI 全改成通过时,恢复真实未测项;要求区分它的测试与本人试用。

04不会具体操作?逐项跟着做

展开收起
  1. 确认修复计划后,让工具只改这一项问题。

    操作后应该看到什么?
    工具说明改了哪里和怎样再试。
    没有看到这个结果时,怎么办?
    范围扩大或要求清库时先停,回修复计划说明原因。
  2. 亲自重走原来失败的那组操作,再试原本正常的功能。

    操作后应该看到什么?
    原问题解决,原来的保存和读取仍正常。
    没有看到这个结果时,怎么办?
    仍失败就保留同一问题编号,补新证据,不重新编一个“已解决”的问题。
  3. 把自己的复测结果交给工具保存。

    操作后应该看到什么?
    问题状态与本人实际结果一致。
    没有看到这个结果时,怎么办?
    工具与本人结论不一致时,以实际复测为依据继续检查。

05这一步出现的词

展开收起

回归测试 ↗

修改后检查已有能力是否被破坏。

修完厨房灯,再看其他灯是否仍正常。

回滚 ↗

恢复软件或配置到较早版本。

换回旧设备不自动恢复被修改的账本。

06遇到问题时,应该怎么处理?

展开收起

AI 说修好了,同样的操作仍失败

先检查哪里,确认问题的原因?
核对正在打开的是新版本,并保留原失败操作。
按下面的方法处理问题
点击“复测仍有问题”,补充当前版本和实际结果。请 AI 用相同步骤复现并更新修复计划,不重新生成整个项目。
恢复后应该看到
重新执行原操作,得到本页要求的实际结果;未执行的检查仍标为未验证。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

AI 检查与本人复测分别记录;仍失败就继续反馈,不能自动进入发布。

09没有看到预期结果,接下来怎么办?

展开收起

范围扩大或要求清库时先停,回修复计划说明原因。

看结果对照(教学示意,不是你的项目结果)
F01 / 修复版本def / 原步骤通过 / 报名回归通过 / 本人已复测 → 可以关闭F01。
记录本次核对结论与版本

这是本人的记录,不是网站自动检测。改动项目后旧结论不能证明新版本通过;未测试或失败时先补测/反馈。

本节点出现的词按出现顺序排列,点开可查完整解释

本节点可查的资料

遇到对应问题再查,资料不是额外必做步骤。

按本节点查术语 →
我的项目材料与备份

材料只存于这台设备的当前浏览器;不是项目文件,也不会自动发给 AI。中英文模板分别保存,项目选择和学习进度共用。不要在这里填写密码或 API Key。

包括想法、进度、各步模板、人工核对记录及选型条件;不包含你的真实项目代码。恢复会建立一个新草稿,不覆盖已有项目。

下载或导入不工作?复制备份文本恢复

草稿与进度只保存在当前浏览器。

按顺序完成本页操作,遇到问题时展开对应的检查和处理方法。

寻找起点

板块快捷入口

大家在做什么 · AI收益调研 · 50个方向 · GitHub项目完整路线图 · 从想法到上线先记下自己的想法只有“想做一个网站”,不知道写什么整理成可以交给 AI 的项目描述不知道第一版的流程怎么写打开一个能制作文件的 AI 工具无法安装、登录,或界面不一样给项目建一个自己的文件夹侧栏没有“文稿”或找不到文件夹让 AI 打开刚才的文件夹AI 说的是另一个项目建立 Git 仓库,写好项目说明和规则提交失败或要求填写姓名邮箱亲手核对 AI 创建的文件找不到上一步的文件一次回答一个问题AI 问的技术词看不懂确认这版只做哪几件事删减以后只剩外观把约定留成看得懂的说明说明太长,不知道该确认哪句把用户怎样使用写清楚AI 只列功能名,没有使用过程先看关键页面,再决定怎么开发原型看起来能用,但不清楚哪些是假数据把实际条件交给 AI 选做法我不知道“本机”和“共享”怎么选让 AI 列出下一小步第一项只有“完成前端”检查运行环境,启动最小项目安装或启动失败,不知道停在哪里打开第一张属于自己的页面地址打不开或一直加载只调整眼前这一页改外观后其他功能也变了让“保存”真正留下内容保存不了,或刷新后记录不见了从开始到结束走通一次按钮能点,但没有结果试试空白和连续点击出现空记录或重复记录关掉以后,还能重新打开第二天地址打不开对照最初想法,确认真的能用AI 说全部完成,但我仍不会用把试用结果记录成反馈问题偶尔出现,不能稳定重现先确定怎么修、怎样算修好AI 没给计划就开始修改按计划修复,再交给本人复测AI 说修好了,同样的操作仍失败先决定:自己用,还是分享发给别人后打不开检查是否具备交付条件评估说可上线,却没有证据准备交付物,并实际试运行安装包打不开或部署后启动失败确认交付,再检查实际入口自己的电脑能开,其他人打不开可选:把简单网页放到 GitHub Pages正式网址显示 404下次继续时,不用从头讲换对话后 AI 要重新做选择工具 · Codex Claude Cursor Qoder TRAE Kimi 价格首页项目分类和 Agent 沟通 · 提示词与排查技术栈选择前端与 UI · 组件词典术语库 · AI与项目开发 · 生活例子与图解打开工具,确认能操作项目把项目、版本记录和 AI 规则准备好把想要的界面风格说清楚只修改一个地方,让 AI 找准目标后端:保存资料与访问规则测试:亲手检查是否能用部署上线:交付一个真实入口运维:让产品继续可用Web 网站与应用 · 把想法变成一个网址。小程序 · 在用户熟悉的地方,做一个小工具。手机 App · 让一个好想法,成为日常习惯。桌面 App · 把重复的电脑工作,交给自己的工具。

一个面向零基础的实践指南

这是面向零基础的双语实践指南,按 6 个阶段、18 个节点、31 个动作组织。页面中的应用画面是示意图;项目完成情况由使用者核对。