公式ツール一式を永続 bash、構造化 read、アトミック write、多形式 edit に置き換え、任意の AST ツールと 2 つのプリセットを添える MIT の DSH プラグイン。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-12
ライセンス
MIT
01どんなタスクに使えるのか？
DSH のエージェントに、1 回きりのコマンドではなく状態を持つシェルと正確なファイル読み取りを与える
`cd` と `export` が呼び出しをまたいで残る永続 bash、冗長ログの圧縮、頭と尻だけ返して全文はディスクに残す切り詰め、長時間コマンドの自動バックグラウンド化
セッションの大半をシェルとファイルツールで過ごす DSH ユーザー
アトミック書き込み・複数のパッチ形式・diff の返却を使ってファイルを編集する
diff を返すアトミックな `write`、replace / patch / hashline / apply-patch に対応する `edit`、複数範囲の編集、一意性検査、空白差を許容する照合
大きなファイルやアーカイブで編集の失敗を減らしたいユーザー
公式の standard / PTC プリセットに加えて Tool Plus プリセットを配る
`@deepseek-ai/dsh-agent-preset` の宣言 2 行がプラグインに同梱され、プリセット一覧から選べる。設定ページの「Tool Plus → プリセット」で最小更新・テンプレート合わせ・同梱宣言への復帰・差分確認ができる
ある DSH プロファイルが公開するツールを統一したいチーム
02DeepSeek Harness への導入方法
前提条件
- `dsh` CLI をグローバルに導入済み（`npm i -g @deepseek-ai/dsh`）で、Node.js ≥ 24.9
- pnpm ≥ 10.4。`--allow-build` で本パッケージと `koffi` のインストールスクリプトを許可する必要がある
- Windows では bash 実行環境として Git Bash が要る
- DeepSeek Harness `dsh` v0.2.2-rc.1 向け。README はプリリリースでありインターフェースが変わりうると明記している
インストール手順
- 01
Web プロファイル: `dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus`
$ dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
- 02
デスクトップ: プロファイルはアプリが占有するため、`cd ~/.dsh/profiles/desktop` してから `pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus` を実行する
- 03
pnpm が古くて `--allow-build` を使えない場合は、プロファイルの `pnpm-workspace.yaml` に 2 つの `allowBuilds:` を足すか、プロファイルディレクトリで `pnpm approve-builds --all` を実行してから入れ直す
導入成功の確認
作者は未記載
03DSH 統合と能力の範囲
Oh My Pi カーネルから移植した DSH プラグイン。導入すると公式の bash / pwsh / ファイル / 検索ツールを引き継ぎ、任意の `ast_grep` / `ast_edit` と、パッチ層で宣言する 2 つのエージェントプリセットを追加する
永続 bash と安全な削除
エージェントからのシェルコマンド→呼び出しをまたぐ状態保持、ログ圧縮、頭と尻だけの切り詰めと全文のディスク保存、長時間コマンドの自動バックグラウンド化、`rm` によるゴミ箱への移動
ゴミ箱の場所はプラットフォームごとに異なり、ネットワークドライブにはゴミ箱がなく、macOS は 10.12+ が必要で、一部の Linux デスクトップでは項目が見えない構造化された `read`
パス（任意で `:N-M`、`:raw`、複数範囲）→行範囲の読み取り、大きなコードファイルの構造要約、zip/tar・SQLite・notebook・PDF の直接読み取り、画像の自動縮小付き読み取り、SPA をローカルブラウザーで描画しての取得
JS で描画されるページの取得ではローカルブラウザーが起動することがあるアトミックな `write` と多形式の `edit`
ファイル内容、または編集指示→diff を返すアトミック書き込み、アーカイブメンバーや SQLite へのパッチ書き込み、replace / patch / hashline / apply-patch の 4 形式の編集
複数範囲の編集では一意性検査と空白差を許容する照合が行われるgrep / glob と任意の AST ツール
パターンまたはファイル名 glob→全文検索とファイル名照合（mtime 順、コンテキスト行、無視規則の設定可）と、任意の `ast_grep` / `ast_edit` による構文木検索・書き換え
`ast_grep` / `ast_edit` は設定で有効にするまで無効プリセット管理
設定ページの「Tool Plus → プリセット」→最小更新、テンプレート合わせ、同梱宣言への復帰、書き込む前の差分確認
書き込みはホストの `ctx.configEditor` を通るため、プロファイルロック・同時実行保護・アトミック書き込み・失敗時のロールバックを備える
04誰に向いているのか？使うべきでない場面は？
向いている用途
- セッションの大半をシェルとファイルツールで過ごす DSH ユーザー
- 大きなファイルやアーカイブで編集の失敗を減らしたいユーザー
- ある DSH プロファイルが公開するツールを統一したいチーム
不向きな用途
- README は `danger-full-access` での利用を勧めている。サンドボックスモードではファイル書き込みが誤って止められることがあるため。
- Linux 上の SWE-bench Multilingual では解決率は公式と同等だったが、1 タスクあたりの総トークンとシステムプロンプトのトークンは増えた。README は Linux でトークン削減や性能向上を約束しないと明記している。
- `--allow-build` には pnpm ≥ 10.4 が必要で、pnpm 11 で付けないと `ERR_PNPM_IGNORED_BUILDS` で導入に失敗する。対象は `dsh` v0.2.2-rc.1 というプリリリースで、インターフェースが変わる可能性がある。
05互換性・メンテナンス・セキュリティ上の注意
- 安全な `rm` はファイルをシステムのゴミ箱へ移すが、扱いは統一されていない。ネットワークドライブにゴミ箱はなく、macOS は 10.12+ が必要で、一部の Linux デスクトップでは項目が見えず、記録された場所から自分で戻す必要がある。
- README は `danger-full-access` での利用を勧めている。サンドボックスモードではファイル書き込みが誤って止められることがあるため。
- Linux 上の SWE-bench Multilingual では解決率は公式と同等だったが、1 タスクあたりの総トークンとシステムプロンプトのトークンは増えた。README は Linux でトークン削減や性能向上を約束しないと明記している。
- `--allow-build` には pnpm ≥ 10.4 が必要で、pnpm 11 で付けないと `ERR_PNPM_IGNORED_BUILDS` で導入に失敗する。対象は `dsh` v0.2.2-rc.1 というプリリリースで、インターフェースが変わる可能性がある。
- 独立した `pwsh` ツールは提供せず、シェルは永続 `bash` が担う。Windows では Git Bash が必要になる。
MIT のソース。ここに書いた事実は記録したコミットの README に基づき、独立した安全性監査は行っていない。
06よくある質問
Web プロファイルへの導入手順は？
`dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus` を実行する。2 つの `--allow-build` が本パッケージと `koffi` のインストールスクリプトを許可し、pnpm ≥ 10.4 が必要。pnpm 11 で付けないと導入に失敗する。
デスクトップだけ入れ方が違うのはなぜ？
デスクトップアプリがプロファイルを占有しており、`dsh plugin --profile desktop` は拒否される。`cd ~/.dsh/profiles/desktop` でそのディレクトリに入り、`pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus` を実行する。
公式ツールよりトークンを節約できる？
自身のベンチマークではそうならない。Linux 上の SWE-bench Multilingual で解決率は同等、`bash` 1 回あたりの返却トークンは減ったが、1 タスクあたりの総トークンとシステムプロンプトのトークンは増えた。README は Linux でのトークン削減や性能向上を約束しないと明記している。
安全な `rm` は何をする？
削除ではなくシステムのゴミ箱へ移す。Windows はごみ箱、macOS は `~/.Trash`、Linux は `$XDG_DATA_HOME/Trash`。ネットワークドライブにゴミ箱はなく、macOS は 10.12+ が必要で、一部の Linux デスクトップでは項目が見えない。本当に削除したいときは `command rm` を使う。
対象の DSH バージョンと環境は？
DeepSeek Harness `dsh` v0.2.2-rc.1（README はプリリリースでインターフェースが変わりうると注意している）、Node.js ≥ 24.9、グローバル導入した `dsh`、Windows では Git Bash、そして推奨どおり `danger-full-access` での利用。
07関連する DSH ワークフロー
dsh-our-free-model
by ebony-vinyl
Adds model choices, availability checks, usage panels, and a local OpenAI-compatible forwarder.
dsh-routing-suite
by yjh051108
dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).
dsh-ops
by t-auto
Run Bash and PowerShell commands, search and edit local files, and manage long-running background jobs from DSH.
brooks-lint
by hyhmrright
Portable AI code quality reviews for Codex, Cursor, Copilot and other coding agents: six Agent Skills for architecture, technical debt, tests and remediation.
08データと出典
DeepSeek Harness 基础工具增强：持久 bash、结构化 read、多模式 edit、原子 write、全文搜索、图像直读，一个插件全覆盖。基于 [Oh My Pi](https://github.com/can1357/oh…
| **Tool Plus 标准增强版** | 官方 standard | 官方标准模式全部能力 + 文件/Shell 工具集换成本插件 |
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-11-12。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。