Was macht Sci-Glow Video Skill (发光线描科普视频全流程制片)?
Übersicht
Wandelt ein hartes wissenschaftliches Thema von einem „Ein-Satz-Konzept“ stabil in einen kompletten Satz auslieferungsfähiger 60-Sekunden-(oder benutzerdefinierten) Leuchtlinien-Wissenschaftsanimationen um: reines Text-Sprachskript, Literatur-Checkliste, präzise getimte Untertitel, 60fps-Bewegungsunschärfe-Master-MP4, horizontales und vertikales 4K-Sicherheitszonen-Cover sowie plattformspezifische Betriebstexte.
Kernphilosophie: Hartqualitäts-Tor mit automatischer Nacharbeit (quantitative Helligkeit + Null-BOM-Prüfung + unabhängiger, schreibgeschützter Blind-Review durch Sub-Agent ≥ 8,5 Punkte) – rendert NIEMALS ein Master-Video, wenn P0/P1-Fehler oder Überbelichtung/graue Bildschirme bestehen.
Abhängigkeiten
Dieses Skill orchestriert und erweitert die folgenden Fähigkeiten auf oberer Ebene, ohne deren zugrunde liegende Engines neu zu implementieren:
Lead-知识讲解动画(lead-knowledge-animation): Stellt deterministische Canvas/DOM-Laufzeit (motion.js,kit.js) und grundlegende Skripte (new_film.mjs,beats.py,timeline.py,fonts.py,sfx.py,mix.py,render.mjs,cover.mjs,verify.mjs,qa_video.py,review_pack.py) bereit. VonAzenYes/leaderai-media-toolkit.Lead-自媒体口播文案(lead-media-script): Stellt Syntax für kalte Einstiege (Hooks), alltägliche Analogie-Strukturen und plattformspezifische Veröffentlichungsdokumentvorlagen für Bilibili, TikTok, Video-Konto, Xiaohongshu und YouTube bereit. VonAzenYes/leaderai-media-toolkit.uv(uv run): Führt das begleitende, reine Standardbibliothek-CLI-Skriptscripts/sci_glow_cli.pyaus.- Optionale wissenschaftliche Recherche-Skills (bevorzugt, wenn im Host installiert):
pubmed-databaseoderliterature-search-openalex, zur Überprüfung von Autoritäten und echten Werten; wenn nicht installiert, verwendet es Internetsuche zur Verifizierung der Primärliteratur.
Schnellstart
# 1. Umgebungs- und IBM Plex Sans SC 8-Schriftstärken-Selbsttest (fehlende Schriftarten werden automatisch mit Ratenbegrenzung geladen)
uv run <skill_dir>/scripts/sci_glow_cli.py preflight --auto-fix-fonts --output work/preflight.json
# 2. Spektrale Höhepunktberechnung von jeder Benutzer-MP3, Ausgabe der Top-3-Cut-Startpunkte und Side-Chain-Parameter
uv run <skill_dir>/scripts/sci_glow_cli.py analyze-bgm --bgm "<BGM.mp3>" --target-duration 60 --top-k 3 --output work/bgm_analysis.json
# 3. Projektverzeichnisse initialisieren und sichere Standardparameter schreiben (inkl. 3:4 1080x1440 und bloom 0.26)
uv run <skill_dir>/scripts/sci_glow_cli.py scaffold-project --workspace "<Projektstammverzeichnis>" --date 20261118 --topic Optogenetik --ratio 3x4 --output work/scaffold.json
Hilfsskripte
Alle Hilfsberechnungen werden über scripts/sci_glow_cli.py bereitgestellt, mit einheitlicher --output-Ausgabe als UTF-8 ohne BOM JSON. Keine rohen Logausgaben an das Terminal:
| Unterbefehl | Kernfunktion | Wichtige erforderliche Parameter |
|---|---|---|
preflight | Prüft Node 18+, FFmpeg, Chrome, Playwright (Tipp für npmmirror + überspringt erneutes Browser-Download), die beiden Upstream-Skills und IBM Plex 8 Schriftstärken; fügt mit --auto-fix-fonts automatisch fehlende .otf-Dateien hinzu | --output |
scaffold-project | Erzeugt 口播文案输出/<Datum Thema-Erklärung>/ und .code/<Datum Thema-Erklärung-Animation>/, führt new_film.mjs aus und patcht es für 3:4-Größe und bloom: 0.26 | --workspace, --date, --topic, --ratio, --output |
analyze-bgm | Dekodiert 8kHz-Mono-Waveform mit FFmpeg, extrahiert Full-Range RMS + <180Hz-Low-Freq-Hüllkurve, sucht Drop 1 (Titelkarte) → Breakdown → Finaler Höhepunkt-Drop, gibt Top-K --music-start und --music-dips aus | --bgm, --target-duration, --top-k, --output |
validate-lines | Prüft/entfernt UTF-8 BOM, überprüft Zeichenanzahl bei 1080px Breite (Hook <=12 Zeichen, Untertitel <=15 Zeichen), ausgeglichene Klammern, keine Satzendzeichen, Hook-Limit von 5s, sperrt automatisch die Gesamtdauer tail | --lines, --target-duration, --ratio, --output (optional --fix-bom, --apply-tail) |
audit-qa | Ruft qa_video.py auf und führt basierend auf Goldenen Fingerabdrücken (mean 17-20, p99 >= 130, bright <= 3.5%, Null-Totzonen, Null-Flimmer-Frames) eine Ampelbewertung und Parameterempfehlung durch, generiert unabhängige Blind-Review-Prompts | --video, --film-dir, --round, --output |
Workflow
Bei parallelen Mehrfach-Fragen oder Zweimodell-Arbeitsteilung gleichzeitig multi-agent-batch-playbook.md laden; Bild- und Layoutparameter strikt nach visual-and-layout-guardrails.md.
Schritt 0: Umgebungs-Check vor Arbeitsbeginn und Musikbestätigung
- Führe
preflight --auto-fix-fonts --output ...aus; falls Playwright fehlt, leite den Benutzer an:$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="1"; npm i playwright --registry https://registry.npmmirror.com. - Musik-Tor: Wenn der Benutzer ein Lied angibt, verwende nur das des Benutzers; wenn kein Lied angegeben ist und keine begleitende Musik lokal vorhanden ist, frage den Benutzer aktiv nach dem Pfad der Musikdatei oder schlage vor, nur Soundeffekte zu verwenden (niemals eigenmächtig überspringen).
Schritt 1: Skripterstellung mit null Barriere und Primärliteratur-Check (unter Wiederverwendung von Lead-自媒体口播文案)
- Die ersten 3 Sekunden MÜSSEN mit spezifischen Zahlen oder kontraintuitiven Fakten fesseln, dann zuerst alltägliche konkrete Analogien geben, bevor wissenschaftliche Begriffe eingeführt werden.
- Überprüfe mindestens 2–3 Primärquellen aus Fachzeitschriften (
Nature/Science/NEJM/Cell). Keine erfundenen Daten erlaubt. - Erstelle im Verzeichnis
口播文案输出/<YYYYMMDD Thema-Erklärung>/das reine Textskript.txtund den Ausführungsplan.md.
Schritt 2: BGM-Spektrum-Höhepunktsynchronisation und präzise Untertitel-Zeitbindung
- Führe
analyze-bgm --bgm <pfad> --target-duration <T> --top-k 3 --output work/bgm.jsonaus, wähle den bestenmusic_start_secund verwendebeats.pyvon oben zur Ausgabe vonwork/beats.json. - Erstelle
work/lines.json: Setze die Titel-KarteT.atauf Drop 1, den Wendepunkt-Konfliktatauf Breakdown, den Durchbruchsmomentatauf Den letzten Höhepunkt-Drop und lasse am Ende Raum für ein abklingendes Bild als Abschluss. - Führe
validate-lines --lines work/lines.json --target-duration <T> --ratio <ratio> --fix-bom --apply-tail --output work/lines_check.jsonaus; erst wenn alles grün ist, führetimeline.py --beats work/beats.json --music-start <start> --film film/von oben aus.
Schritt 3: Visuelles Systemdesign und deterministische Code-Implementierung (unter Wiederverwendung von Lead-知识讲解动画)
[!IMPORTANT] Codierungs- und visuelle Parameter MÜSSEN visual-and-layout-guardrails.md befolgen:
bloom: 0.20–0.28,K.fog: 0.024–0.028,K.hud.cornerdeaktiviert,scenes.jsin IIFE verpackt, Übergangstitel mitmode: 'rise', blur: 0und+0.36sVerzögerung.
- Führe zuerst
scaffold-projectaus, um die Doppelverzeichnisse zu erstellen. - Entwerfe eine nicht-kollidierende Hauptfarbpalette, schreibe 3–5 Schichten feiner Leucht-Primitive für die wissenschaftliche Metapher dieses Films in
film/core.js(wiederhole keine generischen Box-Karten/Strichmännchen). - Schreibe
film/scenes.js,film/index.htmlundfilm/cover.html, führe die Subset-Bildung mitfonts.py film/und die vollständige Null-Fehler-Prüfung mitverify.mjs film/index.html --tol 24von oben durch.
Schritt 4: Side-Chain-Mixing und doppeltes 4K-Cover mit Sicherheitszonen-Prüfung
- Schreibe
work/cues.jsonals UTF-8 ohne BOM, führesfx.py --variants 3undmix.pyaus (fülle die vonanalyze-bgmgelieferten--music-startund--music-dipsein, richte auf-14.0 LUFS / -1.5 dBFSaus). - Führe
cover.mjs film/cover.html --out out --name <Thema> --guidesaus, überprüfe die Bilder inwork/封面检查/visuell, stelle sicher, dass horizontale Schlüsselinformationen streng im zentralen4:3-Bereich (x ∈ [240, 1680]) liegen.
Schritt 5: 30fps-Entwurf mit quantitativer Prüfung + unabhängiger, schreibgeschützter Blind-Review-Kreislauf
Siehe blind-review-protocol.md.
- Zuerst halb aufgelösten Entwurf rendern:
render.mjs film/index.html --fps 30 --scale 0.5 --out out/draft_r1.mp4(einzelne Datei:--workers 8, mehrere parallele Dateien: strikt--workers 4). - Führe
audit-qa --video out/draft_r1.mp4 --film-dir film --round 1 --output work/qa_r1.jsonaus. Wenn Helligkeit oder Totzonen nicht bestanden werden, zuerst Parameter gemäß Rezept ändern und Entwurf erneut rendern. - Führe
review_pack.py out/draft_r1.mp4 --film film/ --out out/review_r1aus, erzeuge einen schreibgeschütztenresearch-Blind-Review-Sub-Agenten (kann nurout/review_r1/lesen, Quellcode strengstens verboten), der eine 9-dimensionale Bewertung durchführt. - Bei irgendeinem P0/P1 oder Durchschnittspunktzahl
< 8.5ist es strengstens verboten, ein 60fps-Master zu rendern. Ändere jeden Punkt, prüfe erneut und wiederhole die Überprüfung, bis alles grün ist.
Schritt 6: 60fps-Bewegungsunschärfe-Master direkt rendern und vollständige Lieferung
- Nachdem der Blind-Review vollständig grün ist, rendere nur einmal die endgültige Version:
render.mjs film/index.html --fps 60 --blur 2 --audio work/mix.wav --out out/<Thema>.mp4. - Führe erneut
audit-qaundqa_video.py --sheet --ref-sheetaus, überprüfe visuell die endgültige Kontaktliste und lösche temporäreout/draft*.mp4-Entwürfe. - Vervollständige
work/文案与封面.mdgemäßLead-自媒体口播文案undcopy_template.md, liefere dem Benutzer den gesamten Satz an Dateien und eine Liste der Momente für Audio-Neuaufnahmen, die menschliches Hören erfordern.
Ratenbegrenzung
analyze-bgm,validate-lines,scaffold-project,audit-qalaufen alle lokal ohne externe Netzwerkanfragen.preflight --auto-fix-fontslädt fehlende.otf-Schriftarten von einem CDN mit einem integrierten, prozessübergreifenden OS-Dateisperrmechanismus +time.monotonic()-Ratenbegrenzer (1.0 req/s). Bei 5xx-Fehlern werden 3 exponentielle Backoff-Wiederholungen durchgeführt, bei HTTP 429 wirdRateLimitErrorausgelöst und die Anfrage abgebrochen.
Häufige Fehler
- PowerShell UTF-8 BOM führt zum Absturz von
mix.py: PowerShell 5.1 schreibt standardmäßig mitSet-Content -Encoding UTF8einenEF BB BF-Dateiheader. Alle.json-Dateien MÜSSEN mitencoding='utf-8'in Python, mit demcli-Tool oder mit[IO.File]::WriteAllText(ohne BOM) geschrieben werden. - Verwendung der Standardwerte
bloom: 0.9undmode: 'center'führt zu Unschärfe: Ein großer Leuchtlinien-Hauptkörper mit0.9Glühen sprengt garantiertbright > 3.5%, undcenter-Titel mit festen 14px Unschärfe zerstören den Lichtereignis-Übergang. MUSS auf0.20–0.28heruntergesetzt und aufrise(blur: 0) gemäß visual-and-layout-guardrails.md geändert werden. - Chromium Workers-Überlastung und „sich selbst prüfen“ bei parallelen Dateien: Bei 3–4 parallelen Dateien muss die Rate mit
--workers 4begrenzt werden; gleichzeitig darf NIEMALS derselbe Kontext, der den Code schreibt, die Freigabe selbst erteilen. Die Unterschrift muss über den isolierten schreibgeschützten Blind-Review-Sub-Agenten über das Verzeichnisout/review_rN/erfolgen.