dsh-smart-approval

English | 中文 | 更新记录

dsh-smart-approval 是 DeepSeek Harness 的失败关闭审批插件。 它把“访问权限”和“自动审查”拆成两个互不耦合的会话设置：DSH 继续管理 Read Only、Workspace Write、Full access，插件在 Workspace Write 旁边增加独立的自动审查选择框。

新会话默认使用智能审批。切换自动审查模式不会改变沙箱权限，切换权限也不会改变自动审查模式； 两者都从下一次授权申请起生效，无需重启 DSH。

[!WARNING] 本项目和 DSH 均处于开发者预览阶段。请阅读下方安全边界，并在要求可复现的环境中固定精确版本。

两个独立选择器

Web 输入框底部应显示两个控件：

[ Workspace Write ▾ ] [ 智能审批 ▾ ]

• 访问权限：Read Only、Workspace Write、Full access，由 DSH 原生权限选择器管理。
• 自动审查：人工审批、智能审批、无人值守，由本插件独立管理。

| 自动审查模式 | 安全请求 | 高风险或不确定 | 明确恶意 | |---|---|---|---| | 人工审批 | 转人工 | 转人工 | 转人工 | | 智能审批（推荐默认） | 自动通过一次 | 转人工 | 拒绝 | | 无人值守 | 自动通过一次 | 拒绝 | 拒绝 |

自动审查只处理已经进入 DSH approval/request waterfall 的请求。它不会扩大当前访问权限， 也不会把会话切换到 Full access。

安装

环境要求

• Node.js 24 或更高版本。
• DeepSeek Harness >=0.1.1-rc.1 <0.2.0（当前验证基线：0.1.1-rc.2）。
• PATH 中存在 pnpm；DSH 会把插件管理操作转发给 pnpm。

全局安装 DSH 后：

npm install --global @deepseek-ai/[email protected]
dsh plugin --profile web add [email protected]
dsh --profile web --dump-config
dsh web

一次性运行：

npx @deepseek-ai/[email protected] plugin --profile web add [email protected]
npx @deepseek-ai/[email protected] --profile web --dump-config
npx @deepseek-ai/[email protected] web

npm dsh ... 不是合法的 npm 命令。全局安装后使用 dsh ...，一次性运行使用 npx @deepseek-ai/dsh ...，从 DeepSeek Harness 源码 checkout 运行时使用 pnpm dsh ...。

DSH 插件命令支持精确版本。因此稳定版发布后可直接执行：

dsh plugin --profile web add [email protected]

从本地或 GitHub 安装

从本仓库安装：

dsh plugin --profile web add .

从 DeepSeek Harness 源码 checkout 运行：

pnpm dsh plugin --profile web add /absolute/path/to/dsh-smart-approval
pnpm dsh --profile web --dump-config
pnpm dsh --profile web

从 GitHub 安装时固定已审查的 commit：

dsh plugin --profile web add github:TingRuDeng/dsh-smart-approval#<commit-sha>

Git 依赖会运行本包的 prepare 构建。pnpm 10 及以上默认阻止依赖构建脚本；首次从 Git 安装时，请按 DSH 提示把精确包名加入该 profile 的 pnpm-workspace.yaml allowBuilds， 审核源码后再重试。Registry 包已包含构建产物，不需要这项许可。

验证或卸载

dsh --profile web --dump-config

配置中应出现 dsh-smart-approval bundle 和 smart-approval 插件行；permission 配置仍应只有 DSH 原生的 Read Only、Workspace Write、Full access。启动 Web 后，自动审查选择框应独立显示在 权限选择器旁边。

卸载：

dsh plugin --profile web remove dsh-smart-approval

使用与切换模式

优先使用 Web UI 中的独立自动审查选择框，也可以在当前会话执行：

/approval-mode manual
/approval-mode smart
/approval-mode unattended

不带参数的 /approval-mode 返回当前模式。访问权限仍使用 DSH 原生 /permission 命令，两套命令 不会互相改写状态。

