dsh-reproducible-build-proof: 离线构建一致性验证

在 DeepSeek Harness (DSH) 生态中，验证构建过程的一致性是一个常见需求。独立构建者如何确认他们产生的输出完全相同？现有的工具通常检查签名或下载状态，但不检查独立构建器之间的字节级匹配。dsh-reproducible-build-proof 插件旨在解决这个问题。

是什么¶

这是一个 DeepSeek Harness 插件，提供离线内容寻址证明以验证独立构建是否产生字节级相同的输出。由 dongsheng123132 维护。

它专注于验证独立构建的收敛性：确认多个独立操作者是否使用相同的源修订、配方、构建类型、参数、依赖集以及相关的环境契约，最终生成了字节级完全相同的指定工件。

核心功能¶

• 离线内容寻址证明：在无网络请求的情况下验证输出。
• 独立构建收敛验证：检查输入声明的一致性。
• 输入检查：验证源修订、配方、构建类型、参数、依赖集和环境契约。
• 显式哈希收据：仅验证显式哈希，不执行构建或安装包。
• 确定性输出：生成确定性内容寻址输出。
• 无运行时依赖：验证器本身无外部依赖。

安装与启用¶

在终端中执行以下命令以安装该插件：

dsh plugin add github:dongsheng123132/dsh-reproducible-build-proof#COMMIT

典型用法¶

插件提供了多种调用方式。

1. CLI 命令：可以直接使用 dsh_reproducible_build_inspect 和 dsh_reproducible_build_verify 命令。
2. MCP stdio 服务器：通过 MCP stdio 服务器暴露了 reproducible_build_inspect 和 reproducible_build_verify 接口。
3. CLI JSON 路径：CLI 支持使用 inspect 或 verify 加上显式 JSON 路径的参数形式。

插件在运行时会读取工作区相对的非符号链接清单，并将结果写入显式的工作区相对 artifactDir 中。它拒绝机密形状的材料、原始日志以及 body/content 字段。

适用场景与注意¶

• 功能边界：此插件不执行构建、安装包、认证来源、签发 SLSA Verified Property，或声称能保护源代码、依赖项或分发威胁。它仅验证显式哈希收据的匹配度。若需认证来源，请使用 provenance/signature verifier。
• 环境要求：需要 Node.js 22 或更新版本。
• 网络与依赖：验证器无运行时依赖且不发起网络请求。
• 清单格式：DSH verify 工具仅读取工作区相对的非符号链接清单。

总结¶

此工具为 DeepSeek Harness 供应链提供了一个离线的、确定性的证据层，用于验证独立构建的一致性。要了解更多细节或查看示例，可访问插件目录或 GitHub 仓库。