前言¶
在 DeepSeek Harness (DSH) 的插件生態中，一切皆插件。當開發者引入第三方插件時，需要確認其安全性，例如是否泄露 Token、是否有惡意網絡連接或混淆代碼。dsh-security-guard 插件提供了一套靜態掃描方案，幫助在 DSH 環境中檢測已安裝插件的安全狀況。
插件概覽¶
這是一個由 weisofns 維護的 DSH 插件。它提供 28 條規則靜態掃描器、風險評分、白名單/黑名單策略、本地 Web 儀表盤以及 DSH 內的風險彈窗功能。
核心功能¶
- 靜態掃描器：內置 28 條規則，覆蓋偷 Token、數據外發、動態執行、混淆、網絡、供應鏈、持久化、提權等場景。
- 啓動自檢：安裝後自動掃描 profile 下已安裝的 dsh 插件包。
- DSH 工具註冊：爲模型註冊
security_scan_plugins、security_scan_plugin和security_guard_report工具。 - 告警機制：支持控制台輸出、事件總線，可選 Webhook，支持等級過濾和限流。
- 本地 Web 儀表盤：提供可視化面板，支持 JSON API。
- 遠程規則更新：支持
remoteSources遠程規則 JSON，可選定時自動更新。
檢測規則¶
插件內置 28 條檢測規則，主要類別包括：
- Token 相關 (TOK)：硬編碼 Token、Token 外發、讀取 DSH 憑據、環境變量憑據。
- 數據外發 (EXF)：可疑外發域名、DNS-ICMP 隧道、剪貼板讀取外發。
- 動態執行 (EXE)：動態代碼執行、子進程執行、遠程代碼加載。
- 代碼混淆 (OBF)：高熵字符串、解碼後執行、JSFuck 極簡混淆。
- 網絡監聽 (NET)：未授權監聽、WebSocket 外發、代理配置篡改。
- 文件系統 (FS)：越界文件寫入、刪除系統文件、全盤文件搜索。
- 進程操作 (PRO)：進程注入、權限提升。
- 供應鏈安全 (SUP)：可疑 install 腳本、依賴混淆、Git 倉庫投毒。
- 持久化 (PER)：啓動項植入、Shell 配置篡改。
- 敏感服務 (PRIV)：請求敏感 DSH 服務、攔截核心服務。
安裝¶
使用官方插件加載方式安裝。請先完全退出 DSH Host，然後執行：
dsh plugin --profile web add ./dsh-security-guard-2.1.0.tgz
重啓 DSH 後，插件自動開始工作。
配置說明¶
插件通過 cordis.patch.yml 配置。關鍵配置項包括：
- enabled：是否啓用插件。
- scanOnStart：啓動時是否掃描。
- autoUpdateRules：是否自動更新規則。
- enableWebPanel / webPanelPath：是否啓用 Web 儀表盤及其路徑。
- remoteSources：遠程規則 JSON URL 列表。
- whitelist / blacklist：白名單和黑名單策略。
- minLevel：告警最小等級。
- webhookUrl：Webhook 地址。
使用方法¶
- 對話掃描：在 DSH 對話中輸入“掃描一下我的插件安全”或“檢查哪些插件有風險”。
- 模型調用：模型會自動調用註冊的工具返回風險報告。
- Web 儀表盤：瀏覽器訪問
http://127.0.0.1:<DSH端口>/security-guard打開可視化面板。
兼容性¶
- Node.js 版本 >= 20。
- 零第三方運行時依賴。
- 依賴 DeepSeek Harness 官方插件加載方式 (
dsh.bundle.patch+cordis.patch.yml)。 @deepseek-ai/dsh-tools爲可選依賴。
注意事項¶
該插件以當前 DSH 進程權限運行。安裝前建議檢查源碼與許可證。
