前言¶

在 DSH 裏調試 Agent 行爲時，經常會想確認相鄰兩次請求之間發生了什麼變化：provider/model 是否變化、system 是否變化、tools 目錄是否變化、skills 或 AGENTS 來源類別是否有差異。
但直接讀取請求體容易把 prompt 文本、message 內容、tool schema、原始路徑等敏感內容暴露出來。

dsh-context-provenance 是用於這個場景的 DSH 插件：它不返回這些原始內容，而是把相鄰請求證據標成 Observed、Estimated 或 Unavailable，並只依賴公共運行時接口能證明的信息。

這是什麼¶

dsh-context-provenance 是 030611 維護的 MIT 許可插件，屬於社區維護項目，不是 DeepSeek 官方項目。

它的定位是一個 observe-only provenance ledger，面向 public DeepSeek Harness runtime evidence。
插件本身是 observe-only、CPU-only、local-only，不做文件、網絡、子進程、GPU、持久化、session、permission、tool、model-routing 或請求變更。

它只保留最近兩條 ordinary agent-loop request observations，並在內存中保存；觀察結果通過現有 Cordis inspect 查詢機制暴露。

核心功能¶

• 比較相鄰請求證據，並把字段標成 Observed、Estimated 或 Unavailable。
• 不返回 prompt text、message content、tool schemas 或 raw paths。
• 只保留最近兩條普通 agent-loop 請求觀察。
• 不執行文件、網絡、子進程、GPU、持久化、session、permission、tool、model-routing 或請求變更。
• 當 official Cordis inspect service 存在時，添加 Host provider ContextProvenance，方法爲 report。
• 缺少 service、projection key、可選字段或不完整 skill discovery 時，按字段降級；absence 不會被靜默轉成 zero。

請求體在 llm/stream 邊界做同步 reduction。system text、messages、tool descriptions、JSON parameter schemas、raw plugin identifiers、raw skill provider/source identifiers，以及 AGENTS paths or contents，不會被返回。

安裝與啓用¶

先確認 DSH 版本和 Node.js 版本。該插件 0.1.1 只支持 DSH 0.1.1-rc.2，Node.js 要求爲 ^22.19.0 || >=24.0.0。
DSH 0.1.0-rc.8 和 0.1.1-rc.1 與該版本顯式不兼容。

安裝到指定 profile：

dsh plugin --profile <profile> add dsh-context-provenance

檢查解析後的配置：

dsh --profile <profile> --dump-config

安裝前建議覈對 registry version、source tag 和 release notes，不要直接把沒有 tag 的 repository checkout 當作 release artifact。

安裝完成後，需要重啓 DSH，然後用現有 inspect tools 查詢 Host provider ContextProvenance，方法 report。如果環境中沒有 official Cordis inspect service，插件仍可掛載 observer，但沒有查詢面。

典型用法¶

以 web profile 爲例：

dsh plugin --profile web add dsh-context-provenance
dsh --profile web --dump-config

上面的命令會把插件 bundle 加到 web profile，並輸出該 profile 的配置。
之後重啓 DSH，再通過現有 inspect tools 查詢 ContextProvenance 的 report 方法。

注意：觀察數據只在內存中保留最近兩條請求觀察；重啓或卸載插件會丟失所有 observations。

適用場景與注意¶

這個插件適合以下場景：

• 想比較相鄰請求之間的證據變化，而不是直接查看請求體。
• 希望明確區分 Observed、Estimated 和 Unavailable。
• 不想讓插件額外做文件、網絡、子進程、GPU、持久化或請求修改。
• 需要查看現有 Cordis inspect 能暴露的公共運行時信息。

需要注意：

• 該插件不是完整的 context provenance graph，也不能解釋所有行爲差異。
• 它只保留最近兩條普通 agent-loop 請求觀察，重啓或卸載後觀察會丟失。
• 缺少 official Cordis inspect service 時，查詢面不可用。
• DSH 插件會以當前 dsh 進程權限運行，安裝前應檢查源碼、依賴、許可證和 release 版本。

鏈接¶

GitHub：

https://github.com/030611/dsh-context-provenance

社區目錄頁（線索中給出，未確認，可自查）：

https://www.skillhub.cn/plugins/030611/dsh-context-provenance