DeepseekPlugin
プラグインを投稿

このチュートリアルでは、約5分で最初の DeepSeek Harness プラグインをインストールします。カタログ CLI のインストール、カタログ検索、ドライラン、インストール、動作確認まで。すべてターミナルで完結し、各コマンドはコピーできます。

プラグインインストール5ステップフロー：検索、確認、ドライラン、インストール、検証1検索dsp search2確認dsp show3ドライラン--dry-run4インストール--yes5検証dsh web動作するプラグインまで5ステップ。各ステップは元に戻せて、ドライランは何も変更しません。
インストール5ステップフロー：検索 → 確認 → ドライラン → インストール → 検証。

前提条件

始める前に、環境に以下が揃っているか確認してください：

  • Node.js 20 以降 — dsp CLI の実行環境。node --version で確認；
  • 公式 dsh コマンド — 実際のインストールを実行する Harness CLI；
  • pnpm — Harness が profile の依存関係管理に使用。PATH に通っている必要があります。

コアコンセプト

インストールの前に、4つの用語を1分だけ整理しましょう。以降のコマンドはすべてこれらを操作します：

  • プラグイン（plugin）：Harness の機能を拡張するコードモジュール。このカタログの各プラグインは npm に公開され、一意の owner/repo 識別子を持ちます。
  • profile：Harness の名前付き環境で、プラグインはここにインストールされます。複数の profile（デフォルトと web など）を互いに干渉せず持てます。dsp install はデフォルトで現在の profile に書き込みます。
  • bundle：プラグインが npm に公開するパッケージ成果物。カタログは各プラグインの正確なバージョン、整合性ハッシュ、bundle エビデンスを登録しており、dsp はインストールするパッケージが登録済みのものと完全に一致することを検証できます。
  • patch（--patch）：1回の起動にだけ設定を重ねる方法。開発中にローカルプラグインを読み込む際などに使い、どの profile も変更しません。

dsp CLI をインストール

dsp は dsh-plugins パッケージに含まれています。グローバルにインストールします：

dsh-plugins をインストール
npm install --global dsh-plugins
dsp --version

これで dsp コマンドが使えます。プラグインレジストリのスナップショットが内蔵されているため、オフラインでも検索できます。デフォルトでは15分に1回までオンラインレジストリの更新を確認します。

キーワードでカタログを検索します。ターミナル UI（TUI）プラグインを探す場合：

キーワードで検索
dsp search TUI

結果には一致したプラグイン、リポジトリ識別子、1行サマリーが表示されます。当サイトのプラグインカタログでカテゴリ別に閲覧することもできます。

プラグイン詳細を確認

気になるプラグインが見つかったら、owner/repo で完全なレコードを表示します：

プラグイン詳細を表示
dsp show huiliyi37/dsh-tianshu-tui

出力にはサマリー、登録された正確な npm バージョン、整合性ハッシュ、bundle チェック結果が含まれます。これらがショートカットインストールの可否を決めます。

ドライラン：インストール計画をプレビュー

インストール前に必ずドライランしてください。--dry-run はインストール計画を表示するだけで、何も変更しません：

インストール計画をプレビュー
dsp install huiliyi37/dsh-tianshu-tui --dry-run

パッケージ名、バージョン、書き込まれる profile を確認してください。不審なインストールを止める最後の機会です。

インストールを確定

計画に問題がなければ、--yes で実際のインストールを実行します：

インストールを確定
dsp install huiliyi37/dsh-tianshu-tui --yes

dsp は公式 dsh コマンドを呼び出し、登録された packageName@version を現在の profile にインストールします。別の profile を指定するには --profile web を使います。

プラグインの読み込みを確認

Harness の Web UI を起動し、プラグインが読み込みログまたは UI に表示されることを確認します：

Harness Web UI を起動
dsh web
# http://127.0.0.1:3080 を開く

ターミナルには起動時に読み込まれたプラグインの一覧が表示されます。そこにインストールしたプラグインが見えれば、フロー全体が成功です。

コマンドチートシート

このチュートリアルで使ったコマンドを1か所にまとめました。後でコピーするときにどうぞ：

コマンドチートシート
# dsp CLI のインストール / アップグレード
npm install --global dsh-plugins

# CLI バージョンの確認
dsp --version

# キーワードでカタログを検索
dsp search TUI

# プラグイン詳細とセキュリティエビデンスを表示
dsp show huiliyi37/dsh-tianshu-tui

# ドライラン：計画を表示するだけで何も変更しない
dsp install huiliyi37/dsh-tianshu-tui --dry-run

# 現在の profile へのインストールを確定
dsp install huiliyi37/dsh-tianshu-tui --yes

# Harness Web UI を起動して読み込みを確認
dsh web

覚えておくべき習慣は1つです。どんなインストールもまず --dry-run で計画を確認し、問題がなければ --yes を付けることです。

クイックスタート FAQ

dsp と dsh の関係は？

dsh は DeepSeek Harness の公式 CLI で、Agent とそのプラグインを管理します。dsp（dsh-plugins パッケージ）は当サイトのカタログツールで、カタログ検索、インストールエビデンスの表示、公式 dsh コマンドの呼び出しによるインストールを行います。

プラグインのインストールは安全ですか？

サードパーティプラグインはあなたの権限で実行され、パッケージライフサイクルスクリプトを実行する可能性があります。dsp は、正確なバージョン、整合性ハッシュ、bundle エビデンスが登録されたプラグインのみショートカットインストールを許可します。必ず先に --dry-run を実行し、リポジトリのソースを読んでください。

Node.js 環境がない場合は？

検索には Node.js 20 以上だけで十分です。CLI をインストールしたくない場合は、当サイトのプラグインカタログを閲覧してください。各プラグインに README とインストール手順を掲載した詳細ページがあります。

プラグインはどこにインストールされますか？

プラグインは dsp CLI にインストールされるのではありません。dsp が公式 dsh コマンドを呼び出し、登録された packageName@version を現在の profile に書き込みます。profile は Harness が pnpm で管理する名前付き環境です。--profile web で別の profile にインストールできます。

検索にインターネット接続は必要ですか？

不要です。dsp にはプラグインレジストリのスナップショットが内蔵されているため、オフラインでも検索できます。デフォルトでは15分に1回までオンラインレジストリの更新を確認するので、接続時には結果が新鮮に保たれます。