前言¶
DeepSeek Harness 採用“一切皆插件”的架構，插件生態在短時間內迅速擴張。隨之而來的是插件間的衝突、隱形故障，以及 Creator 模式下插件重啓即丟失的問題。dsh-plugin-guardian 旨在解決這些運維痛點，爲插件安裝前提供診斷、跨插件衝突掃描，以及將臨時插件轉換爲持久資產的能力。
核心功能¶
該插件提供四個核心工具，覆蓋插件從診斷到落地的完整生命週期：
-
plugin_doctor
對單個插件目錄進行健康檢查。它通過讀取文件內容，提供帶有置信度等級（confirmed/inferred/unknown）的診斷報告，用於評估插件配置是否完整、依賴是否合規。 -
plugin_profile_scan
掃描已安裝的插件集，檢測跨插件的工具名稱衝突、重複項或版本偏差。這有助於在插件投入使用前發現潛在的系統崩潰風險。 -
plugin_promote
將處於 Creator 模式或臨時狀態的插件提升爲持久化、可版本控制的資產。該過程會將插件複製到受管理的暫存目錄，並生成源地址和哈希標記。 -
plugin_install
引導式安裝流程。默認處於“審計優先”模式，在執行安裝前會先進行安全檢查，確認無誤後（通過approve=true）再執行實際安裝命令。
安裝與啓用¶
在 DeepSeek Harness 的 Web Profile 下安裝該插件：
dsh plugin --profile web add github:Nico0713520/dsh-plugin-guardian
安裝完成後，重啓 Harness 服務即可在會話中調用上述工具。
典型用法¶
以下爲各工具的基本調用示例：
# 診斷指定插件目錄
plugin_doctor target="/path/to/my-plugin"
# 掃描當前 Profile 下所有已裝插件的衝突
plugin_profile_scan
# 將臨時插件提升爲持久資產
plugin_promote source="/path/to/my-plugin"
# 審計式安裝（不實際執行）
plugin_install spec="npm:some-plugin"
# 審計通過後執行安裝
plugin_install spec="npm:some-plugin" approve=true
適用場景與注意事項¶
- 適用對象：需要進行插件治理、解決衝突或確保 Creator 模式插件持久化的 Harness 管理員。
- 安全性：
plugin_doctor和plugin_profile_scan是隻讀操作，不會觸發網絡請求、執行源碼或修改文件。plugin_promote僅寫入受控的暫存目錄（$DSH_HOME/.guardian-plugins），默認情況下不會直接修改您的 Live Profile，除非顯式指定參數。
- 運行環境：需要 Node.js >= 20 且 DeepSeek Harness 版本爲 0.1.0-rc.x。
總結¶
dsh-plugin-guardian 爲 DeepSeek Harness 的插件生態提供了一個基礎的治理層。通過分級置信度的診斷和嚴格的讀寫邊界控制，它幫助開發者在插件生態快速膨脹的背景下，保持系統的穩定性與可控性。
- 插件目錄：https://www.skillhub.cn/plugins/Nico0713520/dsh-plugin-guardian
- 源碼倉庫：https://github.com/Nico0713520/dsh-plugin-guardian
