buhuikongpan/dsh-win-gitbash

Plugin插件 Native原生 ⭐ 13 MIT Dev Workflow开发与代码工作流

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 许可证开源,可免费使用和修改。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 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 精选列表(🛠️ 工具与能力) Awesome 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.exe
    • C:\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 →

← 上一个 Prev dsh-dock 下一个 Next dsh-kanban →