前言¶
在 DeepSeek Harness（DSH）的開發與調試過程中，依賴管理往往比較隱晦。開發者在排查問題時，常需要確認當前 Harness、插件及其依賴的精確版本，以及依賴聲明範圍與實際解析版本是否一致。此插件通過在設置面板提供可視化的版本信息，解決了這一痛點。
這是什麼¶
dsh-version-inspector 是一個由 NEVSTOP-LAB 維護的插件，旨在 DSH 設置面板中新增「版本信息」頁面，以緊湊的多列樹狀結構展示 Harness、插件及其依賴的版本詳情。插件遵循 MIT 許可證。
核心功能¶
該插件在設置面板中新增一個獨立頁面，主要提供以下能力：
-
樹狀結構展示
將依賴項分爲三組：- DeepSeek Harness（dsh）：展示 Harness 版本及頂層依賴。
- 插件：展示其他已掛載插件及其版本（不含本插件）。
- 當前插件：展示本插件自身的版本、
dependencies及peerDependencies子樹。
節點支持展開與摺疊。
-
詳細信息
每個依賴項展示以下字段：- 名稱（包名）
- 已解析版本（安裝的真實版本）
- 聲明範圍（如
^x.y.z） - 所屬 section（依賴 / 對等依賴 / 可選依賴）
- 解析路徑
-
異常感知
對於宿主解析不到的依賴（例如客戶端專用的react或未安裝的可選依賴），以警示色標註，並顯示其聲明範圍。 -
佈局與交互
- 緊湊多列布局：使用自適應網格佈局（
auto-fill），長列表橫向鋪開，減少滾動。 - 搜索過濾：支持按包名或版本過濾，結果按分組顯示並計數。
- 主題適配：自動適配 day / dark 模式，使用 DSH 主題變量。
- 緊湊多列布局：使用自適應網格佈局（
安裝與啓用¶
安裝前請確保已安裝並運行 dsh CLI（版本 0.1.0-rc.6 及以上）。
從 GitHub 倉庫安裝：
dsh plugin --profile web add github:NEVSTOP-LAB/dsh-version-inspector
建議鎖定提交以避免後續更新改變內容：
dsh plugin --profile web add github:NEVSTOP-LAB/dsh-version-inspector#<commit-sha>
也可以從 Releases 下載 tarball 安裝：
dsh plugin --profile web add ./dsh-version-inspector-0.1.2.tgz
安裝後，打開 DSH 設置面板，「版本信息」頁面會出現在導航列表的最後一個位置（order 1000）。可以通過以下命令確認插件已生效：
dsh --profile web --dump-config
注意事項¶
- 權限說明：插件通過 Host 側的只讀接口收集數據，並通過同源路由
GET /version-info提供給客戶端，不會執行敏感操作。 - 依賴要求：需要 dsh CLI 0.1.0-rc.6 及以上版本支持。
結語¶
該插件爲 DSH 插件開發與調試提供了一個直觀的版本查檢工具，通過樹狀結構與多列布局，能夠快速定位依賴問題。更多詳情與源碼可參考其 GitHub 倉庫。
