Enviar un plugin

Esta traducción es solo de referencia; por eso, consulta el contenido exacto en la versión en inglés. Versión en inglés

Plugins que puedes enviar

Esta plataforma incluye plugins de audio de código abierto enviados por el autor que administra el repositorio de GitHub.

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

Antes de enviar, revisa que el repositorio y su versión más reciente cumplan las condiciones de la lista: https://audio-soko-kun.allegromoltov.jp/policy

Esta plataforma determina los formatos, el SO, las arquitecturas y la categoría de un plugin a partir de los bundles de sus archivos zip. No necesitas indicarlos.

No incluyas la palabra VST en el nombre de tu plugin ni de tu repositorio. El VST 3 SDK no permite VST en nombres de productos, y la revisión señala ese tipo de nombre como recomendación.

Revisa tu repositorio antes de una versión

Antes de publicar una versión, pide a tu agente de IA que ejecute submit_plugin en modo de comprobación. Este modo evalúa las condiciones de la lista en la versión más reciente y revisa el commit más reciente de la rama predeterminada. No registra el plugin. Puedes usar el modo de comprobación hasta 5 veces en 24 horas.

La revisión sigue los criterios de revisión, que son públicos en GitHub: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/blob/main/docs/design/review-criteria.md

El modo de comprobación no inspecciona los archivos comprimidos ni las firmas de macOS, porque esas revisiones descargan los archivos en GitHub Actions después del registro. El agente muestra lo que exigen esas revisiones.

Cómo enviar

Conecta tu cliente MCP a https://audio-soko-kun.allegromoltov.jp/mcp. En Claude Code, ejecuta:

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

Inicia sesión con tu cuenta de GitHub desde el cliente MCP. En Claude Code, ejecuta /mcp y elige audio-plugin-soko-kun. En Codex, conéctate con codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp y luego inicia sesión con codex mcp login audio-plugin-soko-kun. Esta plataforma en sí nunca obtiene acceso de escritura a tus repositorios de GitHub.

Pide al agente de IA que envíe tu repositorio, por ejemplo: "Registra el plugin de audio de https://github.com/<owner>/<repository>".

Después de enviar

Esta plataforma registra el plugin en espera de revisión. Hasta que una versión pasa las revisiones, el plugin no aparece en la búsqueda ni tiene página propia.

Las revisiones se ejecutan cada 15 minutos y suelen terminar en unas horas.

Esta plataforma incluye solo versiones que pasan las revisiones. Cuando publicas una nueva versión en GitHub, esta plataforma la obtiene y la revisa automáticamente. No necesitas enviarla de nuevo.

Para ver los resultados, pide a tu agente de IA que revise tu plugin con list_my_plugins, por ejemplo: "Revisa si la nueva versión de mi plugin está en la lista". El agente muestra el estado de cada versión, los motivos por los que una versión o un archivo no está en la lista, las observaciones de la revisión y cómo corregirlas.

Algunas versiones esperan la confirmación de un administrador. Para explicar los cambios de una versión así, abre un issue en el repositorio de esta plataforma: https://github.com/AllegroMoltoV/audio-plugin-soko-kun/issues

Cuando se rechaza un envío

El agente de IA muestra el código del motivo y cómo corregirlo. Corrige la causa y vuelve a enviar.

not_admin: No tienes permiso de administrador en el repositorio. Pide a un administrador del repositorio que lo envíe.
private_repository, archived_repository: Haz público el repositorio o desarchívalo.
no_license: Coloca un archivo LICENSE con una licencia de código abierto en la raíz del repositorio y publica una nueva versión.
license_unrecognized: GitHub no puede identificar la licencia. Deja solo el texto estándar de la licencia en LICENSE, mueve los demás avisos a NOTICE o README y publica una nueva versión.
license_not_open: Licencia el plugin con una licencia aprobada por la OSI o reconocida como libre por la FSF y publica una nueva versión.
no_release, no_verifiable_asset: Publica una versión con los archivos del plugin adjuntos (hasta 30 archivos).
no_archive: Adjunta los bundles del plugin a la versión como archivos zip.
not_immutable: Activa las versiones inmutables en la configuración del repositorio y publica una nueva versión.
no_attestation: Agrega actions/attest-build-provenance al workflow de publicación para que todos los archivos, incluidos los instaladores, tengan atestación, y publica una nueva versión.
duplicate: El repositorio ya está registrado. Abre su página desde la búsqueda.
name_reserved: Un plugin de la lista usaba este nombre de repositorio antes de cambiar de nombre. Cambia el nombre del repositorio a uno que ningún plugin de la lista haya usado.
rate_limited: Puedes enviar hasta 10 veces en 24 horas. Vuelve a intentarlo más tarde.
invalid_url: Indica la URL del repositorio con el formato https://github.com/<owner>/<repository>.
not_found: No se encontró el repositorio. Revisa la URL y que el repositorio sea público.
unsupported_tag: Usa una etiqueta de versión solo con letras, números, ".", "-" y "_", de hasta 100 caracteres.
github_unavailable: GitHub no respondió con normalidad. Vuelve a intentarlo más tarde.

