审批门控 ventisyn/dsh-approval-gate

dsh-approval-gate

DeepSeek Harness 自动审批门控 —— 最小人工介入，安全自动放行、危险转人工（fail-safe）。

判定模型预判每次沙箱越界：常规操作自动放行，硬风险操作（删除 / 凭据 / 远程 / 系统 / 批量）永远转人工确认；学习沉淀只针对你确认过的操作，并提供界面化人工审查入口。

✨ 特性

- ⚡ 模型风险预判：每次沙箱越界由判定模型判定（SAFE / RISKY:<类别>），可回补操作自动放行
- 🛡️ 硬风险永远人工：删除、凭据、远程/生产、系统路径、批量不可回补五类操作直接转人工，不计数、不学习
- 🎯 确认制学习：同一操作确认 N-1 次后自动放行；沉淀规则携带操作指纹，只放行你确认过的操作
- 🧠 语义同类验证：措辞变化但意图相同的操作，由判定模型对照你的确认样本语义判断，不再依赖关键词
- 🔧 配置热更新：allowlist.json 修改即时生效，无需重启
- 🎛️ 判定模型可钉死（v1.2.0+）：设置页下拉可选「指定模型 / 跟随会话默认模型 / 用部署默认值（cordis.patch.yml）」；钉死后在会话里切换模型也不会改变判定模型，热更新生效
- ✅ 人工审查 UI：自动放行时输入框上方出现绿色提示；「审批」视图（轨迹右侧）展示当前会话完整放行时间线
- 📄 文件改动对比与撤销（v0.5.0+）：审批涉及的文件可点击查看 unified diff——变动行带上下 5 行上下文、多处修改按 hunk 分区并以「N unmodified lines」分隔条折叠、绿加红删灰上下文、双行号；一键「撤销此改动」投递指令让 AI 按快照恢复文件
- 🗂️ 会话级快照管理（v0.5.0+）：快照按事件归属会话，审批视图按当前会话统计；清理支持「仅清本会话」与「清空全部」两档，避免误删其他会话未查看的 diff 记录

📸 界面速览

① 审批视图

审批视图

「审批」标签页（轨迹右侧）按时间倒序展示当前会话的自动放行与人工审批记录：每条记录含工具名（bash / edit）、判定标签（「自动放行 · 判定安全」「人工通过」等）、时间与操作说明。顶部统计栏显示本会话的 diff 快照占用（2.9 KB · 3 条），并提供两个清理入口：「仅清本会话」（只删除当前会话的快照，不影响其他会话未查看的 diff）与 「清空全部」（二次确认后清空所有会话，防止误删）。

② 文件改动对比（diff）

diff 对话框

点击审批记录中的文件即可打开对比面板：以 unified diff 展示改动前后差异——新增行绿底（+）、删除行红底（-）、上下文行灰底；左侧显示原/新双行号；多处修改按 hunk 分区，块间以灰色「6 unmodified lines」分隔条折叠未变更区间。顶部统计 +2 / -2 行变更 · 20 行未变。底部 「撤销此改动」 一键向对话投递撤销指令，AI 将按审批前的快照恢复文件。

③ 设置 · 自动审批

设置-自动审批

设置页「自动审批」分区提供完整配置：初始化权限预设（一键写入 cordis.patch.yml 的 auto-approve 预设）、当前判定管道总览（DENY → 白名单 → denyRules → 判定 → 学习）、危险词黑名单（预置条目 + 自定义添加）、以及热更新说明（修改即时生效，无需重启）。判定模型一栏是下拉：可选「默认（用 cordis.patch.yml 里的值，本仓库默认钉死 deepseek-official/deepseek-flash）」「跟随会话默认模型」或模型目录中的任意一项，保存即热更新生效，并就地显示当前生效的模型与来源。

🚀 快速开始

dsh plugin --profile web add dsh-approval-gate

1. 权限预设（自动）：插件启动时会把 auto-approve 预设自动写进 profile 的 cordis.patch.yml（可在 allowlist.json 用 autoConfigurePreset: false 关闭，或在设置页手动写入；详见指南）
2. 重启 dsh web（让写入的预设进入权限下拉）
3. 选择预设：会话权限下拉选中「自动审批」

📖 文档

- 完整指南（管道 / 配置 / 安全设计 / 审查 UI） · English Guide

📄 License

MIT

本项目是 moon09300731/dsh-approval-gate 的 fork：

- 原始版权归原作者 moon09300731 所有；完整许可条款见 LICENSE，（保留原作者的版权声明，并在其后追加了本 fork 的版权声明）。
- 本 fork 同样以 MIT 协议发布。
- 依据 MIT 协议，任何人可自由使用、修改、分发本项目，但必须保留上述版权声明与许可声明。