在 DeepSeek Harness (DSH) 的使用過程中，確認運行中的 Harness 版本以及已掛載插件的包版本，是排查環境不一致或依賴衝突的基礎步驟。現有的插件列表僅顯示模塊名稱、啓用狀態和 Fiber 狀態，並不包含版本信息。dsh-version-inventory 插件在 Web UI 中補充了這一空白，提供可視化的版本展示與導出功能。
插件簡介¶
該插件由 kristol07 維護，遵循 MIT 許可證。它的核心作用是在 DSH Web UI 中讀取並展示運行中的 Harness 版本，以及每個已掛載插件的包版本。
核心能力¶
1. 雙平面版本讀取
插件同時讀取 Harness 的兩個掛載平面：
* 全局平面：基於配置文件（如 cordis.patch.yml）的 Loader 樹。
* 預設平面：基於每個 Agent 預設的 composition（agent.<preset>.yml）。
對於在兩個平面都掛載的插件，會分別列出，並顯示其所屬平面。
2. 配置摘要與脫敏
每個掛載點會顯示配置摘要。系統會自動摺疊嵌套值，並屏蔽敏感字段（如 key、token、secret、password 等）的值。對於預設配置，由於不包含運行時掛載的配置，會顯示“config not visible”。
3. 版本合併與標識
插件通過解析模塊規範符，讀取 package.json 中的 name 和 version。它會按包目錄進行合併，而不是按包名，以便能夠檢測同一包的不同版本實例。推斷出的版本會標記爲 (inferred)。
4. 導出與複製
- 單行復制：點擊某一行，可複製
name@version格式的字符串，便於在終端或搜索框中使用。 - 報告複製：點擊表頭，可複製一份完整的、安全的環境報告。該報告包含 Harness 版本、Node 版本、平臺信息、第三方插件列表等，但不包含文件路徑、
DSH_HOME和用戶配置。
5. 會話工具集成
插件註冊爲 dsh_version_inventory 工具，Agent 可以在會話中直接調用該工具讀取環境信息。
使用方法¶
-
在 Web UI 中查看
在 DSH Web UI 中導航至Settings->Plugins->Versions。該標籤頁位於系統自帶的插件列表旁。 -
通過會話工具讀取
在 Agent 會話中，可以直接調用dsh_version_inventory工具獲取環境信息。 -
複製版本信息
- 點擊具體插件行的任意位置，可複製
插件名@版本號。 - 點擊表頭，可複製完整的環境報告。
- 點擊具體插件行的任意位置，可複製
注意事項¶
- 版本來源：Cordis 內置功能沒有版本信息，插件會將其顯示爲 Cordis builtins。
- 報告安全：導出的環境報告僅包含可共享的元數據，不包含本地文件路徑和敏感配置。
- 推斷標記：如果無法從
package.json獲取 Harness 版本，系統會根據已加載的@deepseek-ai/*包推斷，並標記爲(inferred)。 - 許可證：使用需遵守 MIT 許可證。
參考資源¶
- GitHub: https://github.com/kristol07/dsh-version-inventory
- 插件目錄: https://www.skillhub.cn/plugins/kristol07/dsh-version-inventory
