📘 OpenAI Codex📚 官方教程中文版实战场景
发布应用或网站
Codex 可以从 repo、screenshot、map、design brief、product note、API doc 或 data source 出发
Codex 可以从 repo、screenshot、map、design brief、product note、API doc 或 data source 出发,构建或更新网站,再通过 Vercel 部署 preview,并把 live URL 交回来。
官方页面:https://developers.openai.com/codex/use-cases/deploy-app-or-website
适合什么任务
| 场景 | Codex 应该做什么 |
|---|---|
| 把 screenshot、map、design brief 或 rough app idea 做成可访问 preview | 使用 @build-web-apps 构建或打磨 app,再用 @vercel 部署 |
| 部署一个 branch 或 local app,不想手动 wiring Vercel commands | 让 Vercel plugin 处理 preview deployment、deployment inspection 和 build logs |
| 需要 live URL 给别人看 | 本地 build 通过后部署 preview,并回报可访问 URL |
使用的能力
| 能力 | 用法 | 链接 |
|---|---|---|
build-web-apps | 构建、review 和准备 web apps,覆盖 React、UI、deployment、payments、database guidance | https://github.com/openai/plugins/tree/main/plugins/build-web-apps |
vercel | 部署 previews、检查 deployments、读取 build logs、管理 Vercel project settings | https://github.com/openai/plugins/tree/main/plugins/vercel |
相关官方说明:
- Build Web Apps plugin:https://github.com/openai/plugins/tree/main/plugins/build-web-apps
- Vercel plugin:https://github.com/openai/plugins/tree/main/plugins/vercel
- Vercel deployments:https://vercel.com/docs/deployments/overview
起始提示词
请使用 @build-web-apps,把 [repo、screenshot、design 或 rough app idea] 做成可运行的网站。
然后使用 @vercel 部署 preview,并把 live URL 交给我。
上下文:
- [这个网站应该做什么]
- [要使用的 source data、API、docs 或 assets]
- [style 或 product constraints]
- [哪些内容不要改]
交付前,请先运行 local build,并确认 deployment 已 ready。这个 prompt 要求 Codex 先构建,再 preview deploy,并且在交付前运行 local build。不要跳过本地验证直接要 URL。
先明确站点和部署目标
有用的交接应该具体。你可以给 Codex:
- repo。
- screenshot。
- map。
- design brief。
- product note。
- API doc。
- data source。
Codex 应该先 inspect project,再修改。默认部署目标应该是 Vercel preview;只有你明确要求 production,才进入生产发布。
检查后再分享
交付前,Codex 应该告诉你:
- 改了什么。
- 用哪条 command build。
- Vercel deployment 是否 ready。
- 是否缺 environment variable。
- 是否需要 team choice、domain setting 或登录步骤。
- 如果 deploy 失败,失败日志在哪里,下一步怎么修。
如果缺少环境变量、团队选择、域名设置或登录步骤,Codex 应该直接说明 blocker,而不是把站点说成已经完成。
从 live URL 继续迭代
拿到 preview URL 后,不要换线程。同一线程已经有 repo、deployment 和 build context。
可以继续让 Codex:
- 打开 URL 检查页面。
- 修 mobile layout。
- 更新 copy。
- 接上缺失数据。
- 读取 Vercel failed build logs。
- 修复后重新部署 preview。
好的 follow-up 应该具体:
移动端 layout 太拥挤。请修复并重新部署 preview。继续使用同一个项目,并加入来自 [source] 的最新数据。请读取 failed build logs,并修复 deploy。发布边界
preview deployment 是默认动作。production changes 要明确说出来,并在执行前确认:
- 目标 project。
- 目标 branch。
- environment variables。
- domain / alias 设置。
- 是否会影响现有用户。
Codex 适合把构建、部署和日志诊断串起来,但生产发布仍然应该保持显式边界。