Freigabe-Karten, Favicon und App-Symbole
Eine bereitgestellte App (https://{name}.grok.me) wird mit einer 1200×630 Karte aufgefaltet; jede App (inklusive Vorschau) zeigt ein
Favicon im Tab. Die <meta>-Tags der Freigabe-Karte werden nicht in __root.tsx verfasst – der Injector
(scripts/grok-pwa-shared.mjs) überschreibt og:* und twitter:card bei jeder HTML-Antwort. Identitätsdaten sind das
einzige, was jemand schreibt, und der Pass schreibt alles davon – ausführend säen Sie nichts davon ein:
src/lib/og/site.json– nicht vorab befüllt, wird nur bei Bedarf erstellt:{ "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" }; der Titel standardmäßig der Host-Slug.public/og.jpg– benutzerdefinierte 1200×630 Karte (optional; sonst Platzhalter)public/x-banner.jpg– nur für Spiele: 50:11 (1200×264) X-Feed-Kartepublic/favicon.svg– vom Roothead()verlinkt; bis der Pass eintrifft, zeigt der Tab nur das Browser-Standard-Favicon, was nichts kaputt macht
Erweitern Sie __root.tsx; ersetzen Sie es niemals vollständig (Auth-SSR, Neugestaltungen, Skill-Auszüge): Das Entfernen des
Favicon-Links liefert ein leeres Tab-Symbol, das keine lokale Prüfung erkennt.
Entscheiden: Welche Karte diese App erhält
Standard: eine benutzerdefinierte Karte aus der eigenen Grafik der App – Spiele jeder Art und Rendering-Technik (Canvas/WebGL und DOM-Brett, Karte, Wort, Puzzle, Quiz: ein Tic-Tac-Toe-Raster aus Divs ist immer noch ein Spiel), verspielte Apps, kreative Werkzeuge, Inhalts- und Marken-orientierte Seiten. Im Zweifel erstellen Sie die benutzerdefinierte Karte.
Nur reine Dienstprogramm-Apps (Konverter, CRUD-Tracker, Dashboards, Notizen/Admin – Apps, deren Gesicht die Daten sind)
behalten den Standard-Platzhalter von og.grok.me: kein public/og.jpg. Dessen URL, der "color"-Knopf und die Umbenennungsregel:
references/placeholder-card.md.
og:type für Spiele
Ein Spiel jeglicher Art trägt "type": "x:game" in src/lib/og/site.json – der Pass schreibt es und besitzt diese Datei.
Kein Hostname, niemals an eine benutzerdefinierte Karte gekoppelt, niemals auf website, bloßes game, twitter:card
oder einen erfundenen x:type „korrigiert“: X' Pipeline greift auf diesen exakten Wert zu. Nicht-Spiele lassen es weg.
Ihre Prüfung, nicht Ihre Bearbeitung – Fehlt es, oder fehlt public/x-banner.jpg sobald eine benutzerdefinierte Karte existiert, ist das eine MARKENWARNUNG.
Marken-Asset-Pass: immer ein Sub-Agent, niemals darauf warten
Haben Sie das task-Werkzeug? Führen Sie diesen Pass als Sub-Agent aus und generieren Sie niemals selbst Karten-Grafiken –
Inline einzufügen bedeutet Minuten an Generierungslatenz vor dem Benutzer. Sobald Name und Farbpalette feststehen (AGENTS.md §
„Parallele Arbeit“), geben Sie diese Aufforderung wörtlich weiter. Sie ist vollständig – öffnen Sie nicht die Referenzen unten, um
sie anzureichern; der Pass liest sie selbst:
Sie sind der Marken-Asset-Pass. Befolgen Sie den
og-Skill, der Ihnen sagt, wo Sie beginnen sollen. App<NAME>,og:type<TYP>, Palette<PALETTE>. Sie besitzen allein die Marken-Assets inpublic/undsrc/lib/og/site.json.
Bauen Sie weiter. Bleiben Sie nur dann sequentiell, wenn der Benutzer die Bildregie führt oder die wiederzuverwendende Grafik noch nicht existiert.
Warten Sie niemals darauf. Kein wait_tasks, und niemals get_task_output für die Marken-Aufgabe: Das Lesen der Ausgabe einer
Aufgabe verbraucht sie, und eine verbrauchte Aufgabe sendet keine Abschlussbenachrichtigung, sodass das Ergebnis der Karte –
einschließlich eines Fehlschlags – niemanden erreichen würde. Antworten Sie, sobald die App rendert; der Pass weckt Sie später, und diese
Runde ist höchstens ein kurzer Satz – einer, der nach einer erneuten Veröffentlichung fragt, da public/og.jpg im Build
ausgeliefert wird und eine Karte, die nach einer Veröffentlichung eintrifft, die Live-App nie von selbst erreicht:
„Freigabe-Karte hinzugefügt – veröffentlichen Sie erneut, falls Sie es bereits getan haben.“ / „Die Karte ist fehlgeschlagen; die Standard-Karte bleibt bestehen."
Solange der Pass /workspace/.grok/og-pending frisch hält, sagen Markenprüfungen nichts über die Karte aus: In Bearbeitung ist kein Befund.
Der Marker wird nach 10 Minuten ungültig, sodass ein sehr langer Pass die Warnung durchlässt – aber eine Markenwarnung während des
Laufs ist niemals ein Hinweis, seine Arbeit zu wiederholen.
Kein task-Werkzeug? Dann sind Sie der Pass – erstellen Sie die Assets jetzt; sonst wird niemand es tun. Wer auch immer den Pass ausführt,
beansprucht diesen Marker, legt Dateien unter /workspace/.grok/ ab – niemals innerhalb von public/, das vite build
wörtlich in die bereitgestellte App kopiert – übergibt ihn mit scripts/write-atomic.mjs, sodass kein Build eine halbe JPEG-Datei
liest, und führt eine Selbstprüfung mit node scripts/brand-check.mjs --game durch.
Erstellen Sie die Assets – der Pass liest diese, der übergeordnete Agent nicht
Ausführend? Öffnen Sie sie nicht – die obige Aufforderung ist vollständig. Einmaliges Lesen trägt diese Prozedur in Ihren Kontext für jede spätere Runde, während der Sub-Agent die Arbeit ohnehin erledigt.
Sie sind der Pass? Beginnen Sie bei references/brand-pass.md, lesen Sie dann pro
Asset, das Sie schulden: references/custom-card.md für public/og.jpg, references/x-banner.md für das
nur für Spiele geltende public/x-banner.jpg, references/favicon-and-icons.md für public/favicon.svg plus die PWA-
Raster-Symbole – diese nur, wenn der Benutzer nach installierbar/PWA gefragt hat, erfinden Sie niemals ein Manifest. Schreiben Sie
dieses SVG von Hand, niemals imagine_text_to_image: Es muss bei 16px scharf bleiben. site.json für ein Spiel schreiben?
references/og-type-contract.md erläutert die Schreibweisen, die X ablehnt.
Bei Umbenennung oder einer materiellen Identitätsänderung neu generieren – APP_NAME, der site.json-title und der eingebackene
Kartentitel bewegen sich gemeinsam. Ohne imagine_text_to_image oder die xAI Images API die og.grok.me-Karte behalten; niemals
eine defekte og:image-URL ausliefern.
Nicht unterstützt
Keine /api/og-Route, kein Laufzeit-Bildrenderer, keine Routen-spezifischen Karten – die Karte ist ein statisches, seitenweites Bild
(public/og.jpg oder der Platzhalter-Dienst). Wenn Sie robots.txt hinzufügen, niemals pauschal Disallow: /: Crawler
müssen / abrufen, um die Tags zu lesen.