CH 02 · dsh を理解する
この章の目標
この章ではコマンドも叩かないし、環境構築もしません。代わりに 3 つだけハッキリさせます:dsh とは何か、何ができるのか、そしてモデルや Claude Code のようなツールと何が違うのか。読み終えれば、自信を持って CH 03 でインストールに進めます。
dsh とは
一言で言えば、dsh は DeepSeek が 2026 年 8 月 13 日に OSS 公開した Agent ランタイムフレームワークです。コマンド名は dsh、正式名称は DeepSeek Harness、ライセンスは MIT、公式の位置づけは developer preview(開発者向けプレビュー)です。
公式サイトのトップには 1 文だけ書かれています—— Everything is a plugin(すべてがプラグイン)。公式が示す等式:
Agent = Model + Harness
平たく言えば:モデルが「考える」を担い、Harness が「仕事」を担う。 モデルはテキストを生成するだけです。Harness はモデルにファイルの読み取り、コマンド実行、API 呼び出し、文脈管理、タスク計画を行わせ、モデルを現実世界と接続して初めてタスクを完遂できるようにする層です。
取り違えやすいもの
一番よくある落とし穴:dsh を「AI コーディングアシスタント」と思い込むこと。
それは違います。 Claude Code や Codex はコーディングアシスタントで、あれらは完成品——ツール、Skill、セッション、サンドボックスがすべて一つの殻に密閉されていて、壁は壊せないし、レイアウトも動かせない。dsh は「実行の土台」です。コーディングはあくまでプリセットの一組み合わせにすぎず、プログラミングと無関係な Agent を組み立てることだってできます。
もう一つの落とし穴:dsh はモデルではない。DeepSeek V4 flash(あるいは視覚対応の V4 flash vision exp)—— あれがモデルです。dsh はモデルに仕事をさせる「OS レイヤ」であり、両者は別物です。しかも dsh において DeepSeek モデルはデフォルトで同梱されている一つのプラグインにすぎず、他のどんなモデルにも完全に差し替えられます。
4 つのキーワードでつかむ
1. すべてがプラグイン。 モデル、ツール、Skill、セッション、サンドボックス、ストレージ、ループ、スケジューラ、UI—— すべての能力がプラグイン(レゴブロック)で、交換・削除・追加できます。
2. 基盤は Cordis。 Cordis カーネルがプラグインのマウント、アンマウント、依存関係を処理します。プラグイン同士はサービス(services)とイベント(events)で協調し、誰もが参加できるが、誰も特権を持たない。
3. すべての実行が追跡可能。 モデルが見たものはすべて、追記専用のセッションログに書かれます:システムプロンプト、推論、ツール呼び出しとその結果、サブエージェントのスケジューリング、あらゆる文脈注入。Trajectory(軌跡)ビューで出所ごとに絞り込めます。これは観測可能・監査可能・再現可能——研究と本番運用にとって重要な特性です。
4. 4 つのランタイムモード。 名前で身構えないでください—— これは 4 種類のエンジンではなく、公式がプリセットで用意した 4 つのプラグイン組み合わせテンプレートです。もちろん自分で新しいモードを定義することもできます:
- Standard(標準):初心者推奨。コード Agent の完全な能力:ファイル編集、Shell、ファイル/Web 検索、Skill、プラン、目標、サブエージェント、ワークフロー。箱から出してすぐ使えます。
- Code:Standard の全能力に加え、SDK 経由でツールを公開します。モデルが TypeScript プログラムを書いて、複数ステップを 1 パスでオーケストレートできます。「読み取り、検索、フィルタリング、並列呼び出し」の 5 ラウンドトリップが、1 回のプログラム実行に圧縮され得ます。トークン節約とレイテンシ低減につながります。代償はモデルのコード能力への依存とデバッグの難しさで、初心者は手を出さない方がよい。
- Minimal(極簡):永続 bash + ファイルエディタのみを残します。日常開発向けではなく、「素の Agent」ベンチマークを走らせるためのもの——余計なツールを一切装着せず、2 つのモデルの底力を比較するために使います。
- Creator(創造):Standard の全能力に加え、もう 1 つ:動作中の Cordis 環境を点検し、メモリ内でプラグインを試運転し、新しい Agent とプラグインを作成し、自分自身を改造することさえできます。
初心者は何も考えず Standard を使えば十分です。大量の反復的なツール呼び出しに直面しラウンドトリップを圧縮したくなったら Code に切り替えればいい。日常開発に Minimal は使わないこと——機能が足りないせいで「人生を疑う」ことになります。
向いている人、向いていない人
以下はコミュニティの実測に基づく評価であり、公式の見解ではありません。
向いている人:プラグインの仕組みを研究したい開発者や AI 愛好家;Agent 能力を自社システムに組み込みたいチーム—— プラグインモデルがそのまま使える土台;Agent 研究者—— 軌跡機能は再現可能な実験にうってつけ;既製の Agent で日常の雑事を片付けたい個人ユーザー—— コミュニティプラグインはすでに画像認識、Office 文書(Excel/Word/PPT)読み書き、ブラウザ自動化、マルチ Agent 連携をカバーしており、公式が手をつけていない隙間をほぼ埋めています。
慎重に考えるべき人:一切プラグインをいじりたくない、ダブルクリックで使えることだけを望むなら、dsh はまだそこに達していません。公式のデフォルトは最小ツールセット(Shell、ファイル読み書き、コード編集、Web 検索)しか読み込まず、画像認識、Office、ブラウザ自動化のためには自分でプラグインを入れる必要があります;しかも公式は明確に「developer preview であり互換性を壊す変更がある」と警告しており、日々更新されています。安心感を求めるなら、デフォルト能力が拡充され、エコシステムが落ち着くまで少し待ってから手を出しても遅くありません。
この章で学んだこと
下の項目を自力で達成できれば合格です:
- [ ] dsh が何かを自分の言葉で説明でき、
Agent = Model + Harnessの Harness が何を担うかを言える - [ ] dsh と Claude Code のような「コーディングアシスタント」の違いを言える(完成品 vs 土台)
- [ ] 4 つのランタイムモードの名前を言え、初心者がどれを使えばよいか分かる(Standard)
- [ ] dsh の重要な特性を少なくとも 1 つ挙げられる(すべてがプラグイン / Cordis ベース / 実行ごとに追跡可能)