DeepSeek Harness (dsh)

DeepSeek Harness (dsh)は、DeepSeek AIによるオープンソースのエージェントハーネスです。エージェント = モデル + ハーネスであり、その内部のすべての機能は交換可能なプラグインです。

123

2026/08/14

DeepSeek Harnessとは何ですか？

DeepSeek Harness（dsh）は、DeepSeek AIのオープンソースのエージェントハーネスです。モデルにワークスペース、ツールレジストリ、サンドボックスと承認ポリシー、追記専用のセッションログ、そして作業を進め続けるループを提供します。エージェントランタイムを自ら所有したいチーム、dsh-pluginトピックで機能を公開するプラグイン作者、モデルアダプター、サンドボックス、ストレージバックエンドを設定で差し替える必要がある人向けに作られています。際立っているのは、モデル、ツール、スキル、セッション、サンドボックス、ストレージ、ループ、スケジューリング、UIといったすべての機能がCordisカーネル上にマウントされたプラグインである点です。そのため、コアにパッチを当てるのではなく、プラグインを追加してdshを拡張します。

主な機能

すべてがプラグイン: モデルアダプター、ツールレジストリ、セッションログ、エージェントループ、ブラウザUIはすべてプラグインなので、どの部分も設定から差し替え可能で、特権的なコアにパッチを当てる必要はありません。
基盤のCordisカーネル: Cordisはプラグインのマウント、アンマウント、再接続を行い、依存関係を追跡します。また、プラグインがアンロードされると登録は自動的に解除されます。
パッチレイヤー構成: 実行中のインスタンスは、順序付けられたレイヤーから構成されるプラグインツリーです。バンドルパッチ、プロファイル自身のパッチファイル、マシンレベルのパッチ、コマンドラインオーバーレイがあり、後のレイヤーが行ごとに優先されます。
1つのコア上の4つのエージェントプリセット: Standardは完全なツールセットを提供し、CodeはCode Mode SDKを通じてツールを公開し、Minimalは永続的なbashとstr_replace_editorのみを保持し、Creatorはランタイム検査とプリセット作成ガイダンスを追加します。
追記専用セッションログ: システムプロンプト、推論、ツール呼び出しと結果、サブエージェントのスケジューリング、コンテキスト注入はすべて記録され、再開、フォーク、検索、リプレイはその単一のイベントストリーム上で動作します。
サンドボックスと権限モード: 生成されたプロセスに対するファイル影響の閉じ込めにより、Linux、macOS、Windowsバックエンド全体で読み取り専用、ワークスペース書き込み、danger-full-accessモードを提供します。
差し替え可能なモデルプロバイダー: DeepSeek、AnthropicやOpenAIなどのカタログプロバイダー、カスタムのOpenAI互換エンドポイントはすべて同じアダプターインターフェースを通じて利用できます。

DeepSeek Harnessの使い方

Node.js 22.19以降、または24以上をインストールします。
npx @deepseek-ai/dsh webを実行します。このコマンドはWeb UIを起動し、デフォルトではhttp://127.0.0.1:3080で提供されます。ソースチェックアウトの場合は、リポジトリルートでクローン、`pnpm install、pnpm run build、pnpm dsh web`が必要です。
Settings、次にModelsを開き、モデルキーを追加して保存します。モデルルートは再起動なしですぐに使用可能になります。
ワークスペースディレクトリを選択します。選択するまでセッションコンポーザーは利用できません。
ランタイムを検査して拡張します。dsh web --dump-configはマシンが起動する構成済みプラグインツリーを出力し、dsh pluginはpnpm動詞をプロファイルディレクトリに転送することで、ツリー外のプラグインをプロファイルにインストールします。

ユースケース

クローズドなエージェントランタイムを利用するのではなく、自ら所有したいチーム。
GitHubのdsh-pluginトピックで機能を構築・公開するプラグイン作者。
実行間で安定した最小限のツールサーフェスを必要とするモデル評価 — Minimalモードはエージェントを永続的なbashとファイルエディターに制限します。
ブラウザクライアント、HTTPサーバー、クライアントモジュールがバンドルとして提供されるため、独自UIの背後に検査可能なエージェントループを埋め込む内部プラットフォーム。
コードではなく設定でモデルアダプター、サンドボックス、ストレージバックエンドを差し替える必要がある人、または1回の差し替えでファイルシステムとサブプロセスをリモートサンドボックスに向ける必要がある人。

料金

公式サイトにはDeepSeek Harnessの料金や有料プランは掲載されていません。このプロジェクトはMITライセンスで公開されており、開発者プレビュー中なので、最新の詳細は公式サイトを確認してください。

FAQ

DeepSeek HarnessはPythonのdeepseek-harnessパッケージと同じプロジェクトですか？

いいえ。DeepSeek Harnessという名前を使う無関係な2つのプロジェクトがあります。DeepSeek AIによる公式のものはTypeScriptで、Node.js上で動作し、npx @deepseek-ai/dsh webでインストールされます。一方、コミュニティプロジェクトはDeepSeek V4-ProおよびV4-Flash API用のPythonクライアントライブラリで、pipでインストールされます。作者、ソースツリー、言語、バージョン系列が異なり、どちらも他方のフォークでも後継でもありません。

DeepSeek Harnessを実行するには何をインストールする必要がありますか？

DeepSeek HarnessにはNode.js 22.19以降、または24以上が必要です。公開されているCLIを実行するだけなら他には何も必要ありませんが、ソースチェックアウトからビルドする場合は、Corepackを有効にしたpnpm 11.7.0とGit 2.26以降も必要です。少なくとも1つのモデルプロバイダーを設定する必要があります。

DeepSeek Harnessはどのモデルプロバイダーを利用できますか？

DeepSeek APIキー、AnthropicやOpenAIなどのカタログプロバイダー、またはカスタムのOpenAI互換エンドポイントを受け付けます。Bedrock、Vertex、Azure、CodexはAPIキーフィールドではなく、それぞれのネイティブ認証情報が必要です。DeepSeek Harnessは重みを同梱せず、設定したプロバイダーを呼び出します。

DeepSeek Harnessの4つのモードとは何ですか？

Standardモードは、ファイル編集、シェル、ファイル検索とWeb検索、スキル、計画、目標、サブエージェント、ワークフローを備えた完全なコーディングエージェントです。CodeモードはCode Mode SDKを追加し、モデルが複数ステップの操作を1つのTypeScriptプログラムにまとめられるようにします。Minimalモードはベンチマーク用に永続的なbashとstr_replace_editorのみを保持し、CreatorモードはStandardに加えてランタイム検査とプリセット作成ガイダンスを追加します。