yizhiyanhua-ai/fireworks-open-eli5

Fireworks Open ELI5

Verwandle ein schwieriges System in eine wahrheitsgetreue visuelle Geschichte. Erstelle zuerst eine portable JSON-Spezifikation, dann eine deterministische, eigenständige HTML-Erklärung.

Nicht verhandelbare Grenzen

• Belege kommen vor der visuellen Aufbereitung. Kennzeichne jedes Belegelement mit verified, inferred oder analogy.
• Mache niemals aus einer Analogie eine Implementierungswahrheit.
• Eine generierte lokale HTML-Datei ist nur generated. Sie ist nicht published, hochgeladen, gesendet oder zielseitig verifiziert.
• Veröffentliche, lade hoch, sende oder ändere den Zugriff nicht ohne die ausdrückliche Aufforderung des Benutzers und die eigene Verifizierung des Ziel-Workflows.
• Das Rendering führt keine Netzwerkaufrufe durch. Eine zitierte URL ist ein leserseitiger Link, keine Laufzeitabhängigkeit. Die optionale native Pages-Aktion darf nur den gebündelten Same-Origin-Helfer auf 127.0.0.1 aufrufen; sie darf niemals einen entfernten Dienst kontaktieren.
• Browser-lokaler Verlauf, Favoriten und Annotationen sind deaktiviert, bis der Leser zustimmt. Sie sind Komfortzustände, keine Belege und modifizieren niemals die Quellspezifikation oder das generierte Artefakt.
• Beschreibe den Verlauf präzise als zuvor in diesem Browser geöffnete Same-Origin-Erklärungen. Behaupte niemals, dass es alle generierten Dateien aufzählt.
• PDF-Export ruft den Browser-Druckdialog auf. PNG exportiert eine Szene; PPTX und Pages-kompatibles DOCX exportieren eine Szene pro Folie oder Seite. Die native .pages-Ausgabe ist nur erlaubt, nachdem die installierte Pages-App sie wirklich gespeichert hat; benenne niemals eine DOCX in .pages um. Generierte Downloads sind nur lokale Artefakte.

Arbeitsablauf

1. Identifiziere die Zielgruppe, die Frage, die Sprache und eine Sache, die sich durch die Geschichte bewegen soll: eine Anfrage, ein Paket, eine Entscheidung, ein Ereignis oder eine Benutzeraktion.

2. Wähle genau eine Erzählgrammatik:

   • concept: Intuition → Mechanismus → Grenzen.
   • module: Einstiegspunkt → Transformationen → Ausgaben/Abhängigkeiten.
   • tradeoff: Gemeinsames Ziel → konkurrierende Optionen → Konsequenzen/Entscheidungsregel.
   • incident: Normaler Pfad → Bruch und Ausbreitung → Erkennung/Wiederherstellung.

3. Sammle Belege. Für Repository-Arbeiten überprüfe die tatsächlichen Dateien und verwende lokale Pfade. Für externe Behauptungen verwende, wenn verfügbar, maßgebliche Quellen. Halte Unsicherheiten explizit fest.

4. Erstelle eine JSON-Spezifikation der Version 1 gemäß references/spec-contract.md. Verwende 3–7 Szenen, 2–6 Knoten pro Szene, eine vollständige Wahrheitsleiter, Ablaufverfolgung, Glossar, Rückvermittlung, Belegkarte und die erforderlichen modusspezifischen modeData. Füge Fehlerinformationen zu relevanten Knoten hinzu.

5. Validiere vor dem Rendern:

   node scripts/validate.mjs path/to/spec.json
   

6. Rendere in eine neue lokale Datei:

   node scripts/render.mjs path/to/spec.json path/to/explainer.html
   

   Der Renderer lehnt einen vorhandenen Pfad ab. Nur wenn der Benutzer explizit eine bekannte reguläre Datei ersetzen möchte, hänge --force an. Erzwungenes Rendern verwendet einen atomaren Ersatz und lehnt weiterhin symbolische Links und Nicht-Datei-Pfade ab.

7. Validiere die Spezifikation und das Artefakt zusammen:

   node scripts/validate.mjs path/to/spec.json path/to/explainer.html
   

8. Wenn Browserzugriff verfügbar ist, überprüfe das lokale Artefakt in Desktop-Breite und bei 390px. Bestätige eine h1, lesbare Beschriftungen, keinen horizontalen Überlauf, Tastaturfokus, unabhängige Tablisten, globale und szenenlokale Wiedergabe, Viewport-Nachverfolgung, aktive Synchronisation von realen Kanten und Belegkarten, Ein/Aus/Beenden-Animationen, Fehlerlinse, Antwortaufdeckungen und null Anfragen an entfernte Ressourcen. Jede Szenen-Belegkarte muss ihren Status, eine präzise Kernbasis, den Unterstützungsumfang und eine URL oder eine explizite No-Locator-Grenze offenlegen.

9. Übe den Leserarbeitsbereich: Öffne und schließe die modale Schublade mit Maus und Tastatur; bestätige die Fokusrückkehr; aktiviere die Bibliothek absichtlich; lade neu und überprüfe Favoriten und eine Klartext-Annotation; und bestätige, dass der Verlauf nur Same-Origin-Erklärungen enthält, die tatsächlich geöffnet wurden. Verwende eine markup-förmige Annotation, um zu überprüfen, ob sie inerten Text bleibt.

