kingwl
f505bd9258
Review fixes (ds-review-bot warnings on #623): - One chain, every consumer: the override resolution (own post-seed switches ?? header baseline, closed-vocabulary validated) moves into pure exports (sandboxOverrideOf / approvalOverrideOf); the services delegate, and the permission presets consume them — current(session) and set() now see inherited baselines, so a child inheriting danger-full-access gets REAL knob switches when workspace-write is selected instead of a silent no-op, and a seed-carried preset selection is subsumed by the baseline. current(events) becomes current(session) (pre-release; the only callers were tests). - Unconditional durable validation: a malformed header baseline fails loud on every read, no longer shadowed by an own switch. - The two policy peers are declared optional (peerDependenciesMeta), so a thin spawn/fork deployment without policy plugins can consume the driver; verify-runtime-closure honors the flag. Red-first: inherited-preset derive/switch-away and seeded-selection tests in the permission suite; malformed-baseline-with-own-switch tests in both policy suites.
2.8 KiB
@deepseek-ai/dsh-permission
English | 中文
通过 ctx.permission（PermissionService）提供面向用户的权限 preset。每个配置名称都会将 sandbox/mode 与 approval/policy 组成一组；默认项为 workspace-write（workspace-write + ask）和 danger-full-access（danger-full-access + never）。UI 适配器可以将该表作为单个选择器公开，而沙箱执行与审批仍分别消费各自的调节项。
set(session, name) 会先在仅写日志的 permission/preset 事件中记录已变更的选择，再仅对实际值发生变化的调节项调用 setter。它与 current(session) 都通过执行所读取的同一套覆盖链解析调节项（sandboxOverrideOf／approvalOverrideOf：先取会话自己在种子之后的切换，否则取会话头中继承的基线，否则取组合默认值），因此继承了更宽基线的被委派子 agent（智能体）在选中更窄的 preset 时会得到真实的调节项切换，而种子携带的选择会被基线所涵盖。选择事件先于调节项事件，并在多个 preset 共享同一组取值时保留用户意图；净变化为零的选择不会追加任何内容。current(session) 优先返回仍与当前调节项匹配的、会话自己的已记录选择，其次返回表中第一个匹配项，否则返回 custom。客户端可以把 custom 显示为当前值，但不能选择它。
该服务要求存在具有约束能力的 ctx.bash 执行器和 ctx.approval。表中名为 custom 的条目会在加载时抛出异常；如果组合在表外指定默认值，则零事件会话会推导出 custom。详见沙箱切换设计。
模型体验
间接地，通过 dsh-user-approval 和 dsh-tool-bash：二者会渲染由此服务的调节项事件所选择的审批策略提示词、切换通知和沙箱工具结果；permission/preset 本身只写入日志。
KV Cache 影响
不会直接使缓存失效；具名消费方拥有所有请求前缀变更。
已知限制与延期工作
- 当前没有已交付的组合挂载此服务：在 ACP 变为仅用于自动化之前，ACP 桥接层是唯一的选择器；preset 表为下一个公开运行时策略切换的交互式入口保留。
- 只组合两个机制调节项：preset 选择沙箱模式和审批策略；agent／profile 选择尚未纳入
PresetSpec。 custom只能推导得出：调用方可以从不匹配的调节项组合切换出去，但无法通过此服务选中或持久化一个具名 custom preset。- preset 表位于进程级别：配置在插件生命周期内固定；更改可用 preset 必须重新加载插件。