前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的理念，這降低了系統的擴展門檻，但也引入了供應鏈安全風險。在安裝第三方插件時，開發者往往難以在運行前驗證代碼的安全性或完整性。
dsh-plugin-guard 是一個靜態分析插件，它不執行目標插件，而是通過靜態審計和哈希鎖定來攔截潛在風險。它在安裝前進行靜態審計，在安裝後進行哈希與能力鎖定，並提供對等搜索和機械排毒功能。
插件定位¶
- 名稱：
taxueseek/dsh-plugin-guard - 維護者：taxueseek
- 類型：靜態安全審計
- 核心原則：靜態分析，絕不執行目標插件。
- 架構：包含“門”和“診所”兩個層面。
Gate負責安裝前後的靜態審計與鎖定；Clinic負責對等搜索和機械排毒。
核心功能¶
-
plugin_audit（門）：安裝前靜態審計
在插件被安裝或加載前，對代碼進行靜態分析，識別潛在的安全隱患。 -
plugin_verify（門）：哈希與能力鎖定
插件安裝後，通過哈希校驗鎖定插件完整性，並結合能力鎖防止惡意功能被觸發。 -
plugin_peers（診所）：對等搜索
- 本地指紋：對本地已安裝的插件進行指紋識別。
- 查詢：搜索 GitHub 上的
topic:dsh-plugin標籤以及 curated（精選）列表。如果這些結果較輕量，則使用 argo 進行查詢。 - 遠程：直接查詢 GitHub，裁決結果爲
unknown，需在安裝前再次審計。
-
plugin_detox（診所）：機械切除
對已安裝的插件進行機械性切除，不保留其原始行爲。
安裝與啓用¶
安裝此插件需要使用官方提供的命令，並重啓 DSH Web 服務。
dsh plugin --profile web add github:taxueseek/dsh-plugin-guard
# 重啓 dsh web
典型用法¶
評分機制¶
插件會對掃描結果進行評分，初始分數爲 100。
- P0：僅自動運行且包含危險組合（如
curl|bash、密鑰離開機器、eval 網絡內容、安裝腳本中毒）。P0 扣 40 分。 - P1：工具內部出現
exec（模型必須點擊觸發）。P1 扣 12 分。 - P2：其他情況。P2 扣 3 分。
裁決邏輯：
* Block：任何 P0 或評分低於 40。
* Warn：任何 P1 或評分低於 75。
plugin_peers 的三種模式¶
plugin_peers 命令根據參數不同，行爲有所區別：
- path：僅掃描本地路徑（profile bundles）。
- query：命中 GitHub
topic:dsh-plugin+ 精選列表。如果這些列表較輕量，會使用 argo 進行查詢。 - remote：直接查詢 GitHub，裁決結果爲
unknown。這意味着在安裝前必須先進行審計。
適用場景與注意¶
此插件適用於所有需要嚴格管控 DSH 插件生命週期的場景，特別是對供應鏈安全敏感的環境。
注意事項：
1. 不輸出脫敏：插件不會對敏感信息進行脫敏處理。
2. 非通用 SAST：它不是通用的靜態應用安全測試工具。
3. 不能證明安全：通過審計並不代表插件絕對安全。
4. 排毒不保留行爲：plugin_detox 功能是機械切除，不會保留原插件的行爲邏輯。
5. 權限風險：作爲插件，它以當前 DSH 進程的權限運行。在安裝任何插件前，務必人工檢查源碼與許可證。
結語¶
dsh-plugin-guard 提供了一套靜態的安全防線，通過哈希鎖定和評分機制，幫助開發者識別並阻斷高風險插件。更多細節和源碼，可訪問其 GitHub 倉庫或 DSH 生態目錄。
