dsh CLIチートシート
DeepSeek Harness で覚えておきたい全コマンド——インストール、起動、モード、プラグイン、設定、バージョン管理——を印刷しやすい表にまとめました。
最終更新: 2026-10-03
dsh は DeepSeek Harness のコマンドライン入口です。1 つのバイナリがすべての形態を起動します——Web UI、ターミナルセッション、一回きりの headless 実行、そして自動化用プロファイル。インストール・更新・修復も、この CLI が一番の近道です。
このページはクイックリファレンスです。掲載するのは公式 apps/cli README・ルート README・npm パッケージから取った検証済みコマンドのみで、サイト内のステップ解説とも突き合わせて確認しています。印刷してターミナルの横に置き、詳しい手順が必要になったらリンク先のガイドへ。
要点
- ▸インストールは npm install -g @deepseek-ai/dsh の一回だけ（Node.js 20+）。グローバルに入れたくなければ npx @deepseek-ai/dsh web で直接実行。
- ▸dsh web で Web UI（127.0.0.1:3080）を起動。dsh --profile <名前> で他のプロファイルを起動。dsh --profile headless は 1 回実行して終了。
- ▸プラグインはプロファイル単位。インストール時に使った --profile（dsh plugin --profile web add）と、起動時のプロファイルを一致させるのが鉄則です。
- ▸更新は @latest、ロールバックは正確なバージョン指定（@0.2.0-rc.2 など）。トラブルシューティングの前に必ず dsh --version。
インストールと初回起動
ゼロから起動まで 4 ステップ。npm 経由が公式ドキュメントのルートで、ソースからは開発用途のルートです。
- 1
ランタイムを確認
dsh には Node.js 20 以上が必要です（Node 22 LTS 推奨）。ターミナルで node -v が v20.0.0 以上を表示すればOK——この一回の確認で、最も多い「プラグインが登録されない」案件を未然に防げます。
$node -v - 2
CLI をグローバルインストール
グローバルインストール 1 回で dsh コマンドが PATH に入ります。次に進む前に dsh --version で確認を。macOS / Windows デスクトップアプリ（0.2.0-rc.2 以降）には Manage dsh command メニュー項目があり、Node.js や pnpm を別途用意しなくてもコマンドをインストール・管理してくれます。
$npm install -g @deepseek-ai/dsh$dsh --version - 3
起動：入れていれば dsh、なければ npx
npx @deepseek-ai/dsh web はグローバルインストールなしで現行バージョンを実行できる、初回体験の最短ルートです。dsh web も同じく Web プロファイルを起動し、ブラウザーを開き、URL はコマンド自身が印字します（既定は 127.0.0.1:3080。--no-open でブラウザーを開かず、--port で変更。SSH からはホストの URL を印字するだけ）。モデルの接続は最初に Settings → Models で行います。
$npx @deepseek-ai/dsh web$dsh web - 4
代替ルート：ソースから実行
開発向け：リポジトリーをクローンし、インストールとビルドを 1 回済ませれば、以後は pnpm dsh web がビルド済み成果物をそのまま使います。同じランチャーはすべての引数を転送します——pnpm dsh --profile headless は引用符で囲んだタスクを受け取り、環境変数かリポジトリールートの .env に DEEPSEEK_API_KEY が必要です。
$git clone https://github.com/deepseek-ai/deepseek-harness$pnpm install$pnpm run build$pnpm dsh web
プロファイル、レジストリーミラー、サードパーティープラグインの審査チェックリストはインストールガイドへ： DeepSeek Harness 使い方：dsh プラグインの入れ方・インストール方法
モード対照：各エントリーポイントが起動するもの
dsh にデスクトップ・サーバー・クライアント向けの別バイナリーはありません。ランチャーは 1 つで、プロファイルが違うだけ。下表の同梱プロファイルは初回使用時にテンプレートから自動初期化されます。
| モード | コマンド | 得られるもの |
|---|---|---|
| Web UI | dsh web | ブラウザーのダッシュボード（127.0.0.1:3080）：ワークスペース、プラグインマーケット、設定。日常のグラフィカル面です。 |
| Headless | dsh --profile headless "task" | 呼び出しごとに 1 つの新しい永続化セッション：タスクを実行し、最終回答を印字して終了。スクリプトと CI 向け。 |
| ACP | dsh --profile acp | 公式の automation-only Agent Client Protocol サーバー（JSON-RPC stdio）——エディターや自動化クライアント向け。プラン・タイトル・ターミナルビューは意図的に省略されています。 |
| SDK | dsh --profile sdk | シャットダウンまたは切断まで JSON-RPC stdio で SDK クライアントに応える——プログラムからの統合用。 |
| SDK Minimal | dsh --profile sdk-minimal | スタンドアロンの最小エージェントツリーで SDK クライアントに応える——最も軽量な組み込み方式。 |
| TUI | dsh --profile tui | ターミナルネイティブのセッション。--resume <id> フラグはこのターミナルアプリのものです。 |
| Desktop | — | Electron デスクトップアプリ用に予約された名前。CLI は起動・設定ダンプ・プラグイン管理のいずれも拒否します。 |
モードは「表面」で、セッションに何ができるかはエージェントプリセットが決めます。Standard・PTC・Minimal・Creator の 4 つが内蔵で、違うのはツールボックス： 4 つのモード：Standard・PTC・Minimal・Creator
コマンド早見表
印刷しやすいよう用途別にグループ化：プラグイン、セッションとプロファイル、設定の確認、診断、そしてバージョン管理。コマンドは一字一句そのまま。インストール時のフラグと起動時のフラグは一致させてください。
プラグイン——プロファイル単位でインストール・管理
| コマンド | 説明 |
|---|---|
| dsh plugin --profile web list | プロファイルのプラグイン項目とディスク上のディレクトリーを表示。何よりも先にここで確認。 |
| dsh plugin --profile web add <package> | npm レジストリーから web プロファイルへプラグインをインストール（プロファイル名は自分のものに合わせて）。 |
| dsh plugin --profile web add github:owner/repo#tag | GitHub 専用のプラグインをインストール。#ref でブランチやタグに固定できます。 |
| dsh plugin --profile web add ./path/to/plugin | ローカルフォルダーからプラグインをインストール——ローカル開発ルート。 |
| dsh plugin --profile web update | プロファイルのプラグインを一括更新。 |
| dsh plugin --profile web remove <package> | プロファイルからプラグインを削除。 |
セッションとプロファイル
| コマンド | 説明 |
|---|---|
| dsh web | Web プロファイルを起動——dsh --profile web と同じで、URL はコマンドが印字します。 |
| dsh --profile <name> | $DSH_HOME/profiles/<名前> の指定プロファイルを起動（web・headless・acp・sdk・sdk-minimal・tui は初回使用時にテンプレートから自動初期化）。 |
| dsh --profile headless "one-off task" | Headless ワンショット：新しい永続化セッションを 1 つ実行し、最終回答を印字して終了。 |
| dsh --profile tui --resume <id> | ターミナルアプリで永続化セッションを再開。 |
| dsh --profile <name> --from-default-profile web | 同梱テンプレートから新しいカスタムプロファイルを作成して起動。 |
設定——いじる前に確認
| コマンド | 説明 |
|---|---|
| dsh --dump-default-config | 起動せずに既定の合成ツリーを表示——素の dsh が何を組み上げるかがわかります。 |
| dsh --dump-config | プロファイルとパッチの上書きを適用した合成ツリーを表示——これも起動なし。 |
| dsh --dump-config-schema | 設定値の代わりに、プラグイン項目とパッチの JSON Schema を表示。 |
| dsh --patch <file> | 今回の起動で、合成ツリーの上にさらにパッチファイルを重ねる。 |
| cat ~/.dsh/profiles/<name>/cordis.patch.yml | プロファイルのパッチファイルを手で読む——ワークスペース階層の .dsh/cordis.patch.yml があればそちらが優先されます。 |
レイヤー順：バンドルパッチ → プロファイルの cordis.patch.yml → $DSH_HOME/cordis.patch.yml → --patch 上書き。設定変更はまず「どの階層を編集しているのか」から—— プロファイル・パッチ・プリセット
診断
| コマンド | 説明 |
|---|---|
| dsh --version | ランタイムのバージョンを表示（peer 範囲のチェックに使用）。診断の前に必ず実行。 |
| dsh --help | ランチャー自身のヘルプ。アプリ側のフラグはプロファイルごとに違います（dsh --profile web --help を試してみてください）。 |
| node -v | Node.js 20 以上かを確認——プラグインが登録されない最も多い原因です。 |
| npm prefix -g | npm のグローバルプレフィックスを表示。dsh の実行ファイルはその bin ディレクトリーにあります。command not found が出るときは PATH と照合してください。 |
ここのコマンドがうまく動かないときは、「症状 → 原因 → 修正」のエラー事典が一歩ずつ対応します： トラブルシューティング・エラー百科
再起動と起動
dsh restart のようなサブコマンドは存在しません——再起動とは、同じプロファイルを止めてもう一度起動することです。公式リファレンスのルール：バンドルを追加・削除・更新したらそのプロファイルを再起動する。プラグインツリーは起動時に組み立てられるからです。
| コマンド | 説明 |
|---|---|
| dsh web | Web UI の起動——プラグインや設定を変えたらもう一度実行。再起動しない限り、変更は効いたことになりません。 |
| dsh --profile <name> | どのプロファイルも同じ要領で起動（再起動）——「起動時にツリーを組み立てる」ルールは全プロファイル共通です。 |
| Ctrl+C → same start command again | 再起動という動作そのもの：最初の SIGINT/SIGTERM でグレースフルドレインが始まります——プロセスを終了させ、同じコマンドで再起動を。 |
| npx @deepseek-ai/dsh web | グローバルインストールなしで起動——npx 一発で同じ Web UI が立ち上がり、その場限りの用途に向きます。 |
ハングすべてに再起動が効くわけではありません：デスクトップアプリのコマンドが 5 分前後で「This operation was aborted」で死ぬのはディスカッション #8737——ローカルの長い RPC が約 305 秒でクライアント側タイムアウトに切られる形で、再起動では直りません。
バージョン管理
更新とロールバックは同じコマンドで、違うのはタグだけ。プレリリースに乗る前に npm の dist-tags やリリースノートを確認しましょう。
| コマンド | 説明 |
|---|---|
| npm install -g @deepseek-ai/dsh@latest | CLI を npm latest の最新へ更新——2026-10-01 時点では 0.2.0-rc.2。 |
| npm install -g @deepseek-ai/dsh@<exact-version> | 正確なバージョンに固定（またはロールバック）。再現や復旧のときに @latest は使わないこと。 |
| dsh plugin --profile web update | プロファイルのプラグインを更新。 |
| dsh plugin --profile web add github:owner/repo#v1.2.3 | 動くブランチの代わりにタグへプラグインを固定。 |
アップグレード前に ~/.dsh/profiles/<名前>/cordis.patch.yml をバックアップ——0.2.0-rc のアップグレード波では、ワークスペースが消えた・プラグインが一斉に壊れたという報告がディスカッションに集中しました。
更新とロールバックの詳しい手順（Web UI マーケット経由も含む）： DSH とプラグインの更新
プラットフォーム別ワンライナー
プラットフォームごとにコピーして使えるコマンド群。4 つのルートすべての行き先は同じ、127.0.0.1:3080 の Web UI です。
macOS
ターミナルでインストールなしで実行。npm は 1 度だけ尋ねてくるので y と答えます：
Windows
PowerShell で（WSL は不要）：インストールを 1 回してから起動——
Linux
ランタイムを確認してから、グローバルインストールなしで実行：
WSL2
WSL2 の中では Linux と同じコマンドをそのまま使います。dsh は Windows ネイティブでも動くので、どちらか一方のホームに統一すること——混在すると ~/.dsh が 2 つに分かれます。
dsh CLI のFAQ
チートシートを開いたあとに浮かぶ疑問たち。
dsh と DeepSeek Harness は同じものですか？
dsh はハーネスのコマンドライン入口、つまり npm で公開されている @deepseek-ai/dsh パッケージです。デスクトップアプリも Web UI も、同じツリー上の異なる表面にすぎません。dsh web は同じインストールから Web プロファイルを起動します。0.2.0-rc.2 からは macOS / Windows デスクトップアプリに Manage dsh command メニュー項目も加わり、Node.js や pnpm を別途用意せずに同じ CLI（プラグイン込み）をインストール・管理できます。
npx @deepseek-ai/dsh web と、インストールしてから使うの、どちらがいい？
npx はゼロインストールのルートです。パッケージを取得して Web UI を 1 回実行するので、最初の確認に最速で、グローバルインストールが壊れたときのつなぎにもなります。日常使いにはグローバルインストール（npm install -g @deepseek-ai/dsh）がおすすめです。dsh web がすぐ起動し、dsh --version で実行中のバージョンがわかり、dsh plugin でプラグインを管理できます。どちらのルートも dsh --version で確認できます。
プラグインを入れたのに dsh を起動すると無いのですが？
ほぼ確実にプロファイルの不一致です。dsh plugin --profile web add <パッケージ> は項目を web プロファイルに書き込みます。その後に素の dsh（既定プロファイル）を起動すれば、そのツリーにプラグインはありません。dsh plugin --profile web list で項目とディレクトリーを確認してから、dsh --profile web で起動してください。フラグはすべて同じルール：入れるときと起動するときで一致させます。
プロファイルはどこに保存され、どう作りますか？
プロファイルは $DSH_HOME/profiles/<名前>、つまりハーネスホーム（既定は ~/.dsh。DSH_HOME で変更可）の下にあります。同梱プロファイル（web・headless・acp・sdk・sdk-minimal・tui）は初回使用時にテンプレートから自動初期化されます。カスタムプロファイルは dsh --profile <名前> --from-default-profile web で同梱テンプレートを複製して起動。起動せずに合成結果だけ見るには dsh --dump-config を使います。
desktop プロファイルとは何ですか？なぜ dsh は拒否するのですか？
desktop という名前は Electron デスクトップアプリのために予約されています。CLI はその起動・設定ダンプ・プラグイン管理をことごとく拒否するので、dsh --profile desktop は設計通りエラーで終了します。その表面が必要ならデスクトップアプリを、ブラウザールートなら dsh web を使ってください。
dsh の更新方法と、アップグレードが壊れたときのロールバックは？
更新：npm install -g @deepseek-ai/dsh@latest（npm latest は 2026-10-01 時点で 0.2.0-rc.2）の後、dsh --version で確認。ロールバック：正確なバージョンを指定してインストールし直します——npm install -g @deepseek-ai/dsh@0.1.5-rc.2。@latest でのロールバックはしないこと。アップグレード前に ~/.dsh/profiles/<名前>/cordis.patch.yml をバックアップし、個別のプラグインは dsh plugin add github:owner/repo#v1.2.3 で固定できます。
関連ガイド
早見表の背後にある通し解説。
DeepSeek Harness：10 ステップの完全ツアー
git clone から headless モードまで——インストール、プロバイダー接続、プリセット、Creator モードでのプラグイン生成、サンドボックスと Trajectory を 1 本のガイドで。
ガイドを読むDeepSeek Harness 使い方：dsh プラグインの入れ方・インストール方法
dsh でのプラグイン インストールの実際の仕組みと、サードパーティコードを見極めるチェックリスト。
ガイドを読む4 つのモード：Standard・PTC・Minimal・Creator
各エージェントプリセットの中身、得意な場面、そして Creator モードで独自プリセットを作る方法。
ガイドを読むプロファイル・パッチ・プリセット
dsh プロセスが積み重ね設定レイヤーからどう組み立てられるか、そして自分仕様にする方法。
ガイドを読むDSH とプラグインの更新
検証済みの更新コマンド：バージョン確認、dsh CLI のアップグレード、ターミナルまたは Web UI マーケットからのプラグイン更新、そして安全なロールバック。
ガイドを読むトラブルシューティング・エラー百科
症状 → 原因 → 対処法：インストール失敗、pnpm workspace allowlist エラー、cordis.patch.yml 競合、bundle 形式エラー、Profile が反映されない問題。
ガイドを読む