让 Codex 改代码前要先留什么基线？截图、接口样本和回滚点
Codex 接手页面、接口或静态 SEO 任务前，先保留截图、接口样本、关键配置、测试输出和回滚点，能减少误改后难以定位的问题。
适用场景：不是不信任 Codex，而是给变更留参照
这篇适合准备让 Codex 修改后台表单、支付回调、静态 SEO 页面、AI API 接入代码或自动化脚本的团队。真实问题通常不是“模型不会写代码”，而是修改完成后没人能确认它到底改变了什么。比如一个按钮颜色变了、接口多返回一个字段、CCSwitch 配置说明被更新、首页卡片顺序变化，这些都可能是本次目标，也可能是顺手误改。维护 https://ai.jn83.com 时，永沃云枢会先把页面截图、线上状态码、sitemap、robots、关键标题和可回滚文件保存下来，再让 Codex 开始动手。这样即使后面出现样式错位、AI 模型接口调用异常或中文编码问题，也能回到基线逐项比较，而不是凭印象争论。新手搜索“GPT 中转”时常把它理解成某个品牌名，实际更规范的表达是 AI 模型接口接入与调用管理；这类接入任务尤其要在修改前保存请求地址、模型名、示例响应和错误码样本。
操作步骤：把基线分成页面、接口、文件和命令四类
第一步，保存页面基线。对用户能看到的页面，记录 URL、状态码、标题、核心按钮、移动端截图和桌面端截图。静态栏目要额外保存 canonical、JSON-LD、站内链接数量、sitemap 中的 loc 和 lastmod。第二步，保存接口基线。对 AI API 接入、开发者 AI 调用和模型调用管理任务，准备一组最小请求样本，记录 base_url、模型名、非敏感参数、响应状态码、request_id、耗时和费用字段。第三步，保存文件基线。用版本控制、备份目录或导出文件记录当前状态；如果没有 Git，也至少把将要改的 HTML、SQL、配置和脚本复制到带日期的备份文件。第四步，保存命令基线。把已经跑过的测试、构建、同步、curl 和日志查询命令写成清单，标明成功或失败。Codex 后续执行时只需要补充差异，不必重新猜测环境。
排错路径：改完后先比差异，再判断是否修复
如果 Codex 改完后页面异常，先比较截图和 DOM，而不是立刻重写样式。按钮消失可能是 CSS 选择器变化，也可能是首页内容从数据库读取时没有更新。接口异常时，先用基线请求重放，确认是 Key 权限、模型名、代理、限流还是请求体变化。若 Codex 修改了多个文件，优先看与目标直接相关的文件；发现无关 diff 时先暂停，要求它解释为什么要改。对静态 SEO 页面，还要检查 UTF-8 无 BOM、中文标题、站内链接、robots 和 sitemap。这里可以结合站内的任务拆分、灰度验证和成本预警文章，把验收拆成可复核的小项。
常见问题/避坑：不要把备份当成回滚方案的全部
第一个坑是只截图不保存接口样本，导致后端改坏后看不出请求差异。第二个坑是只保存文件，不记录线上状态；部署前正常、部署后异常时，很难判断是构建、缓存还是服务重载造成。第三个坑是把敏感 Key 放进基线文档，建议只记录 Key 所属环境、尾号和权限范围，不记录完整值。第四个坑是把所有基线都交给 Codex 临时生成，却没有人工确认重要页面和业务流程。永沃云枢建议把基线文件放在项目内固定目录，并在任务说明里写清允许读取、禁止上传和需要打码的内容。
检查清单：交给 Codex 前逐项确认
是否保存目标页面的桌面和移动端截图；是否记录首页、栏目页、文章页、sitemap 和 robots 的状态码；是否准备 AI API 接入的最小请求样本；是否写清 CCSwitch 配置、环境变量和模型名只读边界；是否有回滚点或备份文件；是否列出本次允许修改的目录；是否把验收命令写成可复制清单；是否说明不能承诺搜索引擎一定收录，只能说明已提交或可抓取。
验收补充：把基线变成团队习惯
实际执行时，基线不需要写成厚文档，但必须能被下一位接手的人看懂。建议把截图、请求样本、关键文件路径、预期结果和失败表现放在同一个任务记录里，并标注哪些信息来自线上、哪些来自本地。Codex 完成修改后，再把新结果追加到同一份记录中，形成修改前、修改后和最终验收三段。这样下次遇到 AI API 接入异常、CCSwitch 配置变动、模型调用管理成本升高或 AI 自动化办公流程误判时，不必重新收集所有证据。对于搜索引擎相关任务，还要单独记录“已提交”和“已收录”的区别：推送 IndexNow、百度或 sitemap 只代表页面可被发现，不代表一定会被收录。
FAQ：能不能让 Codex 一次把这些都自动做完？
可以让 Codex 读取资料、生成清单、执行低风险检查并整理结果，但涉及生产配置、数据库、支付、敏感 Key、用户隐私和正式发布时，仍要保留人工确认点。更稳的方式是先让 Codex 给出影响文件、命令、风险和验收结果，再决定是否继续扩大范围。