プラグイン開発者ポータル

5分で掲載まで:プラグインを書いて、リリースにタグを付け、ローカルで検証し、レジストリに PR を開きます。

レビュー SLA:3営業日以内に承認または修正依頼をお返しします。掲載後はリリースにタグを付けるだけで自動更新されます——新しい PR は不要です。

1. テンプレートから足場を作る

plugin-template からリポジトリを生成し(1リポジトリ1プラグイン)、manifest.json と main.js を書きます——id は掲載後に変更できません。

2. ローカルで実行する

デスクトップアプリに URL/ローカルからインストールし、ノードがエラーなく表示されることを確認します。テーマプラグインは全ファイルを8ファイル制限内に収めてください。

3. リリースにタグを付ける

v* タグ(例:v0.1.0)をプッシュするとリリースワークフローが起動します:<id>-<version>.zip、<id>.zip エイリアス、安定版アセットとしての manifest.json が作られます。

4. ローカルで検証する

node scripts/validate-plugin-submit.mjs --manifest ./manifest.json --repo you/repo を実行します——PR を開く前にすべてグリーンにしてください(CI と同じルールです)。

5. レジストリに PR を開く

poly-creator/plugins の plugins.json に1件のエントリ(id/repo/name/author/description)を追加します。CI が通れば掲載されます。以降のリリースはタグだけで済みます。

レビュー基準(各項目が却下理由に対応します)

  • 1リポジトリ1プラグイン。リリースは安定版であること(ドラフト/プレリリースは latest になりません)。
  • 3つのアセットが揃っていること:バージョン付き zip、バージョンなしエイリアス zip、整合性注入済み manifest.json。
  • 有効なマニフェスト:safe-id、semver、main または theme.files が必須、権限は許可リスト内。
  • zip 内のマニフェストがレジストリエントリと一致していること(id/version/アセット名)。ピン留めエントリは tag と sha256 の併記が必要です。
  • trusted(nodeEntry あり)はより厳格な人手レビュー対象です。メインプロセス権限は最小限に宣言してください。デフォルトは安全です。
  • 掲載取り下げ=エントリの削除です。zip は 30MiB 以下。内部に ../ や絶対パスを含めないでください。
公開ガイド全文プラグインテンプレートレジストリリポジトリ