/approval-log 列出本会话的自动裁决记录（默认最近 10 条，/approval-log 30 查看最近 30 条）。每行 只包含时间、工具、结局、原因码和审查模式，绝不含参数与模型输出；配置 decisionLogSize: 0 可关闭审计。

尚未明确选择模式的会话使用配置的 defaultMode，默认是 smart。明确选择的模式保存在 DSH storage-domain 的会话伴随记录中；未选择的会话继续跟随当前默认值，确保修改配置后审批行为与 浏览器投影一致。插件不会向不可移植的 Session 事件日志追加自定义事件。从早期预览版升级时， 旧的 smart-approval/mode 事件只读迁移到伴随记录；更早的 smart-approval 与 unattended 权限 preset 分别迁移为 smart 与 unattended。迁移不会修改原权限事件。

工作原理

插件是 DSH approval/request waterfall 中的前置 answerer：

1. 根据 callId 定位真实的 tool/call 事件。DSH bash、pwsh、write、edit 分别使用封闭、 有版本的动作适配器；未知工具或未来新增的未知参数都会失败关闭。
2. 将当前 turn 与有界的近期直接用户纯文本组合为授权上下文；新约束覆盖旧范围，载荷会明确标记是否省略了 更早历史。Assistant 消息、工具输出、模型生成的 justification 和此前审批结果均不构成授权。
3. 仅传递真实执行语义：Shell 传递命令及执行字段；write 传递精确路径和完整新内容；edit 传递精确 路径、old/new 字符串与 replace-all 标志。模型生成的描述和授权理由会被剔除。
4. 文件变更通过 DSH 文件系统服务读取无内容证据：解析后的展示路径、与 workspace 的关系、路径/目标类型 及可选字节数，不读取目标文件正文。最终符号链接、规范路径别名、异常元数据、敏感路径和系统位置会在 模型调用前停止。
5. 确定性前检还会阻止凭据材料、破坏性命令、系统变更、后台任务、依赖安装、发布、远程写入、数据上传及 敏感 workspace/workdir 条件。
6. 模型只返回严格的四字段分类：riskLevel、authorization、intent 和封闭的 reasonCode，不能直接 授权。本地代码仅把“低风险 + 善意 + 高或中等直接用户授权”映射为允许；不确定转人工，明确恶意按模式拒绝。
7. 每次成功分类也只产生 allowed-once。下一次相似申请仍会重新检查并重新调用模型。超时、异常、非法输出、 证据不完整、取消，或检查/审核期间模式发生变化，都会按当前模式失败关闭。

重复申请会重新审查，不会记住授权

如果用户要求连续完成多次普通写入，而且每个精确动作都明确属于该意图，智能审批可以让第二次及后续申请 无需再次点击。每个申请仍会独立调用模型并只获得一次性授权；第一次人工允许或模型结果不会变成目录白名单、 缓存先例或永久权限。

配置

默认复用当前会话路由。需要独立审核路由时，在 profile 的 cordis.patch.yml 中覆盖插件行：

- id: smart-approval
  config:
    defaultMode: smart
    reviewerProvider: your-provider-route
    reviewerModel: your-model-id
    timeoutMs: 15000
    maxTokens: 128

reviewerProvider 和 reviewerModel 必须成对配置。

| 字段 | 默认值 | 作用 | |---|---:|---| | defaultMode | smart | 新会话的自动审查模式：manual、smart 或 unattended | | reviewerProvider / reviewerModel | 当前会话路由 | 可选独立审核路由；必须成对配置 | | timeoutMs | 15000 | 整个审核调用的强制期限 | | maxTokens | 128 | 审核输出上限 | | maxToolArgumentChars | 12000 | 工具参数上限；超限时不截断并失败关闭 | | maxUserMessages | 4 | 当前及近期直接用户消息上限；省略旧历史时会明确标记 | | maxUserContextChars | 8000 | 用户上下文上限；当前 turn 不截断，旧历史可带标记地省略 | | decisionLogSize | 50 | 每个会话生命周期保留的裁决审计条数；0 完全关闭审计 |

本插件的 bundle 不覆盖 permission 行，因此不会替换 profile 已有的权限预设。

模型、数据与安全边界

