このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。個人の GitHub リポジトリで公開すると、Dify マーケットプレイスの審査を経ずにプラグインを配布できます。ユーザーはリポジトリ URL を入力し、
.difypkg アセットを含むリリースを選択することでプラグインをインストールします。
次のような場合に適しています。
- バージョン管理とリリースのペースを完全に管理したい場合。
- プラグインがオープンソースで、他のユーザーに閲覧、フォーク、貢献してもらいたい場合。
- プラグインをチームや組織の内部で利用するが、統一されたインストール URL を 1 つ用意したい場合。
- プラグインがマーケットプレイスの審査待ちで、暫定的な配布チャネルが必要な場合。
前提条件
- パッケージ化されたプラグイン（
.difypkgファイル）。まだない場合は、ローカルファイルとしてパッケージ化して共有する を参照してください。 - GitHub アカウント。
- あなた（またはユーザー）がプラグインをインストールする権限を持つ Dify ワークスペース。
ステップ 1：GitHub リポジトリの作成
マニフェストを確認する
manifest.yaml および provider/*.yaml の author フィールドは、あなたの GitHub ハンドルと一致している必要があります。一致しない場合、ユーザーがインストールしようとしたときに plugin_unique_identifier is not valid が発生します。マニフェストの詳細については、一般仕様 を参照してください。ステップ 2：プラグインパッケージのビルド
プラグインプロジェクトの 1 つ上 のディレクトリで、次を実行します。your_plugin_project.difypkg が生成されます。
ステップ 3：GitHub リリースの公開
Dify は GitHub リリースを通じて、プラグインのインストール可能なバージョンを検出します。リリースにタグを付ける
リポジトリのページで Releases > Draft a new release をクリックします。セマンティックバージョニングを使って新しいタグを作成します（例：
v0.0.1）。タグは manifest.yaml の version フィールドと一致させます。.difypkg ファイルを添付する
リリースフォームで、
.difypkg ファイルを Assets エリアにドラッグします。ユーザーがあなたのリポジトリからインストールする際、Dify はこのアセットを読み込みます。ステップ 4：リポジトリからのインストール
リポジトリ URL をユーザーに共有します。ユーザーは Dify で次の手順でインストールします。リポジトリ情報を入力する
リポジトリ URL を貼り付け（例：
https://github.com/<your-handle>/<repo-name>）、ドロップダウンからバージョンを選択します。Dify はそのリリースから、一致する .difypkg アセットを取得します。インストール をクリックしてから数秒以内に、ユーザーのプラグインページにプラグインが表示されます。Dify は必要に応じて、あなたの GitHub リリースから
.difypkg を取得します。トラブルシューティング
plugin_unique_identifier is not valid：manifest.yaml（およびprovider/*.yaml）のauthorフィールドが、リポジトリを所有する GitHub ハンドルと一致していません。フィールドを更新し、再パッケージ化して再リリースしてください。- インストールダイアログにバージョンが表示されない：リリースに
.difypkgアセットが添付されていないか、リポジトリにまだリリースがありません。GitHub でリリースを開き、アセットが Assets に表示されていることを確認してください。 - 署名検証エラー：セルフホストの Dify インスタンスでは、署名検証が有効になっている場合があります。リリースに署名するには サードパーティ署名検証 を、バイパスのオプションについては FAQ を参照してください。
関連リソース
- 公開の概要：公開方法を比較します。
- ローカルファイルとしてパッケージ化して共有する：
.difypkgパッケージをビルドします。 - Dify マーケットプレイスへの公開：公式マーケットプレイスから提出します。
- サードパーティ署名検証：検証済みインストールのためにパッケージに署名します。
- 一般仕様：マニフェストフィールドのリファレンス。