DeepSeek Harness (dsh)

DeepSeek Harness (dsh)とは？

DeepSeek Harness (dsh)は、DeepSeek AIによって開発されたオープンソースのエージェントランタイムおよびフレームワークです。Cordisプラグインカーネル上に構築されており、AIモデルやツールからセッション、サンドボックス、エージェントループ自体に至るまで、すべてのコンポーネントが交換可能なプラグインとして実装されています。dshは新しいAIモデルではなく、モデルにワークスペース、ツール、権限、メモリ、構造化された実行環境を装備してタスクを完了させるための「ハーネス」です。

DeepSeek Harnessの主な特徴

DeepSeek Harnessは、柔軟性と所有権を重視したモジュラーでプラグインファーストなアーキテクチャによって特徴づけられます。

• Everything is a Plugin: dshの中核となる原則です。モデルアダプター、ツールレジストリ、セッションロギング、サンドボックス化、さらにはユーザーインターフェースなどの機能がすべてプラグインとして実装されています。これにより、モノリシックなコアを変更することなく、エージェントシステムのどのレイヤーでも交換や拡張が可能になります。

• Composable Runtimes: ユーザーはプラグインの「バンドル」を積み重ね、設定「パッチ」を適用することで、自身のエージェントランタイムを組み立てることができます。dshはいくつかの事前定義されたエージェント「プリセット」（Standard, Code, Minimal, Creator）を同梱しており、これらは同じプラグインコアを共有しながら、異なる機能を公開します。

• Fully Local Execution: dshはリモートサーバーではなく、ローカルマシン上（デフォルトはhttp://127.0.0.1:3080）で動作します。これにより、ユーザーは自身のデータと実行環境を完全に制御できます。

• Append-Only Session Log: すべてのアクション（モデルへのプロンプト、推論、ツール呼び出し、結果）が不変のセッションログに記録されます。これにより、ステップごとの検査（「Trajectory」ビュー）、リプレイ、任意の時点からの実行の分岐、作業の再開といった強力な機能が可能になります。

• Extensive Plugin Ecosystem: 活発なコミュニティにより、新しいツール、ユーザーインターフェース、ブラウザー制御、代替のエージェントループ、サンドボックスソリューションを追加する数百のプラグイン（GitHubのdsh-pluginカテゴリ下）が急速に開発されています。

• Developer-Focused & MIT Licensed: MITライセンスの開発者プレビュープロジェクトとして、dshは、閉鎖的でホスト型のサービスを利用するのではなく、自身のエージェントインフラストラクチャを所有、カスタマイズ、構築したいチームや開発者を対象としています。

DeepSeek Harnessの使い方

DeepSeek Harnessを使用するには、ローカルでのセットアップ、設定、およびプラグインシステムを活用してエージェントをニーズに合わせて調整する必要があります。

1. クイックインストールと起動

• Prerequisites: Node.js (v22.19+ または v24+) がインストールされていることを確認してください。

• Start the Web UI: ターミナルでnpx @deepseek-ai/dsh webを実行します。このコマンドはdsh Web UIをダウンロードして起動し、http://127.0.0.1:3080でアクセス可能になります。

• Initial Configuration:

  • Web UIを開き、### Settings > Modelsに移動します。
  • DeepSeek APIキー（またはAnthropicやOpenAIなどの他のサポートプロバイダーの認証情報）を追加します。

  • workspace directory（エージェントが操作するローカルフォルダー）を選択します。ワークスペースが選択されるまで、セッションコンポーザーは利用できません。

2. ソースから実行（開発用）

• リポジトリをクローン: git clone https://github.com/deepseek-ai/deepseek-harness
• 依存関係をインストール: pnpm install
• プロジェクトをビルド: pnpm run build
• ローカルビルドを実行: pnpm dsh web

3. プラグインによる拡張

• dshの真価はその拡張性にあります。コミュニティプラグインをプロファイルに直接インストールできます。
• 例: Terminal UIプラグインをインストールするには、dsh plugin add dsh-cc-tuiを実行します。
• プラグインはWeb UIのプラグイン設定パネルから管理および検査できます。

4. ランタイムモードの理解

• Standard Mode: ファイル編集、シェル、検索、スキル、サブエージェントを備えたフル機能のコーディングエージェントです。

• Code Mode: TypeScript SDKを介してツールを公開し、モデルが単一のプログラム内で複雑なマルチステップ操作を調整できるようにします。

• Minimal Mode: 永続的なbashとファイルエディターのみを持つ簡素化された環境で、AIモデルのベンチマークに最適です。

