Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Regras e verificações do registro

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

Atualizado em 19 de novembro de 2026 Ver como Markdown

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

LimiteValor
Arquivo (gzip)50 MiB comprimido, 200 MiB descompactado
Arquivos5.000 por pacote compactado, 64 MiB por arquivo
Publicadores por conta3
Envios20 por hora (por conta, ou por publicador no caso de envios por token)
Versões aguardando verificações5 por publicador
Tokens de publicador ativos10 por publicador, cada um válido por até 365 dias
Publicadores confiáveis10 por pacote
Notas de versão20 KB de Markdown por versão
Canais5 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çãoRecusa
archiveQualquer 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/
manifestUm 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-rulesUm 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
secretsChaves 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-injectionTexto que tenta dar instruções ao agente (abaixo)
native-codeNada: binários nativos são permitidos e sinalizados, e os usuários veem "native code" no pacote
virus-scanQualquer 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 é 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"}}.

RotaQuemO quê
POST /publishers, GET /publishers, GET /publishers/{slug}autenticado, membrosReivindicar um publicador; listar os seus; um publicador com seus pacotes e versões
GET /me/publishersautenticadoSeus publicadores com seu papel
GET /publishers/{slug}/membersmembroOs membros (e-mails só para o proprietário)
POST /publishers/{slug}/members, DELETE …/members/{userId}proprietárioAdicionar ou remover um mantenedor
POST /publishers/{slug}/tokens, GET …/tokens, DELETE …/tokens/{id}membroTokens de publicador
POST /uploads (multipart tarball, notes opcional)membro ou tokenEnviar uma versão
GET /packages/{id}/versions/{version}membro ou tokenEstado, relatório de verificação e notas de versão
PATCH /packages/{id}/versions/{version}membroEditar notas de versão
POST /packages/{id}/versions/{version}/yankmembro ou tokenYank ou restaurar
POST, DELETE /packages/{id}/deprecate e …/versions/{version}/deprecatemembroDepreciar ou desfazer a depreciação
GET /packages/{id}/dist-tagspúblicoCanais
PUT, DELETE /packages/{id}/dist-tags/{tag}membroDefinir ou remover um canal
GET, POST /packages/{id}/trusted-publishers, DELETE …/{tpId}membro para ler, proprietário para alterarPublicadores confiáveis
POST /oidc/tokenCITrocar um token de identidade de CI por uma credencial de upload
GET /packages/{id}/ratings, PUT e DELETE …/ratingpúblico, autenticadoAvaliaçõ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.