hraness/transmute

Klare Diagramme erstellen

Verwende die installierte transmute-CLI als deterministischen Adapter. Behalte die erstellte .diagram.json-Quelle; behandle .light.svg, .dark.svg, .light.png, .dark.png und .tldr als ersetzbare Exporte.

Der Aufforderung wörtlich folgen

Behandle die Aufforderung des Benutzers als vollständige inhaltliche Spezifikation.

• Erhalte die gelieferten Beschriftungen, Werte, Beziehungen, relativen Größen und Auslassungen.
• Füge nur neutrale Mechaniken hinzu, die benötigt werden, um diese Fakten darzustellen.
• Erfinde keinen Titel, Untertitel, Legende, Anmerkung, Beispiel, Implikation, Kategorie, Metrik, Takt, Verbinder oder dekorative Behauptung.
• Erweitere eine kurze Beschriftung nicht zu einem Satz. Bevorzuge die eigene ein- bis dreiwörtige Beschriftung des Benutzers.
• Entferne beim Aktualisieren abgelehnte Inhalte, ohne sie durch eine neue Ausarbeitung zu ersetzen.

Die Quelle finden

1. Lese die lokalen Repository-Anweisungen und suche nach transmute.config.*.
2. Suche nach einer vorhandenen .diagram.json mit demselben Thema, bevor du eine erstellst.
3. Aktualisiere diese Quelle, anstatt generierte Bilder zu bearbeiten oder ein Duplikat zu erstellen.
4. Verwende in einer Wissensdatenbank mit info/ die Pfade info/diagrams/<slug>.diagram.json und kombiniere sie mit info/notes/<slug>.md. In einem Repository, das noch kb/ verwendet, verwende dort die gleichen relativen Pfade. Bette das gerenderte Hell/Dunkel-Bild gemäß der Konvention des Hosts ein oder verlinke es und verlinke Wissen über die Notiz und nicht über eine binäre Leinwand.
5. Verwende außerhalb einer Wissensdatenbank standardmäßig diagrams/<slug>.diagram.json.

Das Visuelle erstellen

Lies visual-communication.md, bevor du ein Diagramm erstellst oder wesentlich umgestaltest.

Wende diese Standardeinstellungen konsequent an:

• Verwende abgerundete Rechtecke für normale Konzepte. Gleiche Rollen erhalten gleiche Größen, Radien, Strichstärken, Symbolgrößen und Beschriftungsbehandlung.
• Lasse mindestens 96px – und vorzugsweise 120–200px – zwischen verbundenen Formen, damit Pfeile als Beziehungen und nicht als Trennlinien gelesen werden.
• Platziere Symbole direkt in ihrer semantischen Form. Platziere keine umrandete Symbolkachel innerhalb einer anderen umrandeten Karte.
• Verwende drei bis sieben primäre Elemente, wenn die Aufforderung Abstraktion zulässt.
• Etabliere eine klare Lesereihenfolge und richte gleiche Elemente an einem gemeinsamen Raster aus.
• Verwende Leerraum vor Rändern, Farben oder Text, um Gruppen zu trennen.
• Verwende Farbe für höchstens eine semantische Unterscheidung. Nimm niemals willkürliche Größen- oder Stiländerungen vor, die einen Unterschied implizieren, den die Aufforderung nicht geliefert hat.
• Halte Symbole unterstützend: Eine Beschriftung muss dennoch die Bedeutung tragen.
• Bevorzuge eine sichtbare Grenze pro Objekt und einen sichtbaren Strich pro Achse oder Verbindung.

„Verbessere“ keine wörtlichen Daten, um diese Präferenzen zu erfüllen. Die Aufforderung hat Vorrang.

Deterministisches Layout für normale Koordinaten verwenden

Verwende ein koordinatenfreies stack-Layout für eine horizontale oder vertikale Sequenz:

{
  "layout": {
    "type": "stack",
    "direction": "horizontal",
    "gap": 160,
    "align": "center"
  }
}

