Vibe GuideBETA

选择交付方式

交付就是让预期使用者能打开并使用作品,不一定需要公开网址。

做完这一节点,你会得到什么?
知道接下来要准备什么。
为什么要有这一节点?

先决定自己用还是给别人用,才能知道需要准备哪些文件和服务。

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

0101先决定:自己用,还是分享待核对展开这一步收起这一步
先确认已经亲手试用通过
可以只在自己的电脑上使用
需要分享时,再准备正式入口
操作示意 · 非工具截图

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

开始前需要准备什么?

已经试用过的作品,以及准备给谁使用的决定。

做完后要留下什么?

知道接下来要准备什么。

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

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

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

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

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

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

先决定自己用还是给别人用,才能知道需要准备哪些文件和服务。

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

这个概念是什么意思?

交付就是让预期使用者能打开并使用作品,不一定需要公开网址。

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

需要一个网址、一个安装包,还是本机启动说明?

查看参考答案

看实际用户如何使用:浏览器访问选网址;安装使用选对应系统产物;本机自用可只需要可重复的启动说明。不要先选包装形式再硬凑需求。

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

03这一步具体怎么做?

展开收起

本页的两种去向

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

  1. 决定谁在哪里使用:自己电脑、别人通过网址、还是下载安装包。填下方模板并确认。展开收起

    完成后应该看到:选择符合真实使用需要。

  2. 展开“把本步已确认记录交给 AI 保存”,生成话术并发给工具。展开收起

    完成后应该看到:docs/delivery.md 中记录了使用者、设备和交付方式。

  3. 请工具按选好的方式列准备事项。展开收起

    建议提示词:

    请读 docs/delivery.md。本机使用写清启动、停止、数据位置;远程使用分别说明页面、后端、数据库放在哪里,需要哪些账号和费用。先列方案,不发布。

    完成后应该看到:知道接下来要准备什么。

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

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

本轮先选本机自用:一个启动方法、一个网页入口、一份数据库。公开给别人用是之后的单独决定。

做完这一步,应该看到什么?
知道 localhost 只指向打开它的那台电脑;完整全栈项目可先本机交付。
做不下去时,先怎么办?
把本机网址发给朋友打不开不等于代码坏了,不用关闭防火墙解决。

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

展开收起
  1. 决定谁在哪里使用:自己电脑、别人通过网址、还是下载安装包。填下方模板并确认。

    操作后应该看到什么?
    选择符合真实使用需要。
    没有看到这个结果时,怎么办?
    自己电脑能用也是有效结果,不必为了教程公开上线。
  2. 展开“把本步已确认记录交给 AI 保存”,生成话术并发给工具。

    操作后应该看到什么?
    docs/delivery.md 中记录了使用者、设备和交付方式。
    没有看到这个结果时,怎么办?
    文件没出现就让工具给出实际保存位置。
  3. 请工具按选好的方式列准备事项。

    操作后应该看到什么?
    知道接下来要准备什么。
    没有看到这个结果时,怎么办?
    localhost 是当前电脑,把这个网址发给别人不会自动分享自己的项目。

05这一步出现的词

展开收起

构建 ↗

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

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

构建产物 ↗

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

出厂的实际成品。

部署 ↗

把程序和配置放到目标运行环境。

把设备装到营业地点。

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

展开收起

发给别人后打不开

先检查哪里,确认问题的原因?
地址是否以 localhost、127.0.0.1 或 file 开头?
按下面的方法处理问题
这些是本机入口。需要分享时选择下方发布路径;无需分享则继续本机使用,不为这个问题安装无关服务。
恢复后应该看到
使用范围和交付入口相符。

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

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

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

展开收起

先在下面填写自己的材料,点击确认后核对生成内容;什么时候交给工具,按上面的具体操作来。重新打开本页若只看到编辑框,核对后再点确认即可重新复制。

这一步的填写模板

直接编辑下方模板,确认后生成可复制草稿;按当前步骤说明使用,不必立即发给 AI。

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

这是填写方向,请把上方模板中的空白换成自己的真实信息。验收、费用、路径和测试结果不能照抄示例。

记录本轮为本机单人交付;前端、后端、SQLite 都在本机。若以后公开,另定登录、数据隔离、持久磁盘、HTTPS 和费用,不在本步自动部署。
请把我确认的范围保存到 docs/delivery.md,README 写明本机再使用步骤。说明 localhost 是当前电脑,发这个网址不能让另一台电脑访问;远程使用作为另一个已确认方案处理。

08看到这个结果才算完成

知道本机作品已经能用,但本机地址不能发给别人当正式网址。

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

展开收起

自己电脑能用也是有效结果,不必为了教程公开上线。

看结果对照(教学示意,不是你的项目结果)
网站:网址+运行服务;桌面:适合目标系统的安装产物;手机:对应平台和渠道的签名产物/商店入口。
把本步已确认记录交给 AI 保存

先在本页模板填写、确认,再点击下方按钮。AI 将记录保存到 docs/delivery.md,请在项目文件区亲手打开核对。

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

更多问题与排障资料

遇到卡点,从现象开始查

2 种情况

以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。

本地可用,上线构建失败

看到的现象:部署日志变红,或线上找不到资源。

  1. 先检查哪些地方?

    从部署日志第一条错误检查运行时版本、构建命令、输出目录和文件名大小写。

  2. 接着处理

    在本地运行同一生产构建;修复具体差异,再生成预览部署;先检查页面和主流程再切正式地址。

  3. 这样才算解决

    生产构建成功且预览地址完成主流程,不仅是部署状态成功。

把这段发给 AI 协助处理

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

查证依据Vercel · Build troubleshooting ↗

线上登录或接口失败

看到的现象:本地正常,线上却报缺少变量或登录回跳错误。

  1. 先检查哪些地方?

    核对环境变量名称及部署环境、接口地址、登录回调域名;只显示变量名,不输出值。

  2. 接着处理

    在平台正确环境配置变量与回调地址,必要时重新部署;使用线上测试账号验证,不把密钥写进前端文件。

  3. 这样才算解决

    正式域名下登录、读写及退出通过,秘密值未出现在浏览器代码中。

把这段发给 AI 协助处理

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

查证依据Vercel · Build troubleshooting ↗Supabase · Row Level Security ↗

本节点可查的资料

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

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

材料只存于这台设备的当前浏览器;不是项目文件,也不会自动发给 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 个动作组织。页面中的应用画面是示意图;项目完成情况由使用者核对。