DeepSeek Harness(dsh)プラグインのインストール方法:CLI・プロファイル・トラブル対処(2026)

正確なコマンドは dsh plugin --profile web add <package-or-source>。npm と GitHub の書き方、npx 形式、プロファイルの場所、再起動、トラブル対処までを解説します。

最終更新: 2026-11-12

正確なコマンド

npm または GitHub の DeepSeek Harness プラグインを Web UI のプロファイルに入れるコマンドは次のとおりです。

dsh plugin --profile web add <package-or-source>

--profile web は add の前に置きます。具体的には:

# npm:スコープ付きパッケージ、またはパッケージ名のみ
dsh plugin --profile web add @liustack/modlens
dsh plugin --profile web add dshmarket

# GitHub:リポジトリ指定(ブランチ・タグ・コミットで固定可能)
dsh plugin --profile web add github:owner/repo
dsh plugin --profile web add github:owner/repo#main

# グローバルインストールしない場合の npx 形式
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens

導入後は再起動してプラグインツリーを組み直します。

npx @deepseek-ai/dsh web      # または dsh web

dsh plugin は別のパッケージマネージャーではありません。引数をプロファイルディレクトリ(~/.dsh/profiles/web/)内の pnpm に転送し、導入されたパッケージをプロファイルの bundle 一覧に組み込んで初めてプラグインが読み込まれます。だからこそ指定は pnpm が理解できる形式(レジストリ名、github:owner/repo、link:/path/to/plugin)である必要があり、--profile を先頭に置く必要があります。add より後ろは pnpm の引数であり、ランチャーのものではないからです。

Node.js 24.9 以上が必要です(公式 README と @deepseek-ai/dsh npm パッケージが宣言している下限で、Node 22 はサポート対象外)。本ページの事実は 2026-11-12 に公式 README、CLI ドキュメント、公開中の npm パッケージで確認しました。

ハーネス本体をアップグレードする前に

