buhuikongpan/dsh-win-gitbash
Windows 的 Git Bash 工具插件(替代 pwsh 和仅支持 WSL 的 bash)
Project Overview项目介绍
This is a native DSH tool plugin built exclusively for DeepSeek Harness, targeting Windows systems. It was created to address two common pain points with DSH’s built-in command line tools on Windows: the default pwsh tool is slow to start and lags during regular execution, while the built-in bash tool requires a WSL environment that many Windows users do not have installed on their machine. This plugin replaces both options with the Git Bash that ships alongside Git for Windows, and registers it as a separate callable gitbash tool directly within DSH’s tool system.
It is intended for DSH users who develop on Windows and already have Git for Windows installed on their system. Once the plugin is installed and enabled in your DSH profile, the AI agent can call the gitbash tool to run any shell command just like it would with the built-in pwsh or bash tools. All core behaviors, from permission escalation prompts to background run flags to working directory resolution, align exactly with DSH’s native tools, so users will barely notice any difference when switching. It also supports DSH’s built-in security features including file sandboxing, timeout control, output truncation, and background task management.
The only required dependency for the plugin is an existing Git for Windows installation; the plugin automatically detects bash.exe in all common install paths including default Program Files locations, Scoop installations, and custom paths in the system PATH. It is distributed as an npm package under the name dsh-tool-gitbash, and can be installed via the DSH command line, the DSH web GUI plugin market, or manually by adding the package to DSH’s node_modules. After installation, you just need to enable it in your DSH composition profile and restart DSH to start using it. The project is open source under the permissive MIT license.
这是一个专为 DeepSeek Harness (DSH) 开发的原生工具插件,面向 Windows 系统,用于解决 DSH 原生命令行工具在 Windows 平台上的痛点问题。DSH 自带的 pwsh 工具启动速度慢、执行卡顿,原生 bash 工具又必须依赖 WSL 环境,不少 Windows 用户没有安装该环境,无法正常使用。本插件用 Git for Windows 自带的 Git Bash 替代上述工具,在 DSH 中注册为独立的 gitbash 工具。
主要面向日常使用 Windows 搭配 Git for Windows 开发的 DSH 用户,能够给 AI 模型提供一个启动速度快、无额外环境依赖的 bash 命令执行环境。安装启用插件后,AI 即可通过调用 gitbash 工具执行任意 shell 命令,行为逻辑与 DSH 原生 pwsh、bash 工具对齐,切换使用几乎没有感知差异。它支持文件沙箱模式、超时控制、输出截断和后台任务,符合 DSH 的安全规范。
唯一的前置依赖是已经在 Windows 上安装 Git for Windows,插件会自动探测常见安装路径下的 bash.exe,找不到的话也可手动配置路径。它以 npm 包 dsh-tool-gitbash 发布,可通过 DSH 命令行、插件市场图形界面或手动安装,安装后在 DSH 组合中启用即可使用。项目采用 MIT 许可证开源,可免费使用和修改。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-win-gitbash(buhuikongpan/dsh-win-gitbash)
仓库:https://github.com/buhuikongpan/dsh-win-gitbash
本站详情页:https://www.yhbd.top/plugins/buhuikongpan-dsh-win-gitbash/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 13 · 最近提交 2026-10-02 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 13 stars - an early-stage project星标 13,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin add dsh-tool-gitbash
把 buhuikongpan/dsh-win-gitbash 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-win-gitbash
🏅 已收录于 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 上有两个原生命令工具的痛点:
- ⚠️ 原生的 pwsh 工具:Windows 上启动慢、执行卡顿,日常命令体验差
- ⚠️ 原生的 bash 工具:依赖 WSL,Windows 端没有 WSL 环境就用不了
本项目为 DSH 提供一个第三个选项:直接依赖 Git for Windows 自带的 bash
(C:\Program Files\Git\bin\bash.exe),以 DSH 工具插件形式注册为 gitbash
工具。唯一的前置依赖就是装一个 Git for Windows,装完即得一个原生、快速、
可用的 bash 环境,供 AI 模型(Agent)在 Windows 上执行 shell 命令。
- 🚀 快:Git Bash 启动远快于 PowerShell,无 WSL 层开销
- 🪟 原生:不需要 WSL,直接跑在 Windows 上,路径同时支持
C:\...与/c/... - 🔌 插件化:以 DSH 工具插件形式注册为
gitbash工具,与pwsh、bash平级 - 🧯 安全:支持文件沙箱模式、超时控制、输出截断与后台任务
与原生 pwsh / bash 对齐
本工具在行为上向 DSH 原生 pwsh、bash 工具看齐,替代切换几乎无感:
run_in_background参数仅在enableRunInBackground开启时暴露;关闭时描述提示"后台执行不可用",与原生一致- 沙箱受限时的升级提示 + 权限提问(
sandbox_permissions+justification双条件触发,经由approveEscalation+ctx.approval)与原生完全一致 - 工作目录解析与原生
bash一致:沙箱根优先,否则会话 cwd 经canonicalPath规范化
差异仅在实现层:原生依赖
ctx.shell执行器;本工具作为ctx.subprocess消费者直接调用 Git for Windows 自带 bash。调用卡片与原生 pwsh 保持一致(复用 DSH 内置终端卡片)。
依赖
必须安装 Git for Windows(提供 bash.exe):
- 下载:https://git-scm.com/download/win
- 安装后请确认以下任一路径存在(工具会自动探测):
C:\Program Files\Git\bin\bash.exeC:\Program Files\Git\usr\bin\bash.exe- scoop 安装的 Git(跟随
SCOOP环境变量定位,默认C:\Users\<用户名>\scoop\apps\git\current\bin\bash.exe) - 任意 PATH 目录下的
bash.exe(如自定义盘符安装、便携版等;System32下的 WSL 启动器会被跳过)
安装
本插件以 npm 包 dsh-tool-gitbash 发布,声明了 dsh.bundle manifest,可直接通过 DSH 插件系统安装。
方式一:命令行安装(推荐)
dsh plugin add dsh-tool-gitbash
安装命令会自动处理
@deepseek-ai/*peer 依赖;装完在 DSH 组合(composition)/ profile 中启用该 bundle,重启后模型即可获得gitbash工具。
方式二:dsh-market 图形界面
在 DSH Web 设置 → 插件市场(dsh-market)中搜索 dsh-tool-gitbash,一键安装。
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
esengine/DeepSeek-Reasonix
strukto-ai/mirage
chuspeeism/dashi-taskboard
Aisland-SJL/dsh-worktable
ccch1mneyyy/working-activity
zhoushoujianwork/easyeda-agent
pulseaiclub/phi
Ikalus1988/MisakaNet