什么是测试证据的保管链?
测试证据的保管链是一种记录,用于证明测试结果及其文件在运行后未被更改. Verdict System LLC 的 Nexus StudioQA 通过一个可选择启用的仅追加账本来维护保管链: 对证据文件夹中的每个文件计算 SHA-256 哈希值,并将每条记录链接到上一条记录,这样校验时就能指出首条发生变化的记录.
最后更新:
作者:Verdict System LLC 的 Nexus StudioQA 团队。
团队为什么需要保管链?
一次失败的测试可能成为缺陷报告、发布决策的依据或审计事项,几周后可能有人会问,截图和报告是否还是那次运行生成的原始文件. 磁盘上的文件夹本身无法证明任何事情: 其中任何文件都可以被编辑. 有了保管链,任何人都可以运行一条命令,得到是否发生更改的明确答案,并找出发生变化的记录.
它如何工作?
- 一条记录对应一个包含 metadata.json 的证据文件夹,例如状态为 BREACHED 的运行所留下的文件夹,其中包含报告、截图和日志.
- 文件夹中的每个文件都会计算 SHA-256 哈希值,记录的哈希值还包含上一条记录的哈希值. 任何文件中哪怕一个字节发生变化,都会导致该记录及其后所有记录的校验失败.
- 所有记录都保存在同一个仅追加的账本
evidence/chain-of-custody/ledger.jsonl中,该账本存放在证据旁边,且从不删减. 它仅使用 Node.js 内置的 crypto 模块,并在你的机器上运行. - 封存需要主动启用. 在 Studio 中首次判定为真实缺陷或误报时,对应记录及判定理由会加入保管链,从而开始封存; 也可以通过
nexus verify --seal开始. - 如果没有账本,校验会报告 UNVERIFIED 并以失败结束. 它绝不会悄然报告 OK,因为缺少证据并不等于已有证明.
实际运行时是什么样的?
以下是引擎自身命令对两个证据文件夹的输出,记录于 2026-11-06: 一个来自 Chromium 中状态为 BREACHED 的运行,另一个来自 Firefox 中状态为 TIMEOUT 的运行. 在第三条和第四条命令之间,有人手动修改了 TC101 的 report.md 中的一行.
> nexus verify
🔗 Nexus StudioQA — Evidence Chain of Custody (SHA-256, on-prem)
⚠️ UNVERIFIED — no ledger — run `nexus verify --seal` first (UNVERIFIED, not OK)
> nexus verify --seal
✅ SEALED 2 record(s) → evidence\chain-of-custody\ledger.jsonl
tip: bcc9f551e102aa6b0593bbab23e794d2da62934d58dcd27464fa322962338571
> nexus verify
✅ VERIFIED — verified 2 record(s), all artifacts intact
(report.md of TC101 edited by hand)
> nexus verify
❌ TAMPER DETECTED — evidence altered after sealing at record 0: TC101_chromium_2026-11-06_10-15-02 [BREACHED]
record: TC101 / chromium [BREACHED] — TC101_chromium_2026-11-06_10-15-02 [BREACHED]
校验在未验证时退出码为 2,验证通过时为 0,检测到修改时为 1,因此 CI 任务可以在发现篡改时失败.
四种状态分别是什么?
| 状态 | 含义 | 应采取的操作 |
|---|---|---|
| UNVERIFIED | 尚无账本,因此无法提供任何证明 | 执行封存,或首次判定为真实缺陷或误报 |
| VERIFIED | 每条已封存记录及其文件均与各自的哈希值匹配 | 无需操作 |
| TAMPER DETECTED | 文件或账本中的某一行在封存后发生了变化; 会指出首条校验失败的记录 | 将该文件夹与可信副本进行比较 |
| PURGED | 某个已封存的文件夹被有意删除,账本记录了删除者和删除时间 | 无需操作; 账本仍可证明其当时的哈希值 |
清理旧证据时会发生什么?
在因磁盘空间限额、保留策略或释放磁盘空间操作而删除已封存的文件夹之前,引擎会先向账本追加一条 PURGE 条目,注明删除者和删除时间. 此后校验会将该记录报告为 PURGED,而不是被篡改. 如果账本无法记录 PURGE,文件夹就会保留. 存储与自维护介绍了空间限额.
有哪些局限?
- 它证明的是文件在封存后未发生变化,而不能证明文件在封存前就是正确的: 如果记录在编辑后才封存,封存的就是编辑后的内容.
- 只有已封存的记录才在验证范围内. 首次封存之前写入的证据会一直保持 UNVERIFIED 状态,直到你将其封存.
- 账本与证据存放在同一块磁盘上. 同时拥有两者写入权限的人可以重建整条保管链,因此请将封存时输出的链尾哈希值保存在其他位置,例如工单或发布说明中,以便日后比对.
在哪里可以看到?
证据页面以一次失败的测试为线索,逐一介绍它留下的文件; 术语表解释了 UNVERIFIED 以及真实缺陷或误报的判定. 免费试用版使用同一引擎来运行你自己的测试.