失败留档:给产线装黑匣子
用一个 runs/ 文件夹留下每次运行的输入输出,让出事之后能还原全程
飞机为什么装黑匣子?不是为了防止事故——它防不了。是为了事故之后能还原全程,而不是靠机组回忆吵架。
回想本模块前面讲的每一个事故,你有没有注意到一件事:它们全都带着证据来源。断流有续跑日志,47 节只转出 25 节有转换日志的三条记录,分片参数是几撞出来的写在源码注释里。这门课敢把这些数字讲给你、敢让你去核,不是因为我们记性好,是因为当时留了档。
没有留档,这些就全是“我记得好像有一次……”——既没法教学,也没法改进。这一节你会亲手建起自己的第一个黑匣子,门槛低到只是一个文件夹。
黑匣子平时是全飞机最没存在感的设备:不参与飞行、不提升性能、一克油都不省。但它录的是全程——起飞、巡航、每一次操作,而不是只录降落成功那一刻。留档也一样:平时看起来是白花几秒钟存文件,出事的那一天,它是唯一能替你说话的东西。
我们的做法:一个 runs/ 目录
我们的产线有个 runs/ 目录:每次运行的每一步,输入是什么、输出是什么、审核报告说了什么,全部存进去。平时没人看它;出事的时候,全靠它。
留档的价值具体有三个:
- 定位。出事时能回答“断在哪一步、输入是什么、输出到哪了”。上一批课节讲的断点续跑,本质上就是靠留档知道从哪续——没有“已完成到哪”的记录,续跑无从谈起。
- 定责,而且是对事不对人。像分片接缝伤这种“两片之间”的问题,如果留了两片的原始输出,就可以把它们摆在桌上对,而不用靠猜、靠回忆、靠“我印象里不是这样的”。
- 可核查。别人——包括一个月后的你自己——质疑你的结论时,有原始记录可查。这门课的所有数字都能给出复现路径,源头就是
runs/目录、日志和 git 提交记录。
门槛低到没有借口
留档不需要任何工具:一个文件夹就够了。按日期建目录,每次跑任务,把“发出去的 prompt”和“收回来的产出”各存一个文件。就这么多。
规则只有一条,但是硬规则:跑的时候就存,别事后补。事后补的不叫留档,叫回忆录——回忆录会不自觉地把过程改写得比实际顺利,而黑匣子的全部价值就在于它录的是当时的原样。
🔧 动手做:建你的第一个黑匣子(8 分钟)
- 在你放本课练习的地方新建一个文件夹,命名
runs/。 - 在里面按日期建子目录,比如
runs/2026-08-13/。 - 把本模块 5.1 到 5.5 所有练习的材料搬进去:你发出的 prompt 存一个文件,AI 的产出或你的记录存一个文件,输入和输出分开存。
- 文件名带上节号,让文件不用打开就能定位,比如
5.1-断流实验-输入.txt、5.1-断流实验-输出.txt。 - 从今天起养成习惯:每做一次和 AI 相关的正式任务,先存输入,收到产出立刻存输出,然后再做别的。
你会看到:一个能回答“我在 5.2 到底撞到了哪类接缝伤、原始输出长什么样”的目录。一个月后你还能翻出证据,而不是只剩印象。
为什么:可靠性工程的最后一环不是“不出事”,而是“出了事说得清”。这个文件夹就是你产线的黑匣子,后面每一节的产出都会继续存进来。
一句诚实条款:留档给你的是“可以核”的能力,核不核还是要你动手。我们那份一手记录的第一版,自己就写错了两个数字,是靠跑命令对着留档核出来的——这件事我们会在下一模块详细讲。别把“我有留档”当成“我的数字都对”:黑匣子只保证现场还在,不保证你对现场的转述没走样。所有数字,以命令复现为准,不以记忆为准。
留档就是给产线装黑匣子:每次运行,输入、输出、审核报告原样存进 runs/ 目录。它的三个价值是定位(断在哪)、定责(摆证据不靠猜)、可核查(别人和未来的你都能对账)。门槛只是一个文件夹,唯一的硬规则是跑的时候就存、不事后补。现在断流、接缝、续跑、假绿灯、留档都讲完了——下一节把它们装订成一页纸的“可靠性三件套”。
🔎 来源与核验· 4 条,点开核对
