DeepSeek Harness：「すべてがプラグイン」が実際にもたらすもの
Updated August 16, 2026 · first published August 16, 2026
DeepSeek AI は deepseek-harness（dsh）を公開しました。MIT ライセンスのエージェントハーネスで、設計上の標語は「すべてがプラグイン」です。この言い回しはエージェント関連ツールの界隈で緩く使われがちなので、ここでの意味と、どこでエージェント運用の経済性を変えるのかを正確にしておく価値があります。
フック付きフレームワークではなく Cordis
ハーネスは Cordis 上で動きます。プラグインが共有コンテキストにサービス、型付きイベント、可逆な作用を提供するというモデルのプラグインランタイムです。アーキテクチャ文書は、特権的なコアは存在しないと明言しています。モデルアダプタ、ツールレジストリ、セッションログ、そしてエージェントループ自体まですべてプラグインであり、その下に動かせないエンジンが座っていることはありません。
これが重要なのは、「拡張可能」なエージェントフレームワークの通常の形が、固定されたコアにフック面を足したものだからです。観測と装飾はできても、置き換えはできません。置き換えるとはフォークすることです。Cordis はそれを反転させます。置き換えたくなる部品こそが合成の単位なのです。
ケイパビリティ・シーム：運用上いちばん効く部分
ハーネスはこれをケイパビリティ・シーム（capability seam）として形式化します。シームとは実装が複数あるサービスインターフェースのことで、各サービスは三つの役割のいずれかを占めます。
| 役割 | 働き |
|---|---|
| オーナー | サービスインターフェースを宣言するパッケージ |
| 実装 | 具体的な振る舞いを提供するパッケージ（シームには複数ある） |
| コンシューマー | どの実装が動いているか知らずにサービスを呼ぶパッケージ |
すべてのサービスがシームなわけではありません。ドキュメントは三種類を区別します。差し替え可能なシーム（ctx.llm、ctx.subprocess）、単一オーナーのコアサービス（ctx.sessions、ctx.agents）、そして他のサービスを調整する合成点（ctx.agentLoop）です。どれがどれかを知ることが、振る舞いを差し替えてよい場所とそうでない場所を教えてくれます。
コストに効く四つのシーム
ctx.llm：モデルのシーム。llmパッケージが所有し、実装にはllm-deepseek、llm-pi-ai、llm-replayがあります。エージェントループはプロバイダ中立のストリームサービスを消費し、どのバックエンドが動いているかを知りません。コスト作業で面白いのはllm-replayで、記録済みセッションを推論費用を再度払わずに再実行できます。ctx.fs：ファイルシステムのシーム。 実装はfs-local（ホストのファイルシステム）、fs-sandbox（変更を閉じ込める）、fs-e2b（リモートのサンドボックス化された Linux 環境）です。モデルから見えるツールと、実行が物理的にどこで起きるかを切り離します。ctx.sandbox：実行のシーム。 コンシューマーは argv を渡し、実装がポリシー下で実行を包みます。sandbox-localはホスト上で強制し、sandbox-policyはデプロイ既定値を集中管理します。ctx.subagents：委譲のシーム。 インプロセス生成、フォーク、ACP ブリッジ、Codex、Claude Code、SDK ベースのエージェントを網羅する六つの実装があります。ふつうのハーネスが前提を固定してしまう箇所が、ここでは差し替えになっています。
エージェントシステムで意味のあるコスト削減レバーは、いずれもプロバイダの差し替えです。より安いモデルへルーティングする、より安いサンドボックスへ実行を移す、サブエージェントのトランスポートをローカルのものに置き換える。それらがシームであれば、変更は設定の編集です。シームでなければ、変更はあなたが以後保守することになるフォークです。
これがアーキテクチャだけでなく FinOps の問題である理由
エージェントのコスト施策で繰り返される失敗は、チームが高価なモデルを選ぶことではありません。ハーネスが高価な選択を構造にしてしまうことです。モデル選択、ツールの実行場所、委譲のトランスポートがアプリケーションコードに焼き込まれると、あらゆる最適化が独自のスケジュールとリグレッションリスクを持つエンジニアリング案件になります。結果としてチームは最適化を先送りし、支出は積み上がります。
シームに基づくハーネスは、それらの判断を合成の側へ移します。無料になるわけではありませんが、リファクタリングから設定へと性質が変わります。四半期の施策と午後一回分の作業ほどの差です。
はっきり述べておくべき留保
DeepSeek Harness は developer preview であり、README は互換性を壊す変更があると和らげずに述べています。いま本番のコストツールを内部インターフェースに直接ぶつけて作るということは、その変化を追い続けることに同意することです。評価とプロトタイプは有益ですが、バージョンは固定し、変動を見込んでください。
Related
Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →