Eingebettete Untertitel
Ein Katalog, vorne ausgewählt (CATALOG.md — 17 Identitäten; die drei dahinterliegenden Engines sind Backend-Details). Standard (Standard) erstellt eine saubere, wörtliche Schiene (unteres Drittel-Untertitel, der den meisten Text trägt) + einen Einbettungs-Höhepunkt, der in die Szene hinter dem Subjekt am Höhepunkt compositet wird. Cinematic ist reine Einbettung — keine Schiene, jeder Untertitel wird hinter dem Subjekt compositet (Hero-Typografie, Akkumulation, Okklusion als Effekt). Theme ist eine vollständige thematische Verfassung — Körperparadigma × Hero-Setpiece × Front-FX × Plattenreaktion, zusammengesetzt aus Registern (themes/README.md): ordnance terminal neonsign stardust stomp. Die meisten Erklärungen / Voiceovers sind Standard; Einbettung ist der seltene, verdiente Höhepunkt — jedes Wort einzubetten ist der häufige Fehler; Theme ist für VFX-Anfragen ("炸", "特效", "像 AE 做的").
Betriebsablauf (TL;DR)
Der handwerkliche Text unten ist lang; die Pipeline selbst ist kurz — und alles Deterministische wird berechnet oder kompiliert, niemals handschriftlich verfasst:
- Entscheidungstor (schlechte Clips ablehnen) → Wähle EINE Identität aus CATALOG.md (17 Identitäten; Engine/Compiler durch Nachschlagen abgeleitet — niemals eine Modus-/Kategoriefrage stellen)
hyperframes init(überspringen, wenn das Projektverzeichnis bereits mit dem Video existiert —matte.cjs/transcribe.cjsübernehmen jedes Video im Verzeichnis als source.mp4) →bash scripts/prepare.sh <project>(matte ∥ transcribe ∥ audio-envelope parallel, dann safe-zones v2 mit Szenen-Palette/Optik/Beleuchtung — ein Befehl, nichts vergessen)- Ein kleines JSON mit kreativen Entscheidungen erstellen (zuerst
safe-zones.jsonlesen): Cinematic →plan.json→fill-timings.cjs→fit-fonts.cjs→make-composition.cjs; Theme →theme.json→make-theme.cjs(Schiene/Panel/Gedicht/Übernahme-Paradigmen;anchorist die leise Schienen-Standardeinstellung) - Visuelle Qualitätssicherung:
node scripts/preview-frames.cjs <project>→ originalgetreue Composite-Vorschauen in ~2s/Bild (kein Rendern). Vor dem Bezahlen eines Renderings § Visuelle QS prüfen. render-and-composite.sh→ Tore (Timing / Okklusion+Hero / Überlauf / Übergabe) →final.mp4
Tragende Regeln, die Leute übersehen:
- Schiene (Standard) + Einbettung (Promotion).
drop(Füllmaterial, nicht angezeigt) /rail(wörtlicher unterer Drittel-Untertitel, im Vordergrund, trägt den meisten Text) /embed(ein Höhepunktwort, das hinter dem Subjekt compositet wird). Der Standardmodus macht beides, wobei nur die Höhepunkte eingebettet werden. Siehe § Untertitelmodell. - Das Video wird UNBERÜHRT geliefert (Standard/Cinematic; die PLATE-Budget von Theme-Modus ist die einzig zulässige Ausnahme — Register-gesteuerte Reaktionsbeats (Ladungs-Dim, Schlag, Schütteln, Korn), definiert pro Theme-DNA und ANGEWENDET NACH dem Matte-Composite, sodass Subjekt+Text+Platte sich als ein Frame bewegen) — Untertitel sind das Einzige, was hinzugefügt wird; das Matte lässt das Subjekt nur die Einbettungsspur verdecken. Niemals das Filmmaterial gradieren / neu einfärben / mit Scanlinien versehen.
- Zwei Regelwerke: Schiene → references/rail.md (dünn), Einbettungs-Handwerk → references/composition-craft.md (reichhaltig, nur Einbettung). Nach Bedarf überfliegen.
Untertitelmodell — Schiene + Einbettung
Jede gesprochene Phrase ist eine von drei Sachen:
| Was | Wie es angezeigt wird | |
|---|---|---|
| drop | Füllmaterial — äh/hm, Stottern, Selbstkorrekturen | nicht angezeigt |
| rail | der Standard — gewöhnlicher gesprochener Inhalt (wörtlich) | sauberer unterer Drittel-Untertitel, im Vordergrund, lesbar. Ein Punch-Wort kann eine Inline-emphasis-Hervorhebung (Akzentfarbe / aktives Wort-Pop) erhalten — es bleibt auf der Schiene. |
| embed | ein beworbener Höhepunkt — der Schlagzeilen-Beat | ein großes Wort, das hinter dem Subjekt compositet wird (Matte-Okklusion), gestalteter Eintritt + Austritt |
Die Schiene trägt den meisten Text; Einbettung ist der seltene, verdiente Höhepunkt. Knappheit ist pro Beat/Block, nicht pro Clip: ≤1 Hero pro Block (Gedanke), niemals zwei gleichzeitig sichtbar, ≥ eine Pause zwischen Hero-Fenstern (der Compiler warnt unter 0,6s). Ein kurzer Clip → normalerweise 1–2; ein langes Erklärvideo → ~einer pro Abschnitt. Unter mehreren Heroes ist der größte erstellte der APEX (nur er erhält das vollständige Lockup-Embed + Breitenanpassung); kleinere sind MINOR-Peaks, die ihre Spalte als übergroße Hervorhebungszeilen (Vordergrund, gedämpfte Bewegung) reiten — nicht jeder Beat braucht die Matte-Showcase, was genau den Apex zu einem Ereignis macht. Jedes Wort einzubetten ist immer noch der häufige Fehler.
Schienen-Oberflächenidentitäten bauen genau dies auf (Schiene = rail.html, Einbettung = der Höhepunkt in index.html). Spaltenfluss-Identitäten lassen die Schiene weg und machen alles im Embed-Stil — empfehlen Sie sie nur für Stimmungs-über-Wörtlichkeit-Anfragen, niemals für Erklärungen / Voiceover, wo die Worte lesbar sein müssen (CATALOG.md kodiert dies pro Identität).
Schritt 0 — wähle EINE Identität aus dem KATALOG
Ein Frontend, drei Engines dahinter. Der Benutzer wählt eine IDENTITÄT aus CATALOG.md (17 Einträge: 12 klassisch + 5 thematisch); die Engine, der Compiler und die Autorendatei werden durch Nachschlagen aus der Katalogzeile abgeleitet. Stelle niemals "Standard vs Cinematic vs Theme" als Frage — das sind Backend-Namen (ein Produkt hat eine UX auch mit mehreren Engines). Der Katalog kodiert alles, was das Routing benötigt: Leseoberfläche, Stimme, Empfehlung-für, Szenen- Anforderungen, Adjazenznotizen für die wirklich nahen Paare (loud↔ordnance, neon↔neonsign, cream↔stardust).
Vorgehen: Clip untersuchen → 2–3 Identitäten aus dem Katalog in die engere Wahl ziehen → EINE mit einem einzeiligen Warum empfehlen → der Benutzer wählt aus → die Datei dieser Identität erstellen. Identitäten sind Engine-gesperrt (keine Cross-Kombos; das Öffnen einer ist ein Validierungsereignis — siehe dna/README.md).
Präsentiere immer deine Empfehlung und lass den Benutzer wählen, bevor du erstellst. Keine stille Standardannahme.
(Die vollständige Identitätstabelle befindet sich in CATALOG.md — einzige Quelle der Wahrheit für das Routing. Die Engine-Dokumente unten beschreiben den Autorenvertrag jedes Backends.)
Empfehlungsheuristik: Verwende die "Kurzlistungsheuristiken" in CATALOG.md — sie sind auf Identitätsebene (z.B. "炸" listet ordnance/stomp/terminal/loud in die engere Wahl und wählt danach, WAS explodieren soll), niemals auf Kategorieebene. Unsicher → anchor.
- Cinematic → schreibe
plan.jsonfür eine gesperrte Vorlage, kompiliert vonmake-composition.cjs. - Theme → lies themes/README.md, erstelle
theme.json, führescripts/render-theme.shaus (kompiliert + rendert + Plattenreaktion → final_fx.mp4).
Entscheidungstor — ZUERST AUSFÜHREN
Untersuche das Video und klassifiziere die Szene vor beiden Modi.
ffprobe <video.mp4> # Spezifikationen
ffmpeg -ss <t> -i <video.mp4> -vframes 1 sample.png # bei 20/50/80%
Lies die Proben. Ablehnen, wenn:
- Mehrere Sprecher / harte Schnitte (jede Einstellung aufteilen & rendern oder ablehnen)
- Kein menschliches Subjekt (diese Fähigkeit ist für Sprecherkopf)
- Unter 3 Sekunden, keine Sprache, oder das Gesicht nie klar sichtbar —
transcribe.cjswarnt, wenn Audio fast still ist (Whisper halluziniert Wörter wie "Thank you." über Stille; beachte die Warnung und lehne ab, anstatt erfundene Wörter zu untertiteln) - Quelle hat bereits eingebrannte Untertitel / schwere Textgrafiken — das Hinzufügen eines zweiten Untertitelsystems führt zu Konflikten, und das Filmmaterial wird unberührt ausgeliefert (kein Abdecken / Inpainting). Eingebrannter Text erscheint oft nur mitten im Clip: Probiere ein 1fps-Kontaktblatt (
ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png), verlasse dich nicht auf 3 Punktbilder. - Transkript ist Müll — nicht-muttersprachliche/stark akzentuierte Sprache kann in selbstbewussten Unsinn transkribieren. Überfliege
transcript.jsonvor der Erstellung; wenn es sich nicht als Sprache interpretieren lässt, versucheWHISPER_MODEL=mediumeinmal, sonst ablehnen (eine wörtliche Schiene aus erfundenen Wörtern ist schlimmer als keine Untertitel). - Hektische Handkamera mit schneller Bewegung (Matte flackert)
Vorflug-Sonden (kosten nichts, verhindern die schlimmsten Fehler)
- Einstellungs-Schnitt-Sonde. Probenbilder bei 20%, 50%, 80%. Wenn ein anderes Subjekt/Szene erscheint, schneide den Clip vor dem Schnitt zu.
- Letterbox / Pillarbox-Sonde. Schwarze Balken auf dem ersten Bild? Berechne das rechteck des sicheren Inhalts und beschränke die Untertitelplatzierung darauf.
- Luminanz-Sonde. Probiere die durchschnittliche Luminanz der Untertitelregion —
unter 60→ heller Text liest sich wie er ist,60-180→ füge die Glyphen-Scrim hinzu,180+→ deckender Text + Scrim (niemals nackter heller Text). Cinematic-Vorlagen sind creme+screenund GESPERRT — verwende diese Sonde, um eine passende Identität zu wählen (helle Szenen →ink, oder die deckende Schienen-anchor-Theme), niemals um eine neu einzufärben. - Identitätsempfehlung nach Ton (du empfiehlst; der Benutzer wählt — siehe Schritt 0 + CATALOG.md). Erklärungen / Interview / muss-lesbare Wörter → Schienen-/Panel-Oberflächenidentitäten; poetisch / sozial / "cinematic" → Spaltenfluss-Identitäten nach Register; "炸 / 特效 / VFX" / benannte Welten → thematische Identitäten. Bei Unsicherheit →
anchor(Wörter lesbar, Szene sicher) — aber präsentiere eine Kurzliste und lass den Benutzer wählen.
Pipeline — 5 Schritte
1. hyperframes init <project> --non-interactive --video <video.mp4>
2. bash scripts/prepare.sh <project> # matte ∥ transcribe (parallel) → safe-zones. Ein Befehl.
# → frames_fg/ transcript.json safe-zones.json
3. [AGENT-SCHRITT — der einzige kreative Schritt] erstelle ein kleines JSON; siehe unten nach Modus
Cinematic: erstelle plan.json → node scripts/fill-timings.cjs → fit-fonts.cjs → make-composition.cjs
Theme: erstelle theme.json → bash scripts/render-theme.sh <project> (kompiliert + rendert + Platten-FX)
4. node scripts/preview-frames.cjs <project> # ~2s/Bild Composite-Vorschauen → § Visuelle QS (VOR dem Rendern)
5. bash scripts/render-and-composite.sh <project> # Tore → final.mp4 + history/ Schnappschuss
(Theme-Modus: SCHRITTE 3b/5 ÜBERSPRINGEN — render-theme.sh führt bereits Kompilierung + render-and-composite
+ _postfx.sh aus; das Ergebnis ist final_fx.mp4, final.mp4 ist vor der Plattenreaktion)
Schritt 1's init prüft die installierten Skills gegen die neuesten auf GitHub und aktualisiert das globale Set, wenn welche veraltet sind.
Schritt 3 unterscheidet sich je nach Modus:
Schritt 3 — Cinematic-Modus (reine Einbettung)
- Lies zuerst
safe-zones.json. Erzählebenen kommen inzones.hugLeft/hugRight— saubere Streifen, die an die Silhouette GRENZEN (Text weit weg vom Körper liest sich als schwebend, nicht eingebettet; ferne Ecken sind der Notfallplan, nicht die Standardeinstellung). Der Hero standardmäßig aufheroAnchor/heroBands.best(ZENTRIERT auf dem Subjekt, ~30–55% verdeckt).recommendation:"fg"verschiebt ERZÄHLUNG in den Vordergrund für Lesbarkeit; der Hero bleibt eingebettet, wann immerheroBands.feasible— hero-fg ist die letzte Zuflucht. - Die DNA ist die Identität, die du in Schritt 0 gewählt hast (CATALOG.md) — öffne die Wahl hier nicht erneut. Überprüfe sie gegen die Szene (helle Hero-Band-Luma > 150 möchte
ink; die vollständige Auswahlhilfe befindet sich im Katalog und deckt alle zehn einschließlich neon / glitch / chrome / velocity ab). Gib deine Wahl + Grund an; der Benutzer entscheidet. Die DNA sperrt Typ/Palette/Blend/Bewegung + Hero-Dreiakter; safe-zones v2 (palette/optics/lighting) parametrisiert es automatisch FÜR DIESE Szene. - Erstelle
<project>/cinematic.json—"dna": "<name>"+ Gedanken-BLÖCKE, nicht rohe Gruppen: jeder Block = Wortzeilen (gruppiert 2–5 an Klauselgrenzen) + die Ebene, in der er gestapelt wird + pro Zeilecss(nur Größe/Gewicht/Stil — keine Positionen) + höchstens EINE Zeile markiert als"hero": true(das beworbene Wort;"text"für die Anzeigeform). Schema:scripts/make-cinematic.cjs-Kopfzeile. - Kompilieren:
node scripts/make-cinematic.cjs <project>— senkt Blöcke → plan.json → index.html. Für dich generiert: Transkript-sequenzierte Timings, Akkumulation innerhalb des Blocks, Seitenwechsel zwischen Blöcken, der Hero-LOCKUP (der Vorkontext eines Hero-Blocks, HERO und Nachkontext stapeln sich als EINE verbundene Komposition, zentriert auf dem Subjekt — Lesereihenfolge oben→unten = Sprachreihenfolge durch Konstruktion; Kontext schwebt im VORDERGRUND, während der Hero sich im HINTERGRUND einbettet = der Tiefensandwich; eine Massenregel hält den Hero, der seinen Kontext dominiert), Apex/Minor-Hero-Split, Lesereihenfolge durch Konstruktion, fg-Notfallplan pro safe-zones. Dann laufen die Tore wie gewohnt. (Das händische Erstellen von plan.json direkt bleibt möglich für Designs, die Blöcke nicht ausdrücken können — dann führefill-timings.cjs+fit-fonts.cjs+make-composition.cjsselbst aus.)
Schritt 3 — Theme-Modus (thematische Verfassung)
Lies themes/README.md ZUERST — Paradigmen-/Setpiece-Register, Verknüpfungen, harte Regeln und das genaue theme.json-Schema.
- Wähle eine Theme-DNA nach Inhaltsregister (jede
themes/<name>.jsonhatvoice+when). Gib deine Wahl + Grund an; der Benutzer entscheidet. - Erstelle
<project>/theme.json—dna,lines(wörtlich, Transkript-Reihenfolge; 1–5 Wörter pro — fürtakeoverist jede Zeile eine KARTE),minors(Hervorhebungswörter),hero:{match}(das Höhepunkt-Wort/Phrase; lass es AUSlinesfür Embed-Setpieces, behalte es DRIN für Inline-Setpieces und Panel+Redact). - Rendern:
bash scripts/render-theme.sh <project>— kompiliert (Wörtlichkeits-Vollständigkeits-Tor zur Kompilierungszeit), rendert beide Schichten, compositet, wendet die Plattenreaktion an →final_fx.mp4. Verwendepreview-frames.cjszwischen Kompilierung und Rendern für die visuelle Qualitätssicherung.
Visuelle Qualitätssicherung — Vorschau VOR dem Rendern
node scripts/preview-frames.cjs <project> [t…] compositet originalgetreue Vorschaubilder in ~2s pro Bild
(Untertitelebenen zum Suchzeitpunkt screenshottet + echtes Videobild + Matte-Okklusion + Schienen-Overlay = wie
das endgültige Composite in diesem Moment aussehen wird). Standardproben = jedes Gruppen-/Höhepunktfenster.
Ein vollständiges Rendern kostet Minuten — verwende es niemals, um Layoutprobleme zu entdecken.
Überprüfe die Vorschauen (`<project>/preview/sheet.png`) auf ...
[gekürzt zur Übersetzung]