理解 · 発見 · トラブルシューティング
DSH、プラグイン、このディレクトリについて。
まずハーネスモデルを理解し、プラグインとプロファイルを組み合わせる仕組みを把握してから、ディレクトリの使い方や一般的なCLIエラーの解決方法をご確認ください。
セクション 01
DSHを始める
製品、そのアーキテクチャ、安全な初回実行について。
01DeepSeek Harness(dsh)とは何ですか?
DeepSeek HarnessはDeepSeek AIが開発するオープンソースのエージェントハーネスです。モデル、ツール、セッション、ファイルシステム、サンドボックス、オーケストレーション、インターフェースなど、エージェントを取り巻くランタイムを提供しながら、それぞれの機能を置き換え可能に保ちます。
公式ソースとドキュメントはdeepseek-ai/deepseek-harnessリポジトリで公開されています。
02「すべてがプラグイン」とはどういう意味ですか?
DSHはCordisを基盤としています。プラグインは、共有コンテキストにサービス、型付きイベント、取り消し可能なエフェクトを追加します。モデルアダプター、ツールレジストリ、セッションログ、エージェントループもすべてプラグインであるため、特権的なコアにパッチを当てるのではなく、設定を通じて動作を組み合わせます。
置き換え可能であることは、確認なしで相互に交換できるという意味ではありません。プラグインには、バージョン、契約、権限、互換性の制約があります。
03DSHを試すにはどうすればよいですか?また、安定していますか?
npxで公式Webプロファイルを実行してください。DSHは現在、開発者向けプレビュー版であり、互換性を損なう変更が行われることを明示的に前提としています。再現可能な環境ではバージョンを固定し、更新前にリリースノートを確認してください。
npx @deepseek-ai/dsh webWeb UIはデフォルトでhttp://127.0.0.1:3080から配信されます。
セクション 02
プラグイン、バンドル、プロファイル
拡張機能のパッケージ化、組み合わせ、インストール、有効化について。
01DSHプラグインとは何ですか?
プラグインは、共有Cordisコンテキストに動作を追加するマウント可能な拡張機能です。モデル、ツール、メモリ、ファイルシステム、サンドボックス、オーケストレーション、UIなどの機能を提供または利用できます。1つのnpmパッケージに、単一のプラグイン、複数のプラグイン、または設定済みの一式をマウントするバンドルが含まれる場合があります。
実際に何が追加されるかは、名前だけでなく、パッケージのREADMEとマニフェストによって定義されます。
02プラグイン、バンドル、プロファイルの違いは何ですか?
プラグインはランタイムの動作を追加します。バンドルは、順序付けられたCordis設定行と、それらがマウントするコードを配布します。プロファイルはDSHホームに保存される名前付きの構成です。バンドルを積み重ね、ツリー外にインストールされた依存関係を管理し、ユーザーのcordis.patch.ymlを保持します。
npx @deepseek-ai/dsh --profile web --dump-configプロファイルによって、プラグインのインストール先と、それを受け取るアプリケーション構成が決まります。
03プラグインをインストールまたは削除するにはどうすればよいですか?
プロファイル単位のpluginコマンドを使用してください。DSHは初回使用時に選択したプロファイルを初期化し、そのプロファイル内のpnpmへ処理を転送した後、DSHバンドルをエクスポートするインストール済みパッケージとの整合を取ります。
npx @deepseek-ai/dsh plugin --profile web add <package>
npx @deepseek-ai/dsh plugin --profile web remove <package>依存関係の構成を変更した後は、実行中のプロファイルを再起動してください。
04すべてのnpmパッケージがDSHプラグインですか?
いいえ。dsh.bundle.patchを宣言するパッケージは、プロファイルのレイヤースタックに参加できます。この宣言がない通常のパッケージも依存関係としてインストールできる場合がありますが、DSHはプロファイルレイヤーとして有効化できないことを警告します。
npx @deepseek-ai/dsh plugin --profile web why <package>プロジェクトに記載されたパッケージソースのみをインストールしてください。名前が似ているパッケージを代替として使用することはできません。
セクション 03
このディレクトリの使い方
カタログに記録される内容、ラベルの意味、プロジェクトが掲載されるまでの流れ。
01DSH Pluginsとは何ですか?公式ですか?
DSH Pluginsは、ソースを追跡できるDeepSeek Harness拡張機能を見つけるための、独立したコミュニティディレクトリです。公開されているプロジェクトのソース、インストール方法、互換性、権限、レビュー状況を整理しています。DeepSeek AIの公式Webサイトではありません。
DSHのリリース、プラットフォームのドキュメント、製品サポートについては、DeepSeek Harnessの公式リポジトリをご利用ください。
02ここでのプラグイン、コレクション、スキン、スキルとは何ですか?
これらは検索しやすくするためのディレクトリ上のラベルです。プラグインはマウント可能な拡張機能、コレクションは連携する複数の拡張機能をまとめたもの、スキンはインターフェースの外観レイヤーを変更するもの、スキルはエージェント向けの指示やリソースを提供するものです。実際のマニフェストとインストール方法が常に優先されます。
ラベルはプロジェクトの利用方法を示すものであり、人気度や検証状況を示すものではありません。
03コミュニティ、レビュー中、検証済みとは何ですか?
コミュニティは、追跡可能な公開メタデータに基づいて掲載されていますが、ディレクトリのチェックが完了していないことを意味します。レビュー中はチェックが進行中であることを意味します。検証済みは、特定の1バージョンが、インストール可能性、ドキュメント、権限、ライセンス、動作に関する公開基準を満たしたことを意味します。
検証済みはセキュリティを保証するものではなく、ソースレビュー、権限レビュー、サンドボックステストに代わるものではありません。
04カタログデータはどこから取得され、件数が異なることがあるのはなぜですか?
カタログは、厳選されたソース一覧と、公開されているGitHubおよびnpmメタデータのスナップショットから生成されます。スター数、ダウンロード数、バージョン、リポジトリのアクティビティはスナップショット取得後に変化する場合があります。一方、翻訳された説明とプロジェクトタイプは編集方針に基づいて管理されています。
情報の鮮度や出所が重要な場合は、インストール前にリンク先のソースを確認してください。
05プロジェクトを評価または登録するにはどうすればよいですか?
まずソースの所有者、プロジェクトタイプ、インストール元、互換性、権限、検証状況を確認し、次にリポジトリを調査して隔離されたプロファイルでテストしてください。登録時には、サイトが構造化されたMarkdownの下書きを生成し、公開レビューの記録を残すためにGitHub Discussionsを開きます。
登録フォームからこのサイトにデータが送信されることはありません。ブラウザーが投稿用の下書きをコピーします。
セクション 04
コマンドと一般的なエラー
プロファイル引数、pnpmのセットアップ、レジストリ検索、インストール時の警告に対する具体的な解決方法。
01プラグイン検索で--profile <name>が必要なのはなぜですか?
pluginコマンドは1つのDSHプロファイルの依存関係を管理するため、初期化または更新するプロファイルを指定する必要があります。DSH側の--profileフラグは、後に続くpnpmコマンドより前に置いてください。
npx @deepseek-ai/dsh plugin --profile web search "web ui"web、headless、または既存のカスタムプロファイル名を使用してください。
02DSHが「pnpm not found on PATH」と報告するのはなぜですか?
DSHはプラグイン操作をPATH上のpnpm実行ファイルへ転送します。npxは現在の実行用にDSHをインストールしますが、その子プロセス用のpnpmはインストールしません。現在のDSHソースワークスペースではpnpm 11.7.0に固定されています。
corepack enable
corepack install --global pnpm@11.7.0
pnpm --versionCorepackを利用できない場合は、次のコマンドで同じバージョンをインストールしてください: npm install --global pnpm@11.7.0
03検索結果に無関係なnpmパッケージが表示されるのはなぜですか?
DSHは検索内容をそのままpnpm searchへ転送します。pnpm searchは、この厳選されたディレクトリではなく、npmレジストリ全体を検索します。dsh-pluginなどのエコシステム用語を追加し、インストール前にパッケージソースとdsh.bundleマニフェストを確認してください。
npx @deepseek-ai/dsh plugin --profile web search dsh-plugin "web ui"プロジェクトタイプ、ソース、インストール方法、検証状況をまとめて確認する必要がある場合は、このディレクトリをご利用ください。
04Gitでホストされているプラグインのprepareスクリプトが失敗するのはなぜですか?
pnpm 10以降では、明示的に許可されるまで依存関係のビルドスクリプトがブロックされます。DSHは解決されたプロファイルディレクトリと正確なパッケージキーを表示します。レビュー済みの該当パッケージだけを、プロファイルのpnpm-workspace.yaml内にあるallowBuildsの下へ追加し、addコマンドを再実行してください。
allowBuilds:
exact-package-name: trueすべてのビルドスクリプトを一律に許可しないでください。インストールスクリプトはお使いのマシン上でコードを実行します。
05DSHが「plugin needs pnpm arguments to forward」と表示するのはなぜですか?
プロファイルだけでは操作になりません。プロファイルオプションの後に、add、remove、search、whyなどのpnpmコマンドを指定してください。
npx @deepseek-ai/dsh plugin --profile web add <package>
npx @deepseek-ai/dsh plugin --profile web remove <package>
npx @deepseek-ai/dsh plugin --profile web search <terms>相対指定のfile:、link:、./、../パッケージパスは、DSHを実行したディレクトリを基準に解決されます。
06プラグインの問題を報告する前に、何を記録すればよいですか?
3つすべてのランタイムバージョン、プロファイル名、完全なコマンド、DSHが表示する解決済みのプロファイルディレクトリを記録してください。DeepSeek Harnessはまだリリース候補版であるため、バージョンを明記した報告が重要です。
node --version
pnpm --version
npx @deepseek-ai/dsh --version現在のソースワークスペースではNode ^22.19.0または>=24.0.0が必要です。