前言¶
DeepSeek Harness (DSH) 采用了「一切皆插件」的理念,这使得构建安全智能体变得灵活,但也带来了如何平衡「自动化效率」与「执行安全性」的问题。完全放开权限会导致不可控的风险,而事无巨细的人工审批又会拖慢开发节奏。
dsh-auto-review 插件旨在解决这一矛盾。它借鉴了 Codex 的自动审查设计,在保留 DSH 原生沙盒隔离的基础上,引入了一个独立的审查模型。普通操作遵循 DSH 原有权限策略,而高风险操作则会被拦截并交给 Reviewer 进行风险评估,批准后继续执行,拒绝则强制换方案或请求人工授权。
插件简介¶
- 名称:
jhckevin/dsh-auto-review - 维护者:jhckevin
- 许可:MIT
- 核心价值:在 DeepSeek Harness 中引入自动化的「二次审查」机制,通过独立模型评估风险,同时利用原生沙盒保证基础隔离。
核心功能¶
该插件主要包含以下能力:
- 自动审批审查:区分普通操作与高风险操作,自动触发审查流程。
- Codex 风格设计:审查界面与交互逻辑参考了 Codex 风格,支持 WebUI 与 TUI 状态提示(如盾牌图标)。
- 原生沙盒与独立模型:不破坏 DSH 的原生沙盒环境,审查模型独立运行,使用 Flash 模型作为默认选项,也支持按风险分级切换模型。
- 风险分级与熔断:支持风险分级模型策略。当同一回合连续 3 次拒绝,或最近 50 次审查累计 10 次拒绝时,会触发熔断机制,强制结束当前回合,防止 Agent 在错误路径上无限重试。
- 宿主版本自动兼容:自动识别并兼容 DSH 的特定版本(0.1.0-rc.6, 0.1.1-rc.2, 0.1.2-alpha.5),无需手动匹配插件版本。
安装与配置¶
安装过程分为三个步骤:安装插件本体、初始化原生执行组件、安装界面适配。
1. 安装插件本体¶
在已安装兼容版本 DSH 的环境中,直接运行以下命令添加插件:
dsh plugin --profile web add @jhckevin/dsh-auto-review@next
2. 初始化原生执行组件¶
每台机器首次安装时,需要由管理员执行一次,初始化原生 bridge 组件。该组件与用户目录分离,避免被 Agent 修改。
sudo npm install --prefix /opt/dsh-auto-review-native/0.1.0-rc.2 \
--ignore-scripts --no-audit --no-fund \
@jhckevin/dsh-auto-review-bridge-linux-x64-gnu@0.1.0-rc.2
export DSH_AUTO_REVIEW_NATIVE_RUNTIME=/opt/dsh-auto-review-native/0.1.0-rc.2/node_modules/@jhckevin/dsh-auto-review-bridge-linux-x64-gnu
注:建议 Node.js 版本为 24.20.0,支持 Linux x86_64 / glibc 2.31+。
3. 安装界面适配¶
停止 DSH 后,运行安装脚本以获取 WebUI 图标和适配:
npx --yes --package=@jhckevin/dsh-auto-review@next dsh-auto-review-ui
dsh --profile web
注:如遇网络问题,可设置 DSH_AUTO_REVIEW_DOWNLOAD_MIRROR 环境变量使用镜像源。
4. 配置模型与启用¶
- 进入 设置 → 模型,配置 Provider 与 API Key。
- 进入 设置 → 自动审批审查,启用插件并选择 Reviewer 模型。
使用逻辑¶
插件介入后的执行流程如下:
- 普通操作:遵循 DSH 的权限与沙盒设置,无需审查即继续执行。
- 高风险操作:操作被送交给 Reviewer。
- 批准:移除审查状态,继续执行。
- 拒绝:Agent 需要寻找更安全的替代方案,或停止并请求用户授权。
- 熔断触发:如果审查连续失败达到阈值(连续 3 次拒绝 或 历史累计 10 次拒绝),当前回合会被强制结束。
注意事项¶
- 费用问题:审查会产生额外的 token 费用。每次审查都需要发送操作、上下文与策略。虽然输入缓存命中约 50%,但缓存命中的输入并非免费,具体成本取决于 Provider 的定价。
- 隔离依赖:不要依赖
partial enforcement来作为完整的隔离保障。Reviewer 故障时不会自动放行,必须由用户介入。 - 升级行为:同名插件升级时,DSH/npm 会替换当前 profile 中的旧包,不会并排启用多个版本。同名升级不会清理会话、配置或密钥。
- 依赖要求:原生 bridge 的 host/platform 包是必需依赖,不是多余版本,升级或重装时请勿忽略。
总结¶
dsh-auto-review 是一个为 DeepSeek Harness 提供安全增强的工具。它通过引入独立的审查模型和熔断机制,在不牺牲 DSH 原生沙盒优势的前提下,降低了人工审批的频率,提升了 Agent 运行的安全性。