Perler-Bead-Generator
Wandelt Bilder in Perler-Bead-Vorlagen um, die sowohl dem Original ähneln als auch praktisch umsetzbar sind. Zuerst wird sichergestellt, dass das Motiv in der farblosen Blockvorschau klar erkennbar ist, dann wird die reale Perler-Oberfläche dargestellt. Exakte Perler-Positionen, Farbnummern und Mengen müssen durch ein deterministisches Skript berechnet werden; Bildgenerierung wird nur für optionale Präsentationsgrafiken verwendet.
Anfrage-Modus ermitteln
Wähle den minimalen Modus, der die Anfrage erfüllt:
- Vorlagen-Modus – Standard bei vorhandenem Bild: Originalbild → exakte Perler-Effektgrafik + nummeriertes Bauraster + Farb- und Mengendatei.
- Präsentations-Modus: Zuerst den Vorlagen-Modus durchführen, dann auf Basis der Effektgrafik eine Xiaohongshu-artige Präsentationsgrafik oder Produktdarstellung erzeugen. Generierte Präsentationsgrafiken dürfen nicht als Bauvorlage verwendet werden.
- Text-Design-Modus: Wenn der Benutzer kein Bild, sondern nur eine Textidee hat, wird zuerst ein sauberes, fokussiertes Quellbild generiert, dann in den Vorlagen-Modus übergegangen.
- Nur-Prompt-Modus: Nur verwenden, wenn der Benutzer es explizit verlangt; gib den Prompt und empfohlene Parameter zurück, behaupte nicht, dass eine Vorlage erstellt wurde.
Wenn der Benutzer ein Bild hochlädt und sagt „Mach das zu Perler-Beads“, verwende direkt den Vorlagen-Modus. Frage Parameter, die du sicher entscheiden kannst, nicht beim Benutzer ab.
Relevante Anleitungen lesen
- Bevor du Rastergröße, Hintergrundbehandlung, Palette oder Perler-Stil auswählst, lies
references/design-guide.md. - Bevor du das Ergebnis ausgibst, lies
references/quality-gate.mdund führe die Prüfungen durch.
Eingabekonventionen
- Überprüfe vor der Konvertierung das tatsächliche Quellbild und notiere Größe, Seitenverhältnis, Motiv, Hintergrundkomplexität, transparente Bereiche sowie wichtige Texte oder Identitätsmerkmale.
- Behandle das Bild als Bearbeitungsziel, dessen Motiv erhalten bleiben soll, es sei denn, der Benutzer gibt an, dass es nur als Stilreferenz dient.
- Erhalte im Rahmen der Rasterfähigkeiten sichtbare Identitätsmerkmale, Außenkonturen, Ausrichtung, Objektanzahl, Hauptfarbblöcke und kurze, notwendige Texte.
- Wenn das Raster zu klein ist, um Gesichter, feinen Text, komplexe Szenen oder kleine Markierungen darzustellen, erkläre die Einschränkung kurz und vergrößere das Raster; erfinde keine Details.
- Entferne keinen sinnvollen Hintergrund ohne Erlaubnis. Verwende automatische Hintergrundentfernung nur, wenn der Hintergrund fast einfarbig ist oder der Benutzer explizit eine Freistellung des Motivs wünscht.
- Mache bei mehreren Personen oder komplexen Szenen eine „Auflösungsbudget“-Schätzung: Berechne, wie viele Perler-Raster jedes Kernmotiv erhält. Wenn die Breite eines Kernmotivs (Gesicht, Tierkopf oder Logo) weniger als etwa 16 Raster beträgt, priorisiere eine engere Zuschneidung des Motivs oder eine höhere Rastergröße, anstatt direkt zu generieren.
Vorlagen-Modus Ablauf
- Überprüfe das Quellbild mit der lokalen Bildbetrachtungsfähigkeit und lies die Dateigröße aus.
- Wähle Rastergröße, Palette, Anpassungsmethode, Hintergrundbehandlung und Perler-Stil gemäß
references/design-guide.md. - Finde eine Python-Umgebung mit Pillow. Auf dem Codex-Desktop lade zuerst die Workspace-Abhängigkeiten, dann verwende den zurückgegebenen integrierten Python-Pfad. Wenn Pillow nicht vorhanden ist, gib an, dass die Abhängigkeit fehlt; installiere nicht ohne Erlaubnis.
- Führe aus:
<Python-mit-Pillow> scripts/render_bead_pattern.py Eingabebild Ausgabeverzeichnis \
--width-beads 48 \
--max-colors 18 \
--fit contain \
--background keep \
--render beads
Löse die Skript- und Ressourcenpfade relativ zum Skill-Verzeichnis auf. Verwende --help, um alle Parameter anzuzeigen. Bei komplexen Illustrationen kann --sharpen 1.2 hinzugefügt werden; bei Bedarf zur Fokussierung auf das Motiv verwende --crop "links,oben,rechts,unten"; bei kritischen, kleinen Farbflächen verwende die in Anführungszeichen gesetzte Option --anchor-colors "#F2C76E,#8A315F". Verwende --palette source, wenn eine adaptive Palette aus dem Quellbild extrahiert werden soll; wenn eine benutzerdefinierte oder Markenpalette verwendet werden soll, übergebe ein JSON im gleichen Format wie assets/generic-palette.json.
- Betrachte zuerst die farblose Blockvorschau, um zu beurteilen, ob Komposition und Motiv klar sind; dann betrachte die Perler-Effektgrafik und das Bauraster. Verlasse dich nicht nur auf die Befehlsausgabe.
- Vergleiche mit dem Original in Originalgröße und in verkleinerter Größe. Wenn Identität oder Konturen verloren gehen, priorisiere engere Zuschneidung des Motivs oder höhere Rastergröße; wenn feine Linien verloren gehen, erhöhe die Schärfung; wenn kritische Farben verschwinden, verankere sie. Wiederhole einmal.
- Überprüfe, ob die Summe der Stückliste mit der Anzahl aller nicht-leeren Rasterzellen übereinstimmt.
Das Skript gibt aus:
*-color-preview.png: Farblose, unbeschriftete klare Blockvorschau zur Beurteilung der Motiverkennbarkeit.*-bead-preview.png: Von einem exakten Raster gerenderte Perler-Effektgrafik.*-pattern.png: Nummeriertes Bauraster.*-legend.png: Farblegende mit Anzahl pro Farbe.*-pattern.csv: Rasterweise Farbnummerntabelle.*-bom.csv: Materialstückliste.*-metadata.json: Konvertierungsparameter, Farben und Gesamtzahlen.
Präsentations-Modus Ablauf
Der Vorlagen-Modus muss zuerst abgeschlossen sein; dann verwende die generierte Perler-Effektgrafik als Bearbeitungsziel für die integrierte Bildgenerierungsfähigkeit.
Behalte Design, Rasterverhältnis, Konturen, Ausrichtung und Position der Hauptfarben unverändert. Erlaube nur Änderungen an Kamerawinkel, Untergrundmaterial, Tisch, Beleuchtung, Requisiten und Hintergrund. Bevorzuge eine saubere, von oben aufgenommene Handarbeitsumgebung mit weichem, natürlichem Licht und wenigen relevanten Werkzeugen; lass keine Hände oder Requisiten das Kunstwerk verdecken.
Wenn die Präsentationsgrafik das Design oder die Perler-Positionen deutlich verändert, wiederhole sie mit strengeren Erhaltungsanforderungen. Gib zuerst die exakte Effektgrafik und die Baudateien zurück, dann die Präsentationsgrafik, um Verwechslungen zu vermeiden.
Text-Design-Modus Ablauf
- Reduziere die Benutzeranforderung auf eine zentrierte, erkennbare Kontur oder kompakte Komposition.
- Generiere ein Quellbild mit sauberem oder transparentem Hintergrund, breiten Farbblöcken, ohne Textur oder Lichtverläufe und ohne kleinen Text.
- Übergib das tatsächlich generierte Bild an den Vorlagen-Modus.
- Mache deutlich, dass dies ein nach Textvorgabe erstelltes Design ist und keine Konvertierung des Benutzerbildes.
Ausgabeformat
Bevorzuge die praktischsten Ergebnisse:
**Klare Motivvorschau**