• Die Array-Reihenfolge steuert nur die Platzierung. Zeichne eine Kante nur, wenn die Aufforderung diese Beziehung geliefert hat.
• Verwende für Stack-Formen Rechtecke oder Ellipsen und lasse x und y weg.
• Verwende den Standardabstand von 160px, es sei denn, die Aufforderung oder der Veröffentlichungsrahmen erfordert einen anderen Abstand.
• Wechsle zu positioniertem Modus für Verzweigungen, nicht benachbarte Kanten, Diagramme, freien Text, Linien oder absichtlich ungleiche Platzierung. Erzwinge diese Bedeutungen nicht in einem eindimensionalen Stack.
• Wenn ein Stack nicht passt, vergrößere die Leinwand oder reduziere die erstellten Abmessungen explizit. Verkleinere Formen oder Abstände nicht stillschweigend.

Erstellen und rendern

Verwende die öffentliche Schema-URL oder führe transmute diagram init für einen Starter aus:

transmute diagram check diagrams/<slug>.diagram.json --strict
transmute diagram render diagrams/<slug>.diagram.json

Der Render-Befehl überschreibt die konsistenten Exporte mit gleichem Stamm. Überprüfe sowohl die helle als auch die dunkle Ausgabe, wenn Layout oder Kontrast unsicher sind. Behebe alle nützlichen Lint-Funde; ändere die Quelle und führe das Rendern erneut aus.

Wenn das Repository seine eigene Schriftart oder sein eigenes Symbolpaket verwendet, lies customization.md. Füge MonoLisa oder eine andere lizenzierte Schriftart nicht zum Repository hinzu. Das Standard-Rendering verwendet den systemeigenen serifenlosen Schriftstapel.

Vor gehosteter Bildgenerierung authentifizieren

Verwende den OAuth-Browser-Flow, wenn das gehostete Rendern AUTH_REQUIRED meldet:

transmute auth login
transmute auth status

Der Callback ist fest auf http://127.0.0.1:49671/oauth/callback gesetzt. Token gehören nur in den Betriebssystem-Anmeldeinformationsspeicher über Bun.secrets. Bitte den Benutzer niemals, ein Token einzufügen, eines in eine Datei zu kopieren, eines in der Aufgabenausgabe auszugeben oder die Entdeckung zu umgehen. Auf unterstützten macOS- und Linux-Hosts widerruft transmute auth logout die entfernte Anmeldeinformation, wenn möglich, und entfernt die lokale Anmeldeinformation. Login, Aktualisierung und Logout verwenden prozessbereichsgebundene Koordination; die gemeinsame Nutzung des Lease-Verzeichnisses über Linux-PID-Namespaces hinweg schlägt geschlossen fehl, ohne den Marker eines anderen Bereichs zu löschen. Änderungen an Anmeldeinformationen schlagen auf Windows geschlossen fehl, bis Transmute ein gleichwertiges privates natives Koordinationsprimitiv hat.

Ein gehostetes WebP wörtlich generieren

Wenn der Benutzer explizit nach gehosteter Rastergenerierung fragt, behalte seine Aufforderung bei, anstatt sie anzureichern:

transmute image generate '<wörtliche Aufforderung>' --output pfad/zum/bild.webp

Das Standardmodell ist recraft/recraft-v4.1-utility. Verwende --model openai/gpt-image-1.5 nur, wenn der Benutzer danach fragt oder sein Verhalten für das angeforderte Ergebnis wesentlich ist. Dies sind die einzigen unterstützten IDs.

Das gehostete Generieren ist eine authentifizierte, begrenzte kostenlose Vorschau. Sein UTC-Tag-Kontingent beträgt 10 und sein globales tägliches Sicherheitslimit beträgt 100. Die Zahlung wird noch nicht durchgesetzt. Die Vektorisierung wird separat geregelt und bleibt lokal, kostenlos und authentifizierungsfrei.

