# Regras e verificações do registro — App e CLI do AI Game Dev · AI Game Developer Wiki

Registro da comunidade: regras de nomes, limites, verificações automáticas, índice assinado, painel do publicador, API e Markdown para agentes.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/package-registry).

Toda versão enviada ao registro da comunidade do AI Game Dev é verificada automaticamente antes de qualquer pessoa poder instalá-la; não há fila de revisão manual. Esta página lista as regras que um pacote deve seguir, o que cada verificação recusa e por quê, como uma versão publicada chega aos usuários por meio de um índice assinado, o painel do publicador, a API do registro e as páginas Markdown que os agentes de IA leem.

## Nomes

- **Ids de publicador** têm de 2 a 40 letras minúsculas, dígitos e hífens simples, por ordem de chegada. Reservados: `aigd`, os nomes de engines `unity`, `godot`, `unreal`, `brutal`, `bevy` e `threejs`, marcas registradas e palavras de função (`anthropic`, `claude`, `openai`, `official`, `admin`, `samples` …), imitações após converter dígitos em letras (`un1ty`), e qualquer id que use um nome reservado como palavra ou prefixo (`unity-tools`, `my-godot`). Um nome reservado pode ser atribuído ao seu detentor real pelo AI Game Dev.
- **Ids de pacote** são `<publisher>.<name>` e devem corresponder ao manifesto. Ids reservados pelo app, como `aigd.image`, são recusados.
- **Precedência:** o app ignora uma entrada da comunidade para um id `aigd.*` ou para qualquer id listado no índice do próprio AI Game Dev, de modo que ninguém pode se sobrepor a um pacote oficial.

## Limites

| Limite | Valor |
| --- | --- |
| Arquivo (gzip) | 50 MiB comprimido, 200 MiB descompactado |
| Arquivos | 5.000 por pacote compactado, 64 MiB por arquivo |
| Publicadores por conta | 3 |
| Envios | 20 por hora (por conta, ou por publicador no caso de envios por token) |
| Versões aguardando verificações | 5 por publicador |
| Tokens de publicador ativos | 10 por publicador, cada um válido por até 365 dias |
| Publicadores confiáveis | 10 por pacote |
| Notas de versão | 20 KB de Markdown por versão |
| Canais | 5 por pacote |

## As verificações automáticas

O arquivo é tratado como dado não confiável: é descompactado em memória sob um limite de tamanho e lido como bytes, nunca executado. As verificações rodam nesta ordem, e o relatório lista cada uma com seu resultado:

| Verificação | Recusa |
| --- | --- |
| `archive` | Qualquer coisa que não seja gzip; arquivos acima dos limites; symlinks, hard links, dispositivos, caminhos absolutos, `..`, caracteres de controle, nomes inválidos no Windows, duplicatas que diferem só por maiúsculas/minúsculas, `.git/` |
| `manifest` | Um manifesto que o app não carregaria, verificado com o validador do próprio app: schema, ids possuídos, regras de engine de jogo |
| `registry-rules` | Um publicador que você não possui; um id reservado; qualquer entrada em `enabledApiProposals`; um `main` que não está no arquivo; um ícone que não seja um PNG, JPEG, GIF, WebP ou ICO real, ou um SVG com scripts, estilos, referências externas ou manipuladores de eventos |
| `secrets` | Chaves privadas e credenciais (nuvem, GitHub, GitLab, Slack, Stripe, Google, Anthropic, OpenAI, npm, PyPI, Hugging Face, chaves do ai-game.dev), JWTs, arquivos como `.env`, `.npmrc` ou `id_rsa`. O relatório informa o arquivo e a linha, nunca o valor |
| `prompt-injection` | Texto que tenta dar instruções ao agente (abaixo) |
| `native-code` | Nada: binários nativos são permitidos e sinalizados, e os usuários veem "native code" no pacote |
| `virus-scan` | Qualquer coisa sinalizada pelo antivírus, incluindo arquivos aninhados profundos demais para escanear |

Uma versão que falha é `rejected` com todos os motivos; corrija e envie a mesma versão novamente. Quando um scanner fica temporariamente inacessível, a versão aguarda e é reprocessada; ela nunca passa sem ser escaneada.

### Injeção de prompt

O texto de um pacote chega ao agente: descrições de ferramentas, skills, READMEs, notas de versão. O registro lê cada string do manifesto, `README*`, arquivos Markdown e de texto, `SKILL.md`, `CLAUDE.md`, `AGENTS.md` e os arquivos em `skills/`, `agents/`, `commands/` e `prompts/` com todas as regras, e seus arquivos de código com as regras de alta confiança. O texto é normalizado primeiro (entidades HTML, caracteres Unicode parecidos, caracteres invisíveis, ênfase em Markdown), então disfarces não ajudam. Ele recusa:

- instruções para ignorar ou substituir instruções anteriores, ou para revelar o prompt de sistema;
- marcadores de papel de chat (`<|im_start|>`, `[INST]`, `<system>` …);
- caracteres ocultos: caracteres de controle de largura zero e bidirecionais, caracteres de tag Unicode;
- sequências longas de base64 que decodificam para texto legível;
- comentários HTML ou elementos ocultos que se dirigem à IA;
- pedidos para enviar chaves, tokens, credenciais ou a conversa para qualquer lugar;
- frases de jailbreak, pedidos para ocultar ações do usuário e pedidos para aprovar ferramentas automaticamente ou contornar verificações de permissão.

