deepseekplugins

DeepSeek Harness plugin

dsh-bash-win

Windows-first bash tools for DeepSeek Harness: Git Bash and WSL2 bash with bwrap sandbox, approval mode, and background jobs.

Tools & Capabilities
Jump to install

Source facts

Repository
zimzaza4/dsh-bash-win
Latest update
Aug 14, 2026
Category
Tools & Capabilities
GitHub stars
8
Format
bundle
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/zimzaza4/dsh-bash-win
Plugin: dsh-bash-win
Author: zimzaza4

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-bash-win

在 Windows 上为 DeepSeek Harness(DSH)提供 Git Bash 与 WSL2 两个 bash 工具的 Cordis 插件。

这个项目解决什么

  • DSH 在 Windows 上禁用了官方 bash 工具(只有 pwsh)

本插件通过 ctx.subprocess 直接 spawn bash.exe / wsl.exe，绕开受限令牌层， 把 Git Bash 或者 WSL2 带进 DSH，并自建有效沙箱(WSL 内 bwrap)与审批请求。

安全模型

维度机制说明
默认执行无沙箱，全权限git_bash / wsl_bash 默认直接跑，可读写任意路径(绕开沙箱的代价)
沙箱WSL 内 bwrap(sandbox: true)系统目录只读、workspace 可写、/mnt/c 其余只读;越界写入被拒并报 [sandbox: file access denied under workspace-write mode]
审批ctx.approvalrequire_approval: true 执行前弹窗;升权请求(sandbox_permissions + justification)弹窗;ask 策略弹窗、never 自动拒绝

关键概念:

  • 操作路径本身不触发审批——沙箱对越界的处理是"拒绝"(报错，不弹窗);
  • 审批只出现在两处:显式批准模式(require_approval)和越界后的升权请求;
  • 升权阶梯:workspace-write(bwrap 受限)→ danger-full-access(去掉 bwrap)，

走官方 approveEscalation 流程，必须严格加宽且经用户批准。

工具

工具后端UI 标题能力
git_bash本地 Git Bash(MSYS2)Git Bash批准模式(require_approval)、官方沙箱接入(sandbox，Windows 受限模式报 Cygwin 限制)、后台任务
wsl_bashWSL2(Linux)WSL Bashbwrap 真沙箱(sandbox: true)、升权审批(sandbox_permissions + justification)、后台任务

共性能力:

  • 前台执行:timeoutMs 超时终止整个进程树、调用取消
  • 后台任务:run_in_background: true 返回 job id，配合 job_output / job_kill

(非零退出码如实上报，kill 分类为 killed)

  • 输出收集:内存上限 256 KiB，超限截断并落 spill 文件
  • Web 终端卡片:终端图标、可展开输出、退出码状态，与内置 bash/pwsh 卡片一致

支持与限制

Git Bash(git_bash)

  • 自动探测安装位置:C:\Program Files\Git\bin\bash.exe、

C:\Program Files\Git\usr\bin\bash.exe、C:\Program Files (x86)\Git\bin\bash.exe

  • MSYS2 完整语义(管道、重定向、Unix 风格命令)，Windows/Unix 路径混用
  • 每次调用全新进程，状态不跨调用
  • 无文件沙箱:受限令牌下 Cygwin 无法启动，默认以完整权限运行;

sandbox: true 会尝试走 windows-acl 沙箱，受限模式下如实报告 runner 失败 (这是平台限制，不是绕过)

  • 适合:需要 Windows 侧工具、msys 语义、或"全权限 + 人工批准把关"的场景

WSL2(wsl_bash)

  • 自动探测 C:\Windows\System32\wsl.exe;发行版默认 Ubuntu(可指定)
  • --cd 自动转换 Windows 路径(C:\Users\... → /mnt/c/Users/...)，也可直接传 Linux 路径
  • 真 Linux 环境:apt、gcc、python 等，Linux 退出码语义;以 WSL 默认用户身份运行
  • VM 未启动时首次调用有数秒冷启动延迟(可用 timeoutMs 控制等待)
  • 默认无沙箱(ext4 不受 Windows ACL 约束，Windows 侧沙箱管不住它)
  • sandbox: true 时在 WSL 内用 bwrap 包装命令:系统目录(/usr /lib

/bin /etc 等)只读、/tmp 临时可写、workspace 可写、/mnt/c 其余只读; 要求发行版已安装 bubblewrap(apt install bubblewrap)

  • 实现细节:bwrap 参数逐个传递(避免 wsl.exe 的 Windows→Linux 参数字符串

序列化损坏引号);命令经 base64 编码传递(避免引号注入)

程序检测与配置

定位优先级:插件 config > 环境变量 > 自动探测。

# cordis.patch.yml
- insert:
    - id: tool-bashx
      name: '@zimzaza4/dsh-bash-win'
      config:
        bashPath: 'D:\tools\Git\bin\bash.exe'   # 自定义 Git Bash
        wslPath: 'C:\Windows\System32\wsl.exe'  # 自定义 WSL
        wslDistro: 'Debian'                     # 默认发行版

环境变量:DSH_BASHX_BASH_PATH / DSH_BASHX_WSL_PATH / DSH_BASHX_WSL_DISTRO。

安装

插件已发布到 npm。通过 DSH 官方 dsh plugin 命令安装进 profile(dsh web 对应 web profile)。

从 npm 安装(推荐)

dsh plugin --profile web add @zimzaza4/dsh-bash-win

装完重启 dsh web 生效。包内 cordis.patch.yml(经 dsh.bundle.patch 声明)自动挂载插件行，重启后即可在对话中使用 git_bash / wsl_bash。

验证

  • 重启后新会话中应出现 git_bash / wsl_bash 两个工具;
  • 或用 dsh --profile web --dump-config 确认插件配置层已挂载;
  • 若工具未出现，多半是安装后没有重启 dsh web。

卸载

dsh plugin --profile web remove @zimzaza4/dsh-bash-win

然后重启 dsh web。

注意事项

  • 改代码后必须重启 DSH——本插件的 HMR 热加载在此部署中不可靠，重启是唯一

可靠加载路径;

  • 通过 UI 卸载插件会删除 profile 的 cordis.patch.yml;重新安装时重建该文件即可

依赖

  • @deepseek-ai/dsh-tools、@deepseek-ai/dsh-sandbox(peer，宿主提供)
  • 运行时服务:tools(硬依赖);subprocess / fs / timer / jobs /

approval / sandbox / sandboxPolicy(可选 ctx.get)

  • 本机程序(按需):Git for Windows、WSL + 发行版;沙箱模式另需发行版内 bubblewrap

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category