前言¶
DeepSeek Harness（DSH）的生态理念是「一切皆插件」。在使用智能体进行开发时，沙箱越界是常见场景。完全自动放行存在安全隐患，完全人工审批又效率低下。dsh-approval-gate 插件解决了这个矛盾。
是什么¶
dsh-approval-gate 是一个自动审批门控插件，由 ventisyn 维护。它利用判定模型预判每次沙箱越界行为：对常规操作自动放行，对硬性危险操作转人工确认。
核心功能¶
- 模型风险预判：每次沙箱越界由判定模型判定（
SAFE或RISKY:<类别>），可回补操作自动放行。 - 硬风险永远人工：删除、凭据、远程/生产、系统路径、批量操作五类硬性规则直接转人工，不计数、不学习。
- 确认制学习：同一操作确认 N-1 次后自动放行。沉淀规则携带操作指纹，只放行确认过的操作。
- 语义同类验证：措辞变化但意图相同的操作，由判定模型对照确认样本语义判断，不再依赖关键词。
- 配置热更新：修改
allowlist.json即时生效，无需重启。 - 判定模型可钉死：设置页下拉选择「指定模型 / 跟随会话默认模型 / 用部署默认值」，钉死后在会话切换模型不会改变判定模型。
- 人工审查 UI：自动放行时输入框上方出现绿色提示；审批视图（轨迹右侧）展示当前会话完整放行时间线。
- 文件改动对比与撤销：点击审批记录中的文件查看 unified diff（新增绿、删除红、上下文灰），可一键「撤销此改动」投递指令让 AI 恢复文件。
- 会话级快照管理：快照按事件归属会话，审批视图按当前会话统计，支持「仅清本会话」与「清空全部」。
安装与启用¶
执行以下命令安装插件：
dsh plugin --profile web add dsh-approval-gate
安装后，权限预设会自动写入 profile 的 cordis.patch.yml（auto-approve 预设）。完成安装后需重启 dsh web，让写入的预设进入权限下拉。最后，在会话权限下拉选中「自动审批」即可启用。
典型用法¶
- 热更新配置：直接修改
allowlist.json，无需重启服务即可生效。 - 审查与撤销：在审批记录中点击文件，查看 unified diff；若需回滚，点击「撤销此改动」投递指令让 AI 按快照恢复文件。
- 查看审批流：在轨迹右侧的「审批」视图查看当前会话的放行与人工审批记录。
适用场景与注意¶
该插件适合需要在 DeepSeek Harness 中实现最小人工介入、兼顾安全与效率的场景。使用前需注意：本项目是 moon09300731/dsh-approval-gate 的 fork，使用时必须保留原作者的版权声明。插件以当前 dsh 进程权限运行，使用前应检查源码与许可证。
总结¶
dsh-approval-gate 通过判定模型预判和确认制学习，实现了沙箱越界的自动化与安全性平衡。它提供了热更新、撤销回滚和会话级快照管理等实用功能，是 DSH 开发流程中的安全辅助工具。
