プラグイン開発者ポータル
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 以下。内部に ../ や絶対パスを含めないでください。