DeepSeek Harnessとは
DeepSeek Harnessの基本情報
dshDeepSeek Harnessとは DeepSeek AI が公開したオープンソースのエージェント基盤です。
すべてがプラグインという設計
特徴は「すべてがプラグイン」という一点に集約されます。 公式は v0.1 を2026年8月13日に開発者向けプレビューとして公開し、モデル・ツール・スキル・セッション・サンドボックス・ファイルシステム・ループ・オーケストレーション・UI のすべてをプラグインとして実装したと述べています。差し替えも拡張も、本体を改造せず組み替えで行えます。
"🧩 DeepSeek Harness v0.1 is now available in Developer Preview!"／"We’re opening it up to developers building agent harnesses worldwide and open-sourcing the codebase in MIT license."／"Powered by the Cordis meta-framework, DeepSeek Harness is an agent harness built around one core idea: Everything is a plugin. Models, tools, skills, sessions, sandboxes, filesystems, loops, orchestration, and UI are ALL implemented as plugins, and can be mixed, matched, replaced, and extended." — DeepSeek 公式アカウントの告知より
特権的なコアを持たない構造
もう少し内側を見ると、設計思想がはっきりします。公式ドキュメントは「パッチを当てるべき特権的なコアは存在しない」と書き、機能追加は他のプラグインの隣にプラグインを載せて行うと説明しています。 モデルアダプタもツールの登録先もセッションログもエージェントのループ自体もプラグインで、設定から差し替えられます。
"Every part of the product is a plugin, including the model adapter, the tool registry, the session log, and the agent loop itself, so every part is replaceable from configuration."（Cordis の節）／"There is no privileged core to patch: you extend dsh by mounting a plugin beside the others, and registrations are effects that unwind when their plugin unloads."（同節の次段落）— DeepSeek Harness 公式ドキュメントより
DeepSeek Harnessの使い方
起動の2経路
npx 一発で起動起動経路は2つ用意されています。試すだけならnpm経由が早いです。
npxで起動する最短手順
Node.jsさえ入っていれば、次の1行でWeb UIが立ち上がります。 既定の待受は http://127.0.0.1:3080 です。
npx @deepseek-ai/dsh web
Node.jsのバージョン要件は ^22.19.0 || >=24.0.0 です。古いNodeのままだと起動しないので、そこだけ先に確認しておくと詰まりません。
"Install `Node.js`, then run:"／"npx @deepseek-ai/dsh web"／"The command starts the Web UI, served at `http://127.0.0.1:3080` by default."（いずれも Run from `npm` の節）— DeepSeek Harness README より
"engines": { "node": "^22.19.0 || >=24.0.0" } — リポジトリ root の package.json より
ソースから動かす場合
中身を触るならリポジトリを取ってきます。パッケージマネージャはpnpmで、cloneしてinstallとbuildを通してから起動する流れです。
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
"To run from a repository checkout:"／"git clone https://github.com/deepseek-ai/deepseek-harness.git"／"cd deepseek-harness"／"pnpm install"／"pnpm run build"／"pnpm dsh web"（いずれも Run from source の節）— DeepSeek Harness README より
構成の考え方と注意点
構成の単位
差し替えを支えるのがプロファイルとバンドルという2つの単位です。
プロファイルとバンドル
起動時に組み上がるのは層を重ねたプラグインの木です。 プロファイルは積むバンドルを並べた名前付きの構成で、標準では web と headless の2種類がテンプレートとして同梱されます。バンドルは設定行とそれが読み込むコードをまとめた配布単位で、上の層から後からパッチを当てられます。自分の環境で何が起動しているかは次のコマンドで確認できます。
dsh --profile web --dump-config
"A running `dsh` is a plugin tree composed at boot from ordered layers."（Profiles and bundles の節）／"A profile is a named composition stored in the Harness home. It lists the bundles it stacks … `web` and `headless` ship as templates."（同節）／"A bundle is a distribution format for Cordis config rows and the code they mount, so whatever it inserts stays patchable by the layers above it."（同節）／"dsh --profile web --dump-config"（同節のコマンド例）— DeepSeek Harness 公式ドキュメントより
触るときの注意点
差し替え自由という設計は、裏返せば設定次第で挙動が大きく変わるということです。プレビュー段階で互換性を壊す変更が入る以上、業務の常用ツールに組み込むより隔離した環境で試すのが現実的です。 モデル側の動きは DeepSeekのモデル記事 にもまとめてあります。
英語のドキュメントを、見出しや表の構造を保ったままマークダウンにして手元で読みたいときは、次のツールが使えます。
