dsh-tool-gitbash
用于替代原生 pwsh 的 gitbash：面向模型的 Windows Git Bash 工具（替代 pwsh/WSL-bash）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:buhuikongpan/dsh-win-gitbash#a8b7e0a013bcb1515c620fb5f0a0e69f39b95cd6Tool Gitbash 以 dsh-tool-gitbash 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
🏅 已收录于 Awesome DeepSeek Harness (DSH) Plugin 精选列表（🛠️ 工具与能力）
面向 Windows 的 Git Bash 工具插件（DSH / DeepSeek Harness tool plugin）
Model-facing Git Bash tool for Windows — replaces pwsh / WSL-only bash.
🎯 用于替代原生 pwsh 的 gitbash：Git for Windows 自带的 bash，快、原生、免 WSL。
DSH（DeepSeek Harness）在 Windows 上有两个原生命令工具的痛点：
本项目为 DSH 提供一个第三个选项：直接依赖 Git for Windows 自带的 bash
（C:\Program Files\Git\bin\bash.exe），以 DSH 工具插件形式注册为 gitbash
工具。唯一的前置依赖就是装一个 Git for Windows，装完即得一个原生、快速、
可用的 bash 环境，供 AI 模型（Agent）在 Windows 上执行 shell 命令。
C:\... 与 /c/...gitbash 工具，与 pwsh、bash 平级本工具在行为上向 DSH 原生 pwsh、bash 工具看齐，替代切换几乎无感：
run_in_background 参数仅在 enableRunInBackground 开启时暴露；关闭时描述提示"后台执行不可用"，与原生一致sandbox_permissions + justification 双条件触发，经由 approveEscalation + ctx.approval）与原生完全一致bash 一致：沙箱根优先，否则会话 cwd 经 canonicalPath 规范化ctx.sandboxPolicy / ctx.sandbox 都不在 apply() 期读取。
cordis 并行装载各 plugin row，本插件的 row 可能早于 sandbox-policy 注册；若在 apply()
期就把"本组合是否 confine"定死，工具会永久裸跑（read-only / workspace-write
边界失效）。因此执行期的策略以调用时刻为准，工具 schema 则在 ctx.sandboxPolicy
就绪后重建一次（工具定义在注册时固化，早注册会把"无沙箱"写死成没有
sandbox_permissions 参数）。组合里确实没有 policy 服务时才回退为无沙箱工具。差异仅在实现层：原生依赖
ctx.shell执行器（ctx.shell.sandboxMode由执行器 转述）；本工具作为ctx.subprocess消费者直接调用 Git for Windows 自带 bash， 没有执行器可问，所以自己订阅ctx.sandboxPolicy。 调用卡片与原生 pwsh 保持一致（复用 DSH 内置终端卡片）。
必须安装 Git for Windows（提供 bash.exe）：
C:\Program Files\Git\bin\bash.exeC:\Program Files\Git\usr\bin\bash.exeSCOOP 环境变量定位，默认 C:\Users\<用户名>\scoop\apps\git\current\bin\bash.exe）bash.exe（如自定义盘符安装、便携版等；System32 下的 WSL 启动器会被跳过）本插件声明了 dsh.bundle manifest，可作为 profile bundle 直接安装。
方式一：从 GitHub 安装（推荐，目前唯一可用的远程方式）
⚠️ 包尚未发布到 npm（
dsh-tool-gitbash在 npmjs / npmmirror 上均为 404）， 所以dsh plugin add dsh-tool-gitbash会失败。请用github:形式安装， 并 pin 一个 commit 以便复现：
dsh plugin --profile <你的profile> add github:buhuikongpan/dsh-win-gitbash#<commit-sha>
安装命令会自动处理
@deepseek-ai/*peer 依赖；装完在 DSH 组合（composition）/ profile 中启用该 bundle（把dsh-tool-gitbash加进dsh.profile.bundles）， 重启后模型即可获得gitbash工具。git 托管的插件依赖安装时的
prepare脚本构建，pnpm 默认拦截；若报allowBuilds相关错误，按提示把 pnpm 打印的 key 加进该 profile 的pnpm-workspace.yaml再重试。
方式二：本地目录 / 手动放入 node_modules
node_modules（如
%APPDATA%\npm\node_modules\dsh-tool-gitbash），或用 link: 指向本仓库。@deepseek-ai/cordis、@deepseek-ai/dsh-tools、
@deepseek-ai/dsh-llm、@deepseek-ai/dsh-sandbox、@deepseek-ai/dsh-shell、
@deepseek-ai/dsh-subprocess、@deepseek-ai/dsh-timeout、
@deepseek-ai/dsh-jobs、@deepseek-ai/dsh-shell-env、
@deepseek-ai/dsh-system-prompt、@deepseek-ai/dsh-user-approval、
@deepseek-ai/dsh-agent）；直接依赖 @deepseek-ai/schemastery 会自动安装。gitbash 工具。本插件声明 engines.dsh: ">=0.1.0-rc.6 <0.3.0"，对应的 peerDependencies
全部使用同一区间，因此 DSH 0.1.x 与 0.2.x（含 0.2.0-rc.1 / rc.2）都可加载。
⚠️ 这一步是必须的：DSH 启动时会用
evaluatePluginCompatibility逐个校验 profile bundle 的peerDependencies是否覆盖当前运行时版本。只要有一个@deepseek-ai/dsh-*peer 区间不匹配（例如旧版的^0.1.0-rc.6遇到0.2.0-rc.2），该 bundle 会被整体跳过、cordis.patch.yml不生效， 表现就是「插件装了但模型没有gitbash工具」，并在 stderr 打印skipping profile bundle "dsh-tool-gitbash": Plugin ... is incompatible with dsh ...。 升级 DSH 大版本后若出现此提示，先确认本插件的 peer 区间是否覆盖新版本。
自动探测找不到 bash 时，可通过插件 bashPath 显式配置路径，例如在 cordis.patch.yml 的插件行中：
- insert:
- id: tool-gitbash
name: 'dsh-tool-gitbash'
config:
bashPath: 'C:\Users\me\scoop\apps\git\current\bin\bash.exe'
| 参数 | 说明 |
|---|---|
command | 要执行的 Git Bash 命令（bash -c） |
description | 命令用途的一句话描述（界面展示用） |
timeoutMs | 超时（默认 120s，上限 600s） |
workdir | 工作目录，默认会话目录 |
run_in_background | 后台运行，立即返回 jobId |
sandbox_permissions / justification | 沙箱升级（配置了沙箱时可用） |
dsh-win-gitbash
├── index.js # 兼容入口（重新导出 lib/index.js）
├── lib/
│ ├── index.js # Host 端插件：Git Bash 探测、命令执行、超时/沙箱/后台
│ └── client.js # Client 端：Git Bash 调用卡片 UI（tool.call.toolview）
└── package.json