DSH 的核心理念是「一切皆插件」。在引入社區插件時，版本不匹配（如 Node 版本、peer 依賴）或清單缺失可能導致服務崩潰或無法啓動。dsh-install-guard 插件用於在安裝前攔截此類風險。
這是什麼¶
這是 DeepSeek Harness 的一個安裝前兼容性預檢守衛。它由用戶 618527 維護，通過靜態檢查和運行時驗證，確保待安裝的插件能與當前 DSH 環境兼容。
核心功能¶
該插件提供以下檢查與驗證能力：
- engines.node 檢查：比對插件在
package.json中聲明的engines.node要求與當前 Node 環境版本。 - @deepseek-ai/* peers 檢查：比對 peer/dependency 範圍與已解析的版本，防止核心包版本衝突。
- dsh manifest 檢查：檢查插件清單中是否聲明瞭
dsh.bundle.patch或dsh.client等必要字段。 - 隔離試啓動：通過
trial=true參數，將插件安裝到臨時配置中並執行apply，捕獲運行時或加載時的崩潰。
安裝與啓用¶
使用以下命令將插件添加到 web 配置文件中：
dsh plugin --profile web add dsh-install-guard
安裝完成後，重啓 dsh web 使插件生效。
典型用法¶
該插件註冊了一個名爲 plugin_install_guard 的工具，可通過對話指令調用。通常分爲兩步：
- 檢查兼容性：
plugin_install_guard { spec: "plugin-name", action: "check" }
如需運行隔離試啓動，在參數中添加 `trial: true`。
- 確認後執行安裝：
plugin_install_guard { spec: "plugin-name", action: "install", resolution: { spec: "plugin-name@compatible" } }
適用場景與注意¶
- 適用場景：需要嚴格控制環境兼容性的 DSH 插件開發者和管理員。
- 觸發方式：該工具爲主動觸發，非市場安裝按鈕的自動鉤子。
- 風險提示：靜態檢查與隔離試啓動雖能減少但無法消除所有第三方代碼風險。安裝前應檢查源碼與許可證。
- 生態配合：可與
dsh-doctor（環境健康）和dsh-poison-guard（安全/審計）配合使用，構建完整的安裝前檢查鏈路。
總結¶
dsh-install-guard 提供了從依賴版本到運行時行爲的全方位預檢能力，是降低 DSH 插件引入風險、提升系統穩定性的實用工具。
