yunuo110/dsh-gitbash

dsh-gitbash

English · 中文

DeepSeek Harness（DSH）bundle 插件：不新增模式、不新增工具，在 Windows 上把 DSH 现有的 bash 工具直接指向 Git for Windows Bash，并隐藏/禁用 pwsh，让模型自然使用 Git Bash。

参考了 Reasonix 的做法。

设计目标

- 不是 preset 模式：不需要选择新模式，原有模式名不变。
- 不是额外工具：不注册 gitbash 工具，模型看到的还是 DSH 原生的 bash 工具。
- 默认 Git Bash：Windows 上 bash 工具通过 Git\bin\bash.exe -lc  执行。
- 隐藏 PowerShell：Windows 上 pwsh 从 prompt 中隐藏，并且即使旧缓存尝试调用也会被 guard 拒绝。
- 动态描述：bash 工具描述被改写为 Git Bash/MSYS2 规则，模型按 bash 语法写命令。
- Windows 专用：非 Windows 上插件 no-op，不影响原生 bash。

目录结构

dsh-gitbash/
├── package.json
├── cordis.patch.yml        # 插入 dsh-gitbash，禁用 pwsh，启用 bash
├── lib/
│   ├── index.js            # shell provider + prompt 改写 + guard
│   └── gitbash-core.mjs    # 纯函数：路径探测/argv/渲染/校验
└── test/
└── gitbash-core.test.mjs

安装（web profile）

在插件仓库根目录执行。如果你是从 GitHub clone 的，先进入 clone 出来的目录：

cd dsh-gitbash

新版 DSH 的 dsh plugin 命令会把参数转发给 pnpm。安装前请先确认本机已有 pnpm（例如执行 pnpm --version）；没有的话先运行 npm install -g pnpm。

方式 A：dsh 已经在 PATH 里

直接执行：

dsh plugin --profile web add .

方式 B：平时用 npx @deepseek-ai/dsh web 启动 DSH

很多人的 DSH 不是全局安装的，dsh 命令并不在 PATH 里。如果你平时是这样启动的：

npx @deepseek-ai/dsh web

那么安装插件也要通过 npx 调用：

npx @deepseek-ai/dsh plugin --profile web add .

注意：这条命令要在插件仓库根目录下执行，因为 add . 的 . 指向当前目录。

如果你希望以后能直接使用 dsh 命令，可以先把 DSH 装到全局：

npm install -g @deepseek-ai/dsh

之后就能直接：

dsh plugin --profile web add .

安装后

安装会：

1. 把 dsh-gitbash 作为 bundle 加入 ~/.dsh/profiles/web；
2. 在 Windows 上提供一个 Git Bash shell executor；
3. 重新启用 host 层 tool-bash；
4. 禁用 pwsh-sandbox / tool-pwsh。

然后完整重启 DSH。之后新建会话和旧对话都会使用同一个 bash 工具，但它实际执行 Git Bash。

GitHub 安装（推荐）

如果你不想依赖本地源码目录，可以直接从 GitHub 安装：

dsh plugin --profile web add github:yunuo110/dsh-gitbash

如果你之前装过本地版本，先移除再安装：

dsh plugin --profile web remove dsh-gitbash
dsh plugin --profile web add github:yunuo110/dsh-gitbash

建议锁定版本，避免以后仓库变更悄悄影响你（当前最新 tag：v0.1.1）：

dsh plugin --profile web add github:yunuo110/dsh-gitbash#v0.1.1

这样 profile 里保存的是 GitHub 依赖，而不是本地 link 依赖，DSH 更新不会把它刷掉。

使用

- 新会话或旧对话里让模型执行 shell/git 命令，例如“查看 git 状态”“运行 npm test”。
- 模型看到的是 bash 工具，描述会说明它运行 Git Bash。
- Windows 上模型看不到 pwsh，即使旧缓存尝试 pwsh 也会被拒绝并提示改用 bash。
- 如果当前会话沙箱不是完全访问，第一次调用可能失败并提示升级。按提示让模型用：
{
"command": "git status",
"description": "查看 git 状态",
"sandbox_permissions": "danger-full-access",
"justification": "Git Bash 无法在受限沙箱中启动，需要完全访问以执行 git 状态检查。"
}

或直接在设置里把会话权限切到完全访问。

配置

默认自动探测 Git Bash：GIT_BASH 环境变量 → Program Files / Program Files (x86) / ProgramW6432 / LocalAppData / Scoop → PATH（排除 System32 的 WSL bash）。

要固定路径，在 profile 自己的 cordis.patch.yml（~/.dsh/profiles/web/cordis.patch.yml）中覆盖插件行：

- id: dsh-gitbash
config:
shellPath: 'C:\Program Files\Git\bin\bash.exe'
timeoutMs: 120000
maxTimeoutMs: 600000
maxOutputBytes: 64000
maxSpillBytes: 67108864
graceMs: 3000

| 字段 | 默认 | 说明 |
| --- | --- | --- |
| shellPath | 自动探测 | 固定 Git Bash 路径 |
| timeoutMs | 120000 | 单条命令默认超时 |
| maxTimeoutMs | 600000 | 超时上限 |
| maxOutputBytes | 64000 | stdout 内存保留字节数，溢出写入 spill |
| maxSpillBytes | 67108864 | spill 文件上限 |
| graceMs | 3000 | SIGTERM → SIGKILL 宽限 |

工具行为

- 每次调用都是新的非交互式 bash.exe -lc：不保留 cd / export / alias 状态。
- 使用 POSIX/bash 语法：$VAR、export、ls、grep、find、sed、awk、管道、&&/||、命令替换。
- 路径建议：/d/WorkSpace 或 C:/WorkSpace；避免未加引号的反斜杠。
- 环境变量：$VAR / ${VAR}，不要用 PowerShell 的 $env:VAR。
- 支持 DSH 原 bash 工具的 workdir、timeoutMs、run_in_background、sandbox_permissions + justification。

Token 对比

只对比原版 DSH 配置与本插件的差异：

| 配置 | 可见 shell 工具 | 额外系统提示 | 每轮 token 影响 |
| --- | --- | --- | --- |
| 原版 DSH（Windows） | pwsh | 无 | 基准 |
| 本插件 | bash（实际执行 Git Bash） | 无 | 基本持平（只是用 bash schema 替换 pwsh schema，没有新增额外工具） |

测试

npm run check

当前测试覆盖：Git Bash 路径探测、argv 构造、环境变量合并、参数校验、超时钳制、workdir 解析、结果渲染、配置校验、shell 工具过滤。

兼容性

- DeepSeek Harness 0.1.2-rc.1（兼容 0.1.0-rc.6 起的同一套 shell/工具 seam）
- Windows + Git for Windows（MSYS2）
- Node.js 22.19+

说明

本工具完全由 DSH 制作而成。