プラグインを登録する

この翻訳は参考訳なので、正確な内容は英語版で確認してください。英語版

登録できるプラグイン

このプラットフォームは、GitHub リポジトリの管理者である作者が登録した、オープンソースのオーディオプラグインを掲載します。

対象の規格: VST® 3 CLAP, LV2, Audio Unit

登録する前に、リポジトリと最新のリリースが掲載の条件を満たすことを確認してください: https://audio-soko-kun.allegromoltov.jp/policy

このプラットフォームは、プラグインの規格・OS・アーキテクチャ・カテゴリを、zip のアーカイブの中のバンドルから判定します。作者が入力する必要はありません。

プラグインとリポジトリの名前に VST の語を入れないでください。VST 3 SDK は製品名に VST を使うことを認めていません。このプラットフォームのレビューでも、VST を含む名前を推奨の指摘として返します。

リリースの前にリポジトリを確認する

リリースを公開する前に、AI エージェントに submit_plugin の確認のモードを使わせてください。確認のモードは、最新のリリースで掲載の条件を判定し、既定のブランチの最新のコミットをレビューします。このモードでは登録しません。確認のモードは 24 時間に 5 回まで使えます。

レビューは、GitHub で公開している審査の基準にしたがいます: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/blob/main/docs/design/review-criteria.md

アーカイブの中身の検査と macOS の署名の判定は、登録の後に GitHub Actions で配布物を取得して行うため、確認のモードでは行いません。AI エージェントは、これらの検査で求められることを示します。

登録の手順

MCP クライアントを https://audio-soko-kun.allegromoltov.jp/mcp に接続してください。Claude Code では次を実行してください:

claude mcp add --transport http audio-plugin-soko-kun https://audio-soko-kun.allegromoltov.jp/mcp

MCP クライアントから GitHub のアカウントでサインインしてください。Claude Code では /mcp を実行し、audio-plugin-soko-kun を選んでください。Codex では codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp で接続してから、codex mcp login audio-plugin-soko-kun でサインインしてください。このプラットフォーム自体が GitHub リポジトリへの書き込みの権限を得ることはありません。

AI エージェントに登録を頼んでください。話しかけ方の例は「https://github.com/<owner>/<repository> のオーディオプラグインを登録して」です。

登録した後の流れ

このプラットフォームはプラグインを検査待ちで登録します。リリースが検査を通るまで、プラグインは検索とプラグインのページに表示されません。

検査は 15 分ごとに進み、ふつう数時間以内に終わります。

このプラットフォームは、検査を通った版だけを掲載します。GitHub で新しいリリースを公開すると、このプラットフォームは自動で取り込んで検査します。登録し直す必要はありません。

検査の結果は、AI エージェントに list_my_plugins で確かめさせてください。話しかけ方の例は「自分のプラグインの新しいリリースの掲載の状態を確かめて」です。AI エージェントは、版ごとの状態・版や配布物を掲載していない理由・レビューの指摘・直し方を示します。

管理者の確認待ちになる版もあります。その版の変更の意図を説明するときは、このプラットフォームのリポジトリの Issue に書いてください: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/issues

登録が拒否されたとき

AI エージェントが理由のコードと直し方を表示するので、原因を直してから登録し直してください。

not_admin: リポジトリの管理権限がありません。リポジトリの管理者に登録を頼んでください。
private_repository、archived_repository: リポジトリを公開し、アーカイブを解除してください。
no_license: オープンソースのライセンスの LICENSE ファイルをリポジトリの直下に置き、新しいリリースを公開してください。
license_unrecognized: GitHub がライセンスを識別できません。LICENSE には標準の本文だけを置き、ほかの表示は NOTICE や README に移してから、新しいリリースを公開してください。
license_not_open: OSI の承認または FSF の認定を受けたライセンスにしてから、新しいリリースを公開してください。
no_release、no_verifiable_asset: 配布物を添付したリリースを公開してください。配布物は 30 件までです。
no_archive: プラグインのバンドルを zip のアーカイブにして、リリースに添付してください。
not_immutable: リポジトリの設定で不変のリリースを有効にしてから、新しいリリースを公開してください。
no_attestation: リリースのワークフローに actions/attest-build-provenance を加え、インストーラーを含むすべての配布物に証明を付けてください。そのうえで新しいリリースを公開してください。
duplicate: リポジトリは登録済みです。検索からプラグインのページを開いてください。
name_reserved: 掲載中のプラグインが、名前を変える前にこのリポジトリ名を使っていました。掲載中のプラグインが使ったことのない名前にリポジトリの名前を変えてください。
rate_limited: 登録は 24 時間に 10 回までです。時間をおいてから登録してください。
invalid_url: リポジトリの URL を https://github.com/<owner>/<repository> の形で指定してください。
not_found: リポジトリが見つかりません。URL と、リポジトリが公開されていることを確認してください。
unsupported_tag: リリースのタグは、英数字・「.」・「-」・「_」だけの 100 文字以内にしてください。
github_unavailable: GitHub が正常に応答しませんでした。時間をおいてから登録してください。

