DeepSeek Harness(dsh)は、DeepSeek AIが2026年8月13日にMITライセンスで公開したオープンソースのエージェント基盤だ。deepseek-ai/deepseek-harness は2026年11月8日時点で276.4kスター・33.8kフォークに達した。掲げる設計思想は「Everything is a Plugin(すべてがプラグイン)」の一つである。

本記事は、DeepSeek Harnessの使い方、起動しない原因、構成の中身を、npm公開版を実際に動かして測った結果でまとめる。8月の初期版(0.1.0-rc.6)と、11月の最新版(0.2.2-rc.1)の両方を測っており、3か月で変わった前提も並べた。

DeepSeek HarnessのWeb UI。エージェント・プリセットの選択メニューにStandard / Code / Minimal / Creatorの4モードが並ぶ
初期版0.1.0-rc.6で起動したWeb UI(npx @deepseek-ai/dsh web → http://127.0.0.1:3080)。APIキー未設定でも4つのプリセットを選べる

THE SCALE公開3か月の規模

DeepSeek Harnessはプラグイン302行で組まれている

276.4k★

GitHubスター

フォーク 33.8k

302行

web構成のプラグイン行

うち29行は既定で無効

4種

エージェント・プリセット

standard / ptc / minimal / cordis

出典: GitHubリポジトリ(2026-11-08確認)、dsh 0.2.2-rc.1 の --dump-default-config 実測

エージェント基盤の全体像を先に知りたい方は、AIエージェントフレームワーク比較2026|LangGraph・CrewAI・Dify等9種をStar数・実コードで検証を参照してほしい。

30秒でわかるDeepSeek Harness

  • ・正体:モデルではなく「body」側。ツール・権限・セッション・サンドボックス・UIをプラグインとして差し替える実行基盤
  • ・起動しない原因:最新版0.2.2-rc.1はNode 24.9.0以上が必須。初期版はenginesが無く、Node 22.15.0未満で無言で落ちた
  • ・規模:標準webプロファイルの構成ダンプはプラグイン302行、うち29行が既定で無効
  • ・プリセットは4つ:standard / ptc / minimal / cordis。cordisは自らシェルアクセス相当と宣言していた
  • ・既定が変わった点:テレメトリが DISABLED から FEEDBACK_ONLY へ

DeepSeek Harnessとは何か——モデルではなく実行環境を配る

DeepSeekはこれまでモデル(V3、R1、V4系)で知られてきた。DeepSeek Harnessが配るのは逆側で、モデルに手足を与える実行環境だ。対象はモデル接続、bashやファイル編集などのツール、スキル、セッション永続化、サンドボックス、エージェントループ、そしてWeb UIそのものである。UIまでプラグインという点が、Claude CodeやCodex CLIのような完成品CLIとの違いだ。

土台はCordisというメタフレームワークで、リポジトリのvendor/に取り込んだものを@deepseek-aiスコープで再公開している。

開発者プレビューである点に注意

READMEは「互換性を壊す変更が入る」と警告している。本記事の数値は版ごとに動くので、再現コマンドを併記した。初期版の実測は2026年8月16日(macOS arm64、Node 22.13.1 / 22.14.0 / 22.15.0)、最新版の実測は2026年11月8日(Linux、Node 24.22.2)に行った。

DeepSeek Harnessの使い方——npxで起動し、キー無しでもUIは見られる

グローバルインストールは不要で、READMEの手順はnpx一行だ。起動前にNodeの版を確かめる。

node -v                      # v24.9.0 以上(0.2.2-rc.1)
npx @deepseek-ai/dsh web     # http://127.0.0.1:3080 に Web UI が立ち上がる

READMEによれば、ローカル起動ではブラウザが自動で開き、--no-openで抑止できる。SSH越しの起動ではホストURLを表示するだけだ。初期版の実測では、APIキーが無くてもUIは起動し、初回ダイアログを「Configure later」で閉じればプリセットや設定画面を見られた。最新版0.2.2-rc.1では、Web UIの起動までは確認していない(構成ダンプのみ実行)。

モデルを動かすにはキーが要る。既定のルートはdeepseek-official、既定モデルはdeepseek-v4-flashで、キーが無いと次のメッセージで止まる(初期版の実測)。

MISSING_CREDENTIAL の読み方

llm-deepseek: no API key for provider route "deepseek-official"と出たら、Web UIのModelsページから入力するか、環境変数DEEPSEEK_API_KEYを渡す。メッセージ自体が対処を書いている。

DeepSeek Harnessが起動しない原因——Nodeのバージョン要件

BOOT ORDER起動の順番

起動しないときはNodeの版から疑う

  1. node -v

    24.9.0以上か

  2. npx dsh web

    127.0.0.1:3080

  3. APIキー

    なければUIのみ

  4. モデル実行

    deepseek-v4-flash

出典: package.json の engines(0.2.2-rc.1)、README

「起動しない」の原因は、版によって異なる。

版 enginesの宣言 Nodeが足りないときの挙動
0.1.0-rc.6(2026年8月) なし 22.13.1と22.14.0はcreateZstdDecompressが無くSyntaxErrorで無言終了。22.15.0で通過
0.2.1-rc.5(同年10月29日公開) なし(npm viewで空) 初期版と同じ構造で、本記事では起動実測していない
0.2.2-alpha.2以降(同年10月27日公開〜) node >=24.9.0 npmが警告を出す。0.2.2-rc.1のpackage.jsonで確認

初期版の失敗は、セッション永続化プラグインがnode:zlibのcreateZstdDecompressをインポートするためだった。この関数はNode 22系では22.15.0で追加されている。enginesが無いので、npmは警告を出さず、利用者にはnode_modules奥のスタックトレースだけが見えた。

0.2.2-rc.1でもこのプラグインはcreateZstdDecompressを含む(同パッケージ内で2件)。ただしenginesが24.9.0以上を要求するようになったため、24系では関数は存在する(Node 24.22.2でtypeof zlib.createZstdDecompressがfunction)。Node 24.9.0未満での起動は、本記事では試していない。

手元のNodeに該当関数があるかは、次の一行で確かめられる。functionと出れば初期版のゲートは通過する。

node -e "console.log(typeof require('zlib').createZstdDecompress)"

注意として、@deepseek-ai/dsh本体は薄いラッパーで、実体はdsh-*系の依存パッケージにある。本体だけを展開して検索しても該当コードは0件になるので、機能を持つパッケージを名指しで調べる必要がある。

「すべてがプラグイン」を数える——構成ダンプは302行

--dump-default-configは、ユーザー設定を除いたプロファイル本来の構成を出力するフラグだ。同じコマンドを2つの版に実行して数えた。

npx @deepseek-ai/dsh@0.2.2-rc.1 --profile web --dump-default-config > dump.yml
grep -c "name:" dump.yml; grep -c "disabled: true" dump.yml
項目 0.1.0-rc.6(8月) 0.2.2-rc.1(11月)
ダンプの行数 490 1,243
プラグイン行(name:) 129 302
既定で無効(disabled: true) 25 29
dsh-baseへのパッチ(web-app側) 11 11

3か月でプラグイン行が2倍以上になった。各行の上にある# == @deepseek-ai/dsh-base, patched by @deepseek-ai/dsh-web-appのような注記が、誰が置き誰が上書きしたかを示す点は変わっていない。

初期版で無効だった25行には、bash・ファイル・Web・スキルなどのツール類がほぼ含まれていた。ツールを有効にするのはホストではなくプリセットの役割で、同梱の構成はこれをホストプレーン/エージェントプレーンと呼び分けていた。プリセットのサービスはisolateレルムの内側に置かないとマウント時に拒否される、という検査も初期版のソース読解で確認している(ライブ再現は未実施)。0.2.2-rc.1でこの検査が残っているかは未確認だ。

DeepSeek Harnessのプリセット4種の違い

0.2.2-rc.1のダンプにはpreset-standard / preset-ptc / preset-minimal / preset-cordisの4つがある。初期版のUI表示名は Standard / Code / Minimal / Creator で、内部ID(ptc、cordis)と表示名は一致しない。

プリセット 位置づけ 実測できた違い
standard ファイル編集・Shell・検索・スキル・サブエージェントを備えた全部入り 基準
ptc(Code) TypeScriptプログラムを書いて一括実行する Code Mode standardにdsh-tool-executor-ptcを足し、2行を無効化(0.2.2-rc.1のパッチ差分)
minimal bashとエディタだけの最小構成。ベンチマーク向け ペルソナは一文でcomplete: true、ランタイム情報も省く
cordis(Creator) プリセットを作るためのプリセット dsh-tool-cordisを追加

初期版ではCodeとStandardの差分はプラグイン1枚だった。0.2.2-rc.1でも、ptcの差分は実行プラグイン1枚の追加と無効化2行に収まる。モードの違いがプラグインの出し入れで表現されている点は同じだ。

cordis(Creator)の扱い

初期版の構成ファイルは、このプリセットのセッションを「シェルアクセスと同等に扱え」と明記していた。モデルが書いたJavaScriptを稼働中のランタイムで評価するためだ。0.2.2-rc.1のcordisパッチにはこの文言を見つけられなかったが、ツールの性質は変わっていない。信頼できない入力を読ませる用途や共有環境では選ばず、プリセット作成だけに使うのが安全側だ。

サンドボックス・テレメトリ・日本語UIは何が変わったか

WHAT CHANGED初期版からの変化

3か月で前提が4点変わった

0.1.0-rc.6(8月)

0.2.2-rc.1(11月)

0.1.0-rc.6(8月): engines 宣言なし

0.2.2-rc.1(11月): node >=24.9.0

0.1.0-rc.6(8月): テレメトリ既定 DISABLED

0.2.2-rc.1(11月): 既定 FEEDBACK_ONLY

0.1.0-rc.6(8月): 同梱ロケールは en と zh

0.2.2-rc.1(11月): ja を含む8言語

0.1.0-rc.6(8月): ダンプ129行・無効25

0.2.2-rc.1(11月): ダンプ302行・無効29

出典: npm の各版を取得して比較(2026-11-08)

サンドボックス:初期版の実測では、dsh-sandbox-localがOSごとに別の封じ込めを選んだ(Linuxはbwrap→Landlock、macOSはSeatbelt、WindowsはACL制限トークン)。封じ込めが使えない場合は素通しでなく失敗する(fail-closed)設計だった。0.2.2-rc.1にもdsh-sandbox-local・dsh-sandbox-windows-aclなどのパッケージはあるが、動作は再測定していない。READMEのSAFETY.mdは、サンドボックスや承認は被害を減らすだけで隔離を保証しないと明記している。

テレメトリ:初期版は既定がDISABLEDで、環境変数で有効化しない限り送信しなかった。0.2.2-rc.1の構成ダンプではprocess.env.DSH_TELEMETRY_MODE || 'FEEDBACK_ONLY'で、送信先の既定はhttps://dsh-otel-collector.deepseeksvc.com/v1/logsだ。同梱READMEによれば、FEEDBACK_ONLYは利用者が明示的にテキストやレーティングのフィードバックを送った後に記録を出す。DISABLEDにすると送信経路を作らない。運用で止めたいならDSH_TELEMETRY_MODE=DISABLEDを渡す。

日本語UI:初期版はenとzhだけで、ブラウザをja-JPにしても中国語UIが出た。0.2.2-rc.1ではjaを含む8言語(de・en・es・fr・ja・pt・ru・zh)のロケールがあり、フォールバック先はenと書かれている。UIを開いての確認はしていない。

モデル非依存:内部のpi-aiには43個のプロバイダーモジュールが同梱されていた(初期版)。DeepSeek側アダプタのdeepseek / openai / openai-completions / openai-responses / anthropic-messages / openrouterは6種のプロトコルで、対応6社という意味ではない。

DeepSeek Harnessと他のエージェント基盤の違い

  DeepSeek Harness OpenHarness Flue
提供元 DeepSeek AI HKUDS Astroチーム
言語 TypeScript Python TypeScript
中心思想 すべてがプラグイン(UIも含む) Claude Codeの中核をOSS化 プログラム可能なハーネス
UI Web UI同梱(プラグイン) CLI+個人AI ライブラリ(UIなし)
差し替え単位 構成YAMLのプラグイン行 設定・モジュール コード

Claude Codeの構造を再現するアプローチはOpenHarness徹底解説:Claude Codeの仕組みをOSS化したエージェント基盤で扱った。隔離をVMまで上げる設計はAgentENV:Firecracker microVMでAIエージェントを丸ごと隔離すると読み比べるとよい。エージェントとハーネスの関係自体はAIエージェントとは何か——2026年の実装水準で理解するが入口になる。

DeepSeek Harnessは、完成品のエージェントではなく、エージェントを組み立てる規約を配る。「すべてがプラグイン」は、構成ダンプの行数で数えられる主張であり、実測では額面どおりだった。ただし3か月でNode要件・テレメトリ既定・構成規模が変わっている。動かす前にnode -vを確認し、テレメトリの既定を確かめてから使うのがよい。

参照ソース

・deepseek-ai/deepseek-harness — GitHub公式リポジトリ(README、SAFETY.md。MITライセンス)
・DeepSeek Harness 公式ページ
・@deepseek-ai/dsh — npm(0.1.0-rc.6と0.2.2-rc.1を実測)
・cordiverse/cordis — 上流のCordis