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 生態中的結果保管階段提供了一種輕量級、無侵入的驗證手段。通過內容尋址和嚴格的元數據校驗，它幫助開發者在不需要觸碰實際內容的情況下，確認工具運行結果的留存狀態。