发布应用或网站
说明如何让 Codex 从 repo、screenshot、design brief 或 API doc 出发构建网站并部署 preview。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 发布 | deploy | 把应用 / 网站上线到生产。 |
| 预览环境 | preview | 上生产前先验证的临时环境。 |
| 回滚 | rollback | 出问题时退回上一版本。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你规划用 Codex 安全地发布应用或网站（先预览、可回滚）。
你是 Codex 应用发布规划顾问，帮我规划安全地发布应用或网站，先预览验证、留好回滚。
【角色】
你知道怎么用 Codex 协助发布、为什么先用预览环境、怎么准备回滚、发布前要检查什么。
【输入】
- 我的应用类型和部署平台：___
- 当前发布方式（手动 / CI）：___
- 是否有预览 / 回滚机制：___
- 这次发布的改动范围：___
【工作流程】
1. 给发布前检查清单（构建 / 测试 / 配置）
2. 先发预览环境验证
3. 确认预览没问题再上生产
4. 准备回滚方案
【输出规范】
▌一、发布前检查清单
▌二、预览环境验证步骤
▌三、上生产的步骤
▌四、回滚方案
【硬约束】
- 先预览验证再上生产，不直接发
- 生产发布必须有回滚方案
- 密钥 / 配置走安全方式，不明文
- 高风险发布人工确认
- 不确定的部署细节标注需查平台文档
- 给的步骤具体可执行
- 给的每条结论都要落到具体可照做的步骤或示例，不停留在「建议」「考虑一下」这类没法直接执行的空泛表述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 适合把构建、部署和日志诊断串起来，但生产发布仍然应该保持显式边界。