dsh は開発者プレビューです。2026-09-28 の 0.2.0 アップグレード波のあとも npm latest は何度か動いており、当時は公式ディスカッションに互換性報告が並びました——プラグインの大量死(#8145)、ワークスペースの消失(#8140)、Windows サンドボックスの 0xC0000142(#8141–#8143)。あのリリースにはプラグイン利用者に効く点が 2 つあります。自動化タスクがオプションのプラグインバンドルに移行(アップグレードすると定期タスクが消え、バンドルを入れ直すまで戻りません)、プラグイン管理 UI の作り直し。本体に触れる前に:

# 1. プロファイルをバックアップ
cp ~/.dsh/profiles/<name>/cordis.patch.yml ~/dsh-profile-backup.yml

# 2. 実際に公開されているバージョンを確認——@latest が安定版とは限らない
npm view @deepseek-ai/dsh version          # 2026-11-12 時点は 0.2.2-rc.1

# 3. アップグレードは正確なバージョンで固定し、挙動がおかしければ戻す
npm install -g @deepseek-ai/dsh@<version>

0.2.x アップグレードの波及を「症状 → 原因 → 対処」で追えるのはトラブルシューティングガイドです。

1. CLI コマンド早見表(Quick Reference)

CLI での操作に慣れている方は、以下のコマンド早見表をご活用ください。

# 1. ハーネスを起動(Node.js 24.9 以上)。グローバルインストールは任意
npx @deepseek-ai/dsh web

# 2. web プロファイルにプラグインを追加(npm レジストリから)
dsh plugin --profile web add dshmarket
dsh plugin --profile web add @liustack/modlens

# 3. 別のプロファイル(headless や自作プロファイル)に追加
dsh plugin --profile headless add tokenledger

# 4. GitHub リポジトリから直接インストール(ブランチ / タグ / コミット指定可)
dsh plugin --profile web add github:volcengine/openviking#main

# 5. 開発中のローカルプラグインをリンク
dsh plugin --profile web add link:/path/to/my-dsh-plugin

# 6. プラグインを削除
dsh plugin --profile web remove dshmarket

# 7. プロファイルが最終的に何を解決したか確認
dsh --profile web --dump-config

2. DSH の「すべてがプラグイン」アーキテクチャ

DeepSeek Harness(dsh)は Cordis マイクロカーネルアーキテクチャを採用しています。UI テーマ、推論ルーティング、ビジョン OCR、記憶管理、各種 CLI ツールに至るまで、すべての機能がプラグインとして独立して提供されます。

エコシステムも見て回りやすい:GitHub の dsh-plugin トピックだけでも数千の公開リポジトリが登録され、公式 deepseek-ai/deepseek-harness が先頭に並びます。

GitHub の dsh-plugin トピックページに 7,654 件の DeepSeek Harness 公開プラグインリポジトリ、Everything is a Plugin のクジラバナー

GitHub の dsh-plugin トピック――数千のコミュニティリポジトリ。

なぜ DSH プラグインは「完全な可逆性」を持つのか?

従来のパッケージマネージャーでは、アンインストール時に不要なファイルや壊れた状態がシステムに残ることがありました。DSH では、プラグインの導入は設定レイヤーに宣言的な 1 行を追加することと同義です。

  • 起動時: Cordis コンテナがパッチ設定を読み込み、依存ツリーを下から上へと自動構築します。
  • 削除時: 設定から該当行を削除して再起動するだけで、プラグインが登録した API、ツール、コンテキストフック、UI パネルが跡形もなく即座に破棄されます。

3. 3 つの主要インストール方法

利用環境や好みに合わせて最適な方法を選択できます。

公式の講義スライドは、日常的な 3 つの方法――ターミナルコマンド、チャットでのお願い、プラグインマーケット――を 1 枚にまとめたものです。本ガイドではさらに設定ファイルとプロファイルまで掘り下げます。

DeepSeek Harness プラグインの3つのインストール方法を示す講義スライド:コマンドインストール・会話インストール・プラグインマーケット

公式が示す3つのプラグイン導入方法。

方法 1: CLI コマンドによる追加(推奨)

dsh plugin add コマンドを使用すると、パッケージの解決・取得・設定ファイルへの追記が自動的に行われます。

# バージョンを指定してインストール
dsh plugin add dsh-mnemon@^1.2.0

# オプション付きで特定プロファイルに追加
dsh plugin --profile web add @scope/custom-theme --port 8080

方法 2: 設定ファイルでの明示的宣言(cordis.patch.yml)

Git などで開発環境の設定を一元管理したい場合は、パッチ設定ファイルを直接編集します。

# ~/.dsh/profiles/default/cordis.patch.yml またはプロジェクトルートの .dsh/cordis.patch.yml
plugins:
  # 視覚・OCR ツールプラグイン
  dsh-vision-toolkit:
    enabled: true
    options:
      ocrEngine: 'default'
      maxImageSizeMb: 10

  # 長期記憶・コンテキスト拡張プラグイン
  volcengine/openviking:
    enabled: true
    options:
      persistPath: '~/.dsh/memory/viking.db'

編集完了後、dsh を起動して新しいプラグインツリーを読み込ませます。

方法 3: ビジュアルマーケットプレイスでの導入(Web UI)

Web インターフェースをご利用の方は、まず dsh-market プラグイン を導入するのが便利です。

一番手軽なのは会話インストール:チャットで「これを入れて」と伝えるだけです。下のキャプチャでは、DSH が dshmarket v1.14.1 を取得・検証・ホットリロードし、会話を離れずに完結しています。

DeepSeek Harness Web UI のチャットで DSH Market プラグインを会話インストール、dshmarket v1.14.1 を検証してホットリロード

チャットで dsh-market を依頼、完了後すぐホットリロード。

  1. Web 画面で Settings → Plugin Market に移動します。
  2. 導入したいプラグイン(dsh-web-ui や modlens など)を検索します。
  3. Install をクリックすると、バックグラウンドで自動的に設定が更新され反映されます。

コミュニティマーケットのダイアログで dsh-market と検索すると、一覧は一致するカードにすぐ絞り込まれます。

DeepSeek Harness コミュニティプラグインマーケットのダイアログで dsh-market を検索、一致するプラグインカードを表示

Web UI 内蔵のコミュニティマーケット検索。

カードを開くと詳細ポップアップ:概要、正確な dsh plugin add 手動コマンド、ソースリポジトリと DSH マーケットへのショートカットが並びます。

DeepSeek Harness dsh-market プラグインの詳細ポップアップ、手動インストールコマンド dsh plugin add とマーケットボタン付き

dsh-market の詳細ポップアップ、手動コマンド付き。

導入後の管理も同じダイアログで完結:「インストール済み」タブには、プラグインごとに有効トグル・更新状態・アンインストールボタンが揃っています。

DeepSeek Harness Web UI 設定プラグインマーケットのインストール済みリスト、各プラグインにトグルとアンインストールボタン

インストール済みプラグインは同じダイアログで管理。

中国国内でのインストール高速化:公式ソース切り替えと npmmirror ミラー

デフォルトの npm レジストリだとダウンロードが止まりやすい環境では、次の2つの方法で高速化できます。

1. 公式のソース切り替え(0.1.7 系とともに latest チャネルへ):リリースノートによると、プラグインのインストールで 公式ソース / npmmirror ミラー / カスタムソース を選択できるようになり、インストール例と進捗表示も提供されます。0.1.7 系では「初回インストール時にソース未設定なら、到達可能な最適な npm レジストリを自動選択する」挙動も追加されています。npm latest は 2026-09-28 に 0.1.7 系(0.1.7-rc.2)へ切り替わったため、現在の安定版にこの機能は含まれています。

2. npm レジストリを npmmirror に向ける(今すぐ使える):定番の対処はレジストリを npmmirror ミラーに向けること。プラグインのダウンロードを高速経路に乗せます。

# レジストリを npmmirror に設定(-g を外すと現在のプロジェクトのみ)
npm config set registry https://registry.npmmirror.com

# その後は通常どおりインストール
dsh plugin add <owner>/<repo>

dsh plugin add github:owner/repo が GitHub への直接接続でタイムアウトする場合は、リポジトリをクローンして方法1のデバッグモードでローカルパスからインストールするか、プロキシ設定後に再試行してください。npmmirror は npm 公式データの完全ミラーです。企業内ネットワークでは公式スイッチャーにプライベートレジストリをカスタムソースとして登録できます。


4. プロファイルによる環境分離と切り替え

プロファイル機能により、用途ごとに異なるプラグインの組み合わせを分離して管理できます。たとえば、ローカル開発では Web UI やデバッグツールをフル活用し、CI/CD パイプラインでは軽量な Headless モードで実行するといった使い分けが可能です。

プロファイル設定ファイルの階層

  1. グローバルプロファイル: ~/.dsh/profiles/<profile-name>/cordis.patch.yml(すべてのワークスペース共通)
  2. プロジェクト別プロファイル: <project-root>/.dsh/cordis.patch.yml(現在のプロジェクトにのみ適用、グローバルより優先)

プロファイルの起動

# Web UI モードで起動(Web プロファイルのパネルやスキンを読み込み)
dsh --profile web

# 自動化用 Headless モードで起動(推論とコード実行プラグインのみ)
dsh --profile headless --task "run all tests and fix lint errors"

# TUI ターミナル強化モードで起動
dsh --profile tui

5. よくあるエラーとトラブルシューティング

プラグインの導入・読み込みで問題が発生した場合は、以下の確認を行ってください。

残高不足のエラーにも要注意:マーケット導入の最中、軌跡に赤い Insufficient Balance が浮かぶことがあります。DeepSeek API の残高切れなので、チャージして再試行してください。

DeepSeek Harness プラグインインストール中の軌跡に赤い Insufficient Balance(残高不足)quota エラー

残高切れでマーケット導入が止まった場面。

1. Plugin failed to register / Lifecycle timeout

  • 原因: Node.js バージョンが古い、またはプラグインのビルド成果物が不足している。
  • 対処法: Node.js 24.9 以上がインストールされていることを確認してください(Node 22 はサポート対象外)。ソースから導入した場合はプラグインフォルダ内で pnpm install && pnpm build を実行してください。

2. Profile patch collision / Override order issue

  • 原因: 同じ目的の競合するプラグイン(サイドバー UI など)が同一プロファイルに複数読み込まれている。
  • 対処法: cordis.patch.yml を開き、プラグインの読み込み順序を調整するか、片方を別プロファイルに退避させてください(下流の設定が上書きされます)。

3. Permission denied / Sandbox security policy violation

  • 原因: デフォルトの安全サンドボックスにより、ファイルアクセスや外部ネットワーク通信が遮断された。
  • 対処法: DSH はデフォルトで read-only サンドボックスで動作します。信頼できるプラグインでディスク書き込みが必要な場合は、dsh --sandbox workspace-write を指定して起動してください(詳細は セキュリティガイド を参照)。

4. pnpm-workspace allowlist / ESM CJS 読み込みエラー

  • 原因: monorepo 環境での依存関係制限。
  • 対処法: プロジェクトルートの package.json や pnpm-workspace.yaml に該当パッケージを追加してください。

6. 5 分でできるプラグイン安全確認チェックリスト

提供元が不明なサードパーティ製プラグインを導入する前に、以下の 5 点を確認することをおすすめします。

  1. README を読む: 機能範囲、必要な環境変数、外部通信の有無を確認する。
  2. ライセンスを確認する: MIT、Apache-2.0 などの標準的なオープンソースライセンスか確認する。
  3. エントリーポイントのコードを確認する: ~/.ssh/ や ~/.aws/ などの機密領域にアクセスしていないかチェックする。
  4. コミュニティの健全性を確認する: 本サイトの詳細ページに記載されている GitHub Star 数、直近 90 日の Push 活動、Issue 状況を確認する。
  5. 当サイト独自の評価があるか確認する: 「レビュー済み」バッジのページには、当サイト独自のリポジトリ評価が付いています。「キュレーション」は、コミュニティの awesome リストに載っているというだけの意味です。どちらもセキュリティ監査ではありません。

7. よくある質問(FAQ)

Q: npm のような一発インストールコマンドはありますか?
A: はい。dsh plugin add <package>(例: dsh plugin add dsh-vision-toolkit)を使用すれば、パッケージ取得と設定追記がワンストップで実行されます。

Q: プラグイン導入後に dsh の再起動は必須ですか?
A: 必須です。DSH は起動時にプラグインツリーを動的に解決するため、設定変更後は dsh を再起動してください。

Q: 不要になったプラグインを完全に削除する方法は?
A: dsh plugin remove <package> を実行するか、cordis.patch.yml から該当行を削除して再起動します。Cordis の可逆設計により、残骸ファイルは一切残りません。

Q: このディレクトリに掲載されている 31,000 件以上のプラグインはすべて審査済みですか?
A: いいえ。ほとんどのエントリは GitHub から自動で収録し、リポジトリ自身の説明のまま掲載しています。コードの監査は行っていません。「レビュー済み」バッジのページには当サイト独自の評価が付いていますが、これもセキュリティ監査ではなく、「キュレーション」は awesome リストに載っているという意味だけです。第三者のコードを導入する際は、上の 5 分チェックリストを必ず実施してください。


8. 次に読むおすすめガイド

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。