• Behalte den erforderlichen Ausgabepfad .webp innerhalb des vom Benutzer angeforderten Arbeitsbereichs.
• Lasse die CLI eine Idempotenz-UUID erstellen. Gib --idempotency-key nur an, wenn ein Aufrufer bereits einen stabilen 16–128 Zeichen langen Schlüssel besitzt. Der Dienst speichert den Schlüssel dauerhaft innerhalb des Suite-Konto-Bereichs.
• Wiederhole niemals einen fehlgeschlagenen Generierungsaufruf: Ein Fehler kann selbst bei dauerhafter, kontospezifischer Idempotenz mehrdeutig sein.
• Dekodiere, schreibe oder vertraue dem Bild nicht selbst. Die CLI begrenzt kanonisches Base64, validiert die RIFF/WebP-Medienmagie und veröffentlicht es atomar.

Referenzgeführte 3D- und Material-Workflows gezielt einsetzen

Lies reference-led-3d.md, wenn der Benutzer darum bittet, ein generiertes oder geliefertes Bild in eine Three.js-Szene, ein Low-Poly-Objekt, eine transparente 3D-Schleife oder ein metallisches Logo-Produkt-Rendering umzuwandeln.

Dies sind vollständige lokale Code-Mode-Host-Funktionen, die derzeit mit Desktop ausgeliefert werden. Der öffentliche Headless-Bun-Runner kann ein Bild generieren und seine vier festen portablen Operationen ausführen, führt jedoch keine HTML-Overlays, Three.js oder den privaten Projekt-Renderer aus. Die Desktop-Shell bietet native Aufnahme, Berechtigungen und Benutzeroberfläche anstelle eines anderen Workflow-Modells. Dies niemals anders darstellen. Im lokalen Code-Mode:

• Phase Bild-zu-Three-Arbeit als Referenzgenerierung, Quellenerstellung, Überprüfung, Vorschau und dann endgültiges Rendern. Sende niemals vom Modell produziertes JavaScript direkt an eine semantische Operation.
• Binde das genaue Referenzartefakt mit createThreeReferenceScaffoldInput an die überprüfte Szene, selbst wenn es nicht sichtbar zusammengesetzt ist.
• Verwende createMetallicLogoImageRequest für die referenzgeführte quadratische Produktbehandlung. Halte die Modellauswahl explizit und überprüfe die Identitätstreue, bevor du das Ergebnis akzeptierst.
• Rendere Vorschauen in voller Länge zuerst bei 1x. Erhöhe die Auflösung oder den Geräte-Maßstab erst nach Auswahl der Quelle und Behandlung.

Ein Rasterbild ohne Bedeutungsänderung vektorisieren

Wenn der Benutzer darum bittet, ein benutzereigenes Rasterbild in SVG zu konvertieren, behalte das Raster als Quelle und behandle das SVG als ersetzbares Derivat:

transmute image vectorize pfad/zum/input.png --output pfad/zum/input.svg --json

• Authentifiziere dich nicht für die Vektorisierung. Die Konvertierung ist lokal und kontaktiert keine Erkennungs-, OAuth-, Generierungs- oder andere Netzwerkendpunkte.
• Zeichne das Motiv nicht neu, beschrifte es nicht neu, beschneide es nicht, färbe es nicht um und vereinfache es nicht über die Ablaufmechaniken hinaus, die der Befehl misst.
• Verwende --duotone '#primary,#secondary' nur, wenn der Benutzer explizit nach dieser Zweifarben-Anpassung fragt.
• Bewahre den ausgegebenen Beleg in der Aufgabenausgabe oder einem benachbarten Herkunftsnachweis auf, wenn die Prüfbarkeit wichtig ist.
• Umgehe keine Eingabe-, dekodierten Pixel-, Dauer-, Pfad-, Byte- oder Wiedergabetreue-Gates.
• Überprüfe das SVG in seiner beabsichtigten Größe. Eine erfolgreiche Ablaufverfolgung ist kein Beweis dafür, dass ein unbekanntes Symbol das beabsichtigte Konzept kommuniziert.

