# DeepSeek、エージェント基盤を公開

> DeepSeek HarnessはWeb UI、ツール、セッション、サブエージェント、SDKをプラグイン中心の構成にまとめる一方、開発者プレビューとして破壊的変更を予告している。

_Source: DeepSeek AI · 2026-08-13 · 7 min read · Verified against primary sources_

Canonical: https://iyu.app/ja/e/deepseek-harness-open-source-agent-framework

## 60秒でわかる

DeepSeek HarnessはWeb、ヘッドレス、Pythonに対応するMITライセンスのプラグイン型エージェント基盤です。

**要点**

- モデルアダプター、ツール、セッション、プロンプト組み立て、エージェントループまでCordisプラグインで構成される。
- Web UIはワークスペース編集、コマンド、委任、計画、承認付き操作を扱う。
- ヘッドレスProfileはワンショット処理、Python SDKは同梱ランタイムの組み込みに対応する。
- DeepSeek以外のカタログ提供元やカスタムOpenAI互換モデルも設定できる。
- 開発者プレビューであり、現時点の互換性は公式に保証されていない。

**結論.** 実験価値の高い総合エージェント基盤だが、安定するまでは版固定とワークスペース隔離が必須です。

## 本文

**DeepSeekが公開したのは新モデルではなく、モデルの外側で動くエージェント実行基盤です。**DeepSeek Harness、コマンド名`dsh`は、Web UI、モデルアダプター、ツール、永続セッション、承認、サブエージェント、SDKをまとめ、エージェントループ自体もプラグインとして交換できます。

> **⚑ Caveat:** 公式はHarnessを開発者プレビューと明記し、互換性を壊す変更があると説明しています。現在の公開版はリリース候補であり、本番利用では版の固定と更新検証が必要です。


### 中心設計 — すべてをプラグインにする

HarnessはCordisプラグイン基盤で動きます。モデル提供元、プロンプト組み立て、ツール実行、セッションログ、既定ループが共有コンテキストへサービスとイベントを登録します。ProfileはBundleと利用者の上書きを順番に重ねるため、一つの能力を変えるだけで全体を書き直す必要がありません。

- **モデル層:** DeepSeek、AnthropicやOpenAIなどのカタログ提供元、クラウド固有ルート、カスタムOpenAI互換エンドポイント。
- **エージェント層:** プロンプト組み立て、モデル要求ループ、ツール呼び出し、承認、計画、委任。
- **状態層:** 追記型セッションイベントが永続化、再生、再開、記録生成を支える。
- **拡張層:** プラグインでモデル、ツール、コマンド、バックグラウンド処理、サンドボックス、UIを追加できる。


### 三つの入口 — ブラウザー、ヘッドレス、Python

公式の最短手順は`npx @deepseek-ai/dsh web`で、既定では`127.0.0.1:3080`にローカルWeb UIを起動します。モデル設定とワークスペース選択後にセッションを開始できます。同じ基盤はサーバーなしのワンショット処理やPython SDKからも利用できます。

- **3** — Web UI、ヘッドレスCLI、Python SDKの主な入口
- **3080** — Web UIの既定ローカルポート
- **MIT** — プロジェクトのオープンソースライセンス


### 機能 — コーディングエージェント一式

Webガイドでは、選択したワークスペースのファイル読み書き、コマンド実行、作業委任、計画管理が可能です。基本Bundleには永続化、認証情報、テレメトリー、ファイルとShellのポリシー、ジョブ、スキル、Webツール、サブエージェント提供元も含まれます。実際の機能はProfileとプラグイン構成で決まります。

- **Web UI：**対話型ワークスペース、セッション履歴、モデル設定、承認表示。
- **ヘッドレス：**一つのタスクを永続セッションで実行し、最終回答を標準出力へ返す。
- **Python SDK：**コンテキスト管理されたランタイムと再利用可能なセッションID。
- **カスタム構成：**有効なプラグインツリーを確認し、Profileパッチで設定を置き換える。


### 運用上の境界 — プレビュー版は隔離して使う

ソースのツールチェーンは新しいNode.jsとpnpmを対象とし、Python SDKはPython 3.10以上と文書化されたLinuxまたはApple Silicon環境を必要とします。さらに、ツールはファイル変更とShell実行が可能です。Pythonガイドの最小構成は`danger-full-access`で、使い捨てチェックアウトかコンテナーを推奨しています。

> **i** iyuの公開ホストでnpm入口を試したところ、依存関係の解決が2分を超え、停止時点で3080番ポートは準備できていませんでした。公式コマンドを否定する結果ではありませんが、導入時間とレジストリー条件は対象環境で別途確認すべきです。


### 採用判断 — 今すぐ試す価値がある利用者

エージェント設計を研究する開発者、独自ツールやモデル提供元を作る人、同じ基盤でWeb・ヘッドレス・組み込み実行を比較したい人には魅力があります。長期のセッション互換性や固定されたプラグインAPIが必要なチームは待つか、独自のアダプターでプレビュー版を隔離すべきです。

> 重要なのは、DeepSeekがチャットの薄いラッパーではなく、エージェントの実行システム全体を公開したことです。

まず使い捨てプロジェクトで試し、リリース候補の版を固定し、権限とプラグイン構成を確認し、更新を移行作業として扱うのが現実的です。設計は意欲的で透明ですが、互換性の約束はまだありません。


## Primary sources

- [DeepSeek Harness official repository](https://github.com/deepseek-ai/deepseek-harness)
- [Official architecture documentation](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md)
- [Official Web UI guide](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md)
- [Official Python SDK guide](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/python-sdk.md)

---
_Published by iyu (https://iyu.app) — the day's AI news, checked against primary sources and rewritten in plain language. Free to quote with attribution and a link to the canonical URL._
