Og-Bilder
Drei Arten von Bildern, die alle eine Aufgabe haben: jemanden bei einem Link zum Anhalten bringen und die App auf einen Blick verständlich machen. Jedes ist ein echter Screenshot der App mit einem großen Titel, auf dem Brand-Hintergrund oder einem hellen Hintergrundbild. Die UI ist der Held. Nichts wird gezeichnet außer dem Rahmen.
Ausgaben im launch-assets/og/-Verzeichnis des Benutzer-Repos:
| Datei | Größe | Zweck |
|---|---|---|
og.png | 1200×630 | Link-Vorschau für die Startseite. |
og-<id>.png | 1200×630 | Optional: pro Seite einer Website, gleiches Design, Titel von dieser Seite. |
ph/01-<id>.png … 06 | 1270×760 | Product Hunt-Galerie, 4 bis 6 Folien. Folie 1 ist der Held. |
x-header.png | 1500×500 | X-Header mit Avatar und Telefon-Crop-Zonen freigehalten. |
meta.html | Die <meta>-Tags zum Einfügen in <head>. |
Größen und Sicherheitszonen mit Quellen und Daten sind in references/sizes.md.
Wann verwenden
- Ein Launch benötigt ein Teilen-Bild, eine Product Hunt-Galerie oder einen X-Header.
- Das aktuelle
og:imageder Website ist ein Logo auf einer flachen Farbe, oder es gibt keins. - Ein Release hat die UI geändert, sodass die Vorschauen aus neuen Screenshots neu gerendert werden müssen.
Screenshots sind Mac-ähnliche Landschaftsfenster oder Inseln; ein porträtierter Telefonbildschirm wird von diesen Karten nicht unterstützt. Nicht für: App Store-Screenshots (ein anderes Skill mit anderen Größen) oder alles, was eine UI benötigt, die die App nicht hat. Dieses Skill zeichnet niemals UI.
Einrichtung (einmalig)
Node 20 oder neuer. Playwright wird im Skill-Ordner installiert, nicht im Benutzer-Repo:
npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium
Fehlt es, gibt render.mjs diese Zeile aus und beendet sich mit Exit 2.
Schritt 0. Marke
Lese launch-assets/brand.json im Benutzer-Repo. Wenn vorhanden, verwende es. Wenn es fehlt, erkenne jedes Feld aus dem Repo und schreibe die Datei. Frage den Benutzer nur nach dem, was du nicht finden konntest, in einer Nachricht.
{
"appName": "Halo", "oneLiner": "The Dynamic Island for Mac", "platform": "macos",
"colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
"fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
"iconPath": "site/assets/icon.png",
"screenshotDirs": ["launch-assets/captures"],
"siteUrl": "https://example.com"
}
appName,oneLiner: README-Titel und erste Zeile, der<title>und<h1>der Website,Info.plist.colors: die CSS-Variablen der Website, dasAccentColordes Asset-Katalogs, SwiftColor-Definitionen. Nimm die hellen Werte. Schreibe hex (#0d7f76); konvertierergb(),oklch()undhsl()zuerst. Alles, was der Renderer nicht lesen kann, zählt als Grau.fonts.family(ein CSS-Stack),fonts.file(eine Schriftartdatei, die das Repo liefert, ein Pfad relativ zum Repo-Root, der Ordner überlaunch-assets, odernull),fonts.google(z. B.Geist:wght@400;600, odernull). Verwende die Brand-Schriftart nur, wenn das Repo die Datei liefert; ansonsten den System-Stack oder Google Fonts. Kopiere niemals eine proprietäre Schriftart in das Benutzer-Repo.iconPath: das App-Icon, ein quadratisches PNG (1024 px ist am besten), relativ zum Repo-Root. Suche in den Website-Assets, imAppIcondes Asset-Katalogs, im Favicon-Ordner. Erforderlich: Das Icon und der Name sind auf jedem Bild.siteUrl: wohinmeta.htmldie Bild-URLs verweist. Optional; ohne wird ein Platzhalter in den Tags verwendet.
Schritte
-
Screenshots. Wiederverwenden, was existiert:
launch-assets/captures/,screenshotDirsoder ein frühereslaunch-assets/store-screenshots/shots.json. Neue nur dann erstellen, wenn keine die folgenden Regeln erfüllen. Suche zuerst nach der eigenen Methode der App, sich selbst zu erfassen: einen Snapshot, Demo- oder Beispieldaten-Flag (rg -i "demo|snapshot|screenshot|marketing"im Quellcode, der README undPackage.swift; zum BeispielMyApp --snapshot <dir>oderMYAPP_DEMO=1). Lese, was ein Flag tut, bevor du es ausführst. Führe niemals etwas aus, das echte Benutzerdaten scannt, bereinigt oder schreibt, und starte niemals eine zweite Kopie einer App, die Live-Status hält. Wenn ein Flag eines davon tun könnte, stoppe und frage. Andernfalls bringe auf einem Mac die App in den Vordergrund in den zu zeigenden Zustand und führe aus:swift <skill-folder>/scripts/capture-window.swift "MyApp" capture.png(das größte sichtbare Fenster der App, kein Schatten, Retina-Pixel; es überspringt ein Notch- oder Menüleisten-App-Panel, das auf einer höheren Fensterebene liegt, und meldet dies). iOS:xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, dannxcrun simctl io booted screenshot capture.png, dannxcrun simctl status_bar booted clear.Regeln für jeden Screenshot:
- Echte UI, fokussiert. Das aktive Fenster: farbige Ampeln, eine beleuchtete Seitenleiste. Ein graues, abgedunkeltes Fenster ist ein Fehler.
- Beruhigt. Kein Zähler in der Mitte, kein Spinner, nichts halb gezeichnet.
- Neutrale Demodaten. Keine persönlichen Namen, echte Datei-, Projekt- oder Kontonamen, keine Firmennamen anderer Unternehmen (es sei denn, die Website der App nennt diese Integration). Verwende den Demo-Modus, niemals einen Screenshot der echten Sache.
- Heller Modus, wenn die App einen hat. Dunkle Screenshots sind für reine Dunkelmodus-Apps.
- 2x Pixel. Eine Karte zeigt einen Screenshot mit höchstens 1,15x seiner eigenen Pixel (der Renderer schlägt darüber fehl), also benötigt ein Fenster etwa 1400 px in der Breite für eine Link-Vorschau und 2000 px für eine Galerie-Folie.
- Echter Inhalt. Keine leeren Wells, kein Lorem, kein abgeschnittener Text in dem Teil, den der Titel beschreibt.
- Einer, der klein lesbar ist. Die Link-Vorschau zeigt den Screenshot mit etwa 600 px Breite. Wähle den Screenshot, dessen Hauptpunkt bei dieser Größe sichtbar ist (eine große Zahl, eine klare Liste), nicht ein dichtes Einstellungsfenster. Schneide auf den relevanten Teil zu.
- Ein SwiftUI
ImageRenderer-Screenshot (die Insel einer Notch-App) kommt mit undurchsichtigen gelben Platzhaltern in den Eckflares: setze"clean": true. Für eine auf der Karte schwebende Insel füge"square": truehinzu, das die Eckflares quadratisch bis zu den Körperkanten abschneidet. Schneide mitcropeine leere Notch-Zeile weg.
Fertig, wenn jeder Screenshot die Liste erfüllt. Lese die Größe jeder Datei (
sips -g pixelWidth -g pixelHeight) und sieh sie dir an. -
Schreibe die Texte.
- Link-Titel: der One-Liner der App oder der Titel der Seite selbst, in den Worten der Website: 9 Wörter oder weniger, Satzfall, kein Punkt, kein Gedankenstrich, kein
!. Es ist der einzige große Text auf der Karte, also ist kürzer = größer. - Seiten: wenn das Repo eine Website mit mehreren Seiten hat, führe
node <skill-folder>/scripts/pages.mjs <site-folder>aus. Es gibt den<title>und<h1>jeder Seite aus. Wähle die Seiten, die eine eigene Vorschau wert sind (die Anleitungen, die Preisseite, die größten Funktionen); überspringe Seiten, die ein Produkt eines anderen Unternehmens nennen. Nimm den<h1>oder den kürzeren der beiden, entferne den Site-Name-Suffix und Tags im Stil "(2026)", halte es auf 9 Wörter. Paraphrasiere niemals. - Folien: wenn
launch-assets/store-screenshots/shots.jsonexistiert, verwendet"ph": { "fromShots": "../store-screenshots/shots.json" }dessen Überschriften, Unterzeilen, Screenshots und Zuschnitte erneut (erste 6 Shots,"limit"ändert das). Ansonsten schreibe 4 bis 6 Folien: Folie 1 sagt, was die App ist, jede weitere hat einen Nutzen und ergibt allein Sinn. Überschrift 6 Wörter oder weniger, eine optionale Unterzeile von einem kurzen Satz. - X-Header-Titel: der One-Liner. 6 Wörter oder weniger.
- Alt-Text: ein Satz, der sagt, was das Bild zeigt. Standard ist
<app>: <title>. <subline>; schreibealtauf den Link, wenn der Screenshot etwas Bemerkenswertes hinzufügt.
Der Text verwendet die eigenen Worte der Website. Jede Zeile ist von der Website oder README übernommen und gekürzt; jede Zahl, jeder Name und jede Behauptung steht auf der Website. Überprüfe jede Zeile mit
rggegen den Website-Text, bevor du sie behältst. - Link-Titel: der One-Liner der App oder der Titel der Seite selbst, in den Worten der Website: 9 Wörter oder weniger, Satzfall, kein Punkt, kein Gedankenstrich, kein
-
Schreibe
launch-assets/og/og.json.{ "brand": "../brand.json", "out": ".", "wallpaper": "auto", "link": { "title": "Ein Mac-Reiniger für Entwickler", "capture": "../captures/overview.png", "alt": "Shedi, ein Mac-Reiniger für Entwickler: 43,84 GB gefunden, sortiert in sicher zu bereinigen und zuerst prüfen" }, "pages": [ { "id": "xcode-deriveddata", "title": "Xcode DerivedData löschen", "capture": "../captures/xcode.png" } ], "ph": { "fromShots": "../store-screenshots/shots.json" }, "x": { "title": "Ein Mac-Reiniger für Entwickler", "capture": "../captures/overview.png" } }Lasse
pages,phoderxweg, um diese Art zu überspringen. Pfade sind relativ zuog.json. Eine Seite erbt alles vonlink(Screenshot, Zuschnitt, Layout) und überschreibt, was sie benennt. Optionen auflink, einer Seite, einer Folie oderx:capture(odercaptures, bis zu 3, gestapelt),crop({ x, y, w, h }, 0 bis 1 des Screenshots nach Entfernung transparenter Ränder;cropsfür mehrere Screenshots),clean,square,radius,width(Screenshotbreite als Anteil der Karte),shadow: false,minCoverage.layout: Link-Karten sindside(Titel links, ein Fenster, das von unten rechts aufsteigt) oderbelow(Titel zentriert, ein breiter Screenshot darunter). Standardmäßig wirdbelowfür einen Screenshot gewählt, der breiter als 2:1 ist, sonstside. Folien sindfit(der gesamte Screenshot, nichts abgeschnitten),bleed(durch die Unterkante beschnitten, für ein Fenster) oderpair(2 oder 3 Screenshots gestapelt). Eine Folie ohnelayoutund einem einfachen Fenster-Screenshot (keinclean) istbleed; alles andere istfit.minCoverage: die Untergrenze für die UI-Abdeckung (Link 0,3, Folie 0,4, Header 0,12). Ein Screenshot, der 80 % der Kartenbreite einnimmt, besteht ohne sie (eine dünne Insel oder Leiste kann nicht höher werden). Senke die Untergrenze nicht, um einen kleinen Screenshot zu verstecken: zeige ihn größer, schneide ihn zu oder wähle einen anderen.- Auf einer Folie in
fromShots, füge"slides": [{ "id": "<shot id>", ... }]hinzu, um die Optionen einer Folie zu überschreiben.
Hintergrund, einmal für alle Bilder:
"wallpaper": "auto"wählt das mitgelieferte Bild aus, dessen Farbton dem Brand-Akzent am nächsten ist (blau und türkis, grün, warm, pink) und gibt die Auswahl und den Grund aus. Teile dem Benutzer die Auswahl und den Grund mit und dass er sie ändern kann ("wallpaper": "snow"oder ein Pfad zu einem eigenen hellen, ruhigen Bild, mindestens 2400 px breit). Ein grauer Akzent oder einer, der mehr als 50 Grad von jedem Bild entfernt ist, erhält stattdessen das Brand-Feld (der Brand-Hintergrund, mit einem Hauch seines Akzents gewaschen). Lasse den Schlüssel für das Feld weg. Dieses Skill enthält fünf Bilder. -
Rendern.
node <skill-folder>/scripts/render.mjs launch-assets/og/og.jsonEine Ausgabezeile pro PNG:
okoderFAIL, Größe, Dateigewicht, die Schriftart, die den Titel tatsächlich gezeichnet hat, der Kontrast der Wörter gegen die Pixel wirklich dahinter, die Größe und Oberlänge des Titels, die UI-Abdeckung und wie stark der Screenshot und das Hintergrundbild vergrößert wurden.--only link|pages|ph|xrendert nur eine Art (alles andere schlägt fehl). Es schreibt auchmeta.html.Die Prüfung schlägt fehl bei: einer nicht exakten Größe, einem Alpha-Kanal, einer Datei über 5 MB, Textkontrast unter 4,5:1 (es gibt keinen Scrim; wähle ein helleres Hintergrundbild oder dunklere Tinte), einem Titel, dessen Oberlänge unter dem Minimum liegt (Link 40 px, Folie 38 px, Header 36 px, damit er in einer 600 px breiten Vorschau noch lesbar ist) oder der mehr Zeilen benötigt als passen, überlangem oder mit Gedankenstrich (einem Gedankenstrich, " - " oder "--") oder
!-Text, einem Screenshot, der über 1,15x vergrößert wurde, oder einem Hintergrundbild über 1,2x, UI-Abdeckung unter der Grenze, es sei denn, der Screenshot nimmt 80 % der Kartenbreite ein (gemessen an den Inhalts-Pixeln des Screenshots, nicht an seinem Rahmen, sodass leere schwarze oder weiße Bereiche nicht zählen), etwas außerhalb des X-Sicherheitsbereichs oder innerhalb der Avatar-Zone und einem Schriftart-Fallback: die erste genannte Familie vonfonts.familymuss die Schriftart sein, die den Titel gezeichnet hat ("Inter, sans-serif"ohne Datei würde SF Pro zeichnen: FAIL). Ein Stack, der mit-apple-systemodersystem-uibeginnt, bedeutet die Systemschriftart und schlägt nur bei einem Fallback wie Helvetica oder Arial fehl. Behebe jedesFAILinog.jsonund rendere erneut. -
QA-Durchlauf. Erforderlich und auf den Dateien durchgeführt, nicht auf der Konfiguration.
- Größe und Alpha:
sips -g pixelWidth -g pixelHeight -g hasAlpha <jede Datei>. Exakte Größen aus sizes.md,hasAlpha: no. - Ansehen: Öffne jedes PNG mit dem Lese-Tool in voller Größe. Führe dann
node <skill-folder>/scripts/preview.mjs launch-assets/ogaus und öffne_preview-600.pngund_preview-300.png(jedes Bild bei 600 und 300 px Breite, wie ein Feed es zeigt), lösche dann die beiden Dateien. Prüfe für jedes Bild:- Der Titel ist bei 300 px lesbar und nichts ist abgeschnitten oder allein in einer zweiten Zeile.
- Die Schriftart in der Ausgabezeile ist die, die du angefordert hast.
- Der Screenshot ist scharf, zeigt den Punkt des Titels, hat keinen abgeschnittenen Text und keine persönlichen Daten.
- Namen: kein Name oder Logo eines Wettbewerbers oder anderer Unternehmen, es sei denn, die Website nennt diese Integration; keine persönlichen Namen.
- Wörter: Jede Zeile ist der eigene Wortlaut der Website, gekürzt; jede Zahl ist auf der Website.
- X-Header: Die linke untere Ecke (x unter 420, y über 300) ist frei für das Profilfoto; der Inhalt sitzt im mittleren Band, weg von den oberen und unteren 70 px. Überprüfe es gegen sizes.md und, wenn möglich, auf dem echten Profil.
- Set: Die Folien lesen sich wie eine Familie; keine zwei machen denselben Punkt.
- Behebe und rendere erneut, sieh dir dann diese Datei erneut an.
- Erst dann melden: die Dateiliste, die
sips-Ausgabe und alles, was du nicht verifizieren konntest. Sage dem Benutzer, die PNGs auf die Website zu kopieren,meta.htmlin<head>einzufügen und die zwischengespeicherte Vorschau im Debugger jeder Plattform zu aktualisieren.
- Größe und Alpha:
Betrachtungsregeln
- Hell zuerst. Ein helles Hintergrundbild oder das Brand-Feld, Tinte dunkel darauf. Kein dunkler Hintergrund mit Neon.
- Kein Leuchten, kein Halo. Tiefe ist eine 1 px Kante und neutrale schwarze Schatten bei niedriger Deckkraft.
- Ein Job pro Bild. Ein Titel, ein Screenshot (oder ein Paar), höchstens eine Unterzeile.
- Große Schrift. Der Titel ist das, was in einer Miniaturansicht überlebt. Kurzer Text ermöglicht große Schrift.
- Nur echte Screenshots. Die UI wird niemals gezeichnet, neu gezeichnet oder generiert.