Codex 批量处理文件，怎样先小样本再安全扩大？

适用边界与版本日期

这套方法适合重命名、格式转换、元数据补全、文本清理等可重复文件任务。本文按 2026-08-30 的公开实践整理。示例使用虚构资料，不要求你把真实客户文件或私密资料交给模型。

它不适合第一次运行就不可逆地修改原件，也不适合金额、医疗、法律结论等仅靠自动检查无法安全验收的高风险任务。此类任务应增加专业人工复核，或不采用批处理。

跟着做

1. 先盘点，不处理。 记录文件总数、类型、大小范围、目录边界和已知例外。确认哪些是输入，哪些是输出，原件放在哪里。
2. 冻结抽样规则。 从副本中选一个小批次，同时包含常规项、边界项和已知异常项。不要只挑最整齐的文件。样本名单一旦确定，本轮不得替换。
3. 在运行前写门禁。 至少写清：允许改哪些字段、必须保持哪些内容、每项怎样检查、错误率或越界数达到多少立即停止。阈值由你在看结果前决定。
4. 只跑样本副本。 提示 Codex 仅处理冻结名单，并把结果写入单独输出目录。要求先列计划，再执行；输入目录保持只读。
5. 逐项人工抽验。 将每个输出与对应输入比较，记录通过、失败和原因。既检查目标变化，也检查本应保持不变的内容。
6. 做扩大决定。 只有样本达到预先写下的门禁，才批准下一批；下一批仍有限量、有回滚点、有同样验收。未达到就停在样本阶段。

你现在可以用五个虚构文本文件演练。不要急着处理剩余文件，先在门禁表中写下样本名单和停止阈值；如果这两项是处理后才补写，本轮证据无效。

应该看到什么

一个合格的小样本阶段应留下：输入盘点、冻结样本清单、运行前门禁、独立输出目录、逐项验收结果和“扩大 / 修正后重试 / 停止”三选一的决定。

原始目录的文件数量、内容和修改时间不应因演练改变。输出中即使只有一项越过授权边界，也要按照预设门禁处理，不能因为其余项表现不错就忽略。

证据与验收

验收时同时看目标结果和不变量：

• 样本是否按预先规则选出，覆盖常规、边界与异常？
• 实际处理清单是否与冻结样本完全一致？
• 输入原件是否保持不变，输出是否进入单独目录？
• 每个样本是否有目标字段检查和不变量检查？
• 扩大决定是否引用了运行前门禁，而不是事后解释？

可以用文件清单、哈希、版本差异和人工核对表组成证据。单独一条“命令退出码为 0”只能证明程序结束，不能证明内容合格。

常见失败、补救与停止线

• 挑最容易的样本： 重新按文件类型、长度和异常分层抽样，并在运行前冻结名单。
• 直接在原目录运行： 停止进程，从备份恢复原件，改用只读输入与独立输出。
• 样本失败却继续扩大： 撤销扩大授权，先定位失败类型；规则变更后重新跑完整小样本。
• 只查目标字段，不查副作用： 为必须保持的名称、顺序、编码或内容补不变量检查。

发现输入被修改、处理范围超过冻结清单、输出覆盖既有文件、停止阈值被触发，或无法恢复到运行前状态时，立即停止。不要继续处理剩余集合。

来源与深入阅读

需要完整练习如何冻结样本、保留异常、设置门禁并从小样本决定是否扩大，请继续阅读 《Codex 使用手册》第 12 章：可回滚的批处理流水线。