dsh-safeguard

面向 DeepSeek Harness（DSH）的危险命令 + 密钥泄漏拦截插件。挂载到 tools/pre-execute waterfall，在工具解析前短路拒绝，被拦截的副作用不会发生。

简介

• 危险命令拦截：对 bash 工具的命令做正则匹配，命中即 deny。
• 密钥泄漏拦截：对所有工具的 arguments 做 JSON.stringify 后扫描常见密钥模式，命中即 deny。
• 可配置：危险/密钥检测开关、额外正则、精确豁免名单。
• 两个辅助工具：guard_list（列出当前规则）与 guard_check（纯检查不拦截，供调试/自检）。

重要：本插件是基于正则的启发式拦截，不验签、不识别密钥真伪、不做沙箱隔离。它无法替代密钥扫描器、签名校验或操作系统级沙箱，只能拦截明显的高风险动作。

安装

dsh plugin --profile <profile> add dsh-safeguard

本地开发安装：

dsh plugin --profile <profile> add file:./plugins/dsh-safeguard

默认规则表

危险命令（enableDanger）

密钥泄漏（enableSecrets）

eyJ 开头的长 JWT 不拦截（模式太宽，误报率高）。

配置项

在 profile 的 cordis.patch.yml（或 bundle 配置）中覆盖：

- insert:
    - id: guard
      name: dsh-safeguard
      config:
        enableDanger: true      # 危险命令拦截开关（默认 true）
        enableSecrets: true     # 密钥泄漏拦截开关（默认 true）
        extraPatterns:          # 额外正则字符串（额外危险命令规则）
          - 'curl.*\|.*bash'
        allowList:              # 精确豁免名单（字符串完全一致才豁免）
          - 'rm -rf /tmp/safe-dir'

两个工具的用法

guard_list

无参，列出当前启用的规则类别与条目数：

[dsh-safeguard] 规则清单
危险命令: 启用（12 条规则）
密钥检测: 启用（6 条规则）
额外正则: 0 条
豁免名单: 0 条

guard_check

参数 text（必填 string）。纯检查不拦截，返回命中规则名 / 类别 / 是否豁免：

• guard_check("rm -rf /") → 命中，类别 danger，规则 rm -rf
• guard_check("aws key: AKIAIOSFODNN7EXAMPLE") → 命中，类别 secrets，规则 AWS Access Key (AKIA)
• guard_check("echo hello") → 通过

模型可通过 await tools.guard_check({ text: "..." }) 做程序化自检。

不验签、不做沙箱替代

• 本插件只做正则模式匹配，不校验密钥真实性，也不校验命令签名。
• 它不是沙箱：不会隔离文件系统、网络或子进程，拦截的是「命中明显高风险模式」的调用。
• 生产环境仍应配合密钥扫描器（如 gitleaks、trufflehog）、签名校验与操作系统级沙箱（如 dsh-bash-sandbox）使用。

License

MIT