这次工作的最终产物是一条可分享的预览地址，以及一份与它配套的验收记录。记录应包含源码版本、构建命令、部署状态、关键路由检查和仍缺少的环境条件。别人打开链接后能完成指定动作，部署记录又能对应本次代码，才算形成可复查交付。预览默认不碰生产域名。
准备可部署的输入
先给 Codex 一个明确来源，可以是现有仓库、设计稿、截图或已收敛的页面说明。写清页面要完成的任务、必须使用的数据与素材、视觉约束、移动端要求，以及禁止修改的区域。现有项目还要提供包管理器、构建命令、目标分支和仓库规则。只有一句“做得好看”，很难检查完成程度。
把验收写成从用户动作开始的短脚本。比如从首页进入目标页面，提交一组固定输入，看到预期结果，再缩窄窗口确认主要操作仍可见。每一步写明可观察现象，不用“体验顺畅”这类无法复查的判断。链接能打开，还不够。脚本会决定 Codex 应实现哪些状态，也会成为部署后的浏览器检查。
部署前确认可用的执行入口。可以连接并授权 @vercel 插件，也可以准备已经登录且具备网络与沙箱权限的 Vercel CLI 或 API 环境。缺少这些能力时，Codex 只能准备代码和部署步骤，不能声称已经创建 Preview。接着确认 Vercel 项目与源码仓库的关系，并列出所需环境变量的名称。值应通过受控配置提供，不要贴进文章、提示或提交。需要登录、团队选择、域名权限或付费资源时，把它们当作前置条件。
先在本地形成稳定版本
本地先跑通。让 Codex 检查目录结构和现有脚本，再按最小范围实现页面。完成一个可见切片就运行对应检查。页面能渲染以后，再执行完整的生产构建。可见结果包括构建命令、退出状态、生成产物和已知警告。开发服务器能打开不等于生产构建可用，缺失导入、静态路由和服务端环境差异常在这一步暴露。
接着检查改动差异。确认没有把密钥、本地缓存、临时截图和无关格式化带进版本。若页面依赖接口，先验证加载、空数据、错误和超时状态。若素材来自截图或设计稿，要核对文字层级、可点击区域和窄屏布局，避免只还原一张静态画面。
可以让 Codex 使用独立工作树处理这次页面任务。Git 集成部署要先保持工作树干净，提交并推送功能分支，再记录部署来源 SHA。本地目录直接部署时，还要记录 deployment ID、当前 HEAD 与未提交差异或产物哈希，不能把 HEAD 当成远端分支与部署内容一致的证明。
部署预览并读取真实状态
通过已经授权的 @vercel 插件或等价的 CLI/API 环境明确创建 Preview。Codex 官方用例建议把生产更新保持为显式动作。部署开始后读取构建日志和最终状态，遇到环境变量、项目归属或框架设置错误时，根据日志修复并重新部署。不要只看命令已经返回链接，还要确认部署已经就绪，链接指向预期项目。
部署日志里要区分安装、构建和运行时问题。日志要保留。安装失败先核对锁文件与运行时版本，构建失败回到本地复现，页面打开后才出现的错误则检查请求与环境。一次只改变一个条件并保留旧结果，否则第二次成功也难以解释第一次为何失败。
部署完成后在浏览器打开真实地址。按验收清单检查首页、关键深层路由、主要交互、移动端宽度与失败状态。人工可以使用浏览器开发者工具检查控制台和网络请求。需要 Codex 自动读取这些信息时，桌面端必须启用 Browser 的 Developer mode、取得完整 CDP 权限并通过相应批准，管理员也可能禁用这项能力。若链接受登录保护，应写清查看条件，并请具备权限的验收者复查。
每次修复都产生新的预览时，更新验收记录中的地址与来源版本，在记录中把旧链接标为过期并停止继续分享。可见结果是一份当前唯一候选地址。Git 集成 Preview 旁边写部署来源 SHA，本地部署则写 deployment ID、HEAD 和差异记录，再附上逐项检查结论。
处理失败与发布边界
本地通过而远端失败时，先比较运行时版本、安装命令、构建目录和环境变量。网络访问、区域服务与外部 API 也可能只在部署环境暴露问题。错误日志不足时保留失败链接和时间，避免反复改变多项配置后失去原因。
生产另算。预览验收通过仍不代表已经上线。生产发布需要单独授权，并确认生产分支、远端最新提交与部署来源一致。涉及域名切换、数据库写入或付费资源时，还应准备回退方法。本文的终点是可信预览，生产上线属于下一道发布门。
交付清单
- 页面目标、数据来源、视觉约束与禁止修改范围已经确认
- 生产构建命令和结果可以复跑
- 环境变量只记录名称，敏感值没有进入代码
- 当前预览地址有明确来源，能核对 Git SHA 或本地部署记录
- 关键路由、主要交互与移动端已经在真实地址检查
- 权限限制、已知问题和生产发布状态写得清楚