音频处理回归测试：空差、失真复核与报告交接

先约定变化，再看测量结果

本流程面向复核一次音频处理改动的开发与测试人员。先固定用例编号、输入、处理器版本、设置和预期行为。直通或恒等用例与均衡、增益、饱和器不同，后者不抵消可能正是需求。提前约定数值阈值和审批人，不在看到结果后凭空规定通用残差或失真合格线。

双声道生成器可制作可复现素材，但把输入送入被测软件仍需另行完成。保存生成设置和返回元数据。单音示例可用 48 kHz、三秒、两声道同为 1 kHz 正弦、峰值目标 -18 dBFS、相位一致；选择从 0.5 秒开始的一秒窗口避开淡入淡出，再确认输出依然适合 THD。这个例子不是声学校准，试听前先降低播放增益。

核对文件、延迟与比较范围

探测编码、采样率、声道、时长并查看波形。空差输入必须同采样率、同声道数，支持 8–96 kHz 单声道或双声道，每份最多 30 秒，不自动重采样或下混。声道交换、格式转换与时钟漂移需要单独说明，不是一个整数偏移通常就能解决。

残差为 A 减 B。正偏移跳过 B 的对应帧，负偏移跳过 A，再比较剩余重叠范围。记录偏移依据、comparedFrames、excludedFrames 和 wholeFilesCompared。偏移也可能跳过本应验证的瞬态，所以必须写清未测范围。

先核查简单对照：相同解码数组应抵消；B 为 A 的一半幅度时残差为一半 A，相对非静音参考约为 -6.02 dB。这说明增益敏感性，不是验收阈值。工具不会自动对齐、拟合增益、纠正极性、移除直流或归一化。零幅度以及静音参考导致的比值不可定义可能表现为对数字段 null，不能全部替换成数值零。浮点残差超过满刻度也会保留，某些播放器可能削波。

仅对适用稳定片段解读 THD

频谱图可辅助定位稳定区，图像本身不证明数值条件合格。分析窗口为 0.05–5 秒，至少包含 20 个基频周期，在给定标称频率附近搜索。对照获批报告时保持窗口位置、长度、标称频率及谐波阶数相同，记录实际分析长度并逐声道检查。

先读状态与原因，再读百分比。主导单音及半窗口稳定性筛查可能让结果不可靠或无法确定。接近或超过奈奎斯特保护带的选定谐波会被遗漏，遗漏集合不同会降低总数可比性；谐波频点的噪声也会影响估计。结果不是 THD+N、音乐或扫频测量，也不是校准模拟带宽或认证不确定度。

有意时变或非线性处理可能让用例不适用，失真本身也可能是目标。保留这种判断，不强求低数值；数值测量与听感回答的问题不同。

对齐用例并交付结论边界

保留同次运行的原始 JSON、CSV、residual.wav 和可视证据。波形图和包络摘要不是每个样本。路径级 JSON 差异不会自动匹配用例，比较前先对齐编号、声道顺序和设置；时间戳与文件名变化不一定是回归，窗口改变则可能让直接对照无效。

记录观察到的变化、预定阈值、接受或拒绝、负责人和未解决项。精确抵消只描述比较到的解码样本，不一定覆盖所有内容，更不证明容器字节相同。为实际交付输入、输出、报告和归档计算 SHA-256 并保存本地副本，哈希保证身份可核对，不证明测量正确。

丰富测试输入转到测试信号制作专题，有损母带交付转到编码预检专题，广泛调查源文件转到音频分析专题。本页不替你运行处理器、不修复结果，也不证明整台设备的声学性能。