dsh-auto-review
中文 | English
dsh-auto-review 为 DeepSeek Harness 增加 auto-review 权限预设。它对可证明的工作区只读操作直接放行，并让独立 Guardian 模型审查 Shell、网络、MCP、沙箱升级和其他扩展审批。
这是插件层实现，不修改 DSH 内核，也不声称与其他产品的原生审批协议完全等价。
核心安全承诺
- 所有批准最多返回一次性的
allowed-once，不会建立永久授权。
critical 风险永不自动批准；high 风险需要直接用户对精确目标给出充分授权。- 不明确的 call、工具不匹配、证据超限、Reviewer 故障、非法输出和无法还原精确动作的通用审批都会 fail closed。
- 启用审计时，任何批准都必须先成功追加并
fsync 最终 JSONL 记录。
- 人工覆盖复用 DSH 原生“拒绝 / 允许一次”面板，不再显示包含完整参数的大段问题 UI。
- 输入框上方的 Guardian 卡片不保存原始参数或证据；除枚举状态外，只显示一条最多 240 字符、经常见凭据和 URL query 脱敏的 Guardian 判断原因。
详细模型见安全与审计。
安装
npm 包名与 Client 模块身份为 dsh-auto-review-plugin；Host 插件运行时名称仍为 dsh-auto-review。
cd dsh-auto-review
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
dsh --profile web --dump-config
使用 pnpm 11 时，如果安装报告 ERR_PNPM_IGNORED_BUILDS 并列出 @deepseek-ai/dsh-subprocess-local、koffi，这是依赖构建脚本审批机制，不是 lockfile 损坏。审核依赖来源后运行：
pnpm approve-builds @deepseek-ai/dsh-subprocess-local koffi
pnpm rebuild @deepseek-ai/dsh-subprocess-local koffi
不要在未审核所有候选依赖时使用 pnpm approve-builds --all。详细说明见开发文档。
卸载：
dsh plugin --profile web remove dsh-auto-review-plugin
Bundle 保留 DSH 自带的 read-only、workspace-write、danger-full-access，并增加 auto-review。Cordis patch 会替换 permission.config.presets 整张表；已有自定义 preset 时，请在后续 Profile patch 中重新声明，并始终用 --dump-config 检查组合结果。
快速配置
可在 设置 → 插件 → Auto Review 中配置。设置卡默认折叠；展开后按审查模型、审查范围、证据预算、人工审批和审计分组。保存仅写实际变化的字段，Reviewer route 原子更新，失败时回滚。兼容字段 trajectoryEnabled 仍由 Host 接受，但当前 Web 设置已隐藏。
也可使用环境变量：
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 必须同时设置或同时留空。完整字段、默认值和范围见配置参考。
审查体验
- 明确、安全且位于 workspace 内的只读操作可直接执行。
- 其他目标进入 Guardian Review；输入框上方的卡片依次显示 Reviewing、Awaiting approval 和最终状态。
- Guardian 拒绝或不可用且策略允许时，DSH 显示原生单次审批面板。
- 卡片默认折叠；当前 Session 使用
auto-review 时持续显示最近一次结果。刷新、切换 Session 或 Client 插件重载会从 Host 快照恢复；Host 重启后从当前审计 JSONL 恢复最近一条已持久化结果；关闭审计或审计失败的结果只在当前 Host 生命周期保留。
- 插件不写入自定义 Session UI 事件；JSONL 每次审查仍只写一条最终记录。
详见审查流程与 Web UI。
文档
开发
要求 Node ^22.19.0 || >=24。源码、测试和构建配置均使用 TypeScript；生成的 JavaScript 仅位于被 Git 忽略的 lib/。
pnpm install
pnpm verify
更多命令、架构和发布说明见开发文档。
许可证
MIT
