Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Reglas y comprobaciones del registro

El registro de paquetes de la comunidad: nombres, límites, comprobaciones automáticas, índice firmado, panel del publicador, API y Markdown para agentes.

Actualizado el 19 de noviembre de 2026 Ver como Markdown

Cada versión subida al registro de la comunidad de AI Game Dev se comprueba automáticamente antes de que cualquiera pueda instalarla; no hay cola de revisión manual. Esta página enumera las reglas que debe cumplir un paquete, qué rechaza cada comprobación y por qué, cómo llega una versión publicada a los usuarios mediante un índice firmado, el panel del publicador, la API del registro y las páginas Markdown que leen los agentes de IA.

Nombres

  • Los ids de publicador tienen de 2 a 40 letras minúsculas, dígitos y guiones simples, por orden de llegada. Reservados: aigd, los nombres de motores unity, godot, unreal, brutal, bevy y threejs, marcas registradas y palabras de rol (anthropic, claude, openai, official, admin, samples …), imitaciones tras convertir dígitos en letras (un1ty), y cualquier id que use un nombre reservado como palabra o prefijo (unity-tools, my-godot). AI Game Dev puede asignar un nombre reservado a su titular real.
  • Los ids de paquete son <publisher>.<name> y deben coincidir con el manifiesto. Se rechazan los ids reservados por la aplicación, como aigd.image.
  • Precedencia: la aplicación ignora una entrada de la comunidad para un id aigd.* o cualquier id que figure en el índice propio de AI Game Dev, de modo que nadie puede suplantar un paquete oficial.

Límites

LímiteValor
Archivo (gzip)50 MiB comprimido, 200 MiB descomprimido
Archivos5.000 por archivo comprimido, 64 MiB por archivo
Publicadores por cuenta3
Subidas20 por hora (por cuenta, o por publicador en las subidas con token)
Versiones en espera de comprobaciones5 por publicador
Tokens de publicador activos10 por publicador, cada uno válido hasta 365 días
Publicadores de confianza10 por paquete
Notas de la versión20 KB de Markdown por versión
Canales5 por paquete

Las comprobaciones automáticas

El archivo comprimido se trata como datos no confiables: se descomprime en memoria con un límite de tamaño y se lee como bytes, nunca se ejecuta. Las comprobaciones se ejecutan en este orden y el informe enumera cada una con su resultado:

ComprobaciónRechaza
archiveCualquier cosa que no sea gzip; archivos que superen los límites; enlaces simbólicos, enlaces duros, dispositivos, rutas absolutas, .., caracteres de control, nombres no válidos en Windows, duplicados que ignoran mayúsculas y minúsculas, .git/
manifestUn manifiesto que la aplicación no cargaría, comprobado con el validador propio de la aplicación: esquema, ids propios, reglas del motor de juego
registry-rulesUn publicador que no controlas; un id reservado; cualquier entrada de enabledApiProposals; un main que no está en el archivo; un icono que no sea un PNG, JPEG, GIF, WebP o ICO real, o un SVG con scripts, estilos, referencias externas o manejadores de eventos
secretsClaves privadas y credenciales (claves de nube, GitHub, GitLab, Slack, Stripe, Google, Anthropic, OpenAI, npm, PyPI, Hugging Face, ai-game.dev), JWT, archivos como .env, .npmrc o id_rsa. El informe indica el archivo y la línea, nunca el valor
prompt-injectionTexto que intenta dar instrucciones al agente (más abajo)
native-codeNada: los binarios nativos están permitidos y se marcan, y los usuarios ven "código nativo" en el paquete
virus-scanTodo lo que marque el escáner de virus, incluidos los archivos comprimidos anidados demasiado profundamente como para escanearlos

Una versión que falla queda como rejected con todos los motivos; corrígela y vuelve a subir la misma versión. Cuando un escáner no está disponible momentáneamente, la versión espera y se reintenta; nunca pasa sin escanear.

Inyección de prompts

El texto de un paquete llega al agente: descripciones de herramientas, skills, READMEs, notas de la versión. El registro lee cada cadena del manifiesto, README*, los archivos Markdown y de texto, SKILL.md, CLAUDE.md, AGENTS.md y los archivos bajo skills/, agents/, commands/ y prompts/ con todas las reglas, y tus archivos de código con las reglas de alta confianza. El texto se normaliza primero (entidades HTML, caracteres Unicode parecidos, caracteres invisibles, énfasis de Markdown), así que los disfraces no sirven. Rechaza:

  • instrucciones para ignorar o anular instrucciones anteriores, o para revelar el prompt del sistema;
  • marcadores de rol de chat (<|im_start|>, [INST], <system> …);
  • caracteres ocultos: caracteres de ancho cero y de control bidireccional, caracteres de etiqueta Unicode;
  • secuencias largas de base64 que se decodifican a texto legible;
  • comentarios HTML o elementos ocultos que se dirigen a la IA;
  • peticiones para enviar claves, tokens, credenciales o la conversación a cualquier sitio;
  • frases de jailbreak, peticiones para ocultar acciones al usuario y peticiones para aprobar herramientas automáticamente o saltarse las comprobaciones de permisos.

