Skip to main content
このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

背景

他のユーザーが活発に利用しているプラグインを手作業で更新するのは手間がかかります。リリースのたびに、コードの修正、バージョンの更新、変更のプッシュ、ブランチの作成、ファイルのパッケージング、PR の作成を行う必要があります。 Plugin Auto-PR は、この一連の作業全体を自動化する GitHub Actions ワークフローです。1 回のプッシュでプラグインをパッケージングしてマーケットプレイス PR を作成するため、開発そのものに集中できます。

コンセプト

GitHub Actions

GitHub Actions は、GitHub 上の開発タスクを自動化します。トリガー(例:コードのプッシュ)が発生すると、クラウドベースの仮想マシンでワークフローが実行され、ビルドからデプロイまでをすべて処理します。
ワークフロー
GitHub Actions の利用制限:
  • パブリックリポジトリ:無制限
  • プライベートリポジトリ:月 2000 分

Plugin Auto-PR

このワークフローは次のステップを実行します。
  1. プラグインソースリポジトリの main ブランチにコードをプッシュするとトリガーされます。
  2. manifest.yaml ファイルからプラグイン情報を読み取ります。
  3. プラグインを .difypkg ファイルとしてパッケージングします。
  4. パッケージングしたファイルを、フォークした dify-plugins リポジトリにプッシュします。
  5. 新しいブランチを作成し、変更をコミットします。
  6. 上流リポジトリへマージするための PR を作成します。

前提条件

リポジトリ

  • 自分のプラグインソースコードリポジトリ(例:your-name/plugin-source)。
  • 自分がフォークしたプラグインリポジトリ(例:your-name/dify-plugins)。
  • フォーク内にプラグインのディレクトリ構造がすでに用意されていること:

権限

フォークしたリポジトリにコードをプッシュし、上流リポジトリに PR を作成できる GitHub Personal Access Token (PAT) を作成します。

パラメータと設定

セットアップ要件

自動公開には 2 つの準備が必要です。 manifest.yaml ファイルが自動化を駆動します。
  • name:プラグインの名前(パッケージ名とブランチ名に影響します)。
  • version:セマンティックバージョン番号(リリースごとに増やします)。
  • author:自分の GitHub ユーザー名(リポジトリのパスを決定します)。
プラグインソースリポジトリの PLUGIN_ACTION シークレットが認証情報を保持します。
  • :十分な権限を持つ Personal Access Token (PAT)。
  • 権限:フォークしたリポジトリへのブランチのプッシュと、上流リポジトリへの PR の作成。

自動生成されるパラメータ

セットアップが完了すると、ワークフローは以下のパラメータを自動的に導出します。
  • GitHub ユーザー名manifest.yamlauthor フィールドから読み取り。
  • 作者フォルダ名author フィールドと一致。
  • プラグイン名manifest.yamlname フィールドから読み取り。
  • ブランチ名bump-{plugin-name}-plugin-{version}
  • パッケージファイル名{plugin-name}-{version}.difypkg
  • PR のタイトルと内容:プラグイン名とバージョンから生成。

ステップバイステップガイド

1

リポジトリの準備

公式の dify-plugins リポジトリをフォーク済みで、自分のプラグインソースリポジトリがあることを確認してください。
2

シークレットの設定

プラグインソースリポジトリで Settings > Secrets and variables > Actions > New repository secret を開き、シークレットを作成します。
  • NamePLUGIN_ACTION
  • Value:ターゲットリポジトリ(your-name/dify-plugins)への書き込み権限を持つ GitHub Personal Access Token (PAT)
シークレットを作成
3

ワークフローファイルの作成

リポジトリに .github/workflows/ ディレクトリを作成し、plugin-publish.yml という名前のファイルを追加して、以下のワークフローを貼り付けます。このワークフローは、概要としては main へのプッシュごとに実行され、Dify プラグイン CLI をダウンロードし、マニフェストからプラグインをパッケージングし、自分の dify-plugins フォークをチェックアウトして、新しい .difypkg を含む PR を langgenius/dify-plugins に対して作成します。
4

manifest.yaml の更新

以下のフィールドが正しく設定されていることを確認してください。

使用ガイド

初回セットアップ

最初の自動リリースの前に、以下を確認してください。
  1. 公式の dify-plugins リポジトリをフォークしている。
  2. プラグインソースリポジトリの構造が正しい。
  3. プラグインソースリポジトリに PLUGIN_ACTION シークレットが設定されている。
  4. ワークフローファイル .github/workflows/plugin-publish.yml が存在する。
  5. manifest.yamlnameauthor フィールドが正しく設定されている。

その後の更新

セットアップ後に新しいバージョンを公開するには:
  1. コードを修正します。
  2. manifest.yamlversion フィールドを更新します。
    リリース
  3. すべての変更を main ブランチにプッシュします。
  4. GitHub Actions がパッケージング、ブランチ作成、PR 送信を完了するのを待ちます。

結果

プラグインソースリポジトリの main ブランチにコードをプッシュすると、GitHub Actions が公開プロセスを自動的に実行します。
  • プラグインを {plugin-name}-{version}.difypkg 形式でパッケージングします。
  • パッケージングしたファイルをターゲットリポジトリにプッシュします。
  • フォークリポジトリへマージするための PR を作成します。
結果

サンプルリポジトリ

動作する設定とベストプラクティスについては、サンプルリポジトリ を参照してください。
Last modified on July 2, 2026