Enviar um plugin

Esta tradução é apenas uma referência; por isso, confira o conteúdo exato na versão em inglês. Versão em inglês

Plugins que você pode enviar

Esta plataforma lista plugins de áudio de código aberto enviados pelo autor que administra o repositório no GitHub.

Formatos suportados: VST® 3 CLAP, LV2, Audio Unit

Antes de enviar, confira se o repositório e a versão mais recente cumprem as condições de listagem: https://audio-soko-kun.allegromoltov.jp/policy

Esta plataforma determina os formatos, o SO, as arquiteturas e a categoria de um plugin a partir dos bundles nos arquivos zip. Você não precisa informá-los.

Não inclua a palavra VST no nome do plugin nem do repositório. O VST 3 SDK não permite VST em nomes de produtos, e a revisão aponta esse tipo de nome como recomendação.

Verifique seu repositório antes de uma versão

Antes de publicar uma versão, peça ao seu agente de IA para executar submit_plugin no modo de verificação. Ele avalia as condições de listagem na versão mais recente e revisa o commit mais recente do branch padrão. Ele não registra o plugin. Você pode usar o modo de verificação até 5 vezes em 24 horas.

A revisão segue os critérios de revisão, que são públicos no GitHub: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/blob/main/docs/design/review-criteria.md

O modo de verificação não inspeciona os arquivos compactados nem as assinaturas do macOS, porque essas verificações baixam os arquivos no GitHub Actions depois do registro. O agente mostra o que essas verificações exigem.

Como enviar

Conecte seu cliente MCP a https://audio-soko-kun.allegromoltov.jp/mcp. No Claude Code, execute:

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

Entre com sua conta do GitHub pelo cliente MCP. No Claude Code, execute /mcp e escolha audio-plugin-soko-kun. No Codex, conecte com codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp e depois entre com codex mcp login audio-plugin-soko-kun. Esta plataforma em si nunca recebe acesso de escrita aos seus repositórios do GitHub.

Peça ao agente de IA para enviar o repositório, por exemplo: "Registre o plugin de áudio em https://github.com/<owner>/<repository>".

Depois do envio

Esta plataforma registra o plugin como aguardando verificação. Até que uma versão passe nas verificações, o plugin não aparece na busca nem tem página própria.

As verificações rodam a cada 15 minutos e costumam terminar em algumas horas.

Esta plataforma lista apenas versões que passam nas verificações. Quando você publica uma nova versão no GitHub, esta plataforma a obtém e a verifica automaticamente. Não é preciso enviá-la de novo.

Para ver os resultados, peça ao agente de IA para verificar seu plugin com list_my_plugins, por exemplo: "Verifique se a nova versão do meu plugin está listada". O agente mostra o estado de cada versão, os motivos de uma versão ou um arquivo não estar listado, os apontamentos da revisão e como corrigi-los.

Algumas versões aguardam a confirmação de um administrador. Para explicar as mudanças de uma versão assim, abra uma issue no repositório desta plataforma: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/issues

Quando o envio é recusado

O agente de IA mostra o código do motivo e como corrigir. Corrija a causa e envie de novo.

not_admin: Você não tem permissão de administrador no repositório. Peça a um administrador do repositório para enviá-lo.
private_repository, archived_repository: Torne o repositório público ou desarquive-o.
no_license: Coloque um arquivo LICENSE com uma licença de código aberto na raiz do repositório e publique uma nova versão.
license_unrecognized: O GitHub não consegue identificar a licença. Mantenha apenas o texto padrão da licença em LICENSE, mova os demais avisos para NOTICE ou README e publique uma nova versão.
license_not_open: Licencie o plugin sob uma licença aprovada pela OSI ou reconhecida como livre pela FSF e publique uma nova versão.
no_release, no_verifiable_asset: Publique uma versão com os arquivos do plugin anexados (até 30 arquivos).
no_archive: Anexe os bundles do plugin à versão como arquivos zip.
not_immutable: Ative as versões imutáveis nas configurações do repositório e publique uma nova versão.
no_attestation: Adicione actions/attest-build-provenance ao workflow de release para que todos os arquivos, incluindo instaladores, tenham atestação, e publique uma nova versão.
duplicate: O repositório já está registrado. Abra a página dele pela busca.
name_reserved: Um plugin listado usava este nome de repositório antes de ser renomeado. Renomeie o repositório para um nome que nenhum plugin listado tenha usado.
rate_limited: Você pode enviar até 10 vezes em 24 horas. Tente de novo mais tarde.
invalid_url: Informe a URL do repositório no formato https://github.com/<owner>/<repository>.
not_found: O repositório não foi encontrado. Verifique a URL e se o repositório é público.
unsupported_tag: Use uma tag de versão apenas com letras, números, ".", "-" e "_", com até 100 caracteres.
github_unavailable: O GitHub não respondeu normalmente. Tente de novo mais tarde.

