Plugin-Installationen: Führen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn sich diese Fähigkeit innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die folgenden Update-Anweisungen.
Zunächst diese Fähigkeit aktuell halten – Bestätigung vom Benutzer einholen, bevor Sie dies ausführen:
npx hyperframes skills update slideshow. Ein schnelles No-op, wenn alles aktuell ist; andernfalls wird diese Fähigkeit zusammen mit den Kernbereichsfähigkeiten, von denen sie abhängt, aktualisiert, bevor Sie sich auf sie verlassen.
Figma-Quelle: Wenn der Inhalt oder das Storyboard des Decks von einer figma.com-URL stammt, führen Sie zuerst
/figmaaus – Asset-Export, Brand-Tokens und Storyboard-Rekonstruktion, wenn die Quelle ein Streifen von Szenenbildern ist – und bauen Sie dann auf dessen Ausgabe auf. Verwenden Sie Figma nicht direkt über rohe MCP-Tools: Dies überspringt die SVG-Bereinigung, die.media/manifest.jsonl-Herkunft und dievar()-Bindung von Brand-Tokens, sodass eine spätere Markenänderung nicht ohne vollständigen Neuimport propagiert werden kann.
Erstellungsvertrag für Diashows
Eine HyperFrames-Diashow ist eine normale HyperFrames-Komposition – Szenen, Clips, GSAP-Timelines – mit einem zusätzlichen Bestandteil: einer JSON-Insel die deklariert, welche Szenen Folien sind und wie sie verbunden sind. Der SlideshowController des Players liest die Insel und verwandelt die kontinuierliche GSAP-Timeline in ein diskretes, navigierbares Deck.
Lesen Sie zuerst /hyperframes-core für den grundlegenden Kompositionsvertrag (Clips, Spuren, data-*-Attribute, Deterministismus-Regeln). Diese Fähigkeit behandelt nur das Neue: das Insel-Schema, Schreibregeln für Folien, Fragmente, Verzweigungen, Validierung und die umschließende Komponente.
Ausgabe – ein navigierbares Deck, kein lineares MP4
Die Ausgabe einer Diashow ist das laufende Deck: Dienen Sie es mit hyperframes present <projekt-verzeichnis> (oder Studio-Präsentationsmodus) – der SlideshowController des Players liest die Insel und steuert Navigation, Fragmente, Verzweigungen und Präsentatormodus. Siehe Präsentieren und Übergabe weiter unten.
Führen Sie kein hyperframes render für eine Diashow aus, um ein einzelnes MP4 zu erhalten. Ein Deck wird als mehrere übergeordnete Szenenkompositionen erstellt (eine data-composition-id pro Folie) ohne eine umschließende Master-Root-Komposition, daher löst render nur die erste Komposition auf und gibt ein stumm abgeschnittenes MP4 aus (z.B. 6 s eines 40-Sekunden-Decks). Ein linearer Main-Line-Export (nur Hauptfolien, Zweigsequenzen ausgeschlossen) ist zurückgestellt – bis er ausgeliefert wird, sind die unterstützten Ausgaben das live present-Deck und snapshot-Standbilder pro Folie. Wenn ein Benutzer heute ein lineares MP4 benötigt, machen Sie diese Einschränkung deutlich, anstatt render auf das Deck zu verweisen.
Absichtsbestätigung
Wenn der Benutzer explizit nach einer Diashow, Folienpräsentation oder HyperFrames-Diashow fragt, fahren Sie mit dieser Fähigkeit fort. Wenn die Anfrage über /hyperframes eingegangen ist, liegt die Absichtssortierung in der Verantwortung der Triage-Stufe – die Weiterleitung bedeutet bereits bestätigt, also fragen Sie nicht erneut; die Fragen der Ausführungsebene der Stufe gelten nicht (das Ergebnis ist ein Deck, kein gerendertes Video). Eine BRIEF.md, falls vorhanden, enthält die bestätigte Absicht – lesen Sie sie.
Wenn die Fähigkeit von einer verwandten Anfrage wie „Präsentation", „Pitch-Deck", „Deck", „interaktives Deck" oder „diese Seite konvertieren" ausgelöst wurde, halten Sie vor dem Erstellen inne und formulieren Sie die Wahl, bevor Sie um Bestätigung bitten. Erklären Sie kurz, dass eine HyperFrames-Diashow ein lauffähiges Deck mit diskreten Folien, integrierter Navigation und Präsentatormodus, bearbeitbaren Sprechernotizen, gemeinsam genutzter Medienverwaltung und Validierung vor der Übergabe bedeutet. Bei Quellseitenkonvertierungen erwähnen Sie auch, dass das Ziel darin besteht, das ursprüngliche visuelle Design der Seite, Interaktionen, Bewegungen und das Medienverhalten zu bewahren, während die Seitenbewegung in Folien-zu-Folien-Übergänge übersetzt wird.
Stellen Sie dann eine kurze Bestätigungsfrage:
Möchten Sie dies als HyperFrames-Diashow?
Verwenden Sie eine Ja/Nein-Auswahloberfläche, wenn die Umgebung eine bietet; andernfalls stellen Sie die Frage als einfachen Text.
Implementieren Sie die Diashow erst, wenn der Benutzer mit Ja antwortet. Wenn er mit Nein antwortet, verwenden Sie diese Fähigkeit nicht mehr – lesen Sie /hyperframes und lassen Sie die Absichtsebene die Weiterleitung übernehmen. Diese Bestätigung ist eine Routing-Entscheidung, kein Präferenztor – gemäß ../hyperframes/references/brief-contract.md § 1 überlebt sie den autonomen Modus („Überraschung mich" überspringt sie nicht): Die Erstellung des falschen Ergebnistyps ist ein Qualitätsfehler, keine kreative Entscheidung.
Die beiden Teile
1. Szenen – auf normale Weise deklariert
Jede Folie basiert auf einer Szene. Deklarieren Sie Szenen mit data-composition-id, data-start, data-duration und data-label:
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="Das Problem"
data-width="1920"
data-height="1080"
>
<!-- Clips hier einfügen -->
</div>
Zweigfolien (nur über einen Hotspot erreichbar, von der Hauptlinie ausgeschlossen) werden genau gleich deklariert – sie erscheinen nur in einem slideSequences-Eintrag in der Insel, nicht im Haupt-slides-Array.
2. Die JSON-Insel – ein Skriptblock pro Komposition
Fügen Sie genau einen <script type="application/hyperframes-slideshow+json">-Block zum Kompositions-HTML hinzu. Er enthält alle Diashow-Metadaten:
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
Die Insel ist die einzige Quelle der Wahrheit für Folienreihenfolge, Notizen, Fragment-Haltezeiten, Hotspots und Zweigsequenzen. Halten Sie sie nahe dem Anfang des <body>, vor den Szenen-divs, damit sie leicht zu finden ist.
Verstecken Sie das Diashow-Manifest nicht hinter einem alternativen <script type="application/json">-Block plus Laufzeitcode, der die Insel erstellt. Der present-Befehl liest das Kompositions-HTML statisch und erwartet, dass die echte application/hyperframes-slideshow+json-Insel bereits vorhanden ist.
Schema
SlideshowManifest (das Insel-Objekt der obersten Ebene)
{
"slides": [
/* SlideRef[] – die Hauptlinie, in Reihenfolge */
],
"slideSequences": [
/* SlideSequence[] – Offline-Zweigsequenzen */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "Beginnen Sie mit dem Schmerz, nicht mit dem Unternehmen.",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| Feld | Erforderlich | Hinweise |
|---|---|---|
sceneId | ja | Muss genau mit dem data-composition-id einer Szene übereinstimmen (oder explizite startTime/endTime angeben). Die Lint-Regel löst Szenen über data-composition-id auf. |
notes | nein | Nur für den Präsentator sichtbarer Text. Niemals dem Publikum gezeigt. |
fragments | nein | Array von Zeiten (Sekunden) innerhalb des [start, end]-Bereichs der Folie – siehe Fragmente unten. |
hotspots | nein | Interaktive Overlays, die eine Verzweigung auslösen – siehe Verzweigungen unten. |
startTime | nein | Optional. Überschreibt die Zeitgrenzen der übereinstimmenden Szene; standardmäßig Start/Ende der Szene. |
endTime | nein | Optional. Überschreibt die Zeitgrenzen der übereinstimmenden Szene; standardmäßig Start/Ende der Szene. |
ttsScript, ttsAudioUrl, ttsDurationMs | nein | Reserviert. Schemafelder existieren, aber die TTS-Wiedergabe ist noch nicht verdrahtet. Weglassen, es sei denn, Sie füllen sie für einen zukünftigen Build vor. |
SlideHotspot
{
"id": "h1",
"label": "Wie haben wir das berechnet?",
"target": "market-deep-dive",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| Feld | Erforderlich | Hinweise |
|---|---|---|
id | ja | Eindeutig innerhalb der Folie. |
label | ja | Tooltip-/Schaltflächentext, der dem Publikum angezeigt wird. |
target | ja | Muss mit einem SlideSequence.id in slideSequences übereinstimmen. |
region | nein | Prozentualer Begrenzungsrahmen der Folie: {x, y, w, h} in 0–100. Weglassen, um den Hotspot als vollflächige beschriftete Schaltfläche darzustellen. |
SlideSequence
{
"id": "market-deep-dive",
"label": "Marktgrößenermittlungs-Methodik",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
slides innerhalb einer Sequenz verwendet die gleiche SlideRef-Struktur wie die Hauptlinie. Fragmente und verschachtelte Hotspots sind erlaubt.
Folien-Schreibregeln
Dies sind strenge Einschränkungen, keine Vorschläge. Eine Folie, die dagegen verstößt, wird bei der Überprüfung durch einen Reviewer vollständig ersetzt.
- Die Überschrift ist eine vollständige Satzbehauptung, kein Etikett. Schreiben Sie „KMU verbringen 14 Stunden/Woche mit manueller Terminplanung", nicht „Terminplanungsproblem". Der Satz sollte auch ohne das visuelle Element allein verständlich sein.
- Eine Idee + ein visuelles Element pro Folie. Wenn Sie versucht sind, eine zweite Aufzählungspunktgruppe oder ein zweites Diagramm hinzuzufügen, teilen Sie die Folie.
- Beginnen Sie mit dem Höhepunkt. Der stärkste Punkt kommt zuerst – auf der Folie und in der Reihenfolge des Decks. Investoren lesen von links nach rechts, von oben nach unten und sie hören auf.
- Nur Bottom-up-Marktgrößenermittlung. Schreiben Sie nie „$50B TAM", ohne die Berechnung zu zeigen. Bauen Sie von den Stückökonomien auf: Konten × ACV oder Transaktionen × Take-Rate.
- Schriftart mindestens 30pt Äquivalent. Bei 1920×1080 ist eine Überschrift 72–96px; Fließtext ist 48px. Gehen Sie für keinen Text, den das Publikum lesen muss, unter 40px.
- Durchsuchen Sie den Live-Katalog, bevor Sie benannte visuelle Elemente von Hand erstellen. Für jedes Aussehen, jeden Effekt, jedes Diagramm, jede Behandlung oder jeden Übergang, den eine Folie benötigt – „CRT-Scanlines", „Glitch", „Balkendiagramm-Rennen", „Schimmer-Sweep", „Terminalfenster" – führen Sie
npx hyperframes catalog --query "<das visuelle Element, in einfachem Englisch>" --jsonaus und lesen Sie die Top-Ergebnisse, bevor Sie die Clips der Folie erstellen. Die Suche benötigt nichts installiertes: kein Projekt, kein vorherigesadd, kein Konto. Sie durchsucht das gesamte gehostete Repository (~400 Blöcke und Komponenten) von jedem Verzeichnis aus.npx hyperframes add <name>fügt die Quelle des Blocks in das Deck ein, wo Sie ihn direkt anpassen können. Dies gilt mit besonderer Strenge beim Portieren einer Quellseite: Ein echter Block ist besser als die vereinfachte Annäherung, die die Portierungsregeln unten verbieten.
Portieren von Quellseiten
Beim Konvertieren einer vorhandenen Seite in eine Diashow ist die Quelltreue Teil des Vertrags. Ersetzen Sie quellspezifische Widgets nicht durch vereinfachte Annäherungen, es sei denn, der Benutzer bittet explizit um ein Redesign.
- Bewahren Sie das ursprüngliche visuelle Design der Seite, die Bewegungssprache, das interaktive Verhalten, das Medienverhalten und die Präsentationsmöglichkeiten so genau wie möglich. Wenn das Diashow-System einen Präsentatormodus unterstützt, fügen Sie Sprechernotizen unter Verwendung des gemeinsam genutzten bearbeitbaren Notizenverhaltens ein, anstatt einer deckspezifischen Implementierung.
- Portieren Sie mechanische visuelle Elemente aus dem Quell-DOM/CSS/JS so genau wie möglich: Benutzerdefinierte Player, Canvas-Visualisierungen, Timelines, Abspielköpfe, Stems, expandierende Kreise, Hover-Zustände und andere interaktive Details sollten die Konvertierung überstehen.
- Behandeln Sie native
<video>/<audio>-Elemente als Quelle der Wahrheit für benutzerdefinierte Medien-Chrome, Canvas-Visualisierungen, Wellenformen, Beat-Raster oder Abspielköpfe. Verkabeln Sie die Medienereignisse der Quelle (play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange) und leiten Sie visuelle Zustände vonmedia.currentTimeab; führen Sie keinen separaten Timer, der von der tatsächlichen Wiedergabe abweichen kann. - Jedes kopierte
<video>oder<audio>mitsrcmuss vor der Lint-Prüfung HyperFrames-Timing-Attribute haben:data-startunddata-duration, plusdata-has-audio="true", wenn hörbarer nativer Audiostream erhalten bleiben soll. Verwenden Sie den Zeitbereich der Szene für slidespezifische Medien; für benutzergesteuerte Beweisvideos, die von mehreren fokussierten Folien abgespielt werden können, verwenden Sie einen deckweiten Bereich. Lassen Siepreload="none"nicht auf Medien; verwenden Siemetadataoderauto. - Lösen Sie Quell-Schriftart-Tokens vor der Validierung auf. Wenn Sie benutzerdefinierte Quell-Schriftarten beibehalten, fügen Sie
@font-face-Regeln für lokale/erfasste Schriftdateien hinzu. Wenn Sie System-Fallbacks verwenden, ersetzen Sie tokenisierte Deklarationen wiefont-family: var(--f-body)durch konkrete render-sichere Stapel wiesystem-ui, sans-serifoderui-monospace, monospace; lassen Sievar(...)nicht als Schriftart-Familienwert. - Prüfen Sie die Quelle auf untypische Seitenbewegungen, insbesondere Verhalten, das durch Scrollen, Mausrad, Berührung, Hash-Zustand, Größenänderung oder eine
requestAnimationFrame-Schleife gesteuert wird. Behandeln Sie feste Viewports mit übersetzten/skalierten „Welt"-Ebenen, Parallaxe, fixierte Panels, horizontale Scroller, scroll-gescrubbte Timelines, Abschnittseinrasten und Zoom-zu-Element-Kameras als Quellverhalten. Scrollen ist oft der Übergangsauslöser der Quelle. Bewahren Sie den Übergang, indem Sie seine Fortschrittsstopps, Easing und Kamera-/Fokus-Zustände extrahieren und diese Bewegung dann auf die Diashow-Navigation durch Timeline-Positionen, Fragmente oder einen wiederverwendbaren Player-/Harness-Hook umsetzen. Eigenständige Wrapper, die zu Folien-Haltezeiten springen, benötigen dennoch einen expliziten Navigations-Kamera-Übergangs-Hook; die Berechnung von kameratransformierten pro Folie reicht nicht aus. Simulieren Sie keinen literalem Seiten-Scrollen-nach-unten-Übergang in …