ChatGPTClaudeGrok / X / CursorGemini

DSH plugin 用户审批:按会话的 ask/never 策略、请求分发与审计闭环怎么读

插件开发发布于 2026-11-12作者: DeepSeek Plugin 插件市场
DSH pluginDeepSeek Harness用户审批ApprovalPolicy审计
同一工具在不同会话里审批行为不同,或审计里查不到谁批的。本文讲 ApprovalOutcome 的四个闭合取值、策略在应答者之前生效的顺序、请求为何不带工具参数,以及 ask/decided 审计对的提交约束。

“为什么这个会话里工具直接跑,那个会话里却弹审批”,答案在会话日志的最后一条策略事件里。 DSH plugin 的审批 seam 只回答一个问题:这个具体操作是否可以继续?结果只有四种,且只有一种允许继续。 DSH插件 的审批结果只有一种放行,其余全部按拒绝处理。

审批 seam 只回答一个问题

它不负责执行,也不负责展示,只产出闭合结果。(来源)

dsh-user-approval 拥有共享的请求与结果词汇、ctx.approval 分发服务、approval/request 应答者 waterfall、仅记录日志的审计事件对,以及按会话的 ask 与 never 策略。

UI 通道可以提供人类应答者;ACP 自动化桥接层为其拥有的 agent 提供一次性机器决策。调用方如 dsh-tools 与 dsh-tool-bash 消费闭合结果,除非结果为 allowed-once,否则一律拒绝。

这条“除了一种都拒绝”的规则是整套设计的基调。它意味着缺省状态不是放行,而是拒绝;任何不确定都要落到拒绝侧。

标识与结果:闭合四值

allowed-once 是一次性授权,不是开关。(来源)

每个请求都会获得一个全新的 ApprovalRequestId。这个品牌类型把 approval/asked 与 approval/decided 审计事件配对,同时不会让审批 id 与工具调用 id 或 agent 会话 id 互换。

ApprovalOutcome 是闭合的:allowed-once、rejected、cancelled、unavailable。四者语义:

  1. allowed-once 仅授权所询问的那一个操作;
  2. rejected 是明确拒绝;
  3. cancelled 表示请求被撤回;
  4. unavailable 表示应答者不可用。

调用方对后三种一律执行拒绝。缺失、不负责该请求、抛异常或不合规的应答者会产生 unavailable,而不是放行。

按会话策略:先策略后应答者

never 在分发之前生效,应答者根本没机会看到请求。(来源)

ApprovalPolicy 决定在交互式应答者运行之前发生什么:

  • ask(默认) — 委托给组合的应答者链;链上没有应答者时,默认落到失败闭合的 unavailable;
  • never — 从不询问任何人,每个 ask 都确定性地返回 rejected,不分发任何应答者。

生效值是会话日志中最后一条 approval/policy 事件,回退到服务配置。消费方通过 ctx.approval.effectivePolicy(session) 读取;setApprovalPolicy(session, policy) 是唯一的写入路径,因此回放能重建覆盖值。

两种策略都会把各自完整的当前含义贡献给缓存安全的运行时上下文快照。带来源的 user/message 是持久化且模型可见的输入;审批状态变化时,会在保留的历史后追加一份新的完整快照,而不触碰承载渲染后系统提示词的 system/message 节点。

审批请求有意不带工具参数

应答者靠 callId 挂到已流式输出的调用上,而不是重渲染一份可能漂移的副本。(来源)

ApprovalRequest 以足够精确的方式标识 agent 和工具操作,以便路由和审计该问题,但它有意省略工具参数。原因是参数已经在工具调用里流式展示过,再复制一份会漂移。

字段分工:agent 是代其提问的 agent,用于路由(UI 应答者只回答它拥有的 agent)并接收审计事件到该 agent 的会话日志;toolName 用于展示与审计;可选 callId 让 UI 把提示附加到已流式输出的工具调用上;可选 reason 是审计文本;可选 signal 中止即撤回问题——请求立即结算为 cancelled,仍在等待的应答者的迟到回答会被丢弃。

可选的 displayReason 给界面传请求方提供的本地化字符串,而 reason 仍是审计文本。两者不要混用:一个给人看,一个给日志看。

分发与审计:必须在一个未结束的轮次内

审计对必须被日志的提交与回放边界包住,所以空闲时的 ask 直接拒绝。(来源)

