dsh-sandbox-mxc：为 DeepSeek Harness 提供 MXC 进程隔离的沙箱提供方
bitsmug/dsh-sandbox-mxc
为 DeepSeek Harness 提供基于 MXC 的沙箱提供者，在 Windows 上把进程关进容器，按策略限制读写与网络。
dsh-sandbox-mxc 是 DeepSeek Harness 的沙箱提供方，用 MXC（Microsoft eXecution Containers）在 Windows 上为即将启动的命令建立受控边界。它实现 harness 的进程限制接缝，把调用方的 argv 原样交给 wxc-exec 执行，读写根目录沿用沙箱服务导出的策略语义，不重复实现。插件只定位可执行文件、不加载 SDK 原生绑定，因此跟随 harness 自带 Node 运行，并会自动丢弃本机不存在的路径、在 DACL 层级降级处理无法写入的路径。
如何安装
dsh plugin --profile web add github:bitsmug/dsh-sandbox-mxc- 分类
- 开发与运维
- 平台
- DSH Plugin
- 作者
- bitsmug
- 分发方式
- 插件
dsh-sandbox-mxc 核心特性
dsh-sandbox-mxc 仓库简介
它是做什么的？
bitsmug/dsh-sandbox-mxc 是 DeepSeek Harness（DSH）的沙箱提供方插件，用 MXC（Microsoft eXecution Containers）为 DSH 提供进程隔离能力。它实现 harness 的进程限制接缝（ctx.sandbox），把调用方即将启动的 argv 原样包进 wxc-exec 执行，从而在 Windows 上获得受控的读写与网络边界。它不加载 MXC 的 SDK 原生绑定，只定位 wxc-exec 可执行文件，因此不受 SDK 对特定 Node 版本的原生 stdio 限制，跟随 harness 自带的 Node 即可运行。
核心功能
- 进程隔离：把即将 spawn 的 argv 交给 wxc-exec 执行，在 Windows 的 ProcessContainer / AppContainer 后端下运行命令。
- 策略语义复用：读写根目录直接取自 DSH 沙箱服务导出的 writableRoots 与 canonicalPath，read-only / workspace-write 的含义保持单一来源，不在插件里重新实现。
- 路径存在性过滤：构建策略前逐条检查路径是否存在，自动丢弃本机不存在的路径，避免 MXC 因无效路径拒绝整份策略。
- DACL 降级处理：在 appcontainer-dacl 层级无法为某路径写入 DACL 时，丢弃该路径并打印原因、缓存判定结果，而不是让命令整体失败。
- 可配置的 wxc-exec 定位：依次从已安装的 MXC SDK、配置项 wxcExecPath、环境变量中解析可执行文件位置。
怎么使用这个插件？
在 DSH 中启用后，它作为 dsh-sandbox-local 的同级提供方，通过 harness 常规的 bundle-patch 层被选中，之后所有经沙箱接缝启动的命令都会走 MXC 容器。使用前需确认运行在 Windows 上，且 harness 已挂载 sandbox 服务。若 pwsh 工具指向 Store/MSIX 版本，需把执行器的 pwshPath 改为非打包版 PowerShell（例如官方 ZIP 解压到固定目录），并把该 shell 自身的安装目录加入 readonlyPaths，否则容器内会因无法解析当前可执行文件路径而失败。工作区写入被允许，策略外的写入与读取被拒绝，出站网络默认阻断；base-container 层级需要 Windows 11，Windows 10 只能使用 DACL 层级。
报错怎么排查？
- 提示目标可执行文件是打包（MSIX）应用：MXC 容器无法启动打包应用，按官方说明改用非打包版 PowerShell，并把其安装目录加入只读路径列表。
- 提示无法解析当前可执行文件完整路径：说明该 shell 的安装目录在容器内不可读，把它列入 readonlyPaths 后重试。
- 提示 DACL 回退需要写 DACL 权限：属于 appcontainer-dacl 层级的权限限制，插件会丢弃该路径并打印原因，可检查该卷是否属于其他 SID，或改用无需 DACL 操作的 base-container 层级。
- 策略被整体拒绝：通常是路径列表中混入了本机不存在的路径，插件已做存在性过滤，可核对配置中手工添加的路径。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：bitsmug/dsh-sandbox-mxc。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