版や配布物が掲載されないとき

版や配布物を掲載しない理由は、list_my_plugins で確かめられます。作者が直す主な理由は次のとおりです。

vst2_detected: アーカイブに VST 2 のバンドルかエントリーポイントがあります。すべてのアーカイブから VST 2 を外し、新しいリリースを公開してください。
no_plugin_detected、no_plugin_in_archive: アーカイブに対象の規格のバンドルが見つかりません。ビルドしたバンドルを zip のアーカイブに入れてください。ソースコードのアーカイブは直す必要はありません。
content_undetermined: インストーラーや入れ子のアーカイブなど、中を調べられないファイルがアーカイブにあります。プラグインのバンドルを zip のアーカイブに直接入れてください。
macos_not_signed、macos_adhoc、macos_not_developer_id、macos_not_notarized: macOS 向けのバンドルを Developer ID の証明書で署名し、Apple の公証を受けてください。
declaration_mismatch、not_declared: .audio-soko-kun/config.json の宣言と、検査したアーカイブの中身が食い違います。宣言を直して、新しいリリースを公開してください。
installer_not_guided: インストーラーは案内しません。利用者は zip のアーカイブからプラグインを導入します。

ロゴと説明の画像

作者は、ロゴと説明の画像を 1 枚ずつ掲載できます。リポジトリの .audio-soko-kun フォルダーに画像を置いてください。

.audio-soko-kun/logo.png
.audio-soko-kun/image.gif

ロゴ: ファイル名を logo にしてください。大きさは 256 KB 以内、縦と横は 1,024 px 以内にしてください。
説明の画像: ファイル名を image にしてください。大きさは 1.5 MB 以内、縦と横は 4,096 px 以内にしてください。GIF はアニメーションとして再生されます。

このプラットフォームはスクリプトを含められる SVG を受け付けないので、拡張子は png・jpg・jpeg・gif・webp のいずれかにしてください。

このプラットフォームは最新リリースのタグの時点の画像を取得するので、画像を変えたときは新しいリリースを公開してください。

このプラットフォームは条件に合わない画像を掲載しないので、画像が表示されないときは条件を確認してください。

.audio-soko-kun/config.json

作者は .audio-soko-kun/config.json で、表示名とカテゴリと、アーカイブごとの OS・アーキテクチャ・規格を宣言できます。画像と同じ .audio-soko-kun フォルダーにファイルを置いてください。

{
  "name": "Simple Pitch Shift",
  "category": "effect",
  "assets": [
    {
      "pattern": "simple-pitchshift-*-windows-x64.zip",
      "os": "windows",
      "arch": ["x86_64"],
      "formats": ["vst3", "clap"]
    }
  ]
}

name: 表示名です。1〜60 文字で書いてください。書かないときは、リポジトリ名を表示します。
category: instrument・effect・analyzer・midi・utility のいずれかです。バンドルからカテゴリを推定できないときだけ使います。
assets: アーカイブの宣言を 20 件まで書けます。pattern はアーカイブの名前の型で、* だけが任意の文字列に一致します。os は windows・macos・linux のいずれか、arch は x86_64・x86・arm64 の配列、formats は vst3・clap・lv2・au の配列です。

どの項目も任意です。このプラットフォームは、規格・OS・アーキテクチャを検査したバンドルから決め、宣言は照合と案内するアーカイブの絞り込みにだけ使います。

assets を書くと、pattern に一致したアーカイブだけを案内します。ファイルの内容が条件に合わないリリース、どのアーカイブも pattern に一致しないリリース、検査したアーカイブの中身が宣言と食い違うリリースは掲載しません。

このプラットフォームは新しいリリースのタグの時点のファイルを読むので、ファイルを変えたときは新しいリリースを公開してください。

更新と掲載の取り下げ

掲載を更新するときは、GitHub で新しいリリースを公開してください。このプラットフォームは新しいリリースを自動で取り込み、検査を通ったら掲載します。リポジトリの説明から概要も更新します。

新しいリリースが掲載されないときは、AI エージェントに list_my_plugins で理由を確かめさせてください。AI エージェントは理由と直し方を示します。

掲載を取り下げるときは、リポジトリを非公開にする、あるいは削除してください。通報ページの方法で取り下げを依頼することもできます。

リポジトリの名前の変更と移管

このプラットフォームは GitHub のリポジトリの ID でリポジトリを追うので、リポジトリの名前を変えても作業は要りません。掲載は 15 分以内に新しい名前へ移り、旧い名前へのリンクは新しい名前へ転送されます。

旧い名前で別のリポジトリを作らないでください。旧い名前は、名前を変えたプラグインのためにこのプラットフォームが取っておき、その名前では別のリポジトリを登録しません。

リポジトリを別のアカウントや組織へ移管すると、掲載中のリリースはそのまま掲載し、次のリリースは管理者が確かめてから掲載します。

表示名を変えるときは、.audio-soko-kun/config.json の name を変えて新しいリリースを公開してください。