DeepSeek Harness チュートリアル

DeepSeek Harness深度求索(DeepSeek AI)によって開発され、2026年8月に正式にオープンソース化されたAgent Harness(エージェントフレームワーク)、MIT ライセンスを採用し、コードは TypeScript で記述されています。
DeepSeek Harness は採用していますすべてがプラグインというオープンアーキテクチャ:モデル、ツール、スキル、セッション、サンドボックス、ストレージ、ループ、スケジューリング、UI などすべての Agent 能力はプラグインの組み合わせで構成され、自由に置き換えたり柔軟に再構成したりできます——ソースコードを変更することなく、設定レイヤーで自分だけの Agent をカスタマイズできます。
DeepSeek AI 公式理念:Agent = Model + Harness。公式スローガン:Everything is a Plugin.(すべてがプラグイン)
このチュートリアルは誰に向いていますか?
本チュートリアルは以下の読者を対象としています:
開発者 / エンジニア:能力の境界を完全に制御でき、すべてのコンポーネントを置き換え・再構成できるローカル AI コーディングアシスタントを求める方——固定機能にベンダーロックインされたブラックボックスではなく。
AI / ML 従事者:Agent アーキテクチャに興味がある方——基盤は Cordis プラグインシステムによって駆動され、イベント駆動設計は論文で裏付けられており、PTC モードではモデルが TypeScript プログラムで複数ステップのツール呼び出しを組み合わせることもできます。
効率化ツール愛好家:Web UI グラフィカルインターフェース、headless コマンドライン、または Python SDK を使用して Agent を自分のワークフローに組み込みたい方。
研究者:観測可能な Agent を必要とする方——毎回の実行は追記専用セッションログに書き込まれ、Trajectory ビューでシステムプロンプト、思考連鎖(Chain of Thought)、ツール呼び出し、サブAgent のスケジューリングを確認できます。
オープンソースで制御可能なことを重視するユーザー:MIT オープンソースライセンス、設定レイヤーでの自由な組み合わせ、テレメトリーなし、クラウドロックインなし、完全に自己管理。
読む前に必要な基礎スキル
本チュートリアル要求していませんAI 研究のバックグラウンドや深い機械学習の知識は必要ありません。必要なものは次のとおりです:
| スキル | 要求レベル | 説明 |
|---|---|---|
| コマンドラインの基本操作 | 必須 | ターミナルでコマンドを実行し、環境変数を設定できること |
| Node.js の基礎 | 必須 | npx / pnpm を使用して dsh をインストールし、起動できること |
| 基本的な API 概念 | 知っていれば十分 | API Key とは何か、DeepSeek API Key の申請方法を知っていること |
| プラグイン / 設定ファイルの概念 | 知っていれば十分 | 上級章(プラグイン開発、設定レイヤーの組み合わせ)で必要になります |
| Git の基礎 | 任意 | ソースコードからのインストールやコントリビューションの際に使用します |
OS 要件:Linux、macOS、または Windows(Node.js をインストールすれば実行可能)。
コア機能
DeepSeek Harness の機能:
🧩 すべてがプラグイン— Cordis カーネルはプラグインのロード、アンロード、依存関係管理のみを担当;モデル、ツール、スキル、セッション、サンドボックス、ストレージ、ループ、スケジューリング、UI などすべての能力はプラグインによって提供され、サービスとイベントを通じて相互に連携し、設定レイヤーで自由に組み合わせ可能
📜 実行はトレース可能— モデルが見るすべて(システムプロンプト、思考連鎖、ツール呼び出しとその結果、サブAgent のスケジューリング、コンテキスト注入)は追記専用設計のセッションログに書き込まれます;Trajectory ビューではソース別に表示でき、復元、フォーク、検索、リプレイは同一のイベントストリームを共有します
🛠️ 4つの実行モード— 標準モード(フル機能のコーディング Agent)、PTC モード(モデルが TypeScript プログラムで複数ラウンドのツール呼び出しを組み合わせる)、ミニマルモード(2つのツール、モデルベンチマーク用)、クリエイティブモード(ランタイム検査 + プラグイン実験 + カスタム preset の作成)
🌐 多様な利用形態— Web UI(デフォルト http://127.0.0.1:3080)、headless(一度だけ実行し、最終回答を出力して終了)、CLI、Python SDK、TypeScript SDK
🔌 豊富なツールと拡張— ファイル編集、Shell、ファイル・Web 検索、Skills、プラン、目標、サブAgent、ワークフロー;イベント駆動の拡張ポイント(セッション / Agent / 能力の3レベルイベント)、あらゆる能力は patch で置き換え可能
🔒 オープンで制御可能— MIT オープンソース;Profile + 組み合わせパックの階層的な設定の重ね合わせ、
dsh --profile web --dump-config実際に起動された完全な設定ツリーを確認可能;特権カーネルなし、すべての登録は取り消し可能🤖 モデル非依存— DeepSeek API キーを入力するだけで使用可能。他のプロバイダーやカスタムの OpenAI 互換エンドポイントにも対応し、モデルルーティングは再起動不要
🔬 研究対応— 完全に観測可能なイベントストリームと設定ツリー、Agent アーキテクチャ研究のためのオープンな設計(基盤の Cordis は学術論文によって裏付けられています)
関連リソース
公式リソース
| リソース | リンク |
|---|---|
| 公式サイト | deepseek.com/harness |
| GitHub リポジトリ | github.com/deepseek-ai/deepseek-harness |
| 公式ドキュメント · クイックスタート | deepseek-harness.github.io/deepseek-harness/guide/quickstart |
| npm パッケージ | @deepseek-ai/dsh(npx @deepseek-ai/dsh webワンクリック起動) |
| プラグインコミュニティ | GitHub topics: dsh-plugin |
| コミュニティサポート | GitHub Discussions |