dsh-win-mingw
把 Windows 上 DSH 的默认 shell 工具从 PowerShell 换成 Git Bash。
仓库：https://github.com/Scorpiour/dsh-mingw
Git for Windows 本身就自带一套 MinGW64 用户态（bash、coreutils、git、编译器工具链都在其中），
所以这里不需要单独安装 MinGW 或 MSYS2：插件直接用 Git 自带的
C:\Program Files\Git\bin\bash.exe，并把它所在的目录放到子进程 PATH 最前面。
uname -s 会显示 MINGW64_NT-...，uname -o 是 Msys，正是 Git for Windows 内嵌的 MinGW64 环境。
装好之后，新会话里的模型看到的是 bash 工具，而不是 pwsh。命令通过 bash -c 执行，
因此不再经过 PowerShell 的 cmdlet 拦截、$env: 变量语法、反引号转义和控制台代码页：
- 引号、反斜杠、
$、反引号、换行都按 POSIX/bash 规则解析；
- stdout / stderr / 重定向文件都是 UTF-8 字节；
- 托管变量是
$DSH_HOME、$DSH_PROFILE、$DSH_PROFILE_DIR、$DSH_SESSION_ID、$DSH_SHELL；
- 每次调用仍然是新进程，工作目录、超时、后台 job、输出截断和沙箱行为沿用 DSH 的
@deepseek-ai/dsh-bash-sandbox 机制。
安装前提
- Windows。
- Git for Windows（默认
C:\Program Files\Git）。Git 自带的 MinGW64 bash 就是目标 shell；
不需要 C:\msys64，也不需要把 bash 加到系统 PATH。
- DSH
0.2.1-rc.2 系列（engines.dsh 限定在 >=0.2.1-rc.2 <0.3.0）。
自动探测顺序：常见 Git 安装目录 → git --exec-path 反推出的 Git 根目录 → PATH 里的
bash.exe。最后一种会跳过 C:\Windows\System32\bash.exe（WSL 启动器），并运行一次
uname -s; uname -o 确认选中的确实是 MinGW/MSYS；便携版 Git、scoop、非标准目录都能通过
git --exec-path 或 MINGW_BASH 找到。
安装
从 GitHub 安装（推荐）
在 DSH 的插件管理器里：
plugin_manager action=install_bundle target=github:Scorpiour/dsh-mingw
或者从 CLI：
dsh plugin --profile web add github:Scorpiour/dsh-mingw
需要固定发布版本时使用 tag：
dsh plugin --profile web add github:Scorpiour/dsh-mingw#v0.1.1
从本地目录安装（开发）
在克隆目录或源码目录中直接安装：
plugin_manager action=install_bundle target=<克隆目录>
dsh plugin --profile web add <克隆目录>
安装会改写三个 preset 定义（standard、ptc 和 cordis），不动宿主现有的 PowerShell
executor。现有会话保持原样；新建会话才会使用 MinGW bash。minimal preset（持久
pwsh）未改动。
验证
新建一个会话，让模型运行：
uname -o; pwd; printf '中文\n'; echo "$DSH_PROFILE"
command -v pwsh || echo no-pwsh
command -v bash
期望看到：
Msys（不是 GNU/Linux）；- 当前目录的 POSIX 形式，例如
/e/Develop/dsh-win-mingw；
- 正常输出
中文；
DSH_PROFILE 为当前 profile；pwsh 不存在；bash 解析到 Git/MSYS 的路径。
配置
执行器行在 cordis.patch.yml 的 mingw-shell 下，可用字段：
| 字段 | 默认 | 含义 |
|---|
bashPath | 自动探测 | 显式指定 bash.exe，也可以指定包含 bash.exe 的目录 |
verifyBash | true | 是否运行 uname 验证选中的 shell 是 MinGW/MSYS |
pathPrepend | [] | 追加到子进程 PATH 的 Windows 目录（位于 bash 目录之后） |
优先级：bashPath > MINGW_BASH 环境变量 > 常见 Git/MSYS2 安装位置 >
git --exec-path 反推的 Git 根目录 > PATH。
显式值不可用时会直接报错，不会悄悄换用别的 bash。
MINGW_BASH 对每个命令生效，改环境变量不需要重装 bundle。例如 Git 装在非标准位置：
$env:MINGW_BASH = 'D:\PortableGit\bin\bash.exe'
如果 Git/MSYS 装在非标准位置，或用的是 scoop / 便携版，优先设置 MINGW_BASH。
它是怎么接进去的
cordis.patch.yml 覆盖 preset-standard、preset-ptc 和 preset-cordis 的完整 config，
把原来的两行 tool-bash / tool-pwsh 换成：
- 非 Windows：仍然挂载原来的
@deepseek-ai/dsh-tool-bash（宿主 bash executor）；
- Windows：挂载一个
isolate: { shell: true } 的 group，里面依次是
MingwBashExecutor、@deepseek-ai/dsh-tool-bash、MinGW 提示段。
因为 shell 服务被隔离在 group 里，宿主由 @deepseek-ai/dsh-pwsh-sandbox 提供的
PowerShell executor 不会被替换。旧会话和 minimal 仍然能用原来的 PowerShell
工具，不会因为这次安装而坏掉。
-
executor.js — MingwBashExecutor extends SandboxBashExecutor：只重写 resolve()，
把 PATH 改成 Git Bash 目录优先，并固定 TERM/NO_COLOR/UTF-8/Python 相关变量。
沙箱、超时、后台 job、输出上限全部继承。preset 行引用 @local/dsh-win-mingw/executor
这个独立入口，避免热更新时复用旧的模块代。
-
index.js — 包根入口，转发到 executor.js。
-
mingw.js — 探测和验证 bash；也是独立测试的入口。
-
prompt.js — 一小段系统提示，放在 bash 工具说明之后（order 1005），告诉模型这是
Git for Windows 自带的 MinGW64 bash，而不是 PowerShell。
-
scripts/build-patch.mjs — 从 DSH checkout 的 @deepseek-ai/dsh-web-app preset 文件
重新生成 cordis.patch.yml。升级 DSH 后重跑：
node scripts/build-patch.mjs
默认读取 DSH_CHECKOUT，否则自动寻找同级的 ../deepseek-harness；也可以显式传入
checkout 路径。脚本共用 scripts/dev-paths.mjs 的探测逻辑。
测试
node --check index.js
node --check executor.js
node --check prompt.js
node --check mingw.js
node tests/mingw.test.mjs
node tests/import.test.mjs
node tests/executor.test.mjs
tests/import.test.mjs 用 dev-only 的 resolve hook 模拟宿主对 @deepseek-ai/* 的
runtime resolution；tests/executor.test.mjs 则挂载真实的
@deepseek-ai/dsh-subprocess-local、@deepseek-ai/dsh-sandbox-local、
@deepseek-ai/dsh-sandbox-policy 和本执行器，实际跑一条 bash -c 命令，验证
Msys、POSIX 路径、UTF-8 中文和 DSH_* 注入。tests/ 和 scripts/ 不包含在发布用的
files 里。
tests/import-live-resolution.mjs 和 tests/group-mount.test.mjs 需要真实的 DSH 源码
checkout 和已安装 profile。默认会寻找同级的 ../deepseek-harness，profile 默认是
~/.dsh/profiles/web；也可以用环境变量覆盖。找不到时脚本会直接报出缺失的路径，而不是
静默跳过：
$env:DSH_CHECKOUT = 'D:\src\deepseek-harness'
$env:DSH_PROFILE_DIR = "$env:USERPROFILE\.dsh\profiles\web"
node tests/import-live-resolution.mjs
node tests/group-mount.test.mjs
DSH_CHECKOUT 也用于 scripts/build-patch.mjs。
排错：agent-preset/invalid ... never start
这个错误表示 Loader 没能导入 preset 里的模块；UI 只显示 audit 的 never started，
具体的导入错误在启动 DSH 的终端里（Loader 的 logger.error）。
最常见原因：DSH 进程在插件文件更新前已经缓存了 package.json / 模块代。./executor
是后加的导出，旧进程会把它当成不存在的包路径，于是 mingw-shell 这一行没有 fiber。
处理：重启 DSH 一次，不要重装。然后新建会话。
在一个新进程里验证模块可导入：
node tests/import-live-resolution.mjs
应输出：
imported: [ 'Config', 'MingwBashExecutor', 'default' ]
同一个脚本还会打印当前 profile 解析出的 linked root；再用
node tests/group-mount.test.mjs 可以验证 isolate: { shell: true } 的 group
能正常启动 mingw-shell 行。
已知限制
workspace-write 模式下，MinGW bash 本身和 Git 的 /tmp 与 Windows ACL 私有临时目录
的组合还没有做端到端验证。当前 profile 默认是 danger-full-access；如果切到
workspace-write 后遇到临时文件写入被拒绝，请先切回 danger-full-access 或反馈。- 命令里显式调用
powershell / cmd /c 时，仍然由它们执行。
minimal preset 保持原样，仍是持久 pwsh。- 旧会话不会热切换；需要新建会话。
- 如果刚安装后当前进程仍缓存了旧的模块代，重启 DSH 一次即可；新会话会使用
@local/dsh-win-mingw/executor 这个独立入口，不受包根旧缓存影响。
- 依赖
@deepseek-ai/dsh-bash-sandbox / dsh-bash-local 的当前 API，DSH 升级后先跑
测试和 build-patch.mjs，再安装更新。
License
MIT，见 LICENSE。
