dsh-workspace-integrity
一个 DSH 插件:会话切到完全权限时,把工作区的 Low 完整性标签改回 Medium, 修掉 DSH 的 Windows 沙箱留在工作区根上的 no-write-up 标签。
一、问题:DSH 的工作区会被打上 Low 完整性标签
1. 机制
DSH 在 Windows 上跑受限模式(read-only / workspace-write)时,会为工作区授权。
@deepseek-ai/dsh-sandbox-windows-acl 的 grantWrite 在一次
SetNamedSecurityInfoW 调用里写入三样东西:
| # | 写什么 | 作用 |
|---|---|---|
| ① | 能力 SID(S-1-4-x-y,由 sha256(工作区路径) 计算)的允许 ACE |
让当前会话能写这个工作区 |
| ② | world SID 的一条 deny(去掉 FILE_DELETE_CHILD) |
防止一个授权根去删另一个 |
| ③ | 一条 Low 的 no-write-up 强制标签(S-1-16-4096,buildLowLabelAcl) |
让写入者停留在低完整性 |
第 ③ 条是本插件存在的原因。它是可继承标签((OI)(CI)),挂在工作区根目录上,
于是:
<工作区根> ← Low 标签(继承源)
├── 脚本 / 图片 / 配置 … ← 继承 → Low
├── 某个程序.exe ← 继承 → Low
└── 子目录/ ← 继承 → Low(再往下继续继承)
关键点:从 Low 目录启动的程序,自己也是 Low 进程。
(实测:同一个 exe,放在被打过标签的目录里启动是 Low,复制到 C:\新建目录 启动是 Medium。)
2. 后果:一堆看起来毫不相干的毛病
低完整性进程对 Medium 对象的写一律被系统拒绝,而且这条限制由完整性策略强制、 和 DACL 完全无关 —— 所以你查 ACL 会觉得很干净,问题却一直在。
| 症状 | 真实原因 |
|---|---|
程序报「配置目录不可用 / 权限不足」Permission denied (EACCES) |
它想写 Documents / AppData 里的 Medium 对象被拒。走 CRT 的 open() 失败时不带 winerror,很容易被程序自己的错误处理误判成别的意思 |
| .NET 程序起不来,报「从网络位置加载程序集」 | .NET 把这个 Low/不可信位置判成"远程",拒绝加载程序集(loadFromRemoteSources 那条) |
| 双击 exe 弹「无法验证发布者」 | 外壳用了同一套"位置可信度"判断 |
| 程序装好了、跑起来了,但窗口/功能莫名其妙 | 程序自己能跑,但它启动的子进程、内部用到的 exe 全都是 Low |
同一个根因,能被三个不同的模块报成三种毫不相干的错——这也是它难查的地方。
3. 为什么「切回完全权限」没用
因为标签不是会话状态,是文件系统对象上的持久 ACL。
- 切到
danger-full-access时,DSH 不再走沙箱授权那条路径,自然不会去撤销上一步留下的东西; - 切回受限模式时,它会再盖一次(标签本来就在,等于不变)。
所以标签会一直留着,直到有人显式把它改掉。
4. 自查(一条命令)
icacls "<工作区路径>"
中招的样子(这两行都在):
Mandatory Label\Low Mandatory Level:(OI)(CI)(NW)
S-1-4-926279411-962422606:(OI)(CI)(W,D,DC)
Mandatory Label\Low …= 就是这条标签在作怪;S-1-4-…= DSH 给这个路径算出来的工作区身份(sha256(路径)),算是个"我来过"的脚印; 它是惰性残留,留着不会自己作妖。
手工修(路径得是你自己拥有的,见下面「边界」):
icacls "<工作区路径>" /setintegritylevel (OI)(CI)M /T /C
二、这个插件做什么
一句话
监听会话的 sandbox/mode 事件:只要切到 danger-full-access,
就把该会话工作区根的 Low 标签改回 Medium,并递归覆盖已经存在的子项。
具体行为
- 触发:
ctx.on('session/event', …)收到event.type === 'sandbox/mode'且event.data.mode === 'danger-full-access'。 - 定位工作区:
workingDirectory.get(session),拿不到就退回session.header.cwd。 - 先探再修:跑一次
icacls <工作区>,- 根目录不是 Low → 跳过(记一行日志,不做无谓的
/T扫描); - 是 Low → 执行修复。
- 根目录不是 Low → 跳过(记一行日志,不做无谓的
- 修复:
icacls "<工作区>" /setintegritylevel (OI)(CI)M /T /C/T是为了把已经存在的子项一起拉回来(新建的会自然继承 Medium)。 - 兜底:插件热挂载时,会话可能早就是完全权限了。所以每个会话第一次收到事件时,
会按当前策略补查一次(
sandboxPolicy.resolve({ session }).mode)。 - 限流:同一条路径 60 秒内只修一次 —— 一次切换可能来好几个事件(还有子会话的
delegation事件)。 - 如实记日志:成功、跳过、失败、失败原因都写进
~/.dsh/workspace-integrity.log。
它不做什么
- 不改 DACL,也不删那条
S-1-4-*能力 ACE; - 不改会话的权限模式(只修标签,不碰你的授权范围);
- 非 Windows 平台挂载即空转;
- 不会自动提权(见「边界」)。
安装
git clone https://github.com/K0L0banov/dsh-workspace-integrity `
"$env:USERPROFILE\.dsh\external\dsh-workspace-integrity"
然后在 DSH 会话里:
plugin_manager({ action: 'install_bundle',
target: 'C:\\Users\\<你>\\.dsh\\external\\dsh-workspace-integrity' })
装好不需要重启:DSH 的热加载会把它挂上去,日志里会先出现一行「插件已挂载」。
配置
写在 cordis.patch.yml 的 config: 段,都可省:
| 字段 | 默认 | 说明 |
|---|---|---|
thorough |
false |
根目录不是 Low 时也照样 /T 扫一遍(默认跳过以省时间) |
dryRun |
false |
只记日志、不动手 |
日志
~/.dsh/workspace-integrity.log:
[2026-11-16T05:27:55.410Z] 插件已挂载(监听 sandbox/mode)
[2026-11-16T05:27:55.643Z] 会话首见:检查 E:\DSH工作区
[2026-11-16T05:27:55.699Z] 跳过 E:\DSH工作区:根目录没有 Low 标签
[2026-11-16T05:28:38.482Z] 收到 sandbox/mode:检查 C:\Users\…\demo
[2026-11-16T05:28:38.541Z] 已修复 C:\Users\…\demo(30ms)Successfully processed 1 files
边界
- 只在 Windows 生效。
- 改强制标签要
WRITE_OWNER:自己创建的目录(桌面、文档、个人文件)没问题; 但盘根建出来、属主是Administrators的目录(D:\xxx、E:\xxx那种),普通用户改不动。 这时日志会写「拒绝访问」并给出需要管理员执行的那条命令 —— 不是插件偷懒,是 Windows 的权限模型。 - 每条路径 60 秒内只修一次。
自测
node test/smoke.mjs "<自己建的目录>"
脚本会把目标目录打成 Low → 模拟一次「切到完全权限」的会话事件 → 检查标签是否回到 Medium。 别拿盘根目录测(见「边界」)。
免责与归属
- 这是个人开发的非官方插件,与 DeepSeek / DeepSeek Harness 没有隶属、合作或背书关系。
- 代码是独立实现(约 240 行),不依赖任何第三方包(只用 Node 内置模块),未包含任何他人源码。
- 它做的事是:把本机某个目录的完整性标签恢复成 Windows 默认的
Medium。 不提权、不注入进程、不 hook、不绕过任何安全机制 —— 只在会话已经是完全权限时,把沙箱此前留下的标签还原。 - 按 MIT 协议**「按原样」**提供,不提供任何明示或暗示的担保;执行
icacls的后果由使用者承担。 - 文中提到的 DSH 行为(工作区会被打上 Low 标签)是本机实测复现的现象描述,不是对实现细节的复制。
许可
MIT
No comments yet. Be the first to write one.