Quando uma versão ou um arquivo não é listado

O list_my_plugins mostra por que uma versão ou um arquivo não está listado. Os principais motivos que o autor corrige são os seguintes.

vst2_detected: Um arquivo compactado contém um bundle ou ponto de entrada VST 2. Remova o VST 2 de todos os arquivos compactados e publique uma nova versão.
no_plugin_detected, no_plugin_in_archive: Nenhum bundle de plugin suportado foi encontrado nos arquivos compactados. Coloque os bundles compilados nos arquivos zip. Os arquivos de código-fonte não precisam de mudança.
content_undetermined: Um arquivo compactado contém arquivos que não podem ser inspecionados, como instaladores ou arquivos compactados aninhados. Coloque os bundles do plugin diretamente no arquivo zip.
macos_not_signed, macos_adhoc, macos_not_developer_id, macos_not_notarized: Assine os bundles para macOS com um certificado Developer ID e notarize-os com a Apple.
declaration_mismatch, not_declared: As declarações em .audio-soko-kun/config.json não batem com os arquivos compactados inspecionados. Corrija as declarações e publique uma nova versão.
installer_not_guided: Instaladores não são indicados. Os usuários obtêm os plugins pelos arquivos zip.

Logotipo e imagem de descrição

Os autores podem exibir um logotipo e uma imagem de descrição. Coloque as imagens na pasta .audio-soko-kun do repositório.

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

Logotipo: nomeie o arquivo como logo. Mantenha-o com até 256 KB e até 1.024 px em cada lado.
Imagem de descrição: nomeie o arquivo como image. Mantenha-a com até 1,5 MB e até 4.096 px em cada lado. Imagens GIF são reproduzidas como animações.

Esta plataforma não aceita SVG, que pode conter scripts; por isso, use a extensão png, jpg, jpeg, gif ou webp.

Esta plataforma obtém as imagens na tag da versão mais recente; por isso, publique uma nova versão depois de alterar uma imagem.

Esta plataforma não exibe imagens que não atendem a essas condições; por isso, verifique as condições se uma imagem não aparecer.

.audio-soko-kun/config.json

Os autores podem declarar o nome de exibição, a categoria e o SO, as arquiteturas e os formatos de cada arquivo compactado em .audio-soko-kun/config.json. Coloque o arquivo na mesma pasta .audio-soko-kun das imagens.

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

name: O nome de exibição, de 1 a 60 caracteres. Sem ele, esta plataforma mostra o nome do repositório.
category: Um entre instrument, effect, analyzer, midi e utility. Esta plataforma o usa apenas quando não consegue deduzir a categoria pelos bundles.
assets: Até 20 declarações de arquivos compactados. pattern corresponde ao nome do arquivo compactado, e * corresponde a qualquer texto. os é um entre windows, macos e linux. arch é um array com x86_64, x86 e arm64. formats é um array com vst3, clap, lv2 e au.

Todos os campos são opcionais. Esta plataforma obtém os formatos, o SO e as arquiteturas dos bundles inspecionados e usa as declarações apenas para conferi-los e escolher os arquivos compactados a indicar.

Com assets, esta plataforma indica aos usuários apenas os arquivos compactados que correspondem a um pattern. Ela não lista uma versão cujo arquivo seja inválido, cujos arquivos compactados não correspondam a nenhum pattern ou cujos arquivos compactados inspecionados não batam com as declarações.

Esta plataforma lê o arquivo na tag de cada nova versão; por isso, publique uma nova versão depois de alterar o arquivo.

Atualizar e retirar

Para atualizar a listagem, publique uma nova versão no GitHub. Esta plataforma a obtém automaticamente e a lista depois que ela passa nas verificações. Esta plataforma também atualiza o resumo a partir da descrição do repositório.

Se uma nova versão não for listada, peça ao agente de IA para verificá-la com list_my_plugins. O agente mostra o motivo e como corrigir.

Para retirar a listagem, torne o repositório privado ou exclua-o, ou peça a retirada como descrito na página Denunciar.

Renomear ou transferir o repositório

Esta plataforma acompanha o repositório pelo ID do GitHub, então você não precisa fazer nada ao renomear o repositório. A listagem passa para o novo nome em até 15 minutos, e os links para o nome antigo redirecionam para o novo.

Não crie outro repositório com o nome antigo. Esta plataforma reserva o nome antigo para o plugin renomeado e não registra outro repositório com ele.

Se você transferir o repositório para outra conta ou organização, a versão listada continua listada, e um administrador revisa a próxima versão antes de listá-la.

Para mudar o nome de exibição, altere name em .audio-soko-kun/config.json e publique uma nova versão.