MIT ライセンスの DSH ツールプラグインで、Windows の pwsh と WSL 限定 bash を Git for Windows 同梱の bash.exe に置き換え、サンドボックス・タイムアウト・バックグラウンドジョブの挙動をネイティブのシェルツールと揃えた `gitbash` ツールとして登録します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-14
ライセンス
MIT
01どんなタスクに使えるのか？
WSL も PowerShell の遅い起動も使わずに、Windows 上でモデルにシェルコマンドを実行させる
ネイティブの `pwsh` / `bash` と並ぶ `gitbash` ツール。中身は Git for Windows 同梱の bash.exe で、WSL 層のオーバーヘッドがなく、`C:\...` と `/c/...` の両方のパスが通ります
WSL を入れていない、あるいはネイティブ pwsh ツールの起動の遅さと引っかかりを避けたい Windows の DeepSeek Harness ユーザー
pwsh から乗り換えても、ツールの契約を覚え直さずに済ませる
ネイティブツールと同じ呼び出しカード、同じ作業ディレクトリ解決、同じサンドボックス昇格の確認（`sandbox_permissions` + `justification`）、`run_in_background` の公開条件も同じ
プロンプトや運用の癖を DSH ネイティブのシェルツールに合わせて組んであるチーム
シェル実行をサンドボックス内と時間予算内に収める
ファイルサンドボックスのモード、呼び出しごとのタイムアウト、出力の切り詰め、そして jobId をすぐ返すバックグラウンドジョブ
実機の Windows ワークステーションで agent にシェルコマンドを走らせ、ネイティブツールと同じガードレールを必要とする運用担当や開発者
02DeepSeek Harness への導入方法
前提条件
- Git for Windows を導入済みであること（配布元は https://git-scm.com/download/win）。bash.exe が必要で、ツールは `C:\Program Files\Git\bin\bash.exe`、`C:\Program Files\Git\usr\bin\bash.exe`、`SCOOP` から辿る scoop 版、PATH 上の任意の `bash.exe` を自動検出します
- bundle を追加できる DSH プロファイル。パッケージは npm 未公開のため `dsh plugin add dsh-tool-gitbash` は失敗し、`github:` 形式が現時点で唯一のリモート導入手段です
インストール手順
- 01
commit を固定して GitHub から導入します：`dsh plugin --profile <your-profile> add github:buhuikongpan/dsh-win-gitbash#<commit-sha>`。インストールコマンドが `@deepseek-ai/*` の peer 依存を処理します
$ dsh plugin --profile <your-profile> add github:buhuikongpan/dsh-win-gitbash#<commit-sha>
- 02
DSH の composition / プロファイルで bundle を有効にします。`dsh.profile.bundles` に `dsh-tool-gitbash` を追加してください
- 03
pnpm が git ホストのプラグインの `prepare` ビルドを止めた場合は、pnpm が表示するキーをそのプロファイルの `pnpm-workspace.yaml`（`allowBuilds`）に足して再試行します
- 04
手動で入れる方法もあります。パッケージを DSH の `node_modules`（例：`%APPDATA%\npm\node_modules\dsh-tool-gitbash`）に置くか `link:` で参照し、`@deepseek-ai/*` の peer を揃えてから composition で有効にします
導入成功の確認
- 再起動後、モデルに `gitbash` ツールが現れます。現れない場合は stderr に `skipping profile bundle "dsh-tool-gitbash"` が出ていないか確認してください。`@deepseek-ai/dsh-*` の peer 範囲が実行中のバージョンを覆っていないという意味です
03DSH 統合と能力の範囲
`dsh.bundle` manifest を宣言する DSH ツールプラグインで、ネイティブの `pwsh` / `bash` と並ぶ `gitbash` ツールを登録し、`ctx.subprocess` の利用者として Git for Windows 同梱の bash を直接呼び出します
gitbash ツール呼び出し
`command`（`bash -c` 経由で実行）、任意の 1 行 `description`、`workdir`（既定はセッションディレクトリ）、`timeoutMs`（既定 120s、上限 600s）、設定が有効なときの `run_in_background`→コマンドの出力（長い場合は切り詰め）。バックグラウンド呼び出しは jobId をすぐ返します
あなたのユーザー権限で Windows マシン上の任意のシェルコマンドを実行します`run_in_background` は `enableRunInBackground` が有効なときだけツール schema に現れますbash.exe の自動検出と手動指定
何も設定しない、または `cordis.patch.yml` のプラグイン行に `bashPath` を書く→解決された Git Bash の実行ファイル。検出時は `System32` の WSL ランチャーを飛ばし、見つからない場合は設定したパスを使います
上書きパスは `cordis.patch.yml` のプラグイン行に置きますネイティブツールと同じサンドボックス昇格
現在のサンドボックスポリシーで制限される呼び出しと、`sandbox_permissions` および `justification`→`approveEscalation` + `ctx.approval` 経由の承認確認。ポリシーは呼び出しのたびに読み直されます
ポリシーを `apply()` 時に固定せず呼び出し時に解決するため、`read-only` / `workspace-write` の境界が効いたままになります
04誰に向いているのか？使うべきでない場面は？
向いている用途
- WSL を入れていない、あるいはネイティブ pwsh ツールの起動の遅さと引っかかりを避けたい Windows の DeepSeek Harness ユーザー
- プロンプトや運用の癖を DSH ネイティブのシェルツールに合わせて組んであるチーム
- 実機の Windows ワークステーションで agent にシェルコマンドを走らせ、ネイティブツールと同じガードレールを必要とする運用担当や開発者
不向きな用途
- Windows 専用で、Git for Windows の導入が前提です。そもそも pwsh や WSL 限定の bash の代わりに Git Bash を使うためのプラグインであり、README に macOS や Linux での使い方はありません。
- `engines.dsh: ">=0.1.0-rc.6 <0.3.0"` を宣言し peer も同じ範囲なので、DSH 0.1.x と 0.2.x で読み込めます。ただし DSH は起動時に各プロファイル bundle の peer を検証し、`@deepseek-ai/dsh-*` の範囲が 1 つでも合わないと bundle ごとスキップされ、`cordis.patch.yml` が効かずモデルに `gitbash` ツールが出ません。
- パッケージは npm 未公開（`dsh-tool-gitbash` は npmjs でも npmmirror でも 404）なので、素の `dsh plugin add` は失敗します。導入は commit を固定した `github:` 形式のみで、さらに pnpm が git ホストの `prepare` ビルドを止めることがあり、その場合は `allowBuilds` の追加が要ります。
- ツールはあなたのユーザー権限でシェルコマンドを実行します。制限は DSH のサンドボックスポリシーによるもので、プラグインは呼び出しのたびに読み直し、composition に policy サービスが本当に無いときだけサンドボックスなしに落ちます。制限付き呼び出しからの昇格には `sandbox_permissions` と `justification` の両方が必要です。
05互換性・メンテナンス・セキュリティ上の注意
- Windows 専用で、Git for Windows の導入が前提です。そもそも pwsh や WSL 限定の bash の代わりに Git Bash を使うためのプラグインであり、README に macOS や Linux での使い方はありません。
- `engines.dsh: ">=0.1.0-rc.6 <0.3.0"` を宣言し peer も同じ範囲なので、DSH 0.1.x と 0.2.x で読み込めます。ただし DSH は起動時に各プロファイル bundle の peer を検証し、`@deepseek-ai/dsh-*` の範囲が 1 つでも合わないと bundle ごとスキップされ、`cordis.patch.yml` が効かずモデルに `gitbash` ツールが出ません。
- パッケージは npm 未公開（`dsh-tool-gitbash` は npmjs でも npmmirror でも 404）なので、素の `dsh plugin add` は失敗します。導入は commit を固定した `github:` 形式のみで、さらに pnpm が git ホストの `prepare` ビルドを止めることがあり、その場合は `allowBuilds` の追加が要ります。
- ツールはあなたのユーザー権限でシェルコマンドを実行します。制限は DSH のサンドボックスポリシーによるもので、プラグインは呼び出しのたびに読み直し、composition に policy サービスが本当に無いときだけサンドボックスなしに落ちます。制限付き呼び出しからの昇格には `sandbox_permissions` と `justification` の両方が必要です。
MIT · README の記載のみを根拠とし、最新リリース v0.2.3、npm 未公開、セキュリティ監査は未実施
06よくある質問
DeepSeek Harness に導入するには？
パッケージが npm 未公開なので、commit を固定した GitHub 形式を使います：`dsh plugin --profile <your-profile> add github:buhuikongpan/dsh-win-gitbash#<commit-sha>`。そのあとプロファイルの `dsh.profile.bundles` に `dsh-tool-gitbash` を追加して再起動すると、モデルに `gitbash` ツールが現れます。
マシンに先に入れておくものは？
Git for Windows だけです。bash.exe を提供します。ツールは `C:\Program Files\Git\bin\bash.exe`、`C:\Program Files\Git\usr\bin\bash.exe`、`SCOOP` から辿る scoop 版、PATH 上の任意の `bash.exe` を自動検出し、`System32` の WSL ランチャーは飛ばします。検出できない場合は `cordis.patch.yml` のプラグイン行で `bashPath` を指定します。
プラグインは入ったのに gitbash ツールが出ないのはなぜ？
多くの場合 peer のバージョン不一致です。DSH は起動時に各プロファイル bundle の `@deepseek-ai/dsh-*` peer を検証し、1 つでも範囲が合わなければ bundle ごとスキップして stderr に `skipping profile bundle "dsh-tool-gitbash"` を出します。宣言されている範囲は `>=0.1.0-rc.6 <0.3.0` なので、メジャーアップグレード後は使用中の DSH を覆っているか確認してください。
ネイティブの pwsh / bash ツールと同じように動きますか？
設計上は同じです。DSH 内蔵のターミナルカードを再利用し、作業ディレクトリの解決も同じ（サンドボックスルート優先、なければセッション cwd を `canonicalPath` で正規化）、サンドボックス昇格の確認も `sandbox_permissions` + `justification` で同じように出ます。`run_in_background` は `enableRunInBackground` が有効なときだけ公開され、`timeoutMs` は既定 120s、上限 600s です。
サンドボックスは効いたままですか？
効きます。cordis はプラグイン行を並行して読み込むため、この行が `sandbox-policy` より先に登録されることがあります。そのためポリシーは `apply()` 時に固定せず呼び出し時に解決し、composition に policy サービスが本当に無いときだけサンドボックスなしのツールに落ちます。
07関連する DSH ワークフロー
dsh-our-free-model
by ebony-vinyl
ログインやAPIキーなしでDeepSeek V4.1 FlashやKimi K3などを利用できるとし、無料・無制限をうたうDeepSeek Harness向けプラグインです。
dsh-routing-suite
by yjh051108
DeepSeek Harness（dsh）向けのルーティング套件。まずランタイムインジェクターを導入し、続いてタスク認識型の推論モードルーター（P1〜P23 を計測済み）を組み込めます。
dsh-ops
by t-auto
Bash と PowerShell コマンドを実行し、ローカルファイルを検索および編集し、DSH から長期にわたるバックグラウンドジョブを管理します.
brooks-lint
by hyhmrright
12 の古典的な工学書に基づく AI コードレビュー。書籍の引用付きで劣化リスクを診断し、重要度ラベルと全走査の自動修正を含む 6 つの分析モードを提供
08データと出典
**面向 Windows 的 Git Bash 工具插件**（DSH / DeepSeek Harness tool plugin）
以 DSH 工具插件形式注册为 `gitbash`
本工具作为 `ctx.subprocess` 消费者直接调用 Git for Windows 自带 bash，
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-11-14。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。