前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構。在引入第三方插件時，開發者往往難以在運行前評估其潛在風險，或者無法直觀地判斷插件是否越權。dsh-plugin-guard 插件通過靜態代碼分析、依賴審查和 AI 在線審計，對已安裝的插件進行安全體檢，並以綠/黃/紅三級面板呈現結果。
這是什麼¶
這是一個 DeepSeek Harness Web GUI 的插件安全體檢工具。它在不執行插件代碼的前提下，讀取已安裝第三方插件的源碼與元數據，幫助判斷插件的功能範圍、是否存在越權行爲以及風險等級，最後生成一份分級報告。
核心功能¶
靜態掃描與依賴審查¶
插件會對已安裝的插件源碼進行靜態掃描，識別 17 類風險能力，包括危險 API（如子進程、eval、vm、shell）、密鑰泄露、高熵載荷以及下載即執行等。同時，它會審查依賴項，標出非 npm 來源（如 git:、file:、URL）以及命中可疑關鍵詞（如 miner、stealer、backdoor）的依賴。
安裝腳本與權限評分¶
插件會單獨審查 preinstall、install 和 postinstall 腳本，特別關注其中的下載即執行行爲。它還會根據 dsh.plugin.json 的 entry.inject 和 package.json 的 dsh.client.inject 對插件聲明的宿主服務權限進行評分，並檢測“能力與聲明面不匹配”的情況（例如代碼使用了高危能力，但聲明的權限卻很輕量）。
版本監控與告警¶
插件會保存基線數據，持續監控已安裝插件。如果檢測到新安裝、版本變化或相比上次掃描新增了風險能力/聲明權限，面板會打標提示。
AI 在線審計與分級¶
插件結合代碼、版本和多層互聯網聲譽（npm 元數據、OSV.dev、惡意報告、GitHub 信號）進行 AI 二次判定。AI 審計結束後會重新定級：malicious 爲紅，suspicious 爲黃，safe 爲綠，inconclusive 不低於靜態等級。AI 與靜態不一致時，面板會顯式標註。
聲譽佐證¶
聲譽佐證包括 npm registry 元數據（包齡、棄用標記）、OSV.dev 權威記錄、互聯網惡意/攻擊報告檢索以及 GitHub 倉庫信號。GitHub Token 可提升 API 限額。
技能審計（SafeSkill）¶
插件對接微步在線 SafeSkill 平臺，支持對已安裝的 DSH Skills 進行多引擎掃描（LLM / 靜態 / 動態）。SafeSkill 額度用盡時，可使用默認模型進行本地 AI 審查。
安裝與啓用¶
前提¶
- 機器上已安裝 DSH 並能正常運行
dsh web。 - 機器上裝有
pnpm（dsh plugin內部需要它來安裝插件）。
安裝¶
執行以下命令安裝插件：
dsh plugin --profile <name> add @guojin-ai/dsh-plugin-guard
將 <name> 替換爲你要審計的 profile 名稱。安裝完成後，重啓 dsh。
啓用與查看¶
重啓 dsh 後，在 Web GUI 的 設置 → 插件安全體檢 路徑下，即可看到安全報告。
使用指南¶
查看報告¶
面板頂部顯示彙總統計。每行代表一個已安裝插件，包含風險等級徽章、插件名、版本、風險分、命中規則、聲明權限等。展開某一行可以看到自上次掃描的變更、命中的風險規則、聲明的宿主服務權限以及可疑依賴。
AI 審計¶
點擊插件行內的 “AI 審計” 按鈕，查看判定結論（safe/suspicious/malicious/inconclusive）與建議。審計結果有緩存機制（內容指紋+版本+TTL），新負面信號會強制重審。
SafeSkill 掃描¶
在面板頂部配置 SafeSkill API Key 後，點擊 “掃描全部技能”，插件會將已安裝的 DSH Skills 打包上傳至 SafeSkill 平臺，並拉取多引擎掃描報告。
注意事項¶
- 包名匹配：DSH 裝載行的
name必須與package.json的@guojin-ai/dsh-plugin-guard完全一致，否則客戶端 bundle 會被靜默丟棄。 - 數據存儲：GitHub Token 和 SafeSkill Key 只保存在本機，不上傳。
- 平臺獨立性：SafeSkill 是獨立外部平臺，掃描結果由微步在線提供。
結語¶
dsh-plugin-guard 通過靜態分析、依賴審查和 AI 審計，爲 DSH 插件使用提供了可視化的安全評估手段。它適合在引入第三方插件前或定期巡檢時使用，幫助開發者識別潛在的供應鏈風險。
