dsh-risk-guard: Zero-interruption Audit and Fuse Blocking for DeepSeek Harness

DeepSeek Harness (DSH) 提供了开发智能体的框架，但在实际使用中，Agent 执行破坏性操作（如强制推送、删除关键文件）的风险难以量化且难以回溯。传统的安全方案往往需要人工介入或权限变更，打断工作流。dsh-risk-guard 是一个针对 DSH 的插件，旨在提供零打扰的审计能力与不可逆操作的熔断保护。

它由 shuxue6662-a11y 维护，采用 MIT 许可证。核心价值在于将安全监控与业务执行解耦：先静默记录所有工具调用，再通过确定性评分模型识别高风险行为，最后在执行前阻断不可逆的操作。

核心能力¶

静默审计¶

插件不会弹窗询问权限，也不会修改沙箱环境。它会将每次工具调用（工具名称、脱敏后的参数、执行结果、风险标签、可解释分数）记录到本地的 JSONL 文件中。这为事后复盘提供了完整的数据基础。

确定性风险评分¶

评分过程不调用 LLM，不产生额外费用。它覆盖了破坏性删除、读取凭证、网络外联、写入工作区外部、依赖安装和重型构建等场景。对于重复的高风险调用或连续的高风险操作，会累积额外分数。

保险熔断¶

针对不可逆的灾难性操作，插件会直接阻断执行。受保护的操作包括：
* 删除受保护路径（如根目录、凭证文件）；
* 磁盘擦除/格式化命令；
* 强制推送到受保护的分支（默认为 main/master）；
* 引用凭证文件的网络命令。

运作账单¶

通过 /risk-guard 命令，你可以查看当前会话的操作历史、分数分布、标签统计以及具体的熔断记录。这解决了“Agent 到底做了什么”的溯源问题。

安装与启用¶

本插件需要先安装 DeepSeek Harness。

1. 使用插件管理器（推荐）¶

在终端中执行：

dsh plugin --profile web add dsh-risk-guard

安装完成后，重启 Web UI，即可在任意会话中使用 /risk-guard 命令。

2. 通过 npm 安装¶

如果使用 npm，执行：

npm install dsh-risk-guard

然后在配置文件的 cordis.patch.yml 中注册插件：

- insert:
    - id: risk-guard
      name: 'dsh-risk-guard'

典型用法¶

插件提供了以下命令来查看审计记录：

/risk-guard              # 查看当前会话的操作账单
/risk-guard --turn       # 仅查看上一轮的操作
/risk-guard --all        # 查看所有会话的汇总及详细账单
/risk-guard --since=2026-08-01
                        # 查看指定日期后的记录（可与其他参数混用）
/risk-guard --           # 输出机器可读的 JSON 格式

适用场景与注意¶

适用环境：DSH 0.1.0-rc.6，Web 模式或 Headless 模式。
数据存储：所有审计数据存储在 <DSH_HOME>/risk-guard/ 目录下。敏感信息（如 GitHub Token、密钥）在存储前会被脱敏。
隐私与网络：插件不发送任何遥测数据，也不发起网络请求。
运行权限：插件以当前 DSH 进程的权限运行。如果需要更细粒度的权限控制，需在系统层面配置。

总结¶

dsh-risk-guard 是一套偏向系统底层的防护方案，它通过确定性规则替代了模糊的 LLM 判断，保证了审计的客观性。对于需要高安全性的 Agent 开发与调试流程，这是一个值得引入的工具。

插件目录：dsh-risk-guard
GitHub 仓库：shuxue6662-a11y/dsh-risk-guard