前言¶

當自主智能體編寫代碼或運行腳本時，存在 API 密鑰/憑證意外泄漏到 Git diff 或無意中執行破壞性終端命令（如 rm -rf）的風險。dsh-shadow-auditor 在 DSH Agent 運行時環境中作爲一個後臺安全防火牆，掃描代碼差異中的私鑰並驗證終端命令的安全性。

插件簡介¶

這是 DeepSeek Harness (DSH) 的一個插件，專注於後臺安全審計、密鑰泄漏檢測和命令安全。該插件以進程內安全攔截器的形式運行，通過 AST 分析和熵/正則掃描來保護環境。

核心能力¶

實時 API 密鑰與憑證掃描¶

插件對代碼差異進行實時掃描，利用熵分析和正則表達式來識別 API 密鑰、私鑰、OAuth bearer 令牌和數據庫憑據。它在令牌傳輸到 LLM 或存儲到版本控制系統之前進行攔截，並在日誌中自動脫敏。

破壞性命令防火牆¶

利用 AST 分析，插件在終端執行前檢查 shell 命令。它針對危險操作設置了邊界，包括無界的 rm -rf、磁盤擦除、遞歸權限覆蓋以及指向工作區根目錄或外部路徑的遞歸刪除。它需要顯式的用戶覆蓋來執行危險腳本。

安全規則引擎與儀表板¶

插件提供了一個可配置的安全規則引擎，用於管理攔截策略。它提供實時儀表板和 UI 中的安全審計徽章，以便在 DSH Web 界面中可視化和審查安全事件。

安裝與啓用¶

1. 在 DSH 配置文件中執行以下命令以安裝插件：

    dsh plugin --profile web add @goodandready/dsh-shadow-auditor

2. 在 DSH 的配置文件（如 settings.yaml）中啓用功能。以下示例開啓嚴格的密鑰掃描和破壞性命令防火牆：

    dsh-shadow-auditor:
      strictSecretScanning: true
      blockDangerousCommands: true
      enableAuditBadge: true

Agent 工具用法¶

插件提供了三個 Agent 工具供直接調用：

• shadow_auditor_scan_diff(diff)
  • 參數：diff (string) - 掃描統一差異或代碼塊，以查找暴露的 API 密鑰、憑據和私鑰。
• shadow_auditor_check_command(command)
  • 參數：command (string) - 評估 shell 命令，檢查是否包含破壞性執行模式和安全策略。
• shadow_auditor_rules_list
  • 參數：無
  • 描述：返回當前激活的安全規則、模式和執行模式。

適用場景與注意¶

該插件適合需要在運行時保護敏感操作的管理員和開發者。它以當前進程權限運行，因此需要顯式用戶覆蓋來執行危險腳本。

依賴項：需要 @deepseek-ai/cordis、@deepseek-ai/dsh-host-webserver 等依賴項。
本地化：支持英語、中文和俄語。
攔截範圍：主動攔截 .env 文件和設置文件。

結語¶

dsh-shadow-auditor 爲 DSH Agent 提供了一套後臺安全機制。開發者可以查看其 GitHub 倉庫 瞭解更多，或訪問 SkillHub 目錄 進行安裝。