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.
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 enginesunity,godot,unreal,brutal,bevyethreejs, 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, comoaigd.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 é 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.mda qualquer um dos caminhos, ou solicite comAccept: 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.txtlista estas páginas, para que um agente encarregado de escrever um pacote encontre a referência do manifesto e a API de pacotes diretamente.
Páginas relacionadas
- Publicando pacotes para o fluxo de publicação.
- Publicação Confiável para CI e proveniência.
- Ciclo de vida, hosts e permissões para o que um pacote pode fazer depois de instalado.