dsh-auto-review：为 DeepSeek Harness 添加 Guardian 自动审批

前言¶

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在构建智能体应用时，对 Shell、网络、MCP、沙箱升级等操作的审批是安全控制的关键环节。dsh-auto-review 插件通过引入 Guardian 模型审查机制，为 DSH 增加了自动化的权限预设，解决了部分场景下需要人工频繁介入的问题。

插件定位¶

这是一个插件层实现，不修改 DSH 内核。它为 DSH 增加了一个名为 auto-review 的权限预设，允许 Guardian 模型对特定的安全风险进行自动化判断。

维护者：Xinlong-Wu
许可证：MIT
分类：admin-security

核心功能¶

该插件主要实现以下能力：

自动审批预设：在 DSH 的权限配置中新增 auto-review 预设。
工作区只读放行：在可证明的工作区中，对只读操作直接放行，无需 Guardian 审查。
Guardian 模型审查：Guardian 模型会审查 Shell、网络、MCP、沙箱升级以及其他扩展的审批请求。
审计日志：任何批准操作都会生成审计记录，并调用 fsync 确保数据落盘。
UI 优化：Guardian 卡片显示限制在 240 字符，并自动脱敏凭证和 URL。
人工覆盖：支持通过 DSH 原生面板进行手动覆盖审批。

安装与启用¶

安装前请确保本地环境已安装 Node.js（要求 ^22.19.0 || >=24）。

执行以下命令完成安装与配置：

cd dsh-auto-review
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
dsh --profile web --dump-config

卸载：

dsh plugin --profile web remove dsh-auto-review-plugin

依赖构建脚本处理（仅当使用 pnpm 11 且遇到 ERR_PNPM_IGNORED_BUILDS 错误时需要）：

pnpm approve-builds @deepseek-ai/dsh-subprocess-local koffi
pnpm rebuild @deepseek-ai/dsh-subprocess-local koffi

配置与使用¶

插件安装后，需在 Web 界面进行配置。

界面配置：进入 设置 → 插件 → Auto Review。展开设置卡片，配置审查模型、审查范围、证据预算、人工审批及审计选项。
环境变量：也可以通过环境变量进行配置。例如：

    export DSH_AUTO_REVIEW_PROVIDER=deepseek
    export DSH_AUTO_REVIEW_MODEL=deepseek-chat
    export DSH_AUTO_REVIEW_MANUAL_OVERRIDE=denied-and-unavailable
    export DSH_AUTO_REVIEW_AUDIT_DETAIL=summary

*注意：Provider 与 Model 必须同时设置或同时留空。*

审查流程：
- 明确且安全的目标会直接放行。
- 其他目标进入 Guardian Review，卡片显示状态。
- Guardian 拒绝或不可用时，DSH 显示原生单次审批面板。

适用场景与注意事项¶

权限限制：所有批准均为 allowed-once（允许一次），不会建立永久授权。
安全兜底：critical 风险永不自动批准；high 风险需要用户明确授权。
Fail Closed：对于不明确的调用、工具不匹配或无法还原精确动作的情况，插件会采取 Fail Closed 策略。
配置冲突：Cordis patch 会替换 permission.config.presets 整张表。如果你在 DSH 中已有自定义 preset，请在后续 Profile patch 中重新声明，并使用 --dump-config 检查组合结果。
运行时名称：npm 包名为 dsh-auto-review-plugin，但运行时模块名称为 dsh-auto-review。

结语¶

dsh-auto-review 为 DSH 提供了一套基于 Guardian 模型的自动化安全审查方案，适合希望在保持安全性的同时提升审批效率的开发者。