Windows Bash 工具 wjunhere/dsh-bash

dsh-bash

给 Windows 上的 DSH（DeepSeek Harness） 提供一个 bash 工具，和原生 pwsh 平级可用。

它调用 Git for Windows 自带的 bash.exe：不依赖 WSL、不用装额外环境，模型拿到的就是一个标准的 bash -c。

为什么

- DSH 原生 bash 工具在 Windows 上依赖 WSL，没装 WSL 就用不了；
- 原生 pwsh 能用，但启动慢、日常命令体验不如 bash；
- 装一个 Git for Windows 就有了完整 bash + coreutils + git，插件把它接进 DSH。

依赖

只需要 Git for Windows（提供 bash.exe）。

插件会按顺序自动探测，找到第一个可用的即可：

1. C:\Program Files\Git\bin\bash.exe、...\usr\bin\bash.exe
2. 用户级安装 %LOCALAPPDATA%\Programs\Git\...
3. scoop：%SCOOP%\apps\git\current\bin\bash.exe
4. 从 PATH 里的 git.exe / Git\cmd 目录反推安装根目录
5. PATH 里的 bash.exe（System32 下的 WSL 启动器会被跳过）

都找不到时会报错并列出检查过的路径 —— 不会静默降级。

安装

从 npm 安装（推荐）：在 DSH 插件管理器里安装 npm 包 @wjunhere/dsh-bash，它会装进当前 profile，重新加载后模型即可见 bash 工具。

- npm 页面：<https://www.npmjs.com/package/@wjunhere/dsh-bash>
- 要求 DSH 0.2.1-rc.2（运行时包取自 npm 的 next 标签）

改代码或本地开发：

git clone https://github.com/wjunhere/dsh-bash.git
cd dsh-bash
npm install

然后用插件管理器安装这个目录（等同 plugin_manager 的 install_bundle）。

DSH 从软链接的真实路径加载插件，本地目录安装时 npm install 不能省。

配置

在 profile 的 cordis.patch.yml 里给插件行加 config：

- id: dsh-bash
name: '@wjunhere/dsh-bash'
config:
自动探测不到、或想指定某个 Git 安装时 bashPath: 'D:\software\git\Git\bin\bash.exe' 关闭后台任务 / 超时转后台 enableRunInBackground: true promoteOnTimeout: true

| 配置 | 默认 | 说明 |
| bashPath | 自动探测 | bash.exe 绝对路径；填错直接报错 |
| enableRunInBackground | true | 是否暴露 run_in_background 参数（关闭后也不再有超时转后台） |
| promoteOnTimeout | true | 命令超时后不杀，转成后台 job 继续跑 |

工具参数

| 参数 | 说明 |
| command | 要执行的 bash 命令（bash -c） |
| description | 一句话说明命令用途（界面展示） |
| timeoutMs | 超时，默认 120s，上限 600s；超时后默认转后台 |
| workdir | 工作目录，默认会话目录；相对路径按会话目录解析 |
| run_in_background | 后台运行，立即返回 jobId，用 job_output / job_kill 收集和停止 |
| sandbox_permissions / justification | 沙箱拒绝后一次性提权重试（组合里配置了沙箱时可用） |

输出与原生 pwsh / bash 一致：stdout、[stderr] 段、[exit code: N] 等标记；超长输出截断到尾部并给出完整输出文件路径。

与 Git Bash 有关的注意点

Git Bash 是 MSYS2 环境，不是 Linux：

- 路径是 /c/...（不是 /mnt/c），/tmp 在 C 盘；Windows 路径 C:\... 也能直接传；
- ln -s、chmod、执行位基本无效；
- $USER/$LOGNAME 是空的，用 $USERNAME；
- 调原生 Windows 程序时，以 / 开头的参数会被 MSYS 改写，必要时加 MSYS2_ARG_CONV_EXCL='*'；
- cmd 内建命令输出可能是 GBK，Windows 程序输出带 \r\n。

更多细节见 docs/git-bash-notes.md。

开发

npm install
npm test # 单测：bash.exe 探测逻辑

- 架构、DSH API 约定与调试方法见 AGENTS.md；
- 原生 bash/pwsh 行为对齐记录见 docs/parity.md；
- DSH 0.2.1-rc.2 宿主 API 审计见 docs/api-contract.md；
- 独立评审记录见 docs/review.md，实测记录见 docs/verification.md。

许可证

MIT，见 LICENSE。