ctx.approval.request(req) 要求发起请求的会话处于一个尚未结束的轮次内。它追加 approval/asked,获取一个结果,追加对应的 approval/decided,然后以该结果完成。

never 策略在服务内部、waterfall 分发之前强制执行,因此即使后来以 prepend 注册的应答者也无法绕过它。

应答者在负责处理该请求时返回结果,否则调用 next() 委托;第一个应答占据唯一的决策槽位。

审计事件仅写入日志,不进入模型 transcript。模型可见的行为是调用方派生的工具结果与当前运行时上下文快照。服务 dispose 时会移除其上下文贡献;应答者监听器独立地通过 effect 绑定到其所属插件。

失败路径一律闭合

没有任何一条失败路径会变成放行。(来源)

  • 中止的 signal 产生 cancelled;
  • 缺失或抛异常的应答者产生 unavailable;
  • 应答者返回不在词汇表里的值时,被规范化为 unavailable;
  • 空闲时的 ask 在追加任何事件之前就拒绝。

还有一条事务性约束:如果任一次审计追加在提交点之前失败,请求仍然拒绝——因为返回一个未记录的决定会破坏 asked/decided 这一对。反过来,Session 会兜住提交之后的观察者失败,所以一次权威追加不会让请求失败,也不会压掉匹配的审计事件。

这条不对称设计值得记住:提交前失败就整体失败,提交后失败不影响结果。

验证:两个会话用不同策略

验证要同时看分发路径与审计落盘,只测结果值不够。(来源) 六步:

  1. 会话 A 用默认 ask,注册一个返回 allowed-once 的应答者,断言工具能执行一次。
  2. 同一会话再执行一次,断言应答者被再次调用,且配额不延续。
  3. 会话 B 设 never,断言请求结算为 rejected,且应答者一次都没被调用。
  4. 注册一个抛异常的应答者,断言结果是 unavailable,调用方拒绝了该操作。
  5. 在空闲状态(无开放轮次)调 request,断言拒绝且日志没有新增 approval/asked。
  6. 中止 signal 后再让应答者返回 allowed-once,断言结果是 cancelled,迟到回答被丢弃。

如果第 3 步应答者仍被调用,说明 never 被放到了 waterfall 之后,那会让策略形同虚设。

审批与用户提问的组合用法,可以对照审批与用户提问;权限预设的配置见权限与审批设置。

一句话收束: 结果四值只有一种放行,策略先于应答者,请求不带参数只带 callId,审计对必须在开放轮次内成对落盘,失败一律闭合。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DSH plugin 的 allowed-once 能复用吗?

不能,DSH plugin 的 allowed-once 只授权所询问的那一个操作。DSH plugin 每次请求都有全新的 ApprovalRequestId,下一次操作必须重新走审批。

DSH plugin 的应答者抛异常时,操作会被放行还是被拒绝?

不会,DSH plugin 按失败闭合处理。DSH plugin 把缺失、不负责该请求、抛异常或不合规的应答者都归为 unavailable,调用方一律拒绝。

DSH plugin 的 never 策略能被后注册的应答者绕过吗?

不能,DSH plugin 在服务内部、waterfall 分发之前就强制执行 never。DSH plugin 即使有应答者以 prepend 注册,也拿不到这次请求。

DSH plugin 的审批审计事件会进模型历史吗,还是只写日志?

不会,DSH plugin 的审计事件仅写入日志。DSH plugin 模型看到的是调用方派生的工具结果与当前运行时上下文快照,而不是 approval 事件本身。

相关术语

ApprovalRequestId
ApprovalRequestId 是服务为每次请求签发的新品牌 id,用于配对 approval/asked 与 approval/decided。— packages/interaction/user-approval/src/index.ts
ApprovalOutcome
ApprovalOutcome 是闭合审批结果,取值只有 allowed-once、rejected、cancelled 与 unavailable。— packages/interaction/user-approval/src/index.ts
ApprovalPolicy
ApprovalPolicy 是会话级审批策略,ask 委托应答者链,never 确定性地拒绝且不分发。— packages/interaction/user-approval/src/index.ts
ApprovalRequest
ApprovalRequest 是同进程只读权限问题,含 agent、toolName、可选 callId、reason 与 signal,但不含工具参数。— packages/interaction/user-approval/src/index.ts

来源