dsh-output-custody-proof：DSH 工具结果保管的无内容证明

前言¶

在 DeepSeek Harness (DSH) 的工具调用链路中，工具生成的结果可能很大，或者出于性能、隐私和存储成本考虑，需要在保留证据的同时避免直接读取或存储完整的内容体。我们需要一种机制，在不接触具体内容的前提下，验证结果是否被正确保留、处理以及满足特定的字节预算和映射关系。

dsh-output-custody-proof 插件提供了一种针对“无内容”DSH 工具结果保留和溢出保管阶段的内容寻址证明机制。它通过离线、确定性验证来确认保管收据的有效性，确保结果的完整性和一致性。

这是一个由 dongsheng123132 维护的插件，专注于“记忆”分类。它不负责存储结果、转换输出或清理数据，而是作为一个验证层，检查并证明结果在保留和溢出阶段的状态。

插件的核心作用在于协调格式化源摘要和字节计数，与模型可见或仅持久化的投影进行核对，并验证字节预算、遗漏核算、溢出/源身份、表面映射、阶段顺序以及显式上游不完整性。

离线确定性验证
插件能够对无内容的 DSH 工具结果保管收据进行离线验证。它不读取结果体，也不打开溢出工件，仅基于收据中的元数据进行判断。
多维度检查
验证过程涵盖字节预算、精确遗漏核算、溢出/源身份、表面映射、阶段顺序、重复调用/定位符身份以及显式上游不完整性。
MCP 与文件工具
提供 MCP 工具 output_custody_inspect_inline 和 output_custody_verify_inline（仅限内联）。
文件工具具有严格的安全限制：接受工作区相对路径，拒绝遍历和符号链接，限制输入大小，仅写入指定的 artifact 目录，仅发布创建操作，并通过读回验证来确保数据一致性。

安装前请确保环境满足依赖要求：
* DSH 版本：>= 0.1.2-alpha.4
* Node.js 版本：>= 22

使用以下命令安装（安装命令中的 #COMMIT 需替换为实际的 Git Commit Hash）：

dsh plugin --profile web add github:dongsheng123132/dsh-output-custody-proof#COMMIT

安装完成后，可通过以下命令行工具进行操作：

dsh_output_custody_inspect
dsh_output_custody_verify

插件提供了基础的示例文件。你可以使用以下命令进行操作：

dsh-output-custody-proof inspect examples/custody.
dsh-output-custody-proof verify examples/custody. artifacts

在插件仓库的根目录下，还提供了一组测试脚本用于验证环境配置是否正确：

npm test
npm run check
npm run smoke:plugin
npm run smoke:mcp

功能边界
这是一个验证工具，不是溢出存储、输出转换器、清理器、会话导出器或结果记录器。
- dsh-output-retention 库决定机械保留的内容。
- dsh-spill-policy 负责将超大纯文本结果转换为溢出格式。
- dsh-spill-local 负责存储这些溢出内容。
- dsh-telemetry-redactor 负责清理导出副本。
  此插件仅验证来自上述组件或其他生产者的显式收据。
安全性与隐私
插件从不读取结果体或打开溢出工件，这保证了在验证过程中不会泄露工具的实际输出内容。
证明范围
每份报告都会明确指出，哈希值仅证明内容的完整性和一致性，并不证明源的真实性或现实世界的完整性。
数据类型限制
Schema 仅接受有界标识符、字节计数、分类和 SHA-256 哈希，拒绝工具值、输出文本、提示、消息、凭据或溢出定位符。

dsh-output-custody-proof 为 DSH 生态中的结果保管阶段提供了一种轻量级、无侵入的验证手段。通过内容寻址和严格的元数据校验，它帮助开发者在不需要触碰实际内容的情况下，确认工具运行结果的留存状态。