dsh-unsandboxed-winbash
在 Windows 上为 dsh 添加 Git Bash (MSYS2) 工具。Git Bash 无法在 harness 文件沙箱中启动（其 MSYS 运行时需要一个受限令牌拒绝提供的命名管道），因此此工具会在沙箱外生成它，并在自身描述中说明这一点。pwsh、权限预设和 fs 工具保持其沙箱不变。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-unsandboxed-winbash@0.1.3Unsandboxed Winbash 以 dsh-unsandboxed-winbash 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Windows 上的 Git Bash（MSYS2）工具插件。它向会话新增一个 winbash 工具，直接以 Git for Windows 的 bash 执行命令并修好 MSYS 的 PATH；命令在文件沙箱之外执行，工具描述也写明了这一点。
Windows 上 dsh 不提供任何 bash 工具：@deepseek-ai/dsh-base 在 win32 上同时禁用了 dsh-bash-sandbox 与 dsh-tool-bash。手工打开也无效，因为 Windows 沙箱装不下 MSYS2——受限 token 拒绝创建 MSYS 信号处理所需的命名管道。以下为 Windows 11 + dsh 0.1.5-rc.1 的沙箱内实测：
| 尝试 | 结果 |
|---|---|
bash -c（PATH 解析到 C:\Windows\System32\bash.exe） | Bash/Service/CreateInstance/E_ACCESSDENIED |
wsl.exe -e bash -c | Wsl/Service/CreateInstance/E_ACCESSDENIED |
C:\Program Files\Git\usr\bin\bash.exe -c | fatal error - couldn't create signal pipe, Win32 error 5 |
winbash 工具：以 bash -c 执行命令，返回 stdout、stderr 与退出码；非零退出按结果上报，不作为工具错误。usr\bin\bash.exe（真实 MSYS2）优先于 bin\bash.exe 包装器，按 Git for Windows 的常见安装位置查找；bashPath 可显式指定。usr\bin、mingw64\bin、cmd 前置。Windows 的 PATH 通常只有 Git\cmd，不前置时 ls、grep、sed、awk、find、sleep、wc 全部 command not found。maxOutputBytes 窗口，超出部分写入 spill 文件并在结果里给出路径；多字节边界不会被截断成乱码。@deepseek-ai/dsh-subprocess 的 scrubbedParentEnv，只转发 dshEnv 与 Git 需要的变量。taskkill /T /F）。Windows 上子进程被杀后 stdio 管道不保证关闭，因此在 exit 上结算，并用 drainMs 有界排空。run_in_background 走宿主的 ctx.jobs 注册表，可增量读取输出。bash：Windows 上它解析到 WSL shim，是另一个 shell。# 从 npm 安装并注册到 web profile（推荐）
dsh plugin --profile web add dsh-unsandboxed-winbash
# 仅下载 npm package
npm install dsh-unsandboxed-winbash
# 或从 GitHub 安装
dsh plugin --profile web add github:xswt442-cmd/dsh-unsandboxed-winbash
包内声明了 dsh.bundle，bundle 补丁自行挂载工具行，无需手工改 cordis.patch.yml。安装后重启 DSH Web 生效。
- insert:
- id: tool-winbash
name: dsh-unsandboxed-winbash/tool
config:
bashPath: '' # 显式指定 Git Bash 路径（默认自动发现）
gitPathPrefix: true # 把 Git 的 usr\bin / mingw64\bin / cmd 前置到 PATH
extraPath: '' # 额外 PATH 前缀，';' 分隔（排在最前）
drainMs: 250 # 子进程退出后等待输出排空的上限
timeoutMs: 120000 # 命令默认超时
maxTimeoutMs: 600000
maxOutputBytes: 64000
maxSpillBytes: 67108864
enableRunInBackground: true
Git Bash 自动发现顺序：%ProgramFiles%\Git\usr\bin\bash.exe → %ProgramFiles%\Git\bin\bash.exe → %LOCALAPPDATA%\Programs\Git\usr\bin\bash.exe → %ProgramFiles(x86)%\Git\...。找不到且未配置 bashPath 时，只在调用 winbash 时报错，挂载本身不失败。
sandbox_permissions 升级面——没有可升级的起点。pwsh、权限预设、/permission 命令与 fs 工具仍受各自的沙箱与审批策略约束。fs 工具。*KEY*、*TOKEN*、*SECRET*、*PASSWORD*）不传给子进程；dshEnv 与 Git 需要的变量除外。| 项目 | 要求 |
|---|---|
| 平台 | Windows（win32） |
| DSH | >=0.1.5-rc.1 |
| Node.js | >=20 |
| 依赖 | Git for Windows（提供 Git Bash） |
其他平台不需要本插件：dsh-tool-bash 与 dsh-bash-sandbox 在非 win32 上默认启用。
test/exec.test.mjs 会启动真实 Git Bash 并写 spill 文件，必须在非沙箱 shell 中运行。修改后运行：
npm test # 纯单元，沙箱内亦可
npm run test:e2e # 需要非沙箱 shell
npm run docs:check
npm pack --dry-run