⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。
背景
他のユーザーが積極的に使用しているプラグインを更新するのは面倒な作業です。従来は、コードの修正、バージョンの更新、変更のプッシュ、ブランチの作成、ファイルのパッケージング、PRの手動送信が必要でした。この繰り返しのプロセスは開発を遅らせます。 そこで、Plugin Auto-PRを作成しました。これはプロセス全体を自動化するGitHub Actionsワークフローです。これにより、パッケージング、プッシュ、PRの作成を1つのアクションで行え、優れたプラグインの構築に集中できます。コンセプト
GitHub Actions
GitHub Actionsは、GitHub上の開発タスクを自動化します。 仕組み: トリガー(例:コードのプッシュ)が発生すると、クラウドベースの仮想マシンでワークフローが実行され、ビルドからデプロイまですべてが自動的に処理されます。
制限:
- パブリックリポジトリ: 無制限
- プライベートリポジトリ: 月2000分
Plugin Auto-PR
仕組み:- プラグインソースリポジトリのメインブランチにコードをプッシュするとワークフローがトリガーされます
- ワークフローが
manifest.yamlファイルからプラグイン情報を読み取ります - プラグインを
.difypkgファイルとして自動的にパッケージングします - パッケージングされたファイルをフォークした
dify-pluginsリポジトリにプッシュします - 新しいブランチを作成し、変更をコミットします
- 上流リポジトリにマージするためのPRを自動的に作成します
前提条件
リポジトリ
- 自分のプラグインソースコードリポジトリがすでにあること(例:
your-name/plugin-source) - 自分のフォークしたプラグインリポジトリがすでにあること(例:
your-name/dify-plugins) - フォークしたリポジトリにすでにプラグインディレクトリ構造があること:
権限
このワークフローが機能するには適切な権限が必要です:- 十分な権限を持つGitHub Personal Access Token (PAT)を作成する必要があります
- PATはフォークしたリポジトリにコードをプッシュする権限が必要です
- PATは上流リポジトリにPRを作成する権限が必要です
パラメータと設定
セットアップ要件
自動公開を開始するには、2つの主要なコンポーネントが必要です: manifest.yamlファイル: このファイルが自動化プロセスを駆動します:name: プラグイン名(パッケージ名とブランチ名に影響します)version: セマンティックバージョン番号(リリースごとに増加)author: GitHubユーザー名(リポジトリパスを決定します)
- 値: 十分な権限を持つPersonal Access Token (PAT)である必要があります
- 権限: フォークしたリポジトリにブランチをプッシュし、上流リポジトリにPRを作成する能力
自動生成されるパラメータ
セットアップが完了すると、ワークフローは以下のパラメータを自動的に処理します:- GitHubユーザー名:
manifest.yamlのauthorフィールドから読み取り - 作者フォルダ名:
authorフィールドと一致 - プラグイン名:
manifest.yamlのnameフィールドから読み取り - ブランチ名:
bump-{plugin-name}-plugin-{version} - パッケージファイル名:
{plugin-name}-{version}.difypkg - PRタイトルと内容: プラグイン名とバージョンに基づいて自動生成
ステップバイステップガイド
1
リポジトリの準備
公式の
dify-pluginsリポジトリをフォークし、自分のプラグインソースリポジトリがあることを確認してください。2
Secretの設定
プラグインソースリポジトリに移動し、Settings > Secrets and variables > Actions > New repository secretをクリックして、GitHub Secretを作成します:
- 名前:
PLUGIN_ACTION - 値: ターゲットリポジトリ(
your-name/dify-plugins)への書き込み権限を持つGitHub Personal Access Token (PAT)

3
ワークフローファイルの作成
リポジトリに
.github/workflows/ディレクトリを作成し、このディレクトリにplugin-publish.ymlという名前のファイルを作成して、以下の内容をファイルにコピーしてください:4
manifest.yamlの更新
以下のフィールドが正しく設定されていることを確認してください:
使用ガイド
初回セットアップ
自動公開ワークフローを初めてセットアップする際は、以下の手順を完了してください:- 公式の
dify-pluginsリポジトリをフォークしていることを確認します - プラグインソースリポジトリの構造が正しいことを確認します
- プラグインソースリポジトリに
PLUGIN_ACTION Secretをセットアップします - ワークフローファイル
.github/workflows/plugin-publish.ymlを作成します manifest.yamlファイルのnameとauthorフィールドが正しく設定されていることを確認します
その後の更新
セットアップ後に新しいバージョンを公開するには:- コードを修正します
manifest.yamlのversionフィールドを更新します
- すべての変更をメインブランチにプッシュします
- GitHub Actionsがパッケージング、ブランチ作成、PR送信を完了するのを待ちます
結果
プラグインソースリポジトリのメインブランチにコードをプッシュすると、GitHub Actionsが自動的に公開プロセスを実行します:- プラグインを
{plugin-name}-{version}.difypkg形式でパッケージング - パッケージングされたファイルをターゲットリポジトリにプッシュ
- フォークリポジトリにマージするためのPRを作成
サンプルリポジトリ
設定とベストプラクティスを理解するには、サンプルリポジトリを参照してください。このページを編集 | 問題を報告