快速判断

安装前先看这几项

配置资料: 配置资料完整
配置难度: 较高
适合新手: 建议具备相关经验
兼容状态: 当前版本需要复核
验证状态: 源码已审阅，未标记运行实测

本页目录（9）

中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 dsh-gitbash-shell 安装与配置教程 →

功能

这个插件能做什么

在 Windows 上用明确的 Git for Windows bash.exe 替代 PowerShell 执行器，并生成四种 Git Bash Agent Preset。

适合谁

需要Git、版本控制、提交能力的用户。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

Windows 与 Git for Windows（必需）：确认 bash.exe 的绝对路径，不把 System32 的 WSL 启动器当作 Git Bash。
独立测试 Profile（必需）：先在不含敏感凭据的测试工作区验证 Shell。

安装

如何安装 dsh-gitbash-shell

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:KannaKuron/dsh-gitbash-shell#99f2f45fca38

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:KannaKuron/dsh-gitbash-shell#99f2f45fca38
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-gitbash-shell或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-gitbash-shell

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

$DSH_HOME/profiles/web/cordis.patch.yml: 选择物化的 Git Bash Preset、bashPath、超时和 Better Sidebar 联动。

只启用两个 Preset 并指定 Git Bash · yaml。示例中的账号、路径和凭据占位符必须替换，不要提交真实密钥。

复制只启用两个 Preset 并指定 Git Bash 配置

- id: gitbash-presets
  config:
    presets: [standard-gitbash, minimal-gitbash]
- id: gitbash-executor
  config:
    bashPath: 'C:/Program Files/Git/bin/bash.exe'
    timeoutMs: 60000
    betterSidebarShell: false

核对配置证据（外部链接，在新标签页打开）

重启 web Profile，新建会话并显式选择 standard-gitbash。
确认托管 preset 未覆盖已有用户修改；Better Sidebar 联动先保持关闭。

验证

配置检查与成功结果

01
在测试会话查看工具名并查询 Bash 版本。
复制验证命令
```
echo $BASH_VERSION && command -v bash
```
期望结果：出现 bash 工具，路径指向 Git for Windows，不是 System32。

使用

第一次使用建议这样验证

在空测试仓库运行 pwd、git status 和只读文件列表，不执行安装脚本或写操作。

权限

它可能接触哪些数据和能力

执行本机命令写入本地文件

替换 Profile 的 Shell 执行器、启动 Git Bash 子进程、物化或清理用户 preset 目录，并可修改 Better Sidebar 的 terminalShell 设置

数据存储：插件会在首个用户信任 preset 根目录写入带 .plugin-managed.json 哈希标记的托管目录。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

仍然出现 pwsh: 检查 Profile 是否加载插件、bashPath 是否存在，并重启 Host 后创建新会话。
Preset 没有更新: 检查 .plugin-managed.json；插件不会覆盖用户已修改的托管目录。

卸载后的清理步骤

从同一 Profile 移除插件并重启。
确认未修改的 *-gitbash preset 被清理；用户改过的目录由插件保留，需人工决定是否删除。

深入审计：兼容性、数据流与来源

证据

兼容性与审阅记录

兼容性说明

0.6.0 源码分别携带 DSH 0.1.1 与 0.1.2+ 的 preset 组合并按内置 roster 选择；这属于作者实现证据，52DSH 未在 Windows 或 0.1.2-alpha.1 上运行

数据流

DSH Shell 工具调用与环境变量 → 指定的 Git Bash bash.exe → 官方 bash-sandbox 或 full-access 执行路径 → 命令输出返回 Agent；preset 文件写入用户信任目录。

源码审阅结论

已审阅执行器、preset 物化、版本 era 探测、清理标记、Better Sidebar 联动和组合补丁。插件对托管文件使用哈希并拒绝覆盖用户修改，但 danger-full-access 仍会直接执行 Git Bash；只适合已安装 Git for Windows、能理解 Profile 权限并愿意核对 bashPath 的用户。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：KannaKuron/dsh-gitbash-shell（外部链接，在新标签页打开）
来源登记表: GitHub dsh-plugin Topic（外部链接，在新标签页打开）
来源快照: GitHub Topic 采集记录
固定提交: 99f2f45fca38
许可证: MIT
主要语言: JavaScript
中文资料: 有完整中文配置资料

查看开放注册表记录我是插件作者：认领或更新发现错误：提交纠正

dsh-gitbash-shell