Cuando una versión o un archivo no está en la lista

list_my_plugins muestra por qué una versión o un archivo no está en la lista. Los principales motivos que corrige el autor son los siguientes.

vst2_detected: Un archivo comprimido contiene un bundle o un punto de entrada VST 2. Quita VST 2 de todos los archivos comprimidos y publica una nueva versión.
no_plugin_detected, no_plugin_in_archive: No se encontró ningún bundle de plugin compatible en los archivos comprimidos. Coloca los bundles compilados en los archivos zip. Los archivos de código fuente no necesitan cambios.
content_undetermined: Un archivo comprimido contiene archivos que no se pueden inspeccionar, como instaladores o archivos comprimidos anidados. Coloca los bundles del plugin directamente en el archivo zip.
macos_not_signed, macos_adhoc, macos_not_developer_id, macos_not_notarized: Firma los bundles para macOS con un certificado Developer ID y notarízalos con Apple.
declaration_mismatch, not_declared: Las declaraciones de .audio-soko-kun/config.json no coinciden con los archivos comprimidos inspeccionados. Corrige las declaraciones y publica una nueva versión.
installer_not_guided: No se guía a los instaladores. Los usuarios obtienen los plugins de los archivos zip.

Logotipo e imagen descriptiva

Los autores pueden mostrar un logotipo y una imagen descriptiva. Coloca las imágenes en la carpeta .audio-soko-kun del repositorio.

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

Logotipo: nombra el archivo logo. Mantenlo en 256 KB como máximo y en 1,024 px por lado como máximo.
Imagen descriptiva: nombra el archivo image. Mantenla en 1.5 MB como máximo y en 4,096 px por lado como máximo. Las imágenes GIF se reproducen como animaciones.

Esta plataforma no acepta SVG, que puede contener scripts; por eso, usa la extensión png, jpg, jpeg, gif o webp.

Esta plataforma obtiene las imágenes en la etiqueta de la versión más reciente; por eso, publica una nueva versión después de cambiar una imagen.

Esta plataforma no muestra imágenes que no cumplen estas condiciones; por eso, revisa las condiciones si una imagen no aparece.

.audio-soko-kun/config.json

Los autores pueden declarar el nombre visible, la categoría y el SO, las arquitecturas y los formatos de cada archivo comprimido en .audio-soko-kun/config.json. Coloca el archivo en la misma carpeta .audio-soko-kun que las imágenes.

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

name: El nombre visible, de 1 a 60 caracteres. Si no lo indicas, esta plataforma muestra el nombre del repositorio.
category: Uno de instrument, effect, analyzer, midi y utility. Esta plataforma lo usa solo cuando no puede deducir la categoría a partir de los bundles.
assets: Hasta 20 declaraciones de archivos comprimidos. pattern coincide con el nombre del archivo comprimido, y * coincide con cualquier texto. os es uno de windows, macos y linux. arch es un arreglo con x86_64, x86 y arm64. formats es un arreglo con vst3, clap, lv2 y au.

Todos los campos son opcionales. Esta plataforma toma los formatos, el SO y las arquitecturas de los bundles inspeccionados, y usa las declaraciones solo para comprobarlos y elegir los archivos comprimidos a los que guía.

Con assets, esta plataforma solo guía a los usuarios a los archivos comprimidos que coinciden con un pattern. No incluye una versión cuyo archivo no es válido, cuyos archivos comprimidos no coinciden con ningún pattern o cuyos archivos comprimidos inspeccionados no coinciden con las declaraciones.

Esta plataforma lee el archivo en la etiqueta de cada nueva versión; por eso, publica una nueva versión después de cambiar el archivo.

Actualizar y retirar

Para actualizar la publicación, publica una nueva versión en GitHub. Esta plataforma la obtiene automáticamente y la incluye después de que pasa las revisiones. Esta plataforma también actualiza el resumen a partir de la descripción del repositorio.

Si una nueva versión no aparece en la lista, pide a tu agente de IA que la revise con list_my_plugins. El agente muestra el motivo y cómo corregirlo.

Para retirar la publicación, haz privado el repositorio o elimínalo, o pide el retiro como se describe en la página Reportar.

Cambiar el nombre o transferir el repositorio

Esta plataforma sigue el repositorio por su ID de GitHub, así que no necesitas hacer nada al cambiar el nombre del repositorio. La publicación pasa al nuevo nombre en un máximo de 15 minutos, y los enlaces al nombre anterior redirigen al nuevo.

No crees otro repositorio con el nombre anterior. Esta plataforma reserva el nombre anterior para el plugin renombrado y no registra otro repositorio con ese nombre.

Si transfieres el repositorio a otra cuenta u organización, la versión publicada sigue publicada, y un administrador revisa la siguiente versión antes de publicarla.

Para cambiar el nombre visible, cambia name en .audio-soko-kun/config.json y publica una nueva versión.