Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

Regeln und Prüfungen der Registry

Die Community-Registry: Namensregeln, Limits, automatische Prüfungen, signierter Index, Publisher-Panel, API und Markdown für Agenten.

Aktualisiert am 19. November 2026 Als Markdown anzeigen

Jede Version, die in die AI Game Dev Community-Registry hochgeladen wird, wird automatisch geprüft, bevor sie irgendjemand installieren kann; es gibt keine manuelle Prüf-Warteschlange. Diese Seite listet die Regeln, die ein Paket befolgen muss, was jede Prüfung ablehnt und warum, wie eine veröffentlichte Version über einen signierten Index zu den Nutzern gelangt, das Publisher-Panel, die API der Registry und die Markdown-Seiten, die KI-Agenten lesen.

Namen

  • Publisher-IDs bestehen aus 2 bis 40 Kleinbuchstaben, Ziffern und einzelnen Bindestrichen, wer zuerst kommt, mahlt zuerst. Reserviert: aigd, die Engine-Namen unity, godot, unreal, brutal, bevy und threejs, Marken und Rollenwörter (anthropic, claude, openai, official, admin, samples …), Verwechslungsformen nach dem Falten von Ziffern zu Buchstaben (un1ty), und jede ID, die einen reservierten Namen als Wort oder Präfix verwendet (unity-tools, my-godot). Ein reservierter Name kann von AI Game Dev an seinen tatsächlichen Inhaber vergeben werden.
  • Paket-IDs haben die Form <publisher>.<name> und müssen mit dem Manifest übereinstimmen. Von der App reservierte IDs wie aigd.image werden abgelehnt.
  • Vorrang: Die App ignoriert einen Community-Eintrag für eine aigd.*-ID oder jede ID, die im eigenen Index von AI Game Dev aufgeführt ist, damit niemand ein offizielles Paket überschatten kann.

Limits

LimitWert
Archiv (gzip)50 MiB komprimiert, 200 MiB entpackt
Dateien5.000 pro Archiv, 64 MiB pro Datei
Publisher pro Konto3
Uploads20 pro Stunde (pro Konto bzw. pro Publisher bei Token-Uploads)
Versionen, die auf Prüfungen warten5 pro Publisher
Aktive Publisher-Tokens10 pro Publisher, jeweils bis zu 365 Tage gültig
Vertrauenswürdige Publisher10 pro Paket
Release Notes20 KB Markdown pro Version
Kanäle5 pro Paket

Die automatischen Prüfungen

Das Archiv wird als nicht vertrauenswürdige Daten behandelt: Es wird im Speicher unter einer Größenobergrenze entpackt und als Bytes gelesen, niemals ausgeführt. Die Prüfungen laufen in dieser Reihenfolge, und der Bericht führt jede mit ihrem Ergebnis auf:

PrüfungLehnt ab
archiveAlles außer gzip; Archive über den Limits; Symlinks, Hardlinks, Geräte, absolute Pfade, .., Steuerzeichen, unter Windows ungültige Namen, Duplikate mit unterschiedlicher Groß-/Kleinschreibung, .git/
manifestEin Manifest, das die App nicht laden würde, geprüft mit dem Validator der App selbst: Schema, eigene IDs, Spiel-Engine-Regeln
registry-rulesEinen Publisher, den du nicht besitzt; eine reservierte ID; jeden Eintrag in enabledApiProposals; ein main, das nicht im Archiv ist; ein Icon, das kein echtes PNG, JPEG, GIF, WebP oder ICO ist, oder ein SVG mit Skripten, Styles, externen Verweisen oder Event-Handlern
secretsPrivate Schlüssel und Zugangsdaten (Cloud, GitHub, GitLab, Slack, Stripe, Google, Anthropic, OpenAI, npm, PyPI, Hugging Face, ai-game.dev-Schlüssel), JWTs, Dateien wie .env, .npmrc oder id_rsa. Der Bericht nennt die Datei und Zeile, niemals den Wert
prompt-injectionText, der versucht, den Agenten anzuweisen (siehe unten)
native-codeNichts: Native Binaries sind erlaubt und werden markiert, und Nutzer sehen „native code“ am Paket
virus-scanAlles, was der Virenscanner meldet, einschließlich Archiven, die zu tief verschachtelt sind, um gescannt zu werden

Eine Version, die durchfällt, ist rejected mit allen Gründen; behebe das Problem und lade dieselbe Version erneut hoch. Wenn ein Scanner kurzzeitig nicht erreichbar ist, wartet die Version und wird erneut versucht; sie geht nie ungescannt durch.

Prompt-Injection

Der Text eines Pakets erreicht den Agenten: Tool-Beschreibungen, Skills, READMEs, Release Notes. Die Registry liest jede Manifest-Zeichenkette, README*, Markdown- und Textdateien, SKILL.md, CLAUDE.md, AGENTS.md und die Dateien unter skills/, agents/, commands/ und prompts/ mit allen Regeln, und deine Codedateien mit den Regeln hoher Sicherheit. Der Text wird zuerst normalisiert (HTML-Entities, Unicode-Verwechslungszeichen, unsichtbare Zeichen, Markdown-Hervorhebungen), damit Tarnungen nicht helfen. Sie lehnt ab:

  • Anweisungen, vorherige Anweisungen zu ignorieren oder außer Kraft zu setzen, oder den System-Prompt offenzulegen;
  • Chat-Rollenmarker (<|im_start|>, [INST], <system> …);
  • versteckte Zeichen: Zero-Width- und bidirektionale Steuerzeichen, Unicode-Tag-Zeichen;
  • lange Base64-Sequenzen, die sich zu lesbarem Text dekodieren lassen;
  • HTML-Kommentare oder versteckte Elemente, die sich an die KI richten;
  • Aufforderungen, Schlüssel, Tokens, Zugangsdaten oder die Unterhaltung irgendwohin zu senden;
  • Jailbreak-Phrasen, Aufforderungen, Aktionen vor dem Nutzer zu verbergen, und Aufforderungen, Tools automatisch zu genehmigen oder Berechtigungsprüfungen zu umgehen.