• Creator Mode: Standard Modeにランタイム検査ツールを加えたもので、新しいエージェントプリセットの作成やプラグインの組み合わせのテストに設計されています。

DeepSeek Harnessの価格

DeepSeek Harness自体は、MITライセンスの下で### 完全に無料でオープンソースです。ソフトウェアに対するサブスクリプション料金やライセンス費用は一切かかりません。

• Costs to Consider:

  • Model API Costs: AIモデル（例：DeepSeek、OpenAIのGPT-4、AnthropicのClaude）用にご自身のAPIキーを提供する必要があります。選択したモデルプロバイダーの使用量と価格設定に基づいて料金が発生します。

  • Infrastructure: ローカルで動作するため、「インフラストラクチャ」はご自身のコンピューターです。サーバーホスティング費用はかかりません。

  • Development Time: 開発者プレビューフレームワークとして、特定の本番ニーズに合わせてdshを調整するには技術的な投資が必要です。

DeepSeek Harness使用時の役立つヒント

• Start with the Web UI Preset: webプロファイルが最も簡単な開始方法です。適切なデフォルト設定で自動的に初期化されます。

• Inspect Your Configuration: dsh web --dump-configを使用して、インスタンスが起動する際の正確なプラグインツリーを出力します。これはデバッグや、パッチの適用方法を理解する上で非常に貴重です。

• Leverage the Trajectory View: 実行後、Trajectoryタブを使用してエージェントの作業のすべてのステップを検査します。この透明性は、失敗を理解し、プロンプトを最適化するための鍵となります。

• Manage Workspaces Carefully: エージェントは選択したディレクトリ内で動作します。必要な権限があり、タスクに必要なコンテキスト（コード、ファイル）が含まれていることを確認してください。

• Be Mindful of Plugin Sources: コミュニティプラグインはDeepSeek AIによって監査されていません。特にファイルシステムやネットワークへのアクセスを要求するプラグインについては、インストール前にソースコードを確認してください。

• Expect Changes: プロジェクトは「開発者プレビュー」段階です。実験には安定していますが、コアAPIやプラグインへの破壊的変更は1.0リリース前に発生する可能性があります。

よくある質問 (FAQ)

DeepSeek HarnessはDeepSeekの新しいAIモデルですか？

いいえ。DeepSeek Harness (dsh)はモデルではありません。既存のAIモデル（DeepSeek自身のモデルやClaude、GPT-4など）がツールを使用してタスクを完了できる環境を提供するフレームワーク、つまり「ハーネス」です。

公式の「DeepSeek Harness」とPythonの「deepseek-harness」の違いは何ですか？

これらは名前が偶然似ているだけで、完全に関連のない2つのプロジェクトです。公式のdsh（本記事の主題）はDeepSeek AIによるTypeScript/Node.jsのエージェントランタイムです。Pythonのdeepseek-harnessは、DeepSeek V4 API用の独立したコミュニティ構築のクライアントライブラリです。

DeepSeekのモデル以外をdshで使用できますか？

はい。dshはプラグインを介して複数の「モデルアダプター」をサポートしています。DeepSeek、OpenAI、Anthropic、およびOpenAI互換のAPIエンドポイントを提供する他のプロバイダーをサポートしています。

dshを実行しても安全ですか？ファイルにアクセスしますか？

dshはローカルで動作し、明示的に選択したワークスペースディレクトリ内のファイルにのみアクセスします。サンドボックス化プラグインを使用することで、権限をさらに制限できます。ただし、コードを実行するソフトウェア全般と同様に、信頼できるコンテンツを含むワークスペースでのみ実行し、未検証のソースからのプラグインには注意する必要があります。

Claude Codeのようなホスト型エージェントではなく、なぜdshを選ぶのですか？

データプライバシー（すべてがローカルに留まる）を優先する場合、エージェントの機能を深くカスタマイズする必要がある場合、ランタイムを所有および変更したい場合、または内部プラットフォームを構築している場合は、dshを選択してください。よりターンキーで安定した管理された体験を、少ないセットアップオーバーヘッドで求める場合は、ホスト型エージェントを選択してください。

プラグインを貢献するにはどうすればよいですか？

Cordis/dshの規約に従ってプラグインを開発し、npmまたはGitHubに公開し、GitHubでdsh-pluginトピックを付けてコミュニティから発見可能にしてください。

「開発者プレビュー」とはどういう意味ですか？

ソフトウェアが開発とテストのために公開されているが、そのAPIはまだ安定していないことを意味します。将来のリリースで破壊的変更が発生する可能性があります。そのような変更に耐えられない重要な本番環境へのデプロイには推奨されません。