Reels-RSI — einen Reel inszenieren und daraus lernen
Du bist der Regisseur. Jeder Frame ist eine HyperFrames-HTML-Komposition, die Bild für Bild von Headless Chrome gerendert wird – Code, kein Videomodell. Alle deterministischen Schritte sind reels <Befehl> (im PATH; reels --help). Funktioniert in jedem Agenten, der Dateien lesen, schreiben und Befehle ausführen kann; Sub-Agenten sind optional.
Erster Durchlauf: reels doctor – falls Schriftarten/SFX fehlen, reels setup ausführen.
Jeder Durchlauf: Lese references/quality-bar.md (definiert, wann etwas fertig ist) und führe reels lessons digest aus – das sind Lektionen aus früheren Reels; befolge sie. Sobald das Projekt existiert, grenzt reels lessons digest --project <verz> sie auf Voreinstellung, Seitenverhältnis und Modus dieses Reels ein (die Frame-Pakete enthalten bereits die eingegrenzten Frame-Lektionen).
Nach Genre navigieren
| Der Benutzer möchte… | Lese | Voreinstellung |
|---|---|---|
| 科普/讲解 (eine Idee oder einen Prozess erklären) | script-and-storyboard.md | deepspace Physik/Astronomie/Technik · notebook Alltag/Biologie/Geografie |
| 历史/人物/战役/朝代/文明 | history.md | ink Chinesische Geschichte/Gedichte · atlas Weltgeschichte/Seewege · notebook Strichskizzen-Überblick |
| 题目讲解 / 知识点 / 古诗 / 笔顺 | solve.md | chalk Tafelanschrift · notebook jüngeres Publikum · ink klassische Gedichte |
| 故事短片 / ohne Dialog | techniques.md, styles.md | beliebig; nur music:, kein SCRIPT.md |
| „Mach es im Stil dieses Videos“ | zuerst reels analyze <video>, dann die passende Zeile | — |
| > 3 Min | Kapitel, jedes sein eigenes Projekt → reels concat | — |
| Produktpromo / Musikvideo / ≤ 15 s Bewegtgrafik / Untertitel auf Filmmaterial | der passende HyperFrames-Workflow (npx hyperframes skills); mit reels fonts + reels captions für Chinesisch ausliefern | — |
Schritt 0 — Briefing (eine kurze Runde, zuerst Empfehlungen)
Frage nur, was die Anfrage offen lässt, in einer Nachricht, jeweils mit einer empfohlenen Standardeinstellung:
Thema & Blickwinkel (These in einem Satz) · Dauer (60–90 s; ≈ 4,5–5 Zeichen/s) · Seitenverhältnis (16:9 B站/YouTube · 9:16 抖音/Video-Plattform) · Stil (Voreinstellung oben oder ein benannter Look aus styles.md) · Stimme (zh-CN-YunxiNeural lebhafter männlich · XiaoxiaoNeural warmer weiblich · YunjianNeural tief · en-US-AndrewNeural; ElevenLabs wenn ELEVENLABS_API_KEY) · Sprache (中文 · English · 日本語 · 한국어 — Erzählung, Bildschirmtext und Untertitel alle darin; reels voice erkennt sie aus SCRIPT.md, Standardstimmen in reels_rsi/langs.py) · Untertitel (gleiche Sprache · 中英双语 zweisprachig · keine) · Musik (Benutzertitel in assets/music/, sonst eine Stimmung) · Freigabe (ja: Plan → Look-Dev → Final).
„直接做 / nicht fragen“ ⇒ nimm alle Standardwerte, nenne sie in einer Zeile, keine Hürden.
Ein Foto einer Aufgabe (练习册拍照) → solve.md „Problem aus einem Foto“: transkribiere es und formuliere es beim Plan-Gate neu.
Schritt 1 — Recherche & Fakten
Überprüfe jede Behauptung, Zahl, jedes Datum und jeden Namen (Geschichte: zwei Quellen für strittige Fakten; Aufgaben: berechne die Antwort im Code). Schreibe BRIEF.md (Frontmatter workflow: faceless-explainer, flow: automation, storyboard, message, destination, aspect, language, audience, length, angle, voice, style_preset; Textteil ## Intent, ## Notes mit Quellen/Berechnungen).
Schritt 2 — Projekt
reels new videos/<slug> --preset <Voreinstellung> --title "<Titel>" --desc "<Ein Satz>"
Schreibe dann BRIEF.md und capture/extracted/visible-text.txt (Fakten) hinein; jeder spätere Befehl wird innerhalb des Projekts ausgeführt. Karten: reels geo --project . --layers countries,coastline,rivers. Epochenbilder: reels commons search "…" / reels commons get --project . --name x "File:…". Strichfolge: reels hanzi 字 --project ..
Schritt 3 — Skript & Storyboard
SCRIPT.md (## Zeile N — … (Frame N) + eingerückter gesprochener Text; **EN:** Zeilen für Zweisprachigkeit) und STORYBOARD.md (Frontmatter format, duration, message, arc, audience, mode, music; pro Frame ## Frame N — Titel mit scene, voiceover, duration, transition_in, status: outline, src: compositions/frames/NN-name.html, route, sfx, keyMessage). Details: script-and-storyboard.md.
Gate: Präsentiere These, Frameliste (sehen / hören / Route), Länge, Stil, Stimme, Musik — warten.
Schritt 4 — Stimme, Timing, Musik
reels voice --project . [--voice …] [--rate +5%]
Vertont jede Zeile, schreibt Wortzeiten in audio_meta.json, synchronisiert echte Dauern in das Storyboard und baut den Musikteppich auf den tatsächlichen Schnitten auf. Erneutes Vertonen eines Frames: --only 3.
Schritt 5 — Visuelles Design
Schreibe ## Video direction einmal in STORYBOARD.md (Palettenrollen, benannter Stil, Bewegungsgrammatik, Rhythmus, Negativliste). Pro Frame eine Zeitcodierte Shot-Liste, die auf die gesprochenen Wortzeiten abgestimmt ist: eine Kamerabewegung pro Frame, ein reichhaltiger Held (quality-bar.md). Reel-weite Elemente (Jahresleiste, Kapitelleiste) → ein Overlay (compositions/overlays/<name>.html, history.md).
Schritt 6 — Frames bauen
reels packets --project . # .reels/packets/_role.md + ein Paket pro Frame (inkl. Wortzeiten + Lektionen)
reels fonts --project .
6a Look-Dev: Baue zuerst zwei Helden-Frames (Frame 1 + den visuellsten) und eventuell Overlays; markiere sie als animated; reels finalize .; schau dir snapshots/contact-sheet.jpg an. Gate: „这个画面方向对吗?“
6b Der Rest: Mit Sub-Agenten, einer pro Frame parallel – jeder erhält den Projektpfad, seine Frame-ID und die genehmigten Helden-Frames als Referenz und wird angewiesen: lies .reels/packets/_role.md und dein Paket, schreibe nur deinen Frame, führe reels lint --frame <id> aus, antworte mit einer Zeile. Ohne Sub-Agenten baue sie selbst in der Reihenfolge aus denselben Paketen. Markiere jede status: animated.
Schritt 7 — Finalisierung & Überprüfungsschleife
reels finalize .
Schriftarten → Untertitel → Musik → SFX → Zusammenbau → Overlays → Übergänge → HyperFrames-Prüfung (Lint, Laufzeit, Layout, Kontrast) → Reels-RSI-Regeln (Fehler, die frühere Reels gemacht haben) → SRT → Snapshots. Jeder Durchlauf wird in .reels/ protokolliert. Behebe jeden Fehler und jede Warnung in den Frame-Dateien (niemals im generierten Index). Bewerte jeden Frame nach R1–R6 anhand des Kontaktbogens (reels score . fügt einen visuellen Bewerter hinzu, wenn einer konfiguriert ist); alles < 4 → beheben → erneut finalisieren. ≥ 1 Durchlauf, ≤ 3.
Genauer hinschauen: reels times --project . --frame 04 → reels hf --project . snapshot --at <t>.
Schritt 8 — Rendern & ausliefern
reels render . --quality high
reels cover --project . --composition # falls compositions/cover.html existiert
reels cover --project . --frame 08 # sonst: der aussagekräftigste Frame allein, untertitelfrei
Liefere aus: renders/video.mp4, renders/cover.jpg, renders/subtitles*.srt, CREDITS.md falls vorhanden; Dauer; Frame-IDs für Bearbeitungen; was standardmäßig verwendet wurde.
Schritt 9 — Lernen (immer, dauert eine Minute)
- Zeichne jede Bemerkung des Betrachters während des Durchlaufs wörtlich auf:
reels feedback --project . "Untertitel zu klein" [--frame 04] [--approve]. reels retro .— schlägt Lektionen aus dem Durchlaufslog, den Fehlerbehebungs-Diffs und dem Feedback in den Posteingang vor (ohne konfiguriertes Retro-Modell:reels retro . --evidence-only, lies.reels/retro/evidence.mdund lege selbst ≤ 3 Lektionen an mitreels lessons add "…" --kind doc|rule|taste --scope frame|director|history|solve). Eine gute Lektion ist allgemein („Kartenbeschriftungen bleiben oberhalb von y=900, weil …“), niemals eine Tatsache über dieses Thema.- Zeige den Posteingang an (
reels lessons list --state inbox) und frage, welche behalten werden sollen; akzeptiere nur, was der Betrachter genehmigt (reels lessons accept <id>). Einerule-Lektion wird mit einer funktionierenden Prüfung akzeptiert:reels rules new <id>, schreiberule.py+bad.html+good.html,reels rules test <id>, dannreels lessons accept <id> --rule-dir ~/.reels/rules/<id>. Im Modus „直接做“ lasse die Vorschläge im Posteingang und erwähne, wie viele warten.
Bearbeitungen nach der Auslieferung
Ändere nur, was gefragt wurde: Kopie → SCRIPT.md + reels voice --only N + Frame-Text → finalisieren → rendern. Visuell → das entsprechende HTML → finalisieren → rendern. Unberührte Frames niemals neu bauen. Zeichne die Anfrage mit reels feedback auf – Bearbeitungen sind die besten Lektionen.
Optionale Upgrades (automatisch durch die Umgebung aktiviert)
ELEVENLABS_API_KEY → ElevenLabs-Stimmen [ungetestet] · OPENAI_API_KEY / GEMINI_API_KEY → reels image Illustrationsebenen unter Code-Ebenen [ungetestet] · ein Titel in assets/music/ → der Musikteppich · ein Bewertungsmodell (reels config set roles.judge provider:model) → reels score benotet Frames.
Bekannte Fallstricke (werden von den Befehlen behandelt – nicht rückgängig machen)
Kokoro kann kein Mandarin sprechen → edge-tts · Whisper gibt einen chinesischen Satz als ein Wort zurück → TTS-Wortzeiten · Standard-Untertitel verbinden Wörter mit Leerzeichen → reels captions · der Render-Chrome hat keine CJK-Schriftarten → reels fonts + @font-face in jedem Frame · der Assembler verwirft die Untertitel-Spur-Art → finalize fügt sie wieder hinzu · npm kann eine unveröffentlichte CLI bereitstellen → Projekte binden ihre HyperFrames-Version fest.