前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。隨着插件生態的擴展，開發者需要安裝第三方工具以擴展 Agent 能力。這帶來了兩個具體問題：一是插件的 npm 依賴是否存在已知漏洞，二是插件源碼本身是否存在惡意行爲。dsh-plugin-security 爲 DSH 插件提供了一套安全門控機制。

插件簡介¶

這是一款 DeepSeek Harness 插件的安全門控工具，由用戶 dushaobindoudou 維護。它解決的核心問題是：如何在 Agent 調用插件工具時，攔截高風險操作，並提供依賴審計和源碼審查能力。

核心功能¶

該插件包含以下核心能力：
* 依賴與源碼掃描：掃描已安裝插件的源碼和 npm 依賴安全公告。
* 風險分級：將插件標記爲 High Risk（高風險）、At Risk（有風險）、No Risk Found（無風險）或 Whitelisted（白名單）。
* 調用門控：在模型執行高風險插件的工具前，彈出 Allow once（僅允許本次）/ Allow（允許）/ Disable（禁用）的選項。
* 智能體審查：提供 Agent 技能，允許對可疑插件進行審查。
* 狀態同步：與 DSH 的插件管理器狀態保持同步。
* 設置管理：提供設置頁面，支持過濾、報告導出和管理操作。
* Agent 工具：內置 security_scan 和 security_review 兩個工具。
* 配置模式：支持 off（關閉）、report-only（僅報告）、enforce（強制執行）三種模式。
* 白名單機制：支持白名單，內置受保護條目。
* 靜態證據驗證：對非惡意代碼進行靜態證據驗證。

安裝與啓用¶

安裝前需確保環境滿足要求：
* DSH 版本：0.2.x
* Node.js 版本：20+（推薦 24）

使用官方命令安裝：

dsh plugin --profile web add dsh-plugin-security@latest

安裝後，Web 配置文件會自動熱重載並立即掃描所有插件。對於其他配置文件，請替換 web 爲相應的配置文件名稱。插件升級後需要重啓 DSH。

使用方法¶

插件安裝後，可通過以下方式使用：
* 設置頁面：進入 DSH 的設置 → Security Gate。在此頁面可以過濾插件風險等級、查看安全公告和靜態證據、導出 JSON 或 Markdown 報告，或對插件執行啓用/禁用/重置/卸載操作。
* 調用時攔截：當模型嘗試調用高風險插件的工具時，會在輸入框旁顯示一個提問卡片，詢問是否允許。
* 智能體審查：在對話中直接要求，例如：”Use the dsh-plugin-security skill to review my plugins”。Agent 會調用 security_scan 收集證據，執行技能中的五個問題，並使用 security_review 存儲審查結果。

配置說明¶

在設置頁面（$DSH_HOME/plugin-security/state.json）中可配置以下項：
* Mode（模式）：默認爲 report-only。
* off：不進行掃描、門控或強制執行。
* report-only：掃描、記錄並門控調用，但不自動禁用插件。
* enforce：在確認惡意審查時自動禁用插件。
* Auto-disable threshold（自動禁用閾值）：默認爲 critical。設置爲 never 可關閉自動禁用。
* Upgrade suggestions：默認關閉，用於建議依賴升級命令。

Agent 工具¶

插件爲 Agent 提供了兩個工具：
* security_scan：掃描指定包（package?）、強制掃描（force?）或獲取證據（evidence?）。
* security_review：審查指定包，返回裁決（malicious/suspicious/benign）及置信度。

注意事項¶

• 受保護條目：官方 @deepseek-ai/* 包、dsh-plugin-sentinel 以及插件自身內置的受保護條目，不會被檢查，也不會被該插件禁用或卸載。
• 行爲定義：使用 fetch、process.env、文件系統或子進程本身並不代表惡意行爲，靜態匹配是證據，裁決取決於依賴事實和 Agent 的上下文審查。
• 狀態存儲：狀態存儲在 $DSH_HOME/plugin-security/ 目錄，文件權限爲 0700/0600。
• 日誌限制：操作日誌最多保留 200 條。
• 權限風險：插件在 DSH 進程權限下運行，安裝前請檢查源碼和許可證。

結語¶

dsh-plugin-security 爲 DSH 插件生態提供了一個可落地的安全解決方案。它結合了靜態分析、依賴審計和運行時門控，幫助開發者在不犧牲靈活性的前提下控制安全風險。

插件詳情：
* 目錄頁：https://www.skillhub.cn/plugins/dushaobindoudou/dsh-plugin-security
* GitHub：https://github.com/dushaobindoudou/dsh-plugin-security