前言¶
在 DeepSeek Harness (DSH) 生態中，通過插件擴展能力是主要手段。但直接安裝插件時，環境配置衝突或運行時錯誤常導致系統無法啓動，排查過程往往對初學者不友好。dsh-plugin-safe-install 是一個插件，它將一套標準化的“安全安裝技能”封裝爲內置流程，覆蓋審計、逐個安裝、五級驗證、依賴處理和乾淨卸載等環節，解決上述痛點。
插件簡介¶
該插件由用戶 rouyiemei 維護，採用 MIT 許可證。它的核心價值在於將安裝過程“工程化”，避免因一次性安裝多個插件或配置錯誤導致的系統崩潰。
核心功能¶
安裝該插件後，DSH Agent 會獲得 dsh-plugin-safe-install 技能。執行時，Agent 會按以下流程操作：
- 安全審計：在安裝前檢查插件來源與內容，規避風險。
- 逐個安裝與五級驗證：裝一個、驗證一個，防止錯誤累積。
- 原生依賴處理：解決 node-pty、sharp 等常見的構建問題。
- 乾淨卸載/回滾：提供清理與回退機制，確保環境整潔。
- 收尾檢查：安裝完成後進行綜合驗證。
安裝與啓用¶
在終端執行以下命令添加插件。插件通過 dsh.bundle.patch 聲明自動掛載，無需手動編輯配置文件。
dsh plugin --profile web add github:rouyiemei/dsh-plugin-safe-install
安裝完成後，必須重啓 dsh web 進程，技能纔會生效。
使用方法與注意事項¶
安裝成功後，Agent 會在識別到相關指令時自動執行流程。典型的觸發方式爲自然語言對話，例如“幫我安裝 XX 插件”。
在驗證安裝結果時，必須使用 dsh-doctor boot 命令。該命令執行完畢後會自動退出，用於判斷系統啓動是否正常。
注意：
* 不要使用 dsh web --port 0 做測試，該命令會啓動常駐服務，不會自動退出，容易導致超時誤判。
* 如需卸載該插件，執行：
dsh plugin --profile web remove dsh-plugin-safe-install
技術特性¶
該插件在實現上保持了極簡與安全：
* 零運行時依賴：不依賴外部庫。
* 無生命週期腳本：安裝時不執行任意代碼，無網絡訪問權限，僅讀取本地文件。
* 可讀性：技能全文存儲在 skills/dsh-plugin-safe-install/SKILL.md，內容 100% 可讀。
結語¶
dsh-plugin-safe-install 專注於提供穩定、可預期的插件安裝體驗。對於希望在 DSH 環境中保持系統穩定性的開發者，這是一個值得納入工具箱的插件。更多細節可參考 GitHub 倉庫。
