dsh プラグインとは？DeepSeek Harness プラグインの仕組みを解説

一文で答えると

dsh プラグイン とは、DeepSeek のオープンソースエージェントランタイムである DeepSeek Harness の一部を追加、あるいは完全に置き換える Cordis プラグインのことです。Cordis は dsh の下にあるメタフレームワークで、ロード、アンロード、依存解決を担い、プラグイン同士はサービスとイベントで協調します。

ブラウザ拡張や VS Code アドオンとの決定的な違い：dsh プラグインは製品の端に付け足すものではありません。dsh では すべて がプラグインです。モデルアダプター、ツールレジストリ、承認ポリシー、セッションログ、サンドボックス、Web UI、メインのエージェントループまで。コミュニティ製プラグインは組み込みプラグインと同じ段に立つので、これだけ多くを変えられるのです。

dsh プラグインにできること

プラグインはランタイムのあらゆる継ぎ目に差し込まれるので、守備範囲は広いです。

• ツールを追加 ―― モデルが呼べるもの。検索プロバイダー、データベースコネクター、タイトル生成器など
• UI を交換 ―― スキン、サイドバー、ステータスバー、パネル全体（Web UI はマウントポイント宣言つきの第 2 のプラグインツリー）
• エージェントの振る舞いを変える ―― ツール実行をインターセプトして承認・ログ・書き換え。ループやタイムアウトへのガード追加
• インフラを提供 ―― サンドボックスバックエンド、モデルプロバイダー（任意の OpenAI 互換エンドポイント）、セッションストレージ
• ループ自体を置き換える ―― 代替エージェントループ、オーケストレーター、マルチエージェント構成
• 他のエージェントをマウント ―― ローカルの Codex や Claude Code を、ハーネスが委譲するサブエージェントとして登録

ディレクトリ はこれら全部を 22 カテゴリに整理しています。MCP サーバー と エージェントワークフロー から テーマ や デスクトップペット まで。

プラグインの解剖学

概念的に、すべての dsh プラグインは関数（またはライフサイクルフックを持つオブジェクト）で、Cordis の コンテキスト を受け取り、それを使って 2 つのことを宣言します。何を 提供 するか（サービス、ツール、UI コンポーネント）と、何を 消費 するか（他プラグインのサービス、イベント）です。能力は service / provider / consumer の役割に分割されているため、背後にどのプロバイダーがいても、モデルには常に安定したインターフェースが見えます。

エコシステムが課しているルールが 1 つあります。登録は可逆でなければならない。 プラグインが取り除かれたら、それが登録したものはすべて取り消されます。後のセッションに何も漏れません。この保証があるから、ネットで見つけたプラグインを試すことが生き延びられる行為になっています。

プラグインの居場所：bundles、profiles、patches

実行中の dsh は、固定順で積み重なる設定レイヤーから組み立てられるプラグインツリーです。

1. Bundles ―― 公式がまとめて配布するプラグインセット（デフォルトの体験）
2. Profiles ―― bundles の上に載せる、自分の名前つき構成
3. Patches ―― 自分のオーバーライドレイヤー。単一のプラグインエントリーまで指定可能

上位レイヤーが下位を上書きします。つまり「あなたの dsh」とは文字通り設定ファイルのスタックであり、環境の共有とはそのファイルを渡すことです。完全な仕組みは 設定ガイド にあります。

インストールの実際

dsh install <plugin> というコマンドは存在しません。プラグインのインストールとは プロファイルまたはパッチ設定に 1 エントリーを追加する こと（正確な行は各プラグインの README に記載）で、ツリー再構成のために再起動します。エントリーを消せば、クリーンかつ完全にアンインストールされます。

その一行を加える前に、5 分のチェックを。README を読み、ライセンスを見て、エントリーポイントに目を通し、鮮度を確認し、キュレーション済みのものを優先します。プラグインはエージェントの権限で動くコードなので、ハーネスはサンドボックス段階と承認で包んでいますが、見極めはあなたの仕事です。完全な手順は dsh プラグインの安全なインストール方法 へ。

どこで見つけるか

• このディレクトリ ―― カテゴリで探す、スターや更新日でも。詳細ページにはライセンス、言語、活動状況、収録元リストが表示されます
• GitHub の dsh-plugin トピック ―― コミュニティプラグインの公式マーカー。広いエコシステムの発見経路
• コミュニティの awesome リスト ―― エコシステムガイド に地図があります

よくある質問

dsh プラグインは安全？ エージェントの権限で動くコードなので、サードパーティの依存関係と同じように扱ってください。ソースを読み、ライセンスを確認し、まず使い捨てワークスペースの read-only で試す。ハーネスのサンドボックス、承認、ガードは不始末を封じ込めますが、判断の必要性を消すものではありません。

プラグインを入れたら dsh の再起動は必要？ 必要です。プラグインツリーは起動時に組み立てられるので、設定変更は次回起動時に有効になります。

自分で dsh プラグインを書ける？ 書けます。TypeScript の普通の Cordis プラグインです。プラグインテンプレートから始め、可逆性と設定の慣例に従い、リポジトリに dsh-plugin トピックを付け、awesome リストに PR を出せば 掲載 されます。プラグイン開発ガイド が全手順を案内します。

dsh プラグインは何個ある？ 数千件で、増え続けています。このディレクトリはエコシステムを毎日同期し、スター、フォーク、更新日、熱量でエントリーを並べます。

次に読む

• DeepSeek Harness プラグインのインストール方法
• DeepSeek Harness とは？ ―― これらのプラグインが差し込まれるランタイム
• プラグイン開発入門 ―― 自分で作る
• ディレクトリを見る