8.1 数值实验工作流规范：让可靠结果可稳定生产

8.1 数值实验工作流规范：让可靠结果可稳定生产

本节摘要：混沌数值实验的失败，多数不败在算法，败在流程——没去趋势、没记参数、没做对照，结果好看却不可信，或可信却不可复现。本节先复盘一次真实的失败复现，然后把全册实验的共同骨架提炼成五段工作流：设计、预处理、计算、验收、归档，每段交代输入、输出与留痕要求，并把 7.3 节的十二项清单嵌进关键节点，让"边做边检"取代"做完再补"。

从一次失败复现说起

先讲一件真事，主角是本教程作者本人。整理第 4 章素材期间，我想重画三个月前算的一组心率数据的关联维数曲线，图却怎么都和当时的笔记对不上——笔记上的曲线在嵌入维数五附近收敛，新算的曲线一路爬升毫无收敛迹象。排查花了一下午，问题有三层：当时的序列做过滑动平均去噪，这一步没记在笔记里；当时取的是去掉昼夜趋势后的残差，这次直接用了原序列；当时的延迟时间按互信息第一极小值选，这次偷懒用了经验值三。三个差异每一个都足以改变维数曲线的形状，叠加之后面目全非。数据还是那份数据，算法还是那个算法，结论已经无从谈起。

这次事故的教训不是"要细心"——细心救不了流程漏洞，因为人的记性必然在第三周掉链子。教训是：凡是没有被流程强制留下的东西，就等于没做过。去噪要做，但必须留下"做了"的痕迹；延迟时间要选，但必须留下"怎么选的"记录。工作流的本质，就是把好的临场操作变成不由临场状态决定的固定动作。本节余下的部分，就是把全册实验复盘里不动声色反复出现的这套动作，明写成五个阶段。

一、设计段：先立判据，再跑代码

设计段回答"这个实验要判定什么、什么结果算数"。它先于任何一行代码：写出待检验的假设（"该序列在去趋势后仍满足敏感依赖"）、选定判据与指标（正指数、维数收敛、替代数据对照）、预先设定通过线（比如"指数在数据长度减半时变化不超过一成"）。预先设定通过线是关键动作——结果出来之后再定标准，人会不自觉地把标准挪到对自己结论有利的位置，这是人性不是恶意，流程要防的就是它。设计段还要定数据来源与划分：哪段用来定参数，哪段用来出结论，两段不许重叠，第 6 章脑电预测大面积翻车的教训之一就是用同一段数据既调参又报成绩。

留痕要求：一页实验设计卡，写明假设、判据、通过线、数据划分。这页卡是后面所有阶段的合同。

二、预处理段：每一步都要可撤销、可说明

预处理是伪混沌的第一产地，也是工作流里留痕最重的一段。三个固定动作：平稳性检查（趋势检验加去趋势，方法与参数记录在案）、降噪声明（用不用滤波、用什么滤波、参数多少；不滤波也要写"未滤波"三个字）、信噪比估计（哪怕粗估，给个量级）。每个动作都要求可撤销——原始数据永远保留一份只读副本，预处理生成新序列而不是覆盖旧序列，这样任何一步出问题都能退回去重来。第 8 章开头那次事故的根源，就是去噪与去趋势这两步既没留痕也不可撤销。

三、计算段：环境与种子随结果一起存

计算段的纪律可以概括成一句话：结果与它的全部生成条件同存亡。具体包括：参数全套记录（嵌入维数、延迟时间、算法变体、积分步长），随机种子固定并记录（打乱替代数据、随机初始条件都依赖种子），运行环境记录（库版本影响数值细节，跨版本对比时要心里有数）。计算段的另一个纪律是分段试跑：先在短数据、小参数网格上把整条链路走通，再放全量——直接上全量的结局，往往是跑完三小时才发现第三行有个笔误。全册实验复盘时演示过的"手算一段、程序算全程"三角验证，就属于这一段的标准动作：它既是校验，也是对算法实现的活体注释。

四、验收段：十二项清单进场

