dsh プラグインの仕組みと安全な見極め方
dsh プラグインはエージェントと同じ権限で他者のコードを実行します。読み込み時期やアクセス範囲、インストール前に確認する具体的な手順を解説します。
dsh プラグインとは何か、何ができるのか
dsh プラグインは、DeepSeek Harness が自身のプロセスに読み込む Node パッケージです。読み込まれたプラグインは、エージェントがすでに到達できるマシン上で、エージェントと同じ権限を使って他者のコードを実行します。ただし、インストール手順自体にはそれより強い制限があります。pnpm は、承認するまで依存関係のビルドスクリプトを保留します。また、CLI リファレンスには「Bundle を追加、削除、更新した後は、その Profile を再起動してください」と記載されています。そのため、dsh plugin で追加したプラグインは次回の再起動時に読み込まれます。Web の Plugins ページからインストールしたプラグインは、すぐに適用される場合があります。読み込まれたプラグインと harness の他の部分との間に、特別な隔離はありません。したがって、インストール前に確認すべきなのは、そのコードが何にアクセスできるか、そしてその範囲をどう小さく保つかです。
dsh (DeepSeek Harness) は、Cordis というプラグインフレームワーク上に構築された、DeepSeek AI のオープンソースのエージェント harness です。重要なのはこの中間部分です。エージェント harness は、モデルを取り囲み、ループ、ツール、権限を管理するプログラムです。プラグインは、まさにそのレベルで参加します。プロジェクト自身の README には、すべてがプラグインであると記載されています。モデルアダプターもプラグインです。入力に使う Web インターフェースもプラグインです。プロジェクト外からインストールしたものは、同じツリーの同じ信頼レベルに配置されます。まだ構築していない場合は、まず VPS 上で DeepSeek Harness を構築する ところから始め、何かを追加する前に戻ってきてください。
2026 年 8 月時点で、リポジトリの AGENTS.md には、プラグインがアクセスできる拡張ポイントが列挙されていました。内容は次のとおりです。
- LLM (large language model): API key の料金を支払うプロバイダー
- Shell: local および pwsh プロバイダーを備えた bash 機能
- Filesystem: ポリシーで制御されたファイルアクセス
- Web: search および fetch プロバイダー
- Subprocess: プロセスツリーのプロバイダー
- Workflow: worker thread
- Subagent: 追加のエージェントへの委任
- Settings and credentials: 保存済みの設定と環境変数
その一覧は現在、AGENTS.md から削除されています。2026 年 11 月 17 日時点では、プロジェクトの docs/architecture.md が拡張ポイントを別の形で示しています。そこでは、model、tool、shell、filesystem、subagent の接続点に加え、sandbox backend、persistent terminal、background job、human command、webhook でトリガーされる session も挙げられています。
プラグインは ctx.tools にツールも登録します。ドキュメントには、登録されたツールの schema が prompt の組み立てに組み込まれると明記されています。見落とされやすいのは、この後半です。プラグイン自身のコードが特別な処理をしなくても、プラグインが提供する説明文がモデルの読むテキストになるため、エージェントが何を実行するかを変えられます。これは コーディングエージェントに対する prompt injection と同じ種類の問題です。ただし、違いが 1 つあります。このテキストはインストール時に取り込まれ、プラグインを削除するまで残ります。
dsh はプラグインをどのように検出して読み込むか
グローバルなプラグインディレクトリはありません。実行中の dsh は、起動時に順序付きのレイヤーから構成されるプラグインツリーであり、その選択内容を保持する単位がプロファイルです。$DSH_HOME のデフォルトは ~/.dsh で、各プロファイルは $DSH_HOME/profiles/<name> にあります。web と headless のプロファイルは、初回使用時に提供されたテンプレートから自動的に作成されます。
プロファイルディレクトリには、すべてを決定する2つのファイルがあります。
package.json。ツリー外プラグインの依存関係と、順序付きのbundlesリストを含むdsh.profileマニフェストを格納しますcordis.patch.yml。これらのバンドルに対する独自のパッチレイヤーです
ls ~/.dsh
ls ~/.dsh/profiles/web起動時には、レイヤーが次の順序で適用されます。後のレイヤーが優先されます。
- 空のルート
- マニフェストに記載された順序で適用される、プロファイルのバンドル
- プロファイルの
cordis.patch.yml $DSH_HOME/cordis.patch.yml- コマンドラインで渡された
--patch <path>オーバーレイ
次の2つのフラグを使うと、何も起動せずにこの構成結果を表示できます。
dsh --profile web --dump-default-config
dsh --profile web --dump-config--dump-default-config はバンドルレイヤーだけを表示します。--dump-config は、プロファイルとホームのパッチレイヤー、および --patch オーバーレイを追加します。そのため、次回の起動時に読み込まれる内容を正確に把握するには、これが最も近いインベントリになります。引き継いだマシンを信頼する前に、この結果を確認してください。
これらのパッチファイルについて、1つ注意が必要です。ここでは設定は単なるデータではありません。この形式では、プラグインの config ブロック内に !!js タグ付きの値を記述できるためです。フォーラムの投稿からコピーした cordis.patch.yml スニペットはコードです。同じ投稿元のシェルスクリプトと同じように扱ってください。
dsh plugin add は実際には何を実行するのでしょうか。
dsh plugin --profile <name> <args> は引数を、そのプロファイルのディレクトリ内で pnpm に渡します。そのため、pnpm が PATH に含まれている必要があります。動詞は pnpm の動詞です。
dsh plugin --profile web add '<package-or-git-spec>'
dsh plugin --profile web remove '<package-name>'
dsh plugin --profile web why '<package-name>'
dsh plugin --profile web updateしたがって、dsh プラグインのインストールに関するセキュリティモデルは、npm 形式の依存関係をインストールする場合のセキュリティモデルに加え、結果をエージェントに読み込ませる追加の手順を含むものです。パッケージは独自の依存関係ツリーを持ち、そのツリー内のすべてのパッケージが同じプロセス内で実行されます。npm のサプライチェーン攻撃がサーバーに到達する仕組みに関する内容は、ここにもそのまま当てはまります。
pnpm 10 以降では、依存関係のビルドスクリプトはデフォルトで実行されません。許可は pnpm approve-builds または allowBuilds 設定でパッケージごとに指定します。pnpm 11 では、以前の onlyBuiltDependencies 設定が allowBuilds に置き換えられました。そのため、現在の pnpm で onlyBuiltDependencies を使っているガイドや古い設定では、何も許可されません。使用中の pnpm を確認します。
pnpm --versionGit ホスト型プラグインでは、まずこの問題に遭遇します。CLI リファレンスによると、ソースコードを提供する Git プラグインは、インストール時に prepare スクリプトでビルドされます。そのため、最初の add は pnpm の allowBuilds という案内を表示して失敗します。表示されたキーをプロファイルの pnpm-workspace.yaml にコピーして、再実行します。このキーを許可すると、リポジトリのビルドがユーザーの権限で実行されます。ビルド済み tarball とローカルチェックアウトでは、許可は必要ありません。
このデフォルト設定には価値があります。一方で、エコシステム内で安全機能として過大評価されている機能でもあります。ブロックされたビルドスクリプトは、インストール中のコード実行を停止するだけです。プラグイン自体には何も対処しません。プラグインの本来の目的は、プロファイルの再起動後にハーネスがプラグインを import して呼び出すこと、または Web の Plugins ページを使った場合にインストールの適用直後に呼び出すことだからです。プラグインに postinstall hook は必要ありません。プラグインは明示的に追加されたものです。
インストール前に dsh プラグインについて読むこと
公開されている tarball をダウンロードして読みます。アーカイブを展開しただけでは、何も実行されません。
npm pack '<package-name>@<version>'
tar -tzf '<package-name>-<version>.tgz'
tar -xzf '<package-name>-<version>.tgz'
less package/package.jsonその package.json にある 4 つのフィールドを確認すれば、必要な情報の大半が分かります。scripts で preinstall、install、postinstall のエントリを確認します。見覚えのない名前や、知っている名前と 1 文字だけ異なる名前は dependencies で確認します。パッケージが PATH に追加しようとするものは bin で確認します。エントリーファイルは main または exports で確認し、そのファイルを開いて処理を追います。
次に、実際に読み込まれるコードを確認します。通知ツールを提供すると説明するプラグインが、~/.ssh を読み取ったり、聞いたことのないホストへ接続したり、シェルを起動したりする理由はありません。パッケージに同梱された、または minify された JavaScript しかなく、公開リポジトリに対応するソースがない場合は、それが判断材料になります。ソースを読めるプラグインを優先し、小規模なものを選びます。
インストールせずにレジストリを調べることもできます。
pnpm view '<package-name>' dependencies
pnpm view '<package-name>' versions先週公開されたばかりで、バージョンが 1 つしかなく、repository フィールドがなく、人気のあるものと同じ名前を使っているパッケージは、どのレジストリにもある古典的な手口です。チェックサムでダウンロードを検証することも隣接する基本習慣です。実行を許可する前に、何を取得したのかを正確に把握します。
バージョンを固定し、lockfileを保持する
浮動バージョン範囲では、判断しなくてもインストールや更新のたびに agent のプロセス内のコードが変わる可能性があります。バージョンを固定してください。
dsh plugin --profile web add --save-exact '<package-name>@<version>'pnpm のバージョンによってフラグの位置が異なるため、コマンドをそのまま信頼せず、結果を確認してください。その後、プロファイルの package.json を開き、依存関係が先頭に ^ や ~ のない単独のバージョンとして記述されていることを確認します。実際にインストールされる内容は、このファイルで決まります。
次に lockfile を保持します。lockfile はトップレベルの名前だけでなく、依存関係全体のツリーを固定します。
find ~/.dsh -maxdepth 3 -name 'pnpm-lock.yaml'プロファイルの package.json とともに、バックアップ対象の場所へコピーしてください。この 2 つのファイルがあれば、新しいマシンで同じツリーを再構築できます。バージョンを変更すると決めた場合にのみ dsh plugin --profile web update を実行し、定期的な整理のためには実行しないでください。その後、lockfile の差分を確認します。
レジストリではなく git からインストールするプラグインの場合は、ブランチではなくコミットを固定してください。github:owner/repo#<full commit sha> 形式の指定により、固定されたツリーを使用できます。ブランチ名を指定すると、次回 pnpm が解決するときに、そのブランチが保持している内容が使われます。これは別の人に判断を委ねることになります。harness 自体にも同じ規律が必要です。npm latest リリースはリリース候補であり、固定しないインストールでは、その日に応じて別のものに解決される可能性があります。これが、dsh のインストールとバージョンのエラーの大半の原因です。
プラグイン市場と「キュレーション」の価値
dsh にはマーケットプレースがあり、プラグインとしてインストールされます。これは、アーキテクチャについて重要なことを示しています。
dsh plugin --profile web add dshmarket再起動すると、dsh 0.2.1 以降では Plugins ページの Installed の隣にタブとして表示されます。古いホストでは、Settings、次に Plugin Market を開きます。README には制限が明記されています。インストール元はキュレーション済みレジストリに記載されたソースに限定され、それ以外は拒否されます。ビルドスクリプトはデフォルトでブロックされ、1 つを有効にするにはパッケージごとの承認が必要です。ターミナルプラグインは、Web プロファイルに追加される前に警告されます。最も重要な記述は、プラグインがサードパーティーコードであるため、掲載は推奨を意味しないという点です。同じ README には、これを通じてインストールしたプラグインの多くは、再起動せずにページを更新するだけで有効になるとも書かれています。つまり、ワンクリックでインストールしたプラグインが数秒後にはエージェント内で実行されている可能性があります。
キュレーション済みのリストは、最低限の品質を引き上げます。ただし、コードを代わりに確認してくれるわけではありません。また、メンテナーアカウントの所有者が変わった後、次のバージョンのプラグインが何をするかも判断できません。ワンクリックインストールは、同じ作者による curl | bash と同じように扱ってください。README からもう 1 つ引用する価値のある記述があります。エクスポートしたバックアップには、プロファイル設定の認証情報が含まれる場合があります。そのため、公開 issue や paste site に添付してはいけません。手順ではなく開始点となるリストが必要なら、インストールする価値のある dsh プラグインがこの投稿の関連記事です。
ハーネスにも独自の経路があります。実験的な Custom plugin indexes bundle を Plugins ページから有効にすると、自分で追加した index file を元に Discover タブが追加されます。dsh には index source が付属していません。ドキュメントには、index はサードパーティーコンテンツであり、dsh が確認するのはファイル形式だけで、index が示すプラグインのタイトル、作者、ソースの内容までは確認しないと記載されています。
dsh を root ではなく専用ユーザーで実行する
事前確認により、問題が侵入する頻度を下げられます。侵入後に到達できる範囲は、最小権限で制限します。VPS では、この対策を安価に導入できます。
専用の home を持つ専用の unix アカウントを harness に割り当て、root では決して実行しないでください。
sudo adduser --disabled-password --gecos "" dshrun
sudo -iu dshrunそのセッション内で harness を起動し、そのアカウントの home に書き込ませます。
npx @deepseek-ai/dsh webWeb UI はデフォルトで http://127.0.0.1:3080 で待ち受けます。そのままにしてください。別のマシンから表示されたリンクをクリックしても応答がなかった経験がある場合は、dsh がそのアドレスを表示する理由を参照してください。提供されている Web 構成は Host ヘッダーと Origin ヘッダーを確認し、すべての Host RPC メソッドと WebSocket ストリームで、認証済みのブラウザーまたは API Peer を要求します。また、dsh web は --host 0.0.0.0 を拒否します。API の呼び出し元は /connect で認証され、署名済みの API cookie を受け取ります。このログインは 2 つ目の鍵として扱い、3080 を公開する理由にはしないでください。その背後には shell を持つ agent があるため、セッション token の漏えいや公開ポート上のログインの不具合により、見知らぬユーザーに使いやすいインターフェース付きの root 権限なしリモート shell を渡すことになります。代わりに、SSH tunnel を使って laptop から接続してください。
ssh -L 3080:127.0.0.1:3080 you@your-vps次に、公開アドレスで待ち受けているものがないことを確認します。
ss -lnt | grep 3080ローカルアドレスは 127.0.0.1:3080 になっているはずです。0.0.0.0:3080 になっている場合は、別の composition や設定変更など、提供されている dsh web のデフォルト以外の設定によって変更されています。その composition が独自の認証を管理します。プロジェクトのドキュメントによると、基盤となる Web server 自体には認証機能も Origin policy もありません。そのポートを何が保護しているか確認するまでは、見知らぬユーザーと agent の間にあるのは firewall だけだと考え、loopback に戻してください。VPS で Claude Code を安全に実行する方法の考え方は、そのまま dsh にも適用できます。agent には、破壊されてもよい workspace directory を 1 つだけ割り当て、再構築できないものはそのマシンの外に保管してください。さらに、マシンをcoding agent 用の使い捨て VMとして扱うのが望ましいです。VPS の再構築は 1 時間で済みますが、監査には 1 週間かかるためです。
キーの保存場所と、ファイル権限だけでは不十分な理由
dsh は API キーを $DSH_HOME/.credentials.yaml に、環境変数の値を $DSH_HOME/.env に保存し、モデル設定をアクティブなプロファイルの cordis.patch.yml に保存します。このガイドを最初に確認した 2026 年 10 月の時点では、以前のリリースの $DSH_HOME/settings.yaml が 1 回だけインポートされ、settings.yaml.imported に名前変更されていました。これらのファイルのどれにどのキーを保存するのか、また各モードで実際に何がマシンの外部へ送信されるのかについては、dsh の API キー、モデル、エンドポイントを設定するで説明しています。プラグインを追加する前に、この点を明確にしておく価値があります。設定したキーはすべて、プラグインが読み取れる情報になるためです。機密性の高い 2 つのファイルを保護します。
chmod 600 ~/.dsh/.credentials.yaml ~/.dsh/.env
ls -l ~/.dshモード 600 では、所有者に読み取りと書き込みを許可し、それ以外のユーザーには何も許可しません。これは、chmod の数値形式と記号形式のモードのどちらで指定する場合にも知っておくべき点です。この設定で得られる保護を正しく理解してください。ファイルモードは、同じマシン上の別のアカウントからファイルを保護します。しかし、プラグインに対しては何の効果もありません。プラグインは、ファイルを所有するユーザーとして、ファイルを読み取るプロセス内で実行されるためです。そのため、AI エージェントの到達範囲から Secret を隔離するには、そもそもそれらをマシン上に置かないことが必要です。dsh の環境には、必要なモデルキー 1 つだけを保存してください。クラウド認証情報と署名キーは、別の場所に保存します。
Web を読み取るプラグインで脅威モデルが変わる理由
Web の seam は、プラグインに検索プロバイダーと取得プロバイダーを提供します。プラグインがページをセッションに取り込む場合、攻撃者が書き込めるテキストを取り込むことになります。モデルのプロンプトは命令とデータを分離しないため、取得したページにエージェント宛ての行を含めることができます。shell capability を持つ harness は、それに従って実行するまであと 1 ステップです。
制御機能はすでに harness にあります。dsh-base は、web、headless、sdk、acp profile に共通する最初の bundle であり、sandbox と approval policy を提供します(sdk-minimal profile では意図的に含めていません)。これを使用してください。信頼できないページを取得できるセッションでは、書き込みや実行を行う操作すべてに approval を要求する必要があります。これにより、取得した命令だけで操作が実行されることを防げます。エージェントの操作を approval の背後で制御するでは、その境界をどこに設定するかを検討する方法を説明しています。この関係は逆方向にも成り立ちます。あなた自身のサーバーも、誰かの agent が取得するページだからです。これは、サーバー上の AI crawler をブロックする場合にも当てはまります。
プラグインが変更した内容を確認するにはどうすればよいですか?
インストール前にスナップショットを作成し、インストール後にもう一度スナップショットを作成してから、差分を確認します。
dsh --profile web --dump-config > /tmp/dsh-before.txt
dsh plugin --profile web add '<package-name>@<version>'
dsh --profile web --dump-config > /tmp/dsh-after.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after.txt差分には、インストールによって合成ツリーに追加されたプラグインのエントリが表示されます。バンドルパッチを宣言したパッケージだけがツリーに追加されます。通常の依存関係はそこに何も追加せず、dsh がそのことを 1 回警告します。1 つの小さな機能のためにインストールしたプラグインが、把握できない複数のエントリを追加する場合は、起動する前に停止してソースを読むべきです。どの直接依存関係が特定のパッケージを取り込んだかという別の疑問には、dsh plugin --profile web why <package-name> が答えます。
インストール済みパッケージはプロファイル固有の node_modules に、$DSH_HOME/profiles/<name>/node_modules で配置されます。そのため、ディスク上のツリーも確認できます。
ls ~/.dsh/profiles/web/node_modules実験には使用しない 2 つ目のプロファイルを用意してください。インストールによってハーネスが壊れた場合は、dsh --profile <clean-name> を起動すれば、プラグインが原因かどうかを数秒で確認できます。
dsh プラグインを削除するにはどうすればよいですか?
dsh plugin --profile web remove '<package-name>'
dsh --profile web --dump-config > /tmp/dsh-after-removal.txt
diff -u /tmp/dsh-before.txt /tmp/dsh-after-removal.txt依存関係を削除しても、設定が常に削除されるとは限りません。プロファイルの cordis.patch.yml に書き込まれたエントリは、そのまま残ります。このファイルはユーザー自身が管理するものであり、harness が自動的に書き換えることはありません。ファイルを開き、削除したパッケージ名を含むブロックを削除してください。
less ~/.dsh/profiles/web/cordis.patch.yml次に、アンインストールコマンドでは解決できない点を確認します。信頼できなくなったためにプラグインを削除した場合、そのプラグインが読み取れた情報は、すでに読み取られている可能性があります。provider console で DeepSeek API key をローテーションし、$DSH_HOME に置かれていたその他の情報もローテーションしてください。そのうえで、プラグインが実行されていた unix アカウントから、ネットワーク上のどの範囲にアクセスできたかを確認します。
短くまとめると
- インストール前に公開された tarball を確認します。
scriptsとエントリーファイルから読み始めます - 正確なバージョンを固定します。git spec の場合は正確な commit を固定し、lockfile を保持します
- 1 つの profile にインストールします。問題が発生したときに起動できるクリーンな profile も保持します
- インストールの前後で毎回
--dump-configを diff します - harness は専用の unix user として loopback 上で実行し、SSH 経由でアクセスします
- API key はサーバー上に 1 つだけ保持します。信頼しなくなった plugin を削除した日にローテーションします
これは plugin を避ける理由にはなりません。plugin モデルが dsh を有用にしており、拡張できない harness はいずれ置き換えることになります。重要なのは、何を、誰から、どのバージョンでインストールしたかを把握し、全体を再構築できる環境で実行することです。
FAQ
dsh はプラグインを相互にサンドボックス化しますか?
いいえ。プラグインは Cordis を通じてハーネスプロセスに読み込まれ、shell、filesystem、web、subprocess、subagent、credentials など、文書化された機能境界にアクセスできます。dsh-base は、web、headless、sdk、acp の共有される最初のバンドルであり、エージェントのツールが実行できる操作を制御するサンドボックスと承認ポリシーを提供します。保護はこのポリシーによって実現されます。プラグインごとの権限境界はありません。そのため、プラグインをインストールすると、その作成者と依存関係ツリー内のすべてのパッケージを信頼することになります。
インストールスクリプトを実行せずに dsh プラグインをインストールできますか?
pnpm 10 以降では、依存関係のビルドスクリプトがデフォルトでブロックされます。dsh plugin ... add は pnpm に処理を引き渡すため、現在の pnpm では、パッケージを承認しない限りインストール時にパッケージスクリプトは実行されません。pnpm --version でバージョンを確認してください。ただし、これで未確認のプラグインが安全になるわけではありません。ハーネスがプラグインを読み込むと、そのプラグイン自身のコードが実行されます。dsh plugin によるインストール後は、次回のプロファイル再起動時に実行されます。また、Web の Plugins ページからインストールした場合は、通常、直ちに実行されます。インストール時の制限は、この実行に影響しません。
dsh のプラグインと設定は実際にはどこに保存されますか?
$DSH_HOME のデフォルト値は ~/.dsh です。プロファイルは $DSH_HOME/profiles/<name> に配置されます。各プロファイルには、プラグインの依存関係を含む package.json、順序付けされたバンドルの dsh.profile マニフェスト、および cordis.patch.yml パッチ層があります。インストール済みパッケージは各プロファイル固有の node_modules、つまり $DSH_HOME/profiles/<name>/node_modules に配置されます。キーは $DSH_HOME/.credentials.yaml、環境値は $DSH_HOME/.env に保存されます。また、ホームレベルの $DSH_HOME/cordis.patch.yml がすべてのプロファイルに適用されます。dsh --profile web --dump-config を実行すると、起動せずに統合後の結果を確認できます。
dsh プラグインマーケットからインストールしても安全ですか?
マーケットでは、厳選されたレジストリにあるソースからのインストールだけが許可されます。また、パッケージごとに承認しない限りビルドスクリプトをブロックします。これは、チャット画面からパッケージ名を貼り付けてインストールするよりも、実際に安全性を高めます。ただし、マーケット自身の README にも、掲載は推奨を意味しないと記載されています。プラグインは第三者が作成したコードだからです。ソースを確認し、バージョンを固定してください。ハーネスは、失っても許容できるユーザーアカウントで実行してください。理想的には、失っても許容できるマシンを使用してください。