Codex真正省时间的地方,不是多写几段建议,而是能围绕真实文件把一项工作推进到可验收结果。
内部链接可以直接核对文件,外部链接却会受重定向、登录、反爬和临时网络影响。把所有非200都当死链会产生大量误报。
所以这篇文章只解决一件事:建立能区分内部错误、外部异常和待人工确认的网站链接检查流程。这套流程先控制一个小范围,确认有效后再扩大,避免把第一处错误复制到全部材料。
适合谁
适合网站改版、文件迁移或文章增加后,需要确认页面链接没有失效的人。
这不是一套让工具替你承担责任的方法。材料缺失要补,结论无法定位要标记,涉及不可逆操作时要停下来确认。
Codex可以读取项目、修改文件和执行命令,因此先使用副本或版本控制,明确禁止触碰的目录与生产环境。高风险操作、唯一原件和最终判断必须留给人工。
开始前准备
- 构建后的站点目录
- 网站基础域名和路由规则
- 允许访问的外部链接范围
- 建立一个测试副本或新目录,不直接操作唯一原件。
- 写下一句验收标准:每个确定坏链都有来源和目标证据,外部异常保留状态信息,修复后未产生新链接错误
准备材料时,把“必须原样保留”“允许调整”“信息不足时禁止猜测”分开写。三类边界混在一句话里,执行时最容易被忽略。
完整步骤
第一步之前:先做一个最小样本
先选最有代表性的一小份材料:既包含正常情况,也包含一个容易出错的边界。小样不合格时,继续全量处理只会增加返工。
第一步:提取并归一化链接
区分相对路径、绝对路径、锚点、邮件、脚本和外部地址,处理URL编码与尾斜杠。
这一阶段的完成标志不是工具有回复,而是“分类后的链接清单”已经可供人工检查。
第二步:先验证内部目标
检查页面、图片、CSS、脚本和锚点是否真实存在,记录来源页面。
继续下一步之前,抽查“内部坏链报告”中的边界项和异常项;发现前提不成立就先修正。
第三步:单独探测外部链接
记录状态码、重定向和超时;403或登录页只标成待确认,不直接认定失效。
把“外部链接状态表”作为本轮留存证据。后续合并或扩大范围时,都应能用它复盘。
第四步:修复后重新全量检查
更新真实内容源,再构建并确认坏链数量归零或每个例外都有说明。
先停在这里检查一次。此时应已经形成“修复与复检结果”,并且能回到原始材料说明它从哪里来。
第五步:人工验收并沉淀流程
不要在第五步继续扩写内容,而是做对账:输入是否齐、步骤是否留证、结果是否可恢复、风险是否有人确认。
实际示例
微信文章链接返回验证页,不等于文章已删除;站内“/guide.html”对应文件不存在则是确定坏链。两类结果必须分开。
可以先这样描述任务:
我正在处理“建立能区分内部错误、外部异常和待人工确认的网站链接检查流程”。已有材料包括构建后的站点目录、网站基础域名和路由规则、允许访问的外部链接范围。请先不要扩大任务范围,也不要补造缺失信息。先完成“提取并归一化链接”,输出可以人工检查的中间结果;我确认后,再继续“先验证内部目标”。最终请按照“每个确定坏链都有来源和目标证据,外部异常保留状态信息,修复后未产生新链接错误”列出验收结果和仍需人工确认的内容。
若第一次结果仍然太宽泛,不要继续追加十条要求。缩小输入,只重做最早出现偏差的那一步。
常见问题与报错
检查器报告很多404,浏览器却能打开
核对站点是否依赖路由重写、基础路径或部署平台规则;本地文件检查与线上HTTP检查要分别记录。
任务跑了很久,却说不清改了什么
先要求列出计划和预计修改文件,每个阶段输出变更摘要、diff、命令和未解决项;没有检查点的长任务应暂停后重新拆分。
一次修改太多文件,出现问题无法定位
回到版本控制或副本,按一个目标一组文件重新执行;每批修改后立即运行对应检查,不把多个不相关需求放进同一次任务。
排查时先看实际读取文件、修改diff、命令和输出。一次只调整一个范围或规则,避免把多个故障叠在同一次执行里。
完成后的检查方法
- 每个确定坏链都有来源和目标证据,外部异常保留状态信息,修复后未产生新链接错误
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本,敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅,而不是只看页面是否生成。
最后再问自己一次:这份结果解决了最开始的问题,还是只生成了另一份需要重新整理的材料?只有前者才算完成。
资料来源
- OpenAI Codex文档
用于核对Codex的产品定位和当前官方使用说明。
- OpenAI AGENTS.md指南
用于核对项目级规则文件的作用范围;具体行为以当前Codex版本为准。
FAQ
可以一次把整个任务交给Codex完成吗?
不建议一次交付全部范围。先按本文步骤完成一个小样,用“每个确定坏链都有来源和目标证据,外部异常保留状态信息,修复后未产生新链接错误”验收,再决定是否扩大范围。
遇到“检查器报告很多404,浏览器却能打开”应该先检查什么?
核对站点是否依赖路由重写、基础路径或部署平台规则;本地文件检查与线上HTTP检查要分别记录
完成后还需要人工检查吗?
需要。AI或执行工具负责推进流程,最终仍要由你根据原始材料、任务规则和“每个确定坏链都有来源和目标证据,外部异常保留状态信息,修复后未产生新链接错误”完成验收。