• 人工审批不调用审核模型。智能审批和无人值守会把 workspace 根目录、规范化动作、有界的近期直接用户 纯文本及不含正文的文件目标元数据发送给审核 provider。write/edit 的规范化动作包含判断本次变更所需的 精确新内容或替换文本；检测到凭据材料时会在本地停止。模型根据这些有界历史分类风险、授权和意图；调用 模型前先执行确定性本地前检，再由本地封闭映射把严格分类转换为对应模式的最终决定。因此旧消息只是上下文， 不是持久授权。
• 复用当前会话模型便于部署，但不构成独立安全复核；敏感环境应配置独立、受控的 provider 路由。
• 只有已经进入 DSH 审批通道的请求才能被审核；不触发审批的网络或远程操作不在本插件控制范围内。
• 模型分类不是安全证明。未知工具或参数、文件系统别名、后台执行、非文本或不完整上下文均失败关闭：智能 审批转人工，无人值守拒绝。
• 每次自动授权只对当前调用有效，重复申请也会重新审查；不保存决策缓存、目录白名单、审批先例或永久授权。
• 日志只记录工具名、结果和短原因码，不记录完整提示、参数、凭据或模型推理。
• 持久裁决审计（/approval-log）每条只保存时间、工具名、结局、原因码、审查模式和工具调用 id， 绝不保存参数、提示、用户文本或模型输出，并可通过 decisionLogSize: 0 关闭。审计写入是旁路通道： 写入失败不会改变审批结局。
• 智能审批的人工回退和人工审批需要其他 Web、ACP 或自定义人工 answerer；如果不存在，DSH 保持失败关闭。
• 文件目标检查发生在审批和实际执行之前，期间理论上可能发生路径替换（TOCTOU）。在 workspace-write 下， DSH 会在执行变更前再次规范化并检查目标，这会缩小但不能消除竞态；一次性 danger-full-access 拥有宽泛 文件系统权限，不提供同等的目录包含检查。除非 DSH 核心提供原子的 no-follow/open-relative 路径能力， 本插件无法彻底消除路径替换竞态；审批等待期间不应允许不可信进程修改 workspace。
• DSH 当前只有一个 workspace-write 根目录。一次性 Full access 仍拥有宽泛文件系统权限，本插件不会把它 变成多根目录沙箱。

面向维护者与 AI 的仓库地图

| 路径 | 职责 | |---|---| | src/index.ts | 服务注入、旧会话迁移、投影、命令和生命周期 | | src/review-mode.ts | 旧事件只读迁移、命令生命周期折叠和浏览器投影 | | src/review-mode-storage.ts | Session 生命周期绑定的审查模式伴随存储与裁决审计表 | | src/client/ | Web 端独立自动审查选择框和客户端插件注册 | | src/approval-handler.ts | 三模式路由、waterfall 决策和审核后模式复核 | | src/review-context.ts | 封闭动作适配器和有界的直接用户上下文提取 | | src/file-target-inspector.ts | DSH 文件系统只读证据与路径安全分类 | | src/review-policy.ts | 确定性前检、严格分类解析和本地决策映射 | | src/llm-reviewer.ts | 审核提示、流式解析、严格评估协议和超时 | | cordis.patch.yml | 仅挂载主机插件，不覆盖权限预设 | | tests/ | 主机、策略、协议、迁移、投影和浏览器回归契约 |

必须保持的不变量：权限与自动审查状态互不改写；缺失或含糊的证据不能自动放行；只有有界的直接用户文本 可以建立授权且新约束优先；此前审批不构成授权；只有本地映射后的低风险善意分类可以返回 allowed-once；人工审批不能检查申请内容或调用模型；检查或审核期间切换模式必须使原结果失效。

开发

pnpm install
pnpm test
pnpm run typecheck
pnpm run build
pnpm pack --dry-run

支持的 DSH 范围是 >=0.1.1-rc.1 <0.2.0，当前验证基线是 0.1.1-rc.2。真实 provider 的端到端审核和人工回退交互仍依赖部署凭据 与具体环境验收。

License

MIT