**Perler-Effektgrafik**

**Bauvorlage und Stückliste**
- Raster: [Breite] × [Höhe]
- Farben: [Anzahl Farben]
- Gesamt-Perler: [Anzahl nicht-leerer Zellen]
- Bauraster: [klickbarer absoluter Pfad]
- Farblegende: [klickbarer absoluter Pfad]
- Stückliste: [klickbarer absoluter Pfad]
**Konvertierungseinstellungen**
- [Raster / Palette / Anpassung / Hintergrund / Perler-Stil]
- [Ein Satz zur Erklärung erhaltener Effekte oder notwendiger Kompromisse]
Füge Präsentationsgrafik nur hinzu, wenn der Präsentations-Modus ausgeführt wurde. Gib keine internen Logs oder vollständigen Metadaten-JSON aus, es sei denn, der Benutzer verlangt es.
Verpflichtende Regeln
- Effektgrafik, Bauraster, CSV, Legende und Stückliste müssen aus derselben Perler-Matrix stammen.
- Die farblose Blockvorschau und die Perler-Effektgrafik müssen ebenfalls aus derselben Perler-Matrix stammen; verwende kein anderes „schöneres“ Bild als klare Vorschau.
- Verwende niemals generative Bilder als exakte Perler-Bauvorlage.
- Bezeichne allgemeine Farbnummern niemals als offizielle Herstellerfarben von Perler, Hama, Artkal oder anderen.
- Wenn der Benutzer eine Herstellerfarbtabelle bereitstellt, verwende sie als Daten und kennzeichne die Quelle genau.
- Setze bei kleinen Vorlagen keinen langen Text ein; verwende stattdessen Initialen, kurze Wörter oder ein größeres Raster.
- Das Vergrößern eines niedrig aufgelösten PNGs erhöht nicht die Wiedergabetreue; du musst die Perler-Zellen erhöhen und neu berechnen.
- Wenn zwei Kernmotive in der verkleinerten Ansicht der Blockvorschau nicht erkennbar sind, beschreibe das Ergebnis nicht als „klar“ oder „vollständig originalgetreu“.
Aufrufbeispiele
- „Verwende
$make-perler-beads, um dieses Katzenfoto in eine 48 Raster breite Perler-Vorlage zu verwandeln.“ - „Behalte nur die Person, entferne den Hintergrund und begrenze die Farben auf 16.“
- „Mach dieses Logo zu einem 29×29-Perler und gib mir das Bauraster und die Stückliste.“
- „Erstelle nach der Perler-Vorlage eine Desktop-Präsentationsgrafik im Xiaohongshu-Stil.“