Fähigkeit: Artikel-Layout für WeChat Official Accounts (GZH-Design)
Wandelt einen Markdown-Artikel in HTML um, das direkt in den WeChat Official Accounts Editor kopiert und eingefügt werden kann, ohne dass der Stil verloren geht.
Kernressource ist die Designkomponentenbibliothek unter references/ (ein Thema pro Datei: Designvariablen + vollständiges HTML jeder Komponente + Vorlagengerüst + Mapping-Regeln) plus eine gemeinsame Inkrementellbibliothek (Code-Blöcke / Bilder·GIFs / kleine Label-Überschriften, gemeinsam genutzt von allen Themen). Die Themenliste hat references/theme-index.md als einzige Quelle. Diese SKILL.md beschreibt nur den Ablauf und die Entscheidungen – das konkrete HTML wird immer aus der Komponentenbibliothek bezogen, nicht aus dem Gedächtnis geschrieben.
Arbeitsablauf
0. Eingabe & Formatvereinheitlichung
Der Benutzer kann Folgendes bereitstellen: Markdown-Text oder .md-Pfad (geht direkt zu Schritt 1), .docx, .pdf, .txt/reiner Text ohne Markdown, Rich-Text von Webseiten. Nicht-Markdown-Eingabe muss zuerst references/format-normalize.md lesen und nach dessen Regeln in einen Markdown-Entwurf konvertiert und strukturell bestätigt werden (docx mit scripts/extract_docx.py, PDF mit Read seitenweise lesen + entrauschen, reiner Text mit heuristischer Überschriftenstruktur). Wenn nichts angegeben wird, fordere es vom Benutzer an.
Wenn der Benutzer sagt „direkt layouten / automatisch layouten / mit einem Klick / nicht fragen“, wechsle in den Vollautomatik-Modus: Überspringe die Strukturbestätigung und die Themenauswahlfrage, leite die Struktur automatisch ab, wähle das Thema basierend auf dem Inhalt aus, layout und validiere, und liefere eine Entscheidungsbegründung mit (Kapitelstruktur, selbst verfasster Titel, Grund für die Themenwahl).
1. Themenauswahl (Automatische Empfehlung)
Lies references/theme-index.md (die einzige Quelle für Themeninformationen). Empfehle proaktiv das am besten passende Thema basierend auf dem Artikelinhalt und lass es dann vom Benutzer mit einem Schritt bestätigen – empfehle, aber entscheide nicht eigenmächtig:
- Benutzer hat bereits ein Thema in der Anfrage angegeben → Verwende es direkt, ohne zu fragen.
- Inhalt hat eine eindeutige Passung → Frage mit einer Option: „Empfehlung: XX (Grund), bestätigen oder wechseln?“ Optionen: Empfehlung + 1–2 Alternativen + „Alle anzeigen“. Inhalt-zu-Thema-Passung (siehe Spalte „Anwendbare Szenarien“ in theme-index):
- Tutorial / Test / Checkliste / Tool-Übersicht / Wissensorganisation / Methodenzerlegung (hohe Informationsdichte) → Moyu-Grün
- Tiefgehende Analyse / Meinung / kraftvolle Themen → Rot-Weiß-Serie
- Design / Tech-Kritik / professionelle Meinung / hochwertige Marken → Steinpapier-Minimalismus
- Zen / minimalistisches Leben / tiefgründiger Essay → Zen-Weißraum-Stil
- Tool-Vergleich / kreativer Test (visuelle Metapher einer Rechnung) → Moyu-Rechnungsstil
- Interne Zeitschriftennotizen / tiefgehender Test / Fallanalyse → Olive-Notizen
- Keine klare Tendenz → Standardmäßig das erste Thema in theme-index (Moyu-Grün) als erste Empfehlung, verwende AskUserQuestion, um den Benutzer aus mehreren Optionen auswählen zu lassen (wenn es mehr als 4 Themen gibt, gruppiere sie zuerst nach Stil, frage nach der Gruppe und dann nach dem Thema innerhalb der Gruppe).
- Vollautomatik-Modus (Benutzer sagt explizit „direkt layouten / mit einem Klick / nicht fragen“) → Keine Fragen stellen, wähle automatisch das am besten passende Thema oder das Standard-Erste, und erkläre die Wahl bei der Auslieferung.
- Benutzer ist mit keinem vorhandenen Thema zufrieden / möchte einen neuen Stil → Gehe zum „Benutzerdefiniertes Thema generieren“-Ablauf (siehe nächster Abschnitt), generiere und registriere es, kehre dann zu diesem Schritt zurück.
- theme-index ist leer → Layout stoppen, Benutzer informieren, dass zuerst ein Themenstil hinzugefügt werden muss (kann über „Benutzerdefiniertes Thema generieren“ erfolgen).
Erst nachdem der Benutzer das Thema festgelegt hat, erfolgt die Komponentenzuordnung innerhalb des Themas (Schritte 3 & 4: Artikeltyp bestimmen → Komponentenkombination gemäß der Rezeptur des Themas auswählen).
2. Komponentenbibliotheken lesen (zwei)
(1) Lies basierend auf der Spalte „Komponentenbibliotheksdatei“ des Themas in theme-index die themenspezifische Komponentenbibliothek references/theme-{Kennung}.md (enthält themenspezifische Komponenten wie Einleitungskarte, Kapitelüberschriften, Textmarkierungen, Signatur usw.).
(2) Lies gleichzeitig die gemeinsame Inkrementellbibliothek references/common-components.md – Code-Blöcke, Bilder/GIFs, kleine Label-Überschriften werden von allen Themen gemeinsam genutzt, wende einfach die Hauptfarbe des aktuellen Themas an.
Die gesamte nachfolgende Generierung basiert ausschließlich auf diesen beiden Komponentenbibliotheken; HTML wird immer daraus bezogen, nicht selbst geschrieben.
3. Markdown-Struktur parsen
| Element | Erkennungsregel |
|---|---|
| Artikeltitel | # Titel oder frontmatter title |
| Einleitendes Zitat | > Zitat-Block am Anfang des Artikels |
| Kapitelüberschrift | ## Überschrift |
| Unterkapitel | ### Überschrift |
| Fett / Highlight / Unterstreichung | **Text** / ==Text== / <u>Text</u> oder ++Text++ |
| Zitatabsatz | Nicht-am-Anfang > Text |
| Bilder / GIFs | ,  (GIF wird wie Bild behandelt) |
| Code / Befehle / Prompts | ``` ``` Code-Blöcke, Inline `code` |
| Trennlinie / Listen | ---, *** / - Punkt oder 1. Punkt |
| Tabellen | Durch ` |
Nachdem die Struktur geparst wurde, bestimme den Artikeltyp (nimm den dominanten Typ, kann kombiniert sein): Tutorial/Anleitung, Übersicht/Tool-Liste, Meinung/Tiefgehende Analyse, Interview/Personenporträt, Daten-Rückblick/Bericht, Lifestyle/Gefühl-Essay, Fallstudie. Entscheidungskriterien: Viele Schritte und Befehle → Tutorial; Viele parallele Einträge → Übersicht; Viele Zitate und Erzählungen → Interview; Viele Zahlen und Vergleiche → Daten; Viele Argumentationen → Meinung.
4. Komponentenkombination nach Rezept auswählen → HTML montieren
Zuerst die Tabelle „Artikeltyp → Komponentenkombinationsrezeptur“ der ausgewählten Themenbibliothek abfragen, um basierend auf dem Artikeltyp die Kernkomponentenkombination und die dekorativen Komponenten zu bestimmen – nicht einfach abschnittsweise zufällige Komponenten auswählen. Die Rezeptur gewährleistet einen konsistenten Layout-Stil für Artikel desselben Typs. Elemente außerhalb der Rezeptur werden dann gemäß der Mapping-Regeltabelle der Themenbibliothek ergänzt.
Dann gemäß dem Abschnitt „Vollständiges Artikelvorlagengerüst“ der Themenbibliothek montieren, wobei jedes Markdown-Element durch die entsprechende Komponente ersetzt wird:
- Die Reihenfolge des Gerüsts richtet sich nach der Themenbibliothek; verschiedene Themen können unterschiedliche Gerüste haben. Verwende nicht das Gerüst eines anderen Themas.
- Inline-Markierungen werden semantisch in der ausgewählten Komponentenbibliothek nach der entsprechenden Komponente gesucht (die Komponentennummern sind nicht über Bibliotheken hinweg einheitlich; richte dich immer nach der Semantik, nicht nach festen Nummern):
**fett**→ Hauptfarbe fett;==Highlight==→ Verlaufs-Hintergrund-Highlight;<u>Text</u>oder++Text++→ Unterstreichung;~~Text~~→ Textmarker (untere Hälfte Highlight);> Zitat→ Zitat-Highlight-Block. - Komponenten aus der gemeinsamen Inkrementellbibliothek:
``` Code-Block ```→ 1a dunkel / 1b heller Code-Block, Inline`code`→ 1c;→ 2a Bild (Komponente nur, wenn eine Beschreibung vorhanden ist) ,.gif→ 2b GIF; Hervorzuhebende Untertitel/Betonungen → 3a linker vertikaler Balken Untertitel oder 3b Pillen-Label, Schlüsselsätze → 3d, Hinweis-Marginalie → 3e. Priorität: Zuerst die Mapping-Regeltabelle der Themenbibliothek prüfen – wenn das Thema eine semantisch äquivalente Komponente hat (z. B. eigene Schlüsselsatz-/Hinweis-Blöcke), verwende die Version der Themenbibliothek, um den Stil konsistent zu halten; wenn die Themenbibliothek keine entsprechende Komponente hat, verwende die generische 3er-Serie aus der gemeinsamen Bibliothek und wende deren Farbänderungsregeln an, um die Themenfarbe zu erhalten. - Ein Artikel verwendet nur die Komponenten des ausgewählten Themas, keine themenübergreifende Mischung.
- Verwende für Betonungen und Untertitel „kleines Label / linker vertikaler Balken“, nicht gestrichelte Rahmen: Um einen Untertitel oder einen Inhaltsabschnitt hervorzuheben, verwende den linken vertikalen Balken Untertitel (3a), Pillen-Label (3b), linken vertikalen Balken Schlüsselsatz/Hinweis-Block (3d/3e); verwende keine gestrichelten Rahmen (
dashedborder) um eine Überschrift – das wirkt klobig und aufdringlich.
5. Validierung auf Konformität (obligatorisch)
Nachdem das generierte HTML in die Zieldatei geschrieben wurde, muss das Validierungsskript ausgeführt werden. Der Vorgang ist erst abgeschlossen, wenn ERROR = 0 ist:
# Verwende den absoluten Pfad des Skripts im Skill-Verzeichnis, der HTML-Parameter verwendet ebenfalls seinen tatsächlichen Pfad (beide Verzeichnisse sind normalerweise unterschiedlich)
<SKILL_ROOT>/scripts/validate_gzh_html.py <absoluter Pfad der generierten .html-Datei>
Es überprüft deterministisch auf plattformverbotene Elemente und <span leaf>-Umbüllung. Bei einem ERROR zurück zu Schritt 4; Halbe Breite Satzzeichen WARNUNGEN müssen ebenfalls auf 0 korrigiert werden, bevor ausgeliefert wird (dies ist der häufigste Nacharbeitspunkt in der Praxis).
6. Ausgabe
Format des Ergebnisses: Reiner <section>…</section> Textauschnitt, beginnend mit dem globalen Container, ohne <!DOCTYPE>/<html>/<head>/<body> – der WeChat Official Accounts Editor akzeptiert nur Textausschnitte; überflüssige Dokumentenhüllen werden verworfen oder stören das Einfügen.
- Saubere Textdatei: HTML im aktuellen Arbeitsverzeichnis speichern, Dateiname
{ursprünglicher Dateiname}_Layout_{Themenname auf Chinesisch}({Englische Kennung}).html(Englische Kennung = Komponentenbibliotheksdateiname in theme-index ohnetheme--Präfix und.md-Suffix). Diese Datei dient der Validierung und als Fallback für manuelles Einfügen. - Vorschauseite mit „Kopieren“-Schalter (damit der Benutzer mit einem Klick kopieren kann, ohne alles manuell auswählen zu müssen):
Erzeugt<SKILL_ROOT>/scripts/wrap_preview.py <obige saubere Text.html>{…}_Vorschau.html– im Browser geöffnet gibt es oben rechts einen „In WeChat Official Account kopieren“-Button. Ein Klick kopiert den gerenderten Rich-Text in die Zwischenablage (entspricht Strg+A/Strg+C), dann im WeChat Official Accounts Editor Strg/⌘+V einfügen. Der Button und das Skript befinden sich nur in der Vorschauhülle, nicht innerhalb des kopierten<section>, sodass in den WeChat Official Account immer noch der saubere, konforme Text eingefügt wird. - Informiere den Benutzer:
{…}_Vorschau.htmlöffnen → Oben rechts auf „Kopieren“ klicken → Im WeChat Official Accounts Editor einfügen; gib zusätzlich den Pfad der sauberen Textdatei als Fallback an. Füge die Schlussfolgerung des Validierungsskripts hinzu (bestanden / verbleibende warnings).
Intelligente Verarbeitung während der Generierung (Diese sind die Besonderheiten dieses Skills, müssen gemacht werden)
- Automatische Kapitelnummerierung: Weise basierend auf der Reihenfolge von
##die Nummern01/02/03…zu; wenn das letzte Kapitel ein Fazit/Zusammenfassung ist, verwende die von der Themenbibliothek angegebene Variante für die Schlussnummer (z. B.∞); wenn die Themenbibliothek keine spezifische Variante angibt, verwende die fortlaufende Nummerierung. - Englische Labels: Generiere basierend auf dem chinesischen Kapiteltitel ein englisches Label (实测→TEST, 教程→TUTORIAL, 总结→SUMMARY, 思考→THOUGHTS…); verwende es, wenn die Themenbibliothek einen entsprechenden Slot hat.
- Unterstreichung von Schlüsselwörtern im Text (Kernfunktion): Finde in jedem Textabsatz proaktiv 1–3 der wichtigsten Phrasen und markiere sie mit der Unterstreichungs-CSS des Themas (siehe theme-index). Bevorzuge Kernaussagen, Schlussfolgerungen, Schlüsseldaten, Eigennamen; Phrasen 4–15 Zeichen; wenn ein Absatz keine wichtigen Punkte hat, kann die Markierung entfallen. Unterstreichung muss auch dann aktiv hinzugefügt werden, wenn der Originaltext keine Fettungen enthält – es ist die am häufigsten vorkommende grundlegende Markierung.
- Hervorhebung von Schlüsselwörtern in Einleitungszitaten: Erkenne Kernwörter im Eröffnungssatz und markiere sie mit der Highlight-Komponente.
- Inhaltsverzeichnis-Extraktion: Nimm die ersten 3 aus allen
##als Lesezeichen/Inhaltsverzeichnis-Punkte (wenn die Themenbibliothek eine Verzeichniskomponente hat). - Namensnennung in der Einleitungskarte: Richte dich nach dem Autor oder Thema des Artikels – wenn der Artikel eine Namensnennung hat, schreibe „—— Autorenname“; wenn kein klarer Autor vorhanden ist, verwende eine kurze, themenbezogene Signatur oder lasse sie ganz weg. Schreibe nicht fest „Jiamu“ (die Signatur am Ende verwendet ebenfalls
{{Autorenname}}als Platzhalter, siehe Punkt 7). - Signatur des Autors am Ende (vom Autor selbst auszufüllen, nur eine Stelle am Ende): Schreibe standardmäßig keinen Namen fest, verwende einen Platzhalter, den der Benutzer durch seinen eigenen ersetzen kann.
- Erster Satz (Autorenvorstellung):
Ich bin {{Autorenname}}, {{Kurzbeschreibung, z. B.: begeistert vom Teilen von KI-Beobachtungen und Wissen}}– wenn der Benutzer in der Anfrage/Präferenz eine Namensnennung oder Kurzbeschreibung angegeben hat, fülle sie direkt ein; wenn nicht, behalte die Platzhalter{{Autorenname}}/{{Kurzbeschreibung}}bei und weise den Benutzer bei der Auslieferung an, sie durch seine eigenen zu ersetzen. - Zweiter Satz (Interaktionsaufforderung, allgemein kann er so bleiben):
Wenn dir dieser Artikel heute gefallen hat, freuen wir uns über ein **Like, In den Lesezeichen speichern und Teilen** – bis zum nächsten Mal - Wenn das Ende des Originaltexts bereits einen Autoren-Signatur-Abschnitt hat (z. B. „Ich bin XXX…“) → Übernimm die Original-Signatur direkt, ersetze sie nicht durch einen Platzhalter.
- Erster Satz (Autorenvorstellung):
- Listenkonvertierung: Verarbeite sie gemäß den Mapping-Regeln der Themenbibliothek; wenn es keine dedizierte Listenkomponente gibt, wandle sie in eingerückte Textabsätze um.
- Chinesische Satzzeichen in voller Breite: Verwende für alle Satzzeichen im Text die volle Breite (,。!?:;„“''()—— …), nicht die halbe Breite
, . ! ? :und englische gerade Anführungszeichen" '. Schreibe beim Generieren des HTML direkt geschwungene Anführungszeichen „“''; schreibe nicht zuerst gerade Anführungszeichen und ersetze sie später – gerade Anführungszeichen im Originaltext werden beim Umschreiben sofort konvertiert. Ausnahmen: Code-Blöcke, Inline-Code, englische Eigennamen/URLs/Code-Identifikatoren bleiben im Inneren unverändert.
Visuelle Hierarchie (3 Ebenen, gilt für alle Themen)
| Ebene | Funktion | Häufigkeit | Mittel |
|---|---|---|---|
| Ankerebene | Stärkster Anker: Produktname/Schritte/CTA/Kern-Schlüsselsätze | Maximal 5 im gesamten Artikel | Fett in Hauptfarbe, Zitat mit dunklem Hintergrund und weißer Schrift |
| Markierungsebene | Schlüsselwörter im Text, 1–3 pro Absatz | Hochfrequent | Unterstreichungsmarkierung |
| Containerebene | Zitatblöcke, Konzept-Labels, Betonung langer Sätze | Nach Bedarf | Helle Hintergrundzitate, Textmarker, Abzeichen |
Plattform-Rotlinien (Kern, vollständige Prüfung durch Validierungsskript)
- Verboten:
<style>/<script>/<div>,class/id-Attribute,position:fixed/absolute/sticky,float,@media/@keyframes,display:grid, CSS-Variablen, externe Schriften/CSS. - Erforderlich: Alle Stile inline als
style; Alle Textknoten müssen mit<span leaf="">Text</span>umschlossen sein (sonst geht der Stil nach dem Einfügen verloren). - Verwendbar:
display:flex(eingeschränkt),linear-gradient,border-radius,box-shadow,<section>/<p>/<span>/<strong>/<img>/<h3>.
Gotchas (Stolperfallen aus dem echten Layout)
- Fehlendes
<span leaf>-Umschließen ist der häufigste fatale Fehler – nach dem Einfügen in den WeChat Official Account geht der gesamte Stil verloren. Wird durch das Validierungsskript in Schritt 5 abgefangen – überspringe es nicht. - Unterstreichung: Absatzweise umsetzen, 1–3 Phrasen pro Absatz. Markiere nicht den gesamten Absatz (verliert den Fokus) und markiere auch keine Absätze, während andere fehlen; markiere auch Schlüsselbeschreibungen in Listenelementen.
- Kapitelnummerierung durcheinander: Halte dich strikt an die Reihenfolge von
##, überspringe keine Nummern; die Variante für die Schlussnummer gilt nur für das letzte Kapitel, nicht für Zwischenkapitel. - Signatur gibt es nur genau einmal am Ende: Verwende den festgelegten Text, erscheint nicht in der Mitte oder mehrfach; wenn am Ende des Originaltexts bereits ein Autoren-Signatur-Abschnitt / ein Absatz mit „Like, In den Lesezeichen speichern, Teilen“ steht, erkenne ihn und integriere ihn in diese einzige Signatur/CTA-Karte; behalte nicht den Originalabsatz bei und generiere zusätzlich einen neuen.
- Bildbeschreibungen erfunden: Generiere eine Beschreibungskomponente nur, wenn
tatsächlich eine Beschreibung enthält; beimit leerem alt erfinde keine Beschreibung. - Bilder anpassen, nicht in voller Breite:
<img>immer mitmax-width:100%;height:auto;display:block;margin:0 auto– werden in ihrer eigenen Größe angezeigt, zentriert; große Bilder auf die Containerbreite verkleinert, kleine Bilder behalten ihre Größe. Verwende nichtwidth:100%(das würde kleine Bilder strecken und unscharf machen); nur für Layout-Elemente wie Tabellen / Karten / Flussdiagramme verwendewidth:100%. - Themenübergreifende Komponentenmischung: Ein Artikel verwendet nur die Komponenten des ausgewählten Themas + der gemeinsamen Bibliothek, leihe keine Komponenten aus anderen Themen.
- Übermäßiger Gebrauch der Ankerebene: Stärkste Betonung maximal 5 mal im gesamten Artikel; überall Fett zu setzen bedeutet nirgends einen Schwerpunkt.
- Inhalt des Originaltexts ausgelassen: Jeder Absatz, jedes Bild muss konvertiert werden; nichts darf fehlen; füge keine wesentlichen Inhalte des Originaltexts hinzu oder entferne sie.
- Platzhalterbilder übrig gelassen: Wenn die Signatur/CTA-Komponente Platzhalter für Visitenkartenbilder enthält (z. B.
<img src="...URL für Visitenkarte oder Leitbild">), und keine echte Bild-URL vorhanden ist, lösche die gesamte Zeile; hinterlasse keine Platzhalter im Ergebnis. - Inhaltsverzeichnis ist eine Auswahl, nicht vollständig: Die Vorwort-/Inhaltsverzeichnis-Komponente zeigt 3 ausgewählte Kernpunkte an, nicht eine vollständige Kapitelliste; wähle bei mehr als 3 Kapiteln die 3 wichtigsten aus, stopfe nicht alle hinein oder erwecke den Eindruck, es gäbe nur 3 Kapitel.
- Keine gestrichelten Rahmen: Verwende für hervorgehobene Überschriften/Betonungen kleine Labels oder den linken vertikalen Balken (generische 3a–3e), nicht
border:…dashed-Rahmen um eine Überschrift. Ausnahme: Wenn die Themenbibliothek explizit eine gestrichelte Komponente definiert hat (z. B. das quote-box-Zitatfeld oder oneliner-card-Highlight-Karte von Moyu-Grün), verwende sie gemäß den Angaben der Themenbibliothek – das ist ein Stilmerkmal des Themas. - Satzzeichen nicht in halber Breite mischen: Wenn im Text Kommas/Punkte in halber Breite oder englische gerade Anführungszeichen
"'vorkommen, ersetze sie durch die volle Breite; aber halbe Breite Symbole innerhalb von Code-Blöcken/Inline-Code unverändert lassen – nicht den Code „vollbreitieren“. Tick-Notiz: Im Deutschen werden für Zitate und Hervorhebungen im Text „geschwungene Anführungszeichen“ (Gänsefüßchen) verwendet, das passt perfekt zur Forderung nach „voller Breite“. - Code/Prompt müssen in Code-Blöcken stehen: Code, Befehle, Prompt-Wörter im Artikel müssen die Code-Block-Komponente der gemeinsamen Bibliothek verwenden (1a/1b); stecke sie nicht in normale Absätze oder Zitatblöcke, sonst gehen Einrückung und Nichtproportionalschrift verloren.
- Code-Blöcke kompakt, keine großen Leerräume: Verwende die Schreibweise der generischen 1a/1b mit „ein
<p style="margin:0">pro Zeile“, verwende auf keinen Fallwhite-space:pre– das würde Einrückungen vor den<span>-Elementen im HTML-Quellcode und Zeilenumbrüche zwischen den Zeilen originalgetreu als große linke Einrückung + leere Zeilen rendern; Einrückungen nur mit Leerzeichen in voller Breite, Zeilenabstand überline-height:1.6. - Nachzufüllendes Material zentrieren: Platzhalter wie
【Einfügen…】, noch aufzunehmende Screenshots / GIFs / Videos / Ergebnisbilder verwenden die generische 2c zentrierte Materialplatzhalter-Komponente (heller Hintergrund, weicher gestrichelter Rahmen + zentriertes Symbol und Beschreibung), nicht einen linksbündigen Hinweisblock.
Benutzerdefiniertes Thema generieren (Zweiter Arbeitsablauf)
Wenn der Benutzer einen neuen Stil jenseits der integrierten Themen wünscht (sagt „Generiere ein neues Thema / Benutzerdefinierten Stil / Erstelle eine Komponentenbibliothek nach diesem Referenzbild“, oder mit keinem vorhandenen Thema zufrieden ist), lies references/theme-generator.md und führe streng nach dessen Ablauf aus:
- Präferenzen sammeln: Themenbeschreibung ist Pflicht (oder Referenzbild); Name/ID/Fünf Farben/Schriftarten/Drei TAGs/Abrundungen/Schatten können leer sein und werden automatisch ergänzt; frage alles auf einmal ab, nicht Feld für Feld nachfragen.
- Blockbibliothek HTML generieren: Führe den 【Generator-Prompt】 am Ende von theme-generator.md unverändert aus; erstelle eine vollständige Blockbibliothek mit 45~75 Blöcken und speichere sie unter
assets/theme-previews/{theme-id}.html– alle Blöcke sind auf derselben Seite fortlaufend angeordnet; der Benutzer öffnet sie im Browser, um den Stil auf einer Seite auf einmal zu überprüfen und zu bestätigen, nicht Block für Block. - Konvertieren + Registrieren: Nach Bestätigung des Stils durch den Benutzer konvertiere in das Standardformat
references/theme-{Kennung}.md(muss<span leaf="">-Umbüllung ergänzen, Vorschau-IDs entfernen, fünf Kapitel vervollständigen, Regeln siehe theme-generator.md Schritt 3), trage es in theme-index.md ein, führecomponent_lint.pybis auf 0 ERROR aus. - Nach der Auslieferung wird dieses Thema zu einem ständig verfügbaren Thema, das bei späteren Layouts die gleichen Rechte hat wie die integrierten Themen.
Während der Generierungsphase gelten die Regeln des Prompts; während der Konvertierungsphase in die Themenbibliothek gelten die Regeln dieser Datei („Plattform-Rotlinien“ und „Spezifikationen für das Hinzufügen neuer Themen“); bei Konflikten haben die letzteren Vorrang, da die Themenbibliothek direkt das Layout-Ergebnis bestimmt.
Spezifikationen für das Hinzufügen neuer Themen
Neue Themen werden nach dem Schema references/theme-{Englische Kennung}.md benannt. Der Inhalt muss folgende Abschnitte enthalten:
- Designvariablen-Spickzettel (Hauptfarbe/heller Hintergrund/dunkle Schrift/Titelfarbe/Textfarbe/Trennlinienfarbe usw.)
- Vollständiges HTML jeder Komponente (Inline-Styles +
<span leaf="">-Umbüllung, Einhaltung der obigen „Plattform-Rotlinien“) - Vollständiges Artikelvorlagengerüst (Reihenfolge der Komponentenmontage; falls es eine Inhaltsverzeichnis-/Navigationskomponente gibt, kläre ihre Position relativ zum Cover/Einleitung)
- Tabelle „Artikeltyp → Komponentenkombinationsrezeptur“ (Kernkomponentenkombination + dekorative Komponenten für jeden Artikeltyp – die Rezeptur ist der Schlüssel zur Konsistenz des Layout-Stils)
- Tabelle „Markdown → Komponenten-Mapping-Regeln“
Nach dem Hinzufügen einen Eintrag in references/theme-index.md machen (Themenname / Hauptfarbe / Anwendbare Szenarien / Komponentenbibliotheksdatei / Textunterstreichungs-CSS) und python3 scripts/component_lint.py . ausführen, um sicherzustellen, dass die Komponentenbibliothek keine Anti-Patterns enthält (0 ERROR).
Regressions-Testfälle für Auslöser und Themenauswahl siehe
references/eval-cases.md(wird bei Wartung zur Regressionsprüfung verwendet, hat keinen Einfluss auf die einmalige Generierung).