计算出结果不等于实验结束，验收段请出 7.3 节的十二项清单，逐项打分。这一段的关键是把清单拆到合适的节点，而不是堆到最后一次性验收：替代数据对照属于计算段的收尾动作，参数稳健性扫描属于计算段的常规配置，而有界性与敏感依赖的检查在预处理后就该做——数据根本不合格时，后面所有计算都是浪费。验收段留痕的是一张打分表：十二项，每项一（过）、零（不过）或问号（无法判断），附一行结论定级。这张表在协作里有第二个用途：同事接手你的项目时，打分表是他判断"哪些结论可以直接用、哪些要重查"的最快入口。

五、归档段：让三个月后的自己看懂

归档段的读者不是现在的你，是三个月后的你，以及可能接手的任何人。归档件包括：原始数据只读副本、全部中间序列、实验设计卡、参数与环境记录、清单打分表、最终图表的生成脚本。归纳成一个检验标准：一个没参与过本项目的人，只凭归档件，能否不经询问地重跑出同样的图。能，归档合格；不能，缺的那件东西就是下次事故的埋点。归档不必隆重，一套约定好的目录加一份说明文件足矣，隆重与否不重要，齐全才重要。

图 8-1 五段工作流与清单嵌入点

数值实验工作流模板（每段末行为该段强制留痕件）：

[设计] 假设 判据 通过线 数据划分
   └─ 留痕：实验设计卡
[预处理] 平稳性检查 去趋势 降噪声明 信噪比估计
   └─ 留痕：处理日志 加 只读原始副本
[计算] 参数全记录 种子固定 分段试跑 三角验证
   └─ 留痕：参数表 加 生成脚本
[验收] 十二项清单分段嵌入（替代数据在计算尾 稳健性在扫描中）
   └─ 留痕：打分表 加 结论定级
[归档] 目录约定 说明文件 重跑检验
   └─ 留痕：归档说明 加 重跑核对记录
​

常见流程漏洞对照

把全册踩过的坑归拢成三查。一查"静默假设"：每一段里"我当时默认了什么"——默认数据干净、默认参数够用、默认种子不重要，事故复盘里一半的祸根长这个样子。二查"顺序颠倒"：先看结果再定标准、先跑全量再调链路、先写论文再补对照，顺序一颠倒，流程的防错设计全部失效。三查"留痕断链"：设计卡写了判据但没写通过线，参数表记了值但没记单位，打分表打了零但没写原因——断掉的每一环，都会在接手者那里变成一次询问或一次误用。

变式：把工作流缩到十分钟版本

五段全展开适合正式项目，日常练习也要有个轻量版，否则规范会在低风险场合被荒废，等高风险场合来临时手感已经生疏。十分钟版本只保三件：动手前写三行设计（假设、判据、通过线），收工时存三样东西（数据副本、参数表、一句结论定级），周末补一张十二项清单的快速打分。全册的课后实验都可以用这个轻量版养习惯——规范的意义不在隆重，在于高风险日到来时，它已经是你不需要决定的习惯。

三段式缩水的边界也要说清：轻量版产出的结果只配自用，进报告、进论文的实验必须回到完整版。短流程不是完整流程的替代品，是它的日常体操。若实验要与人合做，还有一条分工建议：设计卡与验收表由不同的人执笔——执笔设计的人不看验收结果，验收的人不参与参数调优，这与临床试验里设盲的用意相同，成本极低，却能斩断“为结论服务地调整标准”的通路。单人项目做不到双人，那就把设计卡的时间戳留在结果之前，时间戳是最廉价的盲法。

本节要点回顾

• 流程先于细心：凡是没有被流程强制留下的操作，就等于没做过；失败复现事故的三层根因全是留痕缺失。
• 五段骨架：设计立合同，预处理可撤销，计算与环境同存，验收分段嵌清单，归档面向三个月后的自己。
• 通过线前置：判定标准必须在看到结果之前写下，这是对确认偏误唯一有效的流程防御。
• 留痕件清单：设计卡、处理日志、参数表、打分表、归档说明——五件套齐，实验才算闭环。
• 重跑检验：归档合格的标准是外人凭件可复现，这是全册"重演"承诺的工程化表述。

工作流的骨架立住了，下一节往骨架里填装备：面对具体任务，纸笔、表格、计算库与专用软件各在什么位置，怎么选不后悔。