VTracer wird bei der ersten Verwendung von seiner prüfsummengesicherten offiziellen Version heruntergeladen. Verwende TRANSMUTE_VTRACER_PATH nur für eine kompatible lokale 0.6.4-Binärdatei; Transmute zeichnet dennoch seinen Hash auf. Füge niemals ein Upscaling-Modell, eingebettete Raster-Fallback oder kommerzielle Schriftart hinzu, um eine Ablaufverfolgung zu bestehen.

Die begrenzte Vektorisierung wird derzeit unter macOS und Linux unterstützt. Melde unter Windows den absichtlichen tool_platform-Fehler; umgehe ihn nicht mit einer unbegrenzten temporären Ausgabedatei.

Einen verbundenen Tool-Server gezielt einsetzen

Wenn Transmute MCP verbunden ist, behalte die dedizierten Tools check_diagram und render_diagram für einfache Kompatibilitätsaufrufe bei. Verwende search_transmute, um das feste semantische Register zu entdecken, und execute_transmute mit einem genauen zurückgegebenen Code und getyptem JSON. Bearbeite die überprüfte Diagrammquelle weiterhin direkt; kein Tool erstellt oder überschreibt die Quelle.

• Übergib nur root-relative .diagram.json-Pfade.
• Behandle check_diagram als schreibgeschützt.
• Behandle render_diagram als Genehmigung, die fünf dokumentierten generierten Artefakte zu ersetzen, niemals die Quelle.
• Verwende die CLI anstelle von MCP für eine Quelle mit mehr als 64 Formen oder 128 Kanten. MCP gibt höchstens 40 Funde zurück und meldet, wenn diese Liste gekürzt ist.
• Der MCP-Modus verwendet absichtlich integrierte Designs und Symbole und führt niemals die Arbeitsbereichskonfiguration aus. Verwende die CLI außerhalb von MCP, wenn eine vertrauenswürdige lokale Konfiguration erforderlich ist.
• transmute.image.vectorize akzeptiert root-relative Eingabe-/Ausgabepfade, erfordert keine Anmeldung und behält Raster-Bytes lokal.
• transmute.image.generate erfordert einen root-relativen .webp-Ausgabepfad, schreibt das begrenzte Bild atomar und gibt nur redigierte Datei-/Anforderungsmetadaten zurück. Verwende nur die beiden Register-Modell-IDs und wiederhole es nicht.
• Übergib niemals Quellcode, Shell-Text, dynamisch importierten Text, entfernte URLs oder nicht registrierte Operationsnamen an die semantische Ausführung.

Ohne MCP lautet die entsprechende maschinenlesbare CLI-Oberfläche:

transmute code search '<Begriffe>' --limit 4
transmute code execute <exakter-Operationscode> --input '<strenges JSON-Objekt>'

tldraw gezielt einsetzen

Die generierte .tldr-Datei ist ein bearbeitbares Austauschformat und erfordert nicht das tldraw-SDK oder die Desktop-App, um sie zu erstellen. Öffne sie in tldraw Offline, wenn eine Person direkte Canvas-Bearbeitung wünscht:

transmute canvas open diagrams/<slug>.tldr

Wenn die optionale App fehlt, löst transmute canvas install die aktuelle offizielle Version auf, überprüft ihren veröffentlichten SHA-256-Digest und startet den Plattform-Installer. Die App importiert .tldr als nicht gespeichertes Dokument; speichere es dort, um sein neueres natives .tldraw-Bundle zu erstellen. Überschreibe niemals ein natives .tldraw ZIP/SQLite-Bundle direkt.

Überprüfen

1. Führe transmute diagram check <quelle> --strict aus.
2. Führe transmute diagram render <quelle> aus.
3. Bestätige, dass alle fünf Artefakte neben der Quelle oder im angeforderten Ausgabeverzeichnis existieren.
4. Überprüfe die helle und dunkle Ausgabe in tatsächlicher Größe.
5. Bestätige, dass gleiche Formen keine falschen Unterschiede implizieren.
6. Bestätige, dass Verbinder lang sind, in .tldr an die beabsichtigten Formen gebunden sind und keine Beschriftungen kreuzen.
7. Wenn eine Begleitnotiz erforderlich ist, bestätige ihren Pfad und visuellen Verweis.