前言¶

当自主智能体编写代码或运行脚本时，存在 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 目录 进行安装。