DSH | @topolyte/windows-acl | 非阻塞 Windows ACL 沙箱授权，消除大工作区首次命令冻结

[Ranecc]

DSH | @topolyte/windows-acl | 非阻塞 Windows ACL 沙箱授权，消除大工作区首次命令冻结

非官方项目，由社区成员独立开发和维护。

项目地址：

https://github.com/Ranecc/topolyte-windows-acl

项目介绍：

@topolyte/windows-acl 是 DeepSeek Harness 在 Windows 上的即插即用 ctx.sandbox provider，修复了官方 windows-acl 后端的一个结构性冻结：首次 workspace-write 授权会在 confine() 内同步物化 standing 写 ACE，而 SetNamedSecurityInfoW 的 eager 继承传播会在事件循环上整树遍历——大工作区下整个服务器（所有 session、HTTP、RPC）冻结数分钟。

本插件把那次遍历移入 grant-cli 子进程（fire-and-forget，spawn 而非 spawnSync），保持 confine() 同步但 fail-closed（standing ACE 落地前工作区写被拒——只会报 access denied，绝不冻结）；另提供 prewarm 配置在启动时预热已知工作区。通过 Cordis bundle-patch 机制安装在官方 harness 上，无需 fork。

截图：

> >

与 DSH 的集成方式：

dsh plugin --profile <name> add @topolyte/windows-acl

插件 bundle patch 会禁用官方 @deepseek-ai/dsh-sandbox-local 行，并在独立 id 下插入本 provider（cordis 单例服务，替换 ctx.sandbox）。

---

背景：为什么做这个插件

官方 windows-acl 后端在大工作区首次授权时会整树同步传播 ACE（见 packages/sandbox/sandbox-windows-acl/src/acl.ts 的注释 "eager inheritance; minutes on large workspaces"）。官方已有 hasExactGrant 精确匹配跳过，但这只让第二次 provision 变成 O(1)；第一次仍然阻塞。官方不开 issue、不接受 PR，因此把修复做成独立插件发布，任何官方 harness 用户都能直接安装使用。

实测 benchmark（劫持官方 grant.ts 源码测量）

场景	文件数	首次（阻塞）	后续（O(1) skip）
真实工作区（首次授权）	4,332	2,773.7ms（冻结）	1.2ms
大 monorepo（DSH 本体）	182,053	首次随整树放大（fork 实测 >120s）	1.2ms

同一目录从首次 2,773.7ms → 二次 1.2ms（约 2,300 倍差距），正是用户可感知的冻结；skip 与树大小无关（4,332 与 182,053 文件都是 1.2ms），因为 hasExactGrant 只读目录自身 DACL 头。

实现要点

• grant-cli 子进程承载整树遍历，绝不阻塞事件循环（stdio: 'ignore' + 监听 exit，无僵尸进程）。
• kickOffWorkspaceGrant 用 workspaceGrantInflight Map 合并并发请求（单线程 tick 内 has→set 原子），且官方 acl.ts 已有 withPathLock（LockFileEx per-path 锁）兜底多进程场景。
• confine() 保持同步契约，未授权时只 kick-off 不 await，fail-closed。
• prewarm 配置可在启动时预热已知工作区，缩短首条命令前的 fail-closed 窗口。

[leenkcool]

我是插件库，我感觉你的想法很好，我想收录，可以提ISSUE。 具体提的方法如下。
#4456

我也帮你置顶帖子，省得被埋没。 被收录的插件审核前送STAR