Las palabras normales de juegos ("god mode"), los emoji, las insignias y la documentación de API pasan. Si una comprobación marca texto inofensivo, reformúlalo o informa del falso positivo a AI Game Dev.

El índice firmado

Una versión publicada se escribe en su propio almacenamiento (community-packages.ai-game.dev) y se lista en un índice comunitario que el registro firma con Ed25519. Cada aplicación comprueba la firma con las claves integradas en la app, rechaza un índice que haya caducado o que sea más antiguo que uno que ya haya aceptado, y verifica la integridad sha512 de cada archivo antes de descomprimirlo y su hash de árbol después. Además del archivo de cada versión, el índice incluye por paquete su publicador, valoración, README, icono, canales y deprecación, y por versión sus notas de la versión (los primeros 4 KB), la deprecación, la procedencia y el flag de código nativo.

Una versión que AI Game Dev revoca se incluye en la lista revoked del índice: cada aplicación la desactiva en su siguiente lectura (una aplicación en ejecución lee el índice aproximadamente cada 30 minutos) y no la vuelve a instalar nunca.

El panel del publicador

El panel del publicador en ai-game.dev/publisher es donde los propietarios y mantenedores con la sesión iniciada gestionan lo que publican:

  • tus publicadores, tu rol en cada uno y sus miembros;
  • las versiones de cada paquete con su estado y el informe de comprobación completo;
  • notas de la versión, canales, deprecación y yanking;
  • tokens de publicador (crear, listar, revocar);
  • publicadores de confianza para GitHub y GitLab, con fragmentos de workflow para copiar;
  • el estado de las subidas que todavía se están comprobando.

Rutas de la API del registro

Todo lo que hacen la CLI y el panel pasa por https://ai-game.dev/api/registry/v1. Los errores usan un único envelope, {"error": {"code", "message", "fields"}}.

RutaQuiénQué
POST /publishers, GET /publishers, GET /publishers/{slug}con sesión iniciada, miembrosReclamar un publicador; listar los tuyos; un publicador con sus paquetes y versiones
GET /me/publisherscon sesión iniciadaTus publicadores con tu rol
GET /publishers/{slug}/membersmiembroLos miembros (correos solo para el propietario)
POST /publishers/{slug}/members, DELETE …/members/{userId}propietarioAñadir o quitar un mantenedor
POST /publishers/{slug}/tokens, GET …/tokens, DELETE …/tokens/{id}miembroTokens de publicador
POST /uploads (multipart tarball, notes opcional)miembro o tokenSubir una versión
GET /packages/{id}/versions/{version}miembro o tokenEstado, informe de comprobación y notas de la versión
PATCH /packages/{id}/versions/{version}miembroEditar las notas de la versión
POST /packages/{id}/versions/{version}/yankmiembro o tokenYank o restaurar
POST, DELETE /packages/{id}/deprecate y …/versions/{version}/deprecatemiembroDeprecar o quitar la deprecación
GET /packages/{id}/dist-tagspúblicoCanales
PUT, DELETE /packages/{id}/dist-tags/{tag}miembroFijar o quitar un canal
GET, POST /packages/{id}/trusted-publishers, DELETE …/{tpId}miembro para leer, propietario para cambiarPublicadores de confianza
POST /oidc/tokenCICanjear un token de identidad de CI por una credencial de subida
GET /packages/{id}/ratings, PUT y DELETE …/ratingpúblico, con sesión iniciadaValoraciones (los miembros del publicador de un paquete no pueden valorarlo)

Páginas Markdown para agentes

Los agentes de IA leen el sitio como Markdown, así que todo lo relacionado con los paquetes tiene un gemelo en Markdown:

  • El catálogo. El catálogo de paquetes en ai-game.dev/packages (en despliegue progresivo) lista todos los paquetes oficiales y de la comunidad, y cada paquete tiene su propia página en /packages/<id>. Añade .md a cualquiera de las dos rutas, o solicítala con Accept: text/markdown, para obtener el mismo contenido en Markdown: nombre, id, versión, publicador, descripción y el comando de instalación.
  • Esta documentación. Cada página de esta wiki tiene un espejo en Markdown bajo /docs-md/ (esta es /docs-md/wiki-app-package-registry.md), enlazado desde View as Markdown en la parte superior de la página. Los espejos conservan cada captura de pantalla como un enlace de imagen.
  • El índice del sitio para LLMs. https://ai-game.dev/llms.txt lista estas páginas, de modo que un agente al que se le pide escribir un paquete puede encontrar la referencia del manifiesto y la API de paquetes directamente.