# Reglas y comprobaciones del registro — App y CLI de AI Game Dev · AI Game Developer Wiki

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

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/docs/wiki/app/package-registry).

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ímite | Valor |
| --- | --- |
| Archivo (gzip) | 50 MiB comprimido, 200 MiB descomprimido |
| Archivos | 5.000 por archivo comprimido, 64 MiB por archivo |
| Publicadores por cuenta | 3 |
| Subidas | 20 por hora (por cuenta, o por publicador en las subidas con token) |
| Versiones en espera de comprobaciones | 5 por publicador |
| Tokens de publicador activos | 10 por publicador, cada uno válido hasta 365 días |
| Publicadores de confianza | 10 por paquete |
| Notas de la versión | 20 KB de Markdown por versión |
| Canales | 5 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ón | Rechaza |
| --- | --- |
| `archive` | Cualquier 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/` |
| `manifest` | Un 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-rules` | Un 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 |
| `secrets` | Claves 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-injection` | Texto que intenta dar instrucciones al agente (más abajo) |
| `native-code` | Nada: los binarios nativos están permitidos y se marcan, y los usuarios ven "código nativo" en el paquete |
| `virus-scan` | Todo 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](https://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"}}`.

| Ruta | Quién | Qué |
| --- | --- | --- |
| `POST /publishers`, `GET /publishers`, `GET /publishers/{slug}` | con sesión iniciada, miembros | Reclamar un publicador; listar los tuyos; un publicador con sus paquetes y versiones |
| `GET /me/publishers` | con sesión iniciada | Tus publicadores con tu rol |
| `GET /publishers/{slug}/members` | miembro | Los miembros (correos solo para el propietario) |
| `POST /publishers/{slug}/members`, `DELETE …/members/{userId}` | propietario | Añadir o quitar un mantenedor |
| `POST /publishers/{slug}/tokens`, `GET …/tokens`, `DELETE …/tokens/{id}` | miembro | Tokens de publicador |
| `POST /uploads` (multipart `tarball`, `notes` opcional) | miembro o token | Subir una versión |
| `GET /packages/{id}/versions/{version}` | miembro o token | Estado, informe de comprobación y notas de la versión |
| `PATCH /packages/{id}/versions/{version}` | miembro | Editar las notas de la versión |
| `POST /packages/{id}/versions/{version}/yank` | miembro o token | Yank o restaurar |
| `POST`, `DELETE /packages/{id}/deprecate` y `…/versions/{version}/deprecate` | miembro | Deprecar o quitar la deprecación |
| `GET /packages/{id}/dist-tags` | público | Canales |
| `PUT`, `DELETE /packages/{id}/dist-tags/{tag}` | miembro | Fijar o quitar un canal |
| `GET`, `POST /packages/{id}/trusted-publishers`, `DELETE …/{tpId}` | miembro para leer, propietario para cambiar | Publicadores de confianza |
| `POST /oidc/token` | CI | Canjear un token de identidad de CI por una credencial de subida |
| `GET /packages/{id}/ratings`, `PUT` y `DELETE …/rating` | público, con sesión iniciada | Valoraciones (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.

**Consejo**

Para que un agente te escriba un paquete, apúntalo a los espejos Markdown de la [API de paquetes](https://ai-game.dev/es/docs/wiki/app/package-api) y la [referencia del manifiesto](https://ai-game.dev/es/docs/wiki/app/package-manifest), y deja que ejecute `gamedev pkg validate` después de cada cambio.

## Páginas relacionadas

- [Publicar paquetes](https://ai-game.dev/es/docs/wiki/app/publishing-packages) para el flujo de trabajo de publicación.
- [Publicación de confianza](https://ai-game.dev/es/docs/wiki/app/trusted-publishing) para CI y procedencia.
- [Ciclo de vida, hosts y permisos](https://ai-game.dev/es/docs/wiki/app/package-lifecycle#permissions) para saber qué puede hacer un paquete una vez instalado.

---

Source (HTML): https://ai-game.dev/es/docs/wiki/app/package-registry

Machine-translated (es) from the English page: https://ai-game.dev/docs/wiki/app/package-registry
