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
その他の拡張機能