Normale Spielwörter („god mode“), Emojis, Badges und API-Dokumentation kommen durch. Wenn eine Prüfung harmlosen Text markiert, formuliere ihn um oder melde den Fehlalarm an AI Game Dev.

Der signierte Index

Eine veröffentlichte Version wird in ihren eigenen Speicher geschrieben (community-packages.ai-game.dev) und in einem Community-Index aufgeführt, den die Registry mit Ed25519 signiert. Jede App prüft die Signatur gegen in die App eingebaute Schlüssel, lehnt einen Index ab, der abgelaufen oder älter als ein bereits akzeptierter ist, und verifiziert die sha512-Integrität jedes Archivs vor dem Entpacken und dessen Tree-Hash danach. Neben dem Archiv jeder Version enthält der Index pro Paket dessen Publisher, Bewertung, README, Icon, Channels und Deprecation sowie pro Version die Release Notes (die ersten 4 KB), Deprecation, Provenienz und das Flag für nativen Code.

Eine Version, die AI Game Dev widerruft, wird in der revoked-Liste des Index aufgeführt: Jede App deaktiviert sie bei ihrer nächsten Lektüre (eine laufende App liest den Index etwa alle 30 Minuten) und installiert sie nie wieder.

Das Publisher-Panel

Im Publisher-Panel unter ai-game.dev/publisher verwalten angemeldete Owner und Maintainer, was sie veröffentlichen:

  • deine Publisher, deine Rolle in jedem einzelnen und deren Mitglieder;
  • die Versionen jedes Pakets mit ihrem Status und dem vollständigen Prüfbericht;
  • Release Notes, Channels, Deprecation und Yanking;
  • Publisher-Tokens (erstellen, auflisten, widerrufen);
  • Trusted Publishers für GitHub und GitLab, mit kopierbaren Workflow-Snippets;
  • den Status von Uploads, die noch geprüft werden.

Routen der Registry-API

Alles, was die CLI und das Panel tun, läuft über https://ai-game.dev/api/registry/v1. Fehler verwenden einen einheitlichen Envelope, {"error": {"code", "message", "fields"}}.

RouteWerWas
POST /publishers, GET /publishers, GET /publishers/{slug}angemeldet, MitgliederEinen Publisher beanspruchen; eigene auflisten; ein Publisher mit seinen Paketen und Versionen
GET /me/publishersangemeldetDeine Publisher mit deiner Rolle
GET /publishers/{slug}/membersMitgliedDie Mitglieder (E-Mails nur für den Owner)
POST /publishers/{slug}/members, DELETE …/members/{userId}OwnerEinen Maintainer hinzufügen oder entfernen
POST /publishers/{slug}/tokens, GET …/tokens, DELETE …/tokens/{id}MitgliedPublisher-Tokens
POST /uploads (multipart tarball, optional notes)Mitglied oder TokenEine Version hochladen
GET /packages/{id}/versions/{version}Mitglied oder TokenStatus, Prüfbericht und Release Notes
PATCH /packages/{id}/versions/{version}MitgliedRelease Notes bearbeiten
POST /packages/{id}/versions/{version}/yankMitglied oder TokenYanken oder wiederherstellen
POST, DELETE /packages/{id}/deprecate und …/versions/{version}/deprecateMitgliedDeprecaten oder Deprecation aufheben
GET /packages/{id}/dist-tagsöffentlichChannels
PUT, DELETE /packages/{id}/dist-tags/{tag}MitgliedEinen Channel setzen oder entfernen
GET, POST /packages/{id}/trusted-publishers, DELETE …/{tpId}Mitglied zum Lesen, Owner zum ÄndernTrusted Publishers
POST /oidc/tokenCIEin CI-Identitätstoken gegen ein Upload-Credential tauschen
GET /packages/{id}/ratings, PUT und DELETE …/ratingöffentlich, angemeldetBewertungen (Mitglieder des Publishers des Pakets können es nicht bewerten)

Markdown-Seiten für Agenten

KI-Agenten lesen die Website als Markdown, daher hat alles rund um Pakete ein Markdown-Pendant:

  • Der Katalog. Der Paketkatalog unter ai-game.dev/packages (wird gerade ausgerollt) listet jedes offizielle und jedes Community-Paket auf, und jedes Paket hat seine eigene Seite unter /packages/<id>. Hänge .md an einen der beiden Pfade an oder fordere ihn mit Accept: text/markdown an, um denselben Inhalt als Markdown zu erhalten: Name, ID, Version, Publisher, Beschreibung und den Installationsbefehl.
  • Diese Docs. Jede Seite dieses Wikis hat einen Markdown-Spiegel unter /docs-md/ (diese hier ist /docs-md/wiki-app-package-registry.md), verlinkt über View as Markdown oben auf der Seite. Die Spiegel behalten jeden Screenshot als Bildlink bei.
  • Der Site-Index für LLMs. https://ai-game.dev/llms.txt listet diese Seiten auf, sodass ein Agent, der ein Paket schreiben soll, die Manifest-Referenz und die Paket-API direkt findet.