DeepSeek Harness チュートリアル

DeepSeek Harness深度求索（DeepSeek AI）によって開発され、2026年8月に正式にオープンソース化されたAgent Harness（エージェントフレームワーク）、MITライセンスを採用し、コードはTypeScriptで記述されています。

DeepSeek Harnessは採用していますすべてはプラグインというオープンアーキテクチャ：モデル、ツール、スキル、セッション、サンドボックス、ストレージ、ループ、スケジューリング、UIなど、すべてのエージェント機能はプラグインで構成され、自由に置き換え、柔軟に再編成できます——ソースコードを変更することなく、設定レイヤーで独自のエージェントをカスタマイズできます。

DeepSeek AI公式理念：Agent = Model + Harness。公式スローガン：Everything is a Plugin.（すべてはプラグイン）

このチュートリアルは誰向けですか？

本チュートリアルは、以下のような読者を対象としています：

  • 開発者 / エンジニア：能力の境界を完全に制御でき、すべてのコンポーネントを置き換えて再構成できるローカルAIコーディングアシスタントを求める方——固定機能にベンダーロックインされたブラックボックスではなく。

  • AI / ML 実務者：エージェントアーキテクチャに興味がある方——基盤はCordisプラグインシステムで駆動し、イベント駆動設計は論文に裏付けられており、PTCモードではモデルがTypeScriptプログラムで複数ステップのツール呼び出しを組み合わせることもできます。

  • 効率化ツール愛好家：Web UIのグラフィカルインターフェース、ヘッドレスコマンドライン、またはPython SDKを使用してエージェントを自分のワークフローに組み込みたい方。

  • 研究者：観測可能なエージェントを必要とする方——毎回の実行は追記専用のセッションログに書き込まれ、Trajectoryビューでシステムプロンプト、思考連鎖、ツール呼び出し、サブエージェントのスケジューリングを確認できます。

  • オープンソースで制御可能なことを重視するユーザー：MITオープンソースライセンス、設定レイヤーで自由に組み合わせ可能、テレメトリなし、クラウドロックインなし、完全に自律的に管理できます。

読む前に必要な基礎知識

本チュートリアルは要求しませんAIの研究背景や深い機械学習の知識は不要です。必要なもの：

能力 必要度 説明
コマンドラインの基本操作 必須 ターミナルでコマンドを実行し、環境変数を設定できること
Node.jsの基礎 必須 npx / pnpm で dsh をインストールして起動できること
基本的なAPI概念 知っていれば十分 APIキーとは何か、DeepSeek APIキーの申請方法を知っていること
プラグイン / 設定ファイルの概念 知っていれば十分 上級章（プラグイン開発、設定レイヤーの組み合わせ）で使用します
Gitの基礎 任意 ソースコードからのインストールやコントリビュート時に使用します

OS要件：Linux、macOS、またはWindows（Node.jsをインストールすれば実行可能）。

コア機能

DeepSeek Harnessの特徴：

  • 🧩 すべてはプラグイン— Cordisカーネルはプラグインのロード、アンロード、依存関係管理のみを担当します。モデル、ツール、スキル、セッション、サンドボックス、ストレージ、ループ、スケジューリング、UIなどのすべての機能はプラグインによって提供され、サービスとイベントを介して相互に連携し、設定レイヤーで自由に組み合わせられます

  • 📜 実行は追跡可能— モデルが見たすべて（システムプロンプト、思考連鎖、ツール呼び出しと結果、サブエージェントのスケジューリング、コンテキスト注入）は追記専用設計のセッションログに書き込まれます。Trajectoryビューではソース別に表示され、復元、分岐、検索、リプレイは同じイベントストリームを共有します

  • 🛠️ 4つの実行モード— 標準モード（フル機能のコーディングエージェント）、PTCモード（モデルがTypeScriptプログラムで複数ラウンドのツール呼び出しを組み合わせる）、ミニマルモード（2つのツール、モデルのベンチマークテスト用）、クリエイティブモード（実行時チェック + プラグイン実験 + カスタムプリセット作成）

  • 🌐 多様な形態での利用— Web UI（デフォルト http://127.0.0.1:3080）、ヘッドレス（一度だけ実行し最終回答を出力して終了）、CLI、Python SDK、TypeScript SDK

  • 🔌 豊富なツールと拡張機能— ファイル編集、Shell、ファイルとWebページの検索、Skills、プラン、目標、サブエージェント、ワークフロー。イベント駆動の拡張ポイント（セッション / エージェント / 能力の3レベルイベント）があり、あらゆる機能をパッチで置き換え可能

  • 🔒 オープンで制御可能— MITオープンソース。プロファイル + コンボパックの階層的な重ね合わせ設定、dsh --profile web --dump-config実際に起動した完全な設定ツリーを確認可能。特権カーネルはなく、すべての登録は元に戻せます

  • 🤖 モデル非依存— DeepSeek APIキーを入力するだけで使用可能。他のプロバイダーやカスタムのOpenAI互換エンドポイントをサポートし、モデルルーティングは再起動不要

  • 🔬 研究対応済み— 完全に観測可能なイベントストリームと設定ツリー、エージェントアーキテクチャ研究のためのオープンな設計（基盤の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
その他の拡張機能