10. Übe den Export: Bestätige das Druck-Stylesheet, die PNG-Signatur und -Abmessungen, PPTX- und DOCX-ZIP-Signaturen und erforderliche OOXML-Teile sowie den Fallback-Download-Link, wenn automatische Downloads unterdrückt werden. Überprüfe visuell, dass das Szenenbildmaterial eine begrenzte Belegfußzeile mit Status, Kernbasis und Quellenlokalisierung oder -grenze enthält. Wenn natives Pages im Rahmen der Arbeit liegt, führe scripts/serve.mjs aus, überprüfe, ob das .pages-Paket Index/Document.iwa enthält, und öffne es dann erneut in Pages. Korrigiere die Spezifikation oder Vorlage und führe nach jeder Änderung beide Validierer erneut aus.

Berichtssprache

• Schreibe den abschließenden QA-, Status-, Übergabe- und generierten Artefaktbericht standardmäßig in der Sprache der letzten inhaltlichen Anfrage des Benutzers.
• Eine explizite Berichtssprachenanfrage überschreibt diese Standardeinstellung.
• spec.language steuert nur die generierte Erklärungsoberfläche; es erzwingt nicht die Berichtssprache des Gesprächs.
• Ignoriere in gemischtsprachigen Gesprächen kurze Bestätigungen bei der Wahl der Berichtssprache. Behalte Code, Befehle, Pfade, Bezeichner, exakte Fehler und Quellentitel bei, wenn eine Übersetzung die Präzision verringern würde.

Lies references/reporting.md für den vollständigen Sprachauswahl- und Lieferberichtsvertrag.

Geschichtskonstruktionsregeln

• Schreibe den Titel als ein konkretes Versprechen, nicht als Kategoriebezeichnung.
• Halte die Zusammenfassung auf einen Satz und jeden Knoten auf eine Verantwortlichkeit.
• Bevorzuge 3–5 Szenen. Verwende 6–7 nur, wenn das Weglassen einer Stufe die Kausalität verzerren würde.
• Kanten sind Beziehungen oder Aktionen. Verwende kurze Verben in Beschriftungen.
• Die Ablaufverfolgung muss reale Knoten-IDs in einer sinnvollen Reihenfolge besuchen.
• Verwende Fehlerdaten nur, wenn Auswirkung, sichtbares Symptom und Fallback bekannt sind.
• Halte die einfache Ebene genau genug, um die technische Ebene zu überstehen.
• Setze Einschränkungen in truthLadder.caveat, nicht in winzigen Haftungsausschlüssen.
• Verwende Quellen-IDs für die Szenen oder Knoten, die sie unterstützen.
• Zitiere eine Quelle nicht nur, weil sie der Behauptung benachbart ist.

Lies references/story-grammars.md für Modusmuster, references/evidence-rules.md für Behauptungsgrenzen und references/visual-system.md, bevor du die visuelle Sprache des Renderers änderst. Lies references/library-and-export.md, bevor du das Verhalten von Persistenz, Navigation, Wiedergabe oder Export änderst.

Qualitätsgate

Die Arbeit ist nur dann als lokales Artefakt bereit, wenn:

• der Validator ok: true für die Spezifikation und das gerenderte HTML zurückgibt;
• alle IDs und Referenzen aufgelöst sind;
• jeder erforderliche interaktive Abschnitt Inhalt hat;
• der gewählte Erzählmodus seinen eigenen semantischen Vertrag erfüllt;
• das HTML deterministisch ist und das Spezifikations-SHA-256-Meta-Tag trägt;
• das Artefakt Byte-für-Byte mit der gelieferten Spezifikation übereinstimmt und vertrauenswürdige CSP-Hashes verwendet;
• das Artefakt keine externen Ressourcen, unsicheren Laufzeit-APIs oder entfernten Schriftarten enthält;
• der persistierte Leserzustand opt-in, namensbasiert, begrenzt, same-origin und außerhalb des deterministischen Spezifikations-Hashes gehalten wird;
• Annotationen nur als Text gerendert werden und keine ausführbaren Markups erzeugen können;
• globale und lokale Wiedergabe eine Zustandsmaschine teilen und nie gleichzeitig laufen;
• jeder Trace-Schritt den tatsächlichen ausgehenden Beziehungspfad (oder den eingehenden Pfad einer Senke) aktiviert, die Beschriftung und Pfeilausrichtung synchron hält und nur die Belege hervorhebt, die diesen Schritt unterstützen;
• Szenen-Belegkarten die Grenzen verified/inferred/analogy bewahren und den Kerntext sowie einen umsetzbaren Lokalisierer ohne Abruf entfernter Vorschauen anzeigen;
• Szenen-PNG-, PPTX- und DOCX-Pakete die erwarteten Signaturen und Strukturen aufweisen und ihre Belegfußzeile enthalten; ein behaupteter nativer Pages-Export wurde auch in Pages erneut geöffnet;
• mobil der gestapelte Fluss anstelle einer Schrumpfung des Desktop-SVG verwendet wird;
• der abschließende Bericht der aktuellen Interaktionssprache des Benutzers folgt, die generierten Spezifikations- und HTML-Pfade nennt und angibt, ob Desktop-, Mobil-, Persistenz-, Wiedergabe-, Beleg- und Export-Browser-QA durchgeführt wurden.

Wenn die Belege unvollständig sind, generiere nur, wenn die Belegkarte und der Hinweis die Lücke unmissverständlich machen. Andernfalls stoppe und melde die fehlenden Belege.