DeepSeek Harness 安全插件 dsh-mcpguard

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在構建智能體時，MCP 服務器配置和技能文件本質上是文本。攻擊者可能在這些文件中埋入 Prompt 注入指令、同形異義字或危險的 Shell 命令。dsh-mcpguard 是 DSH 生態中的首個安全插件，旨在掃描這些文件，攔截可能危害 AI 代理的行爲。

插件定位¶

該插件由 ChenLaoshiYF 維護，採用 MIT 許可證。它作爲標準的 DSH 插件提供兩個工具：一個用於靜態配置掃描，另一個提供實驗性的運行時觀察模式。整個插件完全在本地機器運行，不需要守護進程、雲端服務或外部 API 密鑰。

核心功能¶

靜態掃描
- 掃描技能目錄和 MCP 配置文件。
- 檢測 Prompt 注入（如 “ignore previous instructions”）、同形異義字（homoglyphs）、不可見 Unicode（如零寬字符）、危險 Shell 命令（如 eval、curl | sh）以及憑證泄露。
- 掃描結果以 JSON 格式輸出，包含文件評分、規則 ID、嚴重程度和 offending excerpt。報告中所有敏感信息（API keys、tokens）均已脫敏。
運行時觀察（實驗性）
- v0.2 版本引入了 mcpguard_observe 工具。
- 它附加到 tools/pre-execute 鉤子，監視工具調用（包括 MCP 工具）。
- 設計上永遠不會阻斷工具執行。它僅用於記錄、日誌和報告，決策權完全在用戶手中。任何內部錯誤會自動降級爲允許執行並記錄日誌。

安裝與啓用¶

通過命令行安裝：

dsh plugin --profile web add "github:ChenLaoshiYF/dsh-mcpguard"

或者通過界面操作：在 Settings → Plugins 中安裝後，重啓 dsh --profile web。

典型用法¶

安裝完成後，插件會提供以下工具：

mcpguard_scan: 掃描默認目標（MCP 配置 + 技能目錄）。
mcpguard_scan_path: 掃描你指定的任意路徑。
mcpguard_observe: 運行時觀察摘要。

示例輸出（JSON 格式）：

{
  "total": 3,
  "bySeverity": {
    "critical": 1,
    "high": 2
  },
  "recent": [...]
}

安全與隱私¶

插件內置了多重安全機制以防止誤傷和隱私泄露：

隱私保護: 沒有任何網絡請求，沒有遙測數據上傳。
文件掃描限制: 大於 256 KB 的文件會被跳過；遞歸掃描深度限制在 8 層。
敏感目錄保護: 即使顯式指向，.ssh、.aws、.gnupg 目錄也絕不會被掃描。
結果脫敏: 報告中所有 sk- 開頭的密鑰、ghp_ 開頭的 token、SSH 私鑰塊和 JWT 都會被替換爲 ***。

兼容性與注意¶

該插件已針對 DeepSeek Harness 0.1.0-rc.5 進行測試。由於 DSH 處於開發者預覽階段，API 可能會有變動。如果遇到兼容性問題，建議在 GitHub 上提交 Issue。

總結¶

dsh-mcpguard 專注於解決 AI 智能體開發中的文本安全痛點。它提供了一個輕量級、本地化的掃描和觀察方案，幫助開發者在代碼進入運行時環境前發現潛在的注入風險和配置隱患。

插件目錄: https://www.skillhub.cn/plugins/ChenLaoshiYF/dsh-mcpguard
GitHub 倉庫: https://github.com/ChenLaoshiYF/dsh-mcpguard