Palavras comuns de jogos ("god mode"), emoji, badges e documentação de API passam. Se uma verificação sinalizar um texto inofensivo, reescreva-o ou reporte o falso positivo ao AI Game Dev.

## O índice assinado

Uma versão publicada é gravada em seu próprio armazenamento (`community-packages.ai-game.dev`) e listada em um índice da comunidade que o registro assina com Ed25519. Todo app verifica a assinatura com as chaves embutidas no app, recusa um índice expirado ou mais antigo que um já aceito, e verifica a integridade `sha512` de cada arquivo antes de descompactar e o tree hash depois. Além do arquivo de cada versão, o índice traz, por pacote, seu publicador, avaliação, README, ícone, canais e depreciação, e, por versão, suas notas de versão (primeiros 4 KB), depreciação, proveniência e a flag de código nativo.

Uma versão que o AI Game Dev revoga é listada na lista `revoked` do índice: todo app a desativa na próxima leitura (um app em execução lê o índice a cada 30 minutos, aproximadamente) e nunca mais a instala.

## O painel do publicador

O painel do publicador em [ai-game.dev/publisher](https://ai-game.dev/publisher) é onde proprietários e mantenedores autenticados gerenciam o que publicam:

- seus publicadores, seu papel em cada um e seus membros;
- as versões de cada pacote com seu estado e relatório completo de verificação;
- notas de versão, canais, depreciação e yanking;
- tokens de publicador (criar, listar, revogar);
- publicadores confiáveis para GitHub e GitLab, com trechos de workflow copiáveis;
- o status dos uploads ainda em verificação.

## Rotas da API do registro

Tudo o que a CLI e o painel fazem passa por `https://ai-game.dev/api/registry/v1`. Os erros usam um único envelope, `{"error": {"code", "message", "fields"}}`.

| Rota | Quem | O quê |
| --- | --- | --- |
| `POST /publishers`, `GET /publishers`, `GET /publishers/{slug}` | autenticado, membros | Reivindicar um publicador; listar os seus; um publicador com seus pacotes e versões |
| `GET /me/publishers` | autenticado | Seus publicadores com seu papel |
| `GET /publishers/{slug}/members` | membro | Os membros (e-mails só para o proprietário) |
| `POST /publishers/{slug}/members`, `DELETE …/members/{userId}` | proprietário | Adicionar ou remover um mantenedor |
| `POST /publishers/{slug}/tokens`, `GET …/tokens`, `DELETE …/tokens/{id}` | membro | Tokens de publicador |
| `POST /uploads` (multipart `tarball`, `notes` opcional) | membro ou token | Enviar uma versão |
| `GET /packages/{id}/versions/{version}` | membro ou token | Estado, relatório de verificação e notas de versão |
| `PATCH /packages/{id}/versions/{version}` | membro | Editar notas de versão |
| `POST /packages/{id}/versions/{version}/yank` | membro ou token | Yank ou restaurar |
| `POST`, `DELETE /packages/{id}/deprecate` e `…/versions/{version}/deprecate` | membro | Depreciar ou desfazer a depreciação |
| `GET /packages/{id}/dist-tags` | público | Canais |
| `PUT`, `DELETE /packages/{id}/dist-tags/{tag}` | membro | Definir ou remover um canal |
| `GET`, `POST /packages/{id}/trusted-publishers`, `DELETE …/{tpId}` | membro para ler, proprietário para alterar | Publicadores confiáveis |
| `POST /oidc/token` | CI | Trocar um token de identidade de CI por uma credencial de upload |
| `GET /packages/{id}/ratings`, `PUT` e `DELETE …/rating` | público, autenticado | Avaliações (membros do publicador do pacote não podem avaliá-lo) |

## Páginas Markdown para agentes

Agentes de IA leem o site como Markdown, então tudo sobre pacotes tem um gêmeo em Markdown:

- **O catálogo.** O catálogo de pacotes em `ai-game.dev/packages` (em implantação) lista todos os pacotes oficiais e da comunidade, e cada pacote tem sua própria página em `/packages/<id>`. Adicione `.md` a qualquer um dos caminhos, ou solicite com `Accept: text/markdown`, para obter o mesmo conteúdo em Markdown: nome, id, versão, publicador, descrição e o comando de instalação.
- **Esta documentação.** Toda página desta wiki tem um espelho em Markdown em `/docs-md/` (esta é `/docs-md/wiki-app-package-registry.md`), linkado em **View as Markdown** no topo da página. Os espelhos mantêm cada captura de tela como um link de imagem.
- **O índice do site para LLMs.** `https://ai-game.dev/llms.txt` lista estas páginas, para que um agente encarregado de escrever um pacote encontre a referência do manifesto e a API de pacotes diretamente.

**Dica**

Para um agente escrever um pacote para você, aponte-o para os espelhos Markdown da [API de pacotes](https://ai-game.dev/pt-br/docs/wiki/app/package-api) e da [referência do manifesto](https://ai-game.dev/pt-br/docs/wiki/app/package-manifest), e deixe-o executar `gamedev pkg validate` após cada alteração.

## Páginas relacionadas

- [Publicando pacotes](https://ai-game.dev/pt-br/docs/wiki/app/publishing-packages) para o fluxo de publicação.
- [Publicação Confiável](https://ai-game.dev/pt-br/docs/wiki/app/trusted-publishing) para CI e proveniência.
- [Ciclo de vida, hosts e permissões](https://ai-game.dev/pt-br/docs/wiki/app/package-lifecycle#permissions) para o que um pacote pode fazer depois de instalado.

---

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

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