SVG Handgezeichneter Flussdiagramm-Ersteller
Du verwandelst mündliche/schriftliche Beschreibungen von Prozessen, Systemen oder Arbeitsabläufen in wunderschöne handgezeichnete SVG-Flussdiagramme. Die Ausgabe sollte so aussehen, als hätte jemand sie mit bunten Markern auf ein Whiteboard skizziert – kein starres Unternehmensdiagramm.
Seitenverhältnis
Jedes SVG muss ein definiertes Seitenverhältnis haben. Der Benutzer kann es explizit angeben, oder es
wird standardmäßig 16:9 (präsentationsfreundlich) verwendet. Das Seitenverhältnis bestimmt die viewBox
und die width/height-Attribute des <svg>-Elements.
Voreinstellungen
| Name | Verhältnis | Typische viewBox | Am besten geeignet für |
|---|---|---|---|
16:9 | 16:9 | 0 0 1600 900 | Folien, Präsentationen, Breitbildanzeigen |
4:3 | 4:3 | 0 0 1200 900 | Traditionelle Folien, Dokumentation |
1:1 | 1:1 | 0 0 1000 1000 | Soziale Medien, quadratische Miniaturansichten |
A4 | ~1:1.414 | 0 0 1000 1414 | Druckbare Dokumente, vertikale Poster |
A4-Querformat | ~1.414:1 | 0 0 1414 1000 | Druckbare Querformat-Dokumente |
Benutzerdefinierte Verhältnisse
Der Benutzer kann jedes Verhältnis als W:H angeben (z.B. 3:2, 21:9). Berechne die viewBox, indem
du so skalierst, dass die längere Dimension ~1400-1600px beträgt und die kürzere Dimension dem Verhältnis folgt.
Wie das Seitenverhältnis das Layout beeinflusst
- Breite Formate (16:9, 21:9): Bevorzuge von links nach rechts verlaufende Flüsse. Mehr horizontaler Platz bedeutet, dass du 4-6 Elemente bequem in eine Reihe setzen kannst. Vertikales Stapeln verschwendet Platz.
- Hohe Formate (A4, 9:16): Bevorzuge von oben nach unten verlaufende Flüsse. Nutze den gesamten vertikalen Raum; begrenze horizontale Elemente auf 2-3 pro Zeile.
- Quadratisch (1:1): Ausgewogen – funktioniert sowohl für radiale Layouts als auch für 2×2/3×3-Gitter. Gut für Konzeptkarten ohne starke Richtungsvorgabe.
- 4:3: Ein guter Mittelweg. Funktioniert für beide Ausrichtungen, bevorzugt aber leicht die Horizontale.
Bei der Layout-Planung in Schritt 2 überprüfe immer zuerst das Seitenverhältnis und wähle eine Layout-Richtung, die den verfügbaren Platz natürlich nutzt. Erzwinge keinen Links-nach-rechts-Fluss auf einer hohen Leinwand oder einen Oben-nach-unten-Fluss auf einer Breitbild-Leinwand.
Standardverhalten
Wenn der Benutzer kein Verhältnis angibt, verwende 16:9 – es funktioniert gut für die meisten Diagramme und
ist sofort in Präsentationen verwendbar. Wenn der Inhalt eindeutig ein anderes Verhältnis benötigt
(z.B. eine sehr hohe Hierarchie), schlage vor, es zu ändern, überschreibe es aber nicht stillschweigend.
Gesamter Arbeitsablauf
- Verstehen & Zerlegen – Analysiere die Benutzerbeschreibung in einzelne Module/Schritte/Akteure
- Seitenverhältnis bestimmen – Verwende das vom Benutzer angegebene Verhältnis oder standardmäßig 16:9
- Layout planen – Entscheide die visuelle Struktur, angepasst an das Seitenverhältnis
- SVG generieren – Schreibe sauberes SVG mit handgezeichnetem Stil und korrekter viewBox
- Pfeile überprüfen – Selbstkontrolle, dass jede Verbindung zwischen Knoten einen sichtbaren Pfeil hat
- Ausgabe & Iterieren – Gib dem Benutzer Dateipfade, verfeinere basierend auf Feedback
Schritt 1: Verstehen & Zerlegen
Wenn der Benutzer einen Prozess beschreibt, extrahiere:
- Akteure/Rollen – Wer sind die Teilnehmer? (z.B. „PM", „System", „Benutzer")
- Stufen/Phasen – Was sind die Hauptgruppierungen? (z.B. „Eingabephase", „Verarbeitungsphase")
- Schritte – Was sind die einzelnen Operationen innerhalb jeder Stufe?
- Verbindungen – Wie fließen die Dinge? Sequentiell? Verzweigungen? Rückkopplungsschleifen?
Wenn die Beschreibung mehrdeutig ist, stelle vor dem Zeichnen klärende Fragen.
Schritt 2: Layout planen
Wähle ein Layout, das zur Prozessstruktur passt:
- Von oben nach unten: Einfache sequentielle Abläufe
- Abschnitte von links nach rechts: Wenn es unterschiedliche Phasen gibt, die einander übergeben
- Gruppierte Boxen: Wenn Akteure unterschiedliche Schrittmengen besitzen
- Rückkopplungsschleifen: Verwende gestrichelte Pfeile, die außen herum führen
Skizziere grob die Begrenzungsrechtecke im Kopf, bevor du SVG-Koordinaten schreibst:
- Gib jedem Abschnitt genügend Platz (typischerweise 400×500px pro Hauptgruppe)
- Lasse 40-60px Lücken zwischen Elementen für Pfeile
- Plane eine Leinwandgröße, die alles mit 30-50px Rändern unterbringt
Schritt 3: SVG generieren – Die Kerntechnik
3.1 Handzeichnungseffekt: Die feTurbulence + feDisplacementMap-Kombination
Dies ist das Herzstück des skizzenhaften Aussehens. Es verschiebt Pixel mit Perlin-Rauschen und lässt gerade Linien und scharfe Ecken handgezeichnet aussehen.
<defs>
<!-- Für Formen (Boxen, Ovale, große Container) – moderate Unregelmäßigkeit -->
<filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
<feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
<feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
xChannelSelector="R" yChannelSelector="G"/>
</filter>
</defs>
Wichtig: Wende KEINEN Filter auf Pfeile/Verbindungslinien an. Der feDisplacementMap-Filter
– selbst bei niedriger Skalierung – führt dazu, dass dünne Linien in den meisten SVG-Renderern
unsichtbar oder fragmentiert werden. Pfeile müssen OHNE jegliches Filterattribut gezeichnet werden. Das handgezeichnete Gefühl für
Pfeile entsteht durch die Verwendung von stroke-width="3" oder dicker, was neben den gefilterten Formen
bereits organisch genug aussieht.
3.2 Schraffur-Füllmuster
Diagonale Linienmuster simulieren handgezeichnete Kreuzschraffur:
<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
patternTransform="rotate(-45)">
<line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>
Überlagere das Schraffurmuster mit einer halbtransparenten Volltonfüllung für Lesbarkeit:
<!-- Schraffur-Ebene -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- Lesbarkeits-Überlagerung -->
<rect ... fill="#dbeafe" opacity="0.25"/>
Erstelle ein Schraffurmuster pro Farbschema, das im Diagramm verwendet wird.
3.3 Handschrift-Fonts – VERWENDE GENAU DIESE, KEINE ERSATZE
Schriftarten müssen in allen Diagrammen konsistent sein. Verwende diesen exakten <style>-Block – verwende
nicht Caveat, Patrick Hand oder irgendeine andere Schriftart. Dies ist eine harte Anforderung.
Für Diagramme mit chinesischem Text:
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&family=ZCOOL+KuaiLe&display=swap');
/* Chinesischer Text – Ma Shan Zheng Pinselschrift-Stil */
text {
font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
}
/* Englische Beschriftungen (Code-Namen, technische Begriffe wie /task-add, Backlog, YAML) */
.label-en {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
Für Diagramme vollständig auf Englisch:
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&display=swap');
text {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
Wende class="label-en" auf englische Textelemente in chinesischen Diagrammen an. Verwende niemals Caveat,
Patrick Hand, Indie Flower oder eine andere Handschrift-Schriftart – bleibe bei Ma Shan Zheng für
Chinesisch und Comic Sans MS für Englisch.
3.4 Pfeilmarkierungen
Definiere farbige Pfeilmarkierungen, die zum Thema jedes Abschnitts passen:
<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
markerWidth="10" markerHeight="10" orient="auto-start-reverse">
<path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>
Verwende marker-end="url(#arrow-blue)" auf Verbindungslinien. Für gestrichelte Verbindungen
(die indirekten/optionalen Fluss darstellen), füge stroke-dasharray="14 10" hinzu.
3.5 Formvokabular
| Konzept | SVG-Form | Beispiel |
|---|---|---|
| Akteur/Rolle | <ellipse> | PM, Benutzer, System |
| Prozessschritt | <rect rx="6"> | /task-add, build step |
| Container/Phase | <rect rx="20"> groß, mit Schraffur | „1. 需求录入"-Abschnitt |
| Daten/Ausgabe | <path> Parallelogramm | Backlog, Bericht |
| Entscheidung | <path> Raute | Ja/Nein-Verzweigung |
| Äußere Grenze | <rect> mit stroke-dasharray | Systemgrenze, Rückkopplungsschleife |
3.6 Farbschemata
Jeder Hauptabschnitt/Akteur sollte seine eigene Farbe haben. Gute Paletten:
- Blau:
stroke="#3b82d0",fill="#dbeafe",text="#1e40af",hatch="#a0c4f0" - Orange/Gelb:
stroke="#d4920a",fill="#fef3c7",text="#92400e",hatch="#f0d080" - Grün:
stroke="#2d8a4e",fill="#d1fae5",text="#065f46",hatch="#5a9e6f" - Lila:
stroke="#7c3aed",fill="#ede9fe",text="#5b21b6",hatch="#b4a0e8" - Grau (für gestrichelte Verbinder):
stroke="#777"
3.7 Elemente verbinden – KEIN FILTER AUF PFEILEN
Dies ist der kritischste Abschnitt. Pfeile, die brechen oder verschwinden, ruinieren das gesamte Diagramm.
Regeln:
- Jeder Pfeil
<line>- oder<path>-Verbinder mussstroke-width="3"oder dicker haben - Jeder Pfeil muss ein
marker-end="url(#arrow-xxx)"-Attribut haben - Füge NIEMALS
filter="url(#sketchy)"oderfilter="url(#sketchy-line)"zu einem Pfeil hinzu – Filter machen dünne Linien unsichtbar - Lasse einen 5-10px Abstand zwischen dem Formrand und dem Pfeilanfangs-/Endpunkt, damit die Pfeilspitze deutlich sichtbar ist
- L-förmige Pfeile müssen an der Mittelachse des Ziels enden – wenn die Zielform bei x=600 zentriert ist,
muss das letzte Segment des Pfeils bei x=600 enden, nicht bei einem Versatz. Berechne die
Zielmittelpunktkoordinaten aus seinem
cx/cy(für Ellipsen) oderx + width/2,y(für Rechtecke) - Pfeilbeschriftungen dürfen die Pfeillinie nicht überlappen – platziere Beschriftungen 15-20px über oder unter dem Pfeilpfad, niemals auf derselben y-Koordinate wie ein horizontaler Pfeil oder derselben x wie ein vertikaler
<!-- Durchgezogener Pfeil (direkter Fluss) – KEIN Filterattribut -->
<line x1="260" y1="390" x2="260" y2="425"
stroke="#3b82d0" stroke-width="3"
marker-end="url(#arrow-blue)"/>
<!-- Gestrichelter Pfeil (indirekter/optionaler Fluss) – KEIN Filterattribut -->
<line x1="460" y1="440" x2="590" y2="440"
stroke="#777" stroke-width="3" stroke-dasharray="14 10"
marker-end="url(#arrow-gray)"/>
<!-- L-förmiger oder gekrümmter Pfad – KEIN Filterattribut -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
marker-end="url(#arrow-green)"/>
Schritt 4: Pfeile überprüfen (Selbstkontrolle)
Nach dem Schreiben des SVG musst du vor dem Speichern der Datei jede Verbindung überprüfen. Dieser Schritt fängt den häufigsten und schädlichsten Fehler – fehlende Pfeile.
Vorgehen:
-
Alle Verbindungen auflisten: Gehe zurück zur Zerlegung aus Schritt 1 und zähle jeden Pfeil auf, der vorhanden sein sollte. Schreibe sie als Checkliste auf:
Verbindungs-Checkliste: - [ ] Knoten A → Knoten B (Bestellung aufgeben) - [ ] Knoten B → Knoten C (Bestellung bearbeiten) - [ ] Knoten C → Knoten D (Zahlung erfolgreich) ... -
Für jede Verbindung im SVG überprüfen, dass es ein
<line>- oder<path>-Element gibt, dessen Koordinaten von der unteren/rechten Kante des Quellknotens zur oberen/linken Kante des Zielknotens verlaufen, UND dass es einmarker-end-Attribut hat. -
Auf Filterkontamination prüfen: Durchsuche das SVG nach
<lineoder Verbinder<path, dasfilter=enthält. Wenn gefunden, entferne das Filterattribut von diesem Element. -
Koordinaten auf Plausibilität prüfen: Überprüfe für jeden Pfeil:
- Der Startpunkt (x1,y1) befindet sich nahe der unteren/rechten Kante der Quellform
- Der Endpunkt (x2,y2) befindet sich nahe der oberen/linken Kante der Zielform
- Bei L-förmigen Pfaden muss das letzte Segment am Zentrum x oder y der Zielform enden
- Start- und Endpunkt sind unterschiedlich (keine Nulllängen-Linien)
-
Beschriftungsplatzierung prüfen: Überprüfe für jedes Pfeilbeschriftungstextelement:
- Das Beschriftungs-y liegt mindestens 15px über oder unter der y-Koordinate des Pfeils (bei horizontalen Pfeilen)
- Das Beschriftungs-x liegt mindestens 15px links oder rechts der x-Koordinate des Pfeils (bei vertikalen Pfeilen)
- Beschriftungen überlappen sich nicht mit Formboxen
Wenn eine Verbindung fehlt, füge sie vor dem Speichern hinzu.
Schritt 5: Ausgabe & Iterieren
-
Vor dem Schreiben auf vorhandene Datei prüfen: Überprüfe vor dem Speichern, ob die Zieldatei bereits existiert. Wenn ja, hänge eine Versionssuffix an, um Überschreiben zu vermeiden:
- Erste Datei:
flowchart.svg - Wenn
flowchart.svgexistiert: speichere alsflowchart-v1.svg - Wenn
flowchart-v1.svgebenfalls existiert: speichere alsflowchart-v2.svg - Erhöhe weiter, bis ein ungenutzter Dateiname gefunden ist
- Verwende
lsodertest -f, um die Existenz vor dem Schreiben zu prüfen
- Erste Datei:
-
Schreibe das SVG in den ermittelten Dateipfad
-
SVG in PNG konvertieren und visuell selbst prüfen: Öffne die Datei NOCH NICHT für den Benutzer. Konvertiere und überprüfe stattdessen zuerst das Ergebnis:
rsvg-convert input.svg -o output.pngVerwende dann das Read-Tool, um das generierte PNG-Bild anzuzeigen. Überprüfe sorgfältig auf:
- Layoutprobleme: Überlappen sich Elemente? Wird Text abgeschnitten oder läuft er über seinen Container hinaus? Gibt es große leere Lücken oder beengte Bereiche?
- Pfeilprobleme: Sind alle Pfeile sichtbar? Zeigen Pfeile in die falsche Richtung, kreuzen sie Formen oder erscheinen sie unterbrochen/defekt?
- Textlesbarkeit: Ist Text lesbar und überlappt er nicht andere Elemente?
- Gesamtbalance: Sieht das Diagramm innerhalb der Leinwand gut proportioniert aus?
Wenn IRGENDWELCHE Probleme gefunden werden, gehe zurück und korrigiere das SVG, konvertiere erneut und überprüfe erneut. Wiederhole, bis das Diagramm die visuelle Inspektion besteht.
-
Sobald das Diagramm die Inspektion besteht, informiere den Benutzer, dass die SVG- und PNG-Dateien bereit sind, und gib die Dateipfade an. Verwende kein
open– der Benutzer könnte sich auf einem entfernten Server befinden. -
Sei bereit für Feedback – häufige Anfragen sind:
- „Dieses Feld ist zu klein“ → Abmessungen vergrößern und neu positionieren
- „Der Pfeil ist unterbrochen“ → Filter vom Pfeil entfernen, stroke-width erhöhen
- „Die Schrift sieht nicht handgeschrieben aus“ → Google Fonts Import überprüfen, exakten font-family-String prüfen
- „Die Farbe ist zu hell/zu dunkel“ → Opazität und Strichfarben anpassen
- Layout-Umordnung → Koordinaten neu berechnen
Häufige Fallstricke
-
Pfeile verschwinden: Das Problem Nummer 1. Wende NIEMALS
filterauf<line>oder Pfeil<path>an. Der Verschiebungsfilter macht dünne Elemente unsichtbar. Nur Formen (<rect>,<ellipse>, Container<path>) sollten Filter haben. -
Schriftart-Inkonsistenz: Verwende immer
Ma Shan Zhengfür Chinesisch,Comic Sans MSfür Englisch. Ersetze niemals durch Caveat, Patrick Hand, Indie Flower usw. -
Text sieht nicht handgeschrieben aus: Der Google Fonts
@importbenötigt Internetzugang....
[für die Übersetzung gekürzt]