# Regeln und Prüfungen der Registry — AI Game Dev App & CLI · AI Game Developer Wiki

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

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/app/package-registry).

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

| Limit | Wert |
| --- | --- |
| Archiv (gzip) | 50 MiB komprimiert, 200 MiB entpackt |
| Dateien | 5.000 pro Archiv, 64 MiB pro Datei |
| Publisher pro Konto | 3 |
| Uploads | 20 pro Stunde (pro Konto bzw. pro Publisher bei Token-Uploads) |
| Versionen, die auf Prüfungen warten | 5 pro Publisher |
| Aktive Publisher-Tokens | 10 pro Publisher, jeweils bis zu 365 Tage gültig |
| Vertrauenswürdige Publisher | 10 pro Paket |
| Release Notes | 20 KB Markdown pro Version |
| Kanäle | 5 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üfung | Lehnt ab |
| --- | --- |
| `archive` | Alles 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/` |
| `manifest` | Ein Manifest, das die App nicht laden würde, geprüft mit dem Validator der App selbst: Schema, eigene IDs, Spiel-Engine-Regeln |
| `registry-rules` | Einen 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 |
| `secrets` | Private 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-injection` | Text, der versucht, den Agenten anzuweisen (siehe unten) |
| `native-code` | Nichts: Native Binaries sind erlaubt und werden markiert, und Nutzer sehen „native code“ am Paket |
| `virus-scan` | Alles, 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](https://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"}}`.

| Route | Wer | Was |
| --- | --- | --- |
| `POST /publishers`, `GET /publishers`, `GET /publishers/{slug}` | angemeldet, Mitglieder | Einen Publisher beanspruchen; eigene auflisten; ein Publisher mit seinen Paketen und Versionen |
| `GET /me/publishers` | angemeldet | Deine Publisher mit deiner Rolle |
| `GET /publishers/{slug}/members` | Mitglied | Die Mitglieder (E-Mails nur für den Owner) |
| `POST /publishers/{slug}/members`, `DELETE …/members/{userId}` | Owner | Einen Maintainer hinzufügen oder entfernen |
| `POST /publishers/{slug}/tokens`, `GET …/tokens`, `DELETE …/tokens/{id}` | Mitglied | Publisher-Tokens |
| `POST /uploads` (multipart `tarball`, optional `notes`) | Mitglied oder Token | Eine Version hochladen |
| `GET /packages/{id}/versions/{version}` | Mitglied oder Token | Status, Prüfbericht und Release Notes |
| `PATCH /packages/{id}/versions/{version}` | Mitglied | Release Notes bearbeiten |
| `POST /packages/{id}/versions/{version}/yank` | Mitglied oder Token | Yanken oder wiederherstellen |
| `POST`, `DELETE /packages/{id}/deprecate` und `…/versions/{version}/deprecate` | Mitglied | Deprecaten oder Deprecation aufheben |
| `GET /packages/{id}/dist-tags` | öffentlich | Channels |
| `PUT`, `DELETE /packages/{id}/dist-tags/{tag}` | Mitglied | Einen Channel setzen oder entfernen |
| `GET`, `POST /packages/{id}/trusted-publishers`, `DELETE …/{tpId}` | Mitglied zum Lesen, Owner zum Ändern | Trusted Publishers |
| `POST /oidc/token` | CI | Ein CI-Identitätstoken gegen ein Upload-Credential tauschen |
| `GET /packages/{id}/ratings`, `PUT` und `DELETE …/rating` | öffentlich, angemeldet | Bewertungen (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.

**Tipp**

Damit ein Agent ein Paket für dich schreibt, verweise ihn auf die Markdown-Spiegel der [Paket-API](https://ai-game.dev/de/docs/wiki/app/package-api) und der [Manifest-Referenz](https://ai-game.dev/de/docs/wiki/app/package-manifest) und lass ihn nach jeder Änderung `gamedev pkg validate` ausführen.

## Verwandte Seiten

- [Pakete veröffentlichen](https://ai-game.dev/de/docs/wiki/app/publishing-packages) für den Veröffentlichungs-Workflow.
- [Trusted Publishing](https://ai-game.dev/de/docs/wiki/app/trusted-publishing) für CI und Provenienz.
- [Lifecycle, Hosts und Berechtigungen](https://ai-game.dev/de/docs/wiki/app/package-lifecycle#permissions) dafür, was ein Paket nach der Installation tun darf.

---

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

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