dsh-msys2-bash-executor

English

这是一个面向 Windows 的独立 DeepSeek Harness Bash 执行器。它可以通过 MSYS2/UCRT64 Bash 或 Git Bash 执行 agent 的 shell 调用，并在 DSH Web 设置页提供可视化配置。

本包不依赖 dsh-anchored-standard 或 dsh-anchored-standard-bash。插件会在隔离的 shell realm 中注册一个全局 Bash 工具，然后按全局开关或 preset ID 决定哪些新会话可以看到它。

功能

• 通过 DSH 的受管 subprocess 服务直接传递 argv，不使用 Node 的 shell: true。
• 自动检测 MSYS2、UCRT64、Git Bash 和 PATH 中的 bash。
• 可配置 Bash 路径、参数、PATH 前置目录和环境变量。
• 支持前台超时、取消、输出限制、溢出文件、后台任务、增量读取和进程树终止。
• 可为 Standard、Code、Cordis、Minimal 和自定义 preset ID 分别启用。
• 可用一个全局开关为所有预设启用 Bash。
• Minimal 启用时会覆盖其内置持久 Bash 工具，绕过 Windows 不支持的 terminal inspection 路径。
• 未启用 Bash 的预设仍保留 Host PowerShell provider。

安全说明

本执行器没有沙箱。命令以 DSH 进程的完整用户权限运行，等价于 danger-full-access，不具备默认 PowerShell 沙箱的 Windows ACL 隔离。

请只在可信提示词、可信仓库和可信工具环境中使用。

从本地压缩包安装

目前暂不发布到 npm，可在本地检查并打包：

npm.cmd run check
npm.cmd pack --cache .npm-cache
dsh plugin --profile web add "C:\path\to\dsh-msys2-bash-executor-0.1.1.tgz"

从 GitHub 构建：

git clone https://github.com/3223698962/dsh-msys2-bash-executor.git
cd dsh-msys2-bash-executor
npm.cmd install
npm.cmd run check
npm.cmd pack --cache .npm-cache
dsh plugin --profile web add "C:\path\to\dsh-msys2-bash-executor-0.1.1.tgz"

安装或更新后重启 dsh web。启用范围仅对新建会话生效，运行中的会话会保留创建时的工具集合。

在 DSH Web 中配置

打开“设置”，进入“插件”的可配置插件页，在 MSYS2 / Git Bash 卡片中设置：

• 为所有预设启用 Bash：所有新会话显示 bash 并隐藏 pwsh。
• 按预设启用：关闭全局模式后，可分别控制 Standard、Code、Cordis、Minimal，或填写其他 preset ID。
• Bash 可执行文件：例如 C:\msys64\usr\bin\bash.exe 或 C:\Program Files\Git\bin\bash.exe。
• Bash 参数：命令之前传入的 JSON 数组，通常是 ["-c"]。
• PATH 前置目录：每行一个 Windows 路径。
• 环境变量：值为字符串的 JSON 对象。

UCRT64 典型配置：

Bash 可执行文件：
C:\msys64\usr\bin\bash.exe

PATH 前置目录：
C:\msys64\ucrt64\bin
C:\msys64\usr\bin

环境变量：
{"MSYSTEM":"UCRT64","CHERE_INVOKING":"1"}