Communitygithub.com

bio-viz-film

Erstelle 3D-Erklärvideos in Filmqualität für Zellbiologie, Virologie und Molekularbiologie: programmatische 3D-Szenen mit Three.js, filmreifem Rendering (Tiefenschärfe, Bloom, Baking-AO) und wissenschaftlich geprüften Schritt-für-Schritt-Abläufen.

Was ist bio-viz-film?

bio-viz-film ist ein KI-Agenten-Skill, der Lehrinhalte aus Zellbiologie, Virologie und Molekularbiologie (z. B. Lehrbuchkapitel, Diagramme aus Forschungsarbeiten, Experimente) in professionelle 3D-Erklärvideos umwandelt. Er nutzt Three.js für programmatische Schnittszenen, filmreifes Rendering mit Tiefenschärfe und Bloom sowie einen strengen Wissenschaftlichkeits-Workflow: Faktencheck mit Quellenangabe → Liste verbotener Darstellungen → zwei unabhängige Prüfrunden (wissenschaftlich + visuell). Die Ausgabe ist wahlweise reine 3D-Animation ohne Text, eine Vorlesungsansicht mit Schritt-Titeln und Lehrbuchzitaten, ein Notiz-Layout oder ein modernes ‚Bench‘-Layout für soziale Medien. Der Skill ist auf Genauigkeit optimiert – ‚professorgeprüft, einmal ansehen und verstehen‘ – und unterstützt mehrere Plattformen wie Claude Code, Cursor und Codex. Der Workflow beginnt mit einer Faktenliste, gefolgt von Szenen- und Story-Entwicklung, zwei unabhängigen Prüfrunden, Rendering (schnell: Three.js; professionell: Blender Cycles) und endgültiger Auslieferung als MP4. Enthaltene Beispiele sind Thylakoid-Membran (Photosynthese), hippocampale Synapse (Neurotransmission) und exokrine Sekretion (Proteintransport).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/moluyao/bio-viz-film/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

bio-viz-film · Biologische 3D-Erklärfilme (v2)

Ziel: Professoren sehen keine Fehler, Studenten verstehen beim ersten Anschauen, visuelle Qualität auf kommerziellem Niveau. Genauigkeit geht vor Ästhetik; keine erfundenen Daten oder Abläufe.

Verzeichnis

template/site2/   ← Aktuelle Engine (v2)
  index.html        Erklär-Layout (eigens entwickelt: dunkel, akademisch, Serifen-Überschriften, rechte Navigationsleiste)
  engine.js         Renderer, Kamera, Zeitlinie, Post-Processing (Tiefenschärfe + Bloom), Erklär-Overlay
  lib.js            Seed-Zufall, instanziiertes Bauen, dynamischer Pool, Baking-AO
  scene-*.js        Programmatische Szene, exportiert build(scene, seed) → { anchors, update(t,T), palette }
  story-*.js        Story-Script: Schritte, Kamerafahrten, Untertitel, Zeitfenster, Legenden, Quellen
  vendor/           Three.js r170 + Addons (Postprocessing / Environments usw.)
template/site/    ← Alte Engine v1 (Dashboard-Stil, Zellen/Viren; bekannte wissenschaftliche Probleme siehe references/pitfalls.md, nicht empfohlen)
template/tools/   record.mjs Frame-für-Frame-Rekorder · sheet2.py Musterseiten-Fotografie · probe.mjs Raytracing-Sonde · hidetest.mjs Einzelobjekt-Ausschluss
references/       accuracy-protocol.md (Pflichtlektüre) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/         secretion: Vollständiges Beispiel aus dem chinesischen Lehrbuch (PEP, Biologie Pflichtmodul 1, 3.2) mit 5 Prüfrunden

Ausgabeformate (Layout wählbar)

?layout=EffektGeeignet für
cleanReine 3D-Szene, ohne Web- oder TextelementeZweitschnitt, Voice-Over, Hintergrund
lecture (Standard)Dunkles akademisches Layout: Schrittnummern + Serifen-Überschrift + Original-Lehrbuchsätze, rechte Navigationsleiste, Legenden, untere QuellenleisteErklärvideos, Veröffentlichung
notesHelles Vorlesungs-Layout: Linke 3D-Ecke mit abgerundetem Bild, rechts alle Schritte auf Papier (aktueller Schritt mit Originaltext), Legenden, Experimentdaten, QuellenUnterricht, Beamer-Präsentation
dashboardTracking-Dashboard: Rechtes Panel zeigt Echtzeit-Zählung markierter Moleküle in verschiedenen Kompartimenten (aus dem Modell, nicht experimentell)Wissenschaftliche Vorträge, ‚Prozess‘-Demonstrationen
benchHelles Labor-Seiten-Layout (im Stil erfolgreicher Dashboard-Seiten): Obere Leiste (Sichtfeld, Schritt, Modelluhr) + Laufband mit echten Fakten + 3D-Fenster mit Rahmen (Label mit Fadenkreuz an 3D-Strukturen, Echtzeit-Maßstab) + Modellzählbalken + Schrittanzeige + drei kleine Karten (typische Wertekurve / Modellzählkurve / Lehrbuchabbildung). Hochformat 1080×1350 optimalTwitter, Xiaohongshu, soziale Medien
BenutzerdefiniertIn layouts/ neue <name>.js Datei, exportiert meta / css / html / mount / update. Aufruf mit ?layout=<name>Themen- oder anforderungsspezifische Anpassung
  • In der Story kann layout: 'notes' als Standard gesetzt werden; mit --size 1080x1920 wird das Layout automatisch auf Hochformat umgestellt.
  • Neue Layout-Regeln:
    • Jede Zahl auf dem Bild muss echt sein (aus Quelle oder Modellstatus);
    • Keine Referenzvideos kopieren; Layout themenspezifisch neu entwerfen;
    • 3D-Hauptobjekt durch meta.camShift Platz für Text freigeben.

Showreel-Modus – für Reichweite und Wow-Effekt

Verwendet denselben wissenschaftlichen Inhalt, nur anders präsentiert. Kann direkt im Prompt oder mit Parametern gesteuert werden:

Du sagstParameterOptionen
„Mach ein Showreel / eine beeindruckende Version / ein vertikales Kurzvideo“?story=<thema>-reel (Story wird auf 0,42x komprimiert, One-Take)—
„Stil hell / Neon / akademisch / Papier“look=vivid bunt, Bonbon · neon dunkel, Neon-Leuchten · academic dunkel, akademisch · paper Papieroptik
„Farbpalette Bonbon / Eisblau / Sonnenuntergang“palette=textbook · candy · ice · sunset · neon
„Ich möchte diesen Scan-Farbwechsel-Übergang“fx=channelsBei jedem Schritt Pixel-Scan-Übergang zum nächsten ‚Pseudofarb-Kanal‘ (wie Fluoreszenzmikroskop-Kanalwechsel)
„Große Überschriften / TikTok-Stil“layout=reelPro Schritt ein großer Hook-Text, plus Pseudofarb-Kanal-Label und kurzer Disclaimer
„Hochformat“--size 1080x1920Kamera zoomt automatisch 1,7x heraus (portraitZoom)

Regeln:

  • Pseudofarben ändern nur die Farbe, nicht Struktur oder Ablauf; permanenter Hinweis „Farben sind Pseudofarben“ auf dem Bild.
  • Showreel-Version durchläuft ebenfalls die wissenschaftliche Prüfung.

Aufzeichnung:

node tools/record.mjs site2 out/x_clean.mp4  --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion&layout=clean"
node tools/record.mjs site2 out/x_lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion"

--draft (1x, 30 fps, ca. 1/8 der Zeit) erstellt eine Vorschau zur Freigabe, dann die endgültige Aufnahme. Der Rekorder sperrt Dateien, um parallele Schreibvorgänge zu verhindern; schreibt zuerst *.partial.mp4, benennt nach Fertigstellung um. Automatische Frame-für-Frame-Überprüfung; Fehler werden gemeldet. --dpr 2 --scale 1920x1080 bedeutet: Rendern in 2-facher Auflösung, dann auf 1080p skalieren (Supersampling-Antialiasing). Für 4K-Endergebnis --scale weglassen.

Workflow (kein Schritt darf übersprungen werden)

1. Faktenliste (vor der Szene) – gemäß references/accuracy-protocol.md

  • Lehrbuchthema: Zuerst den Original-Lehrbuchsatz finden, als Untertitelgerüst verwenden; Untertitel enthalten nur Schlussfolgerungen auf Lehrbuchniveau, Details auf Universitätsniveau in Notizen zur Faktenliste.
  • Forschungsthema: Argumente aus Abstract und Bildunterschriften extrahieren, jede Einstellung entspricht einer Abbildung, Quellenangabe (z. B. Fig.2b).
  • Ergebnis: review/Faktenliste.md, Spalten: Schritt | Original-Untertitel | Quelle (Lehrbuchkapitel/DOI) | Status (geprüft/ungeprüft). Ungeprüfte Inhalte dürfen nicht auf den Bildschirm.
  • Gleichzeitig Liste verbotener Darstellungen erstellen, die häufige Fehler zu diesem Thema auflistet (z. B. „Ribosom gelangt in das endoplasmatische Retikulum-Lumen“, „Protein treibt nackt im Zytoplasma“).

2. Erste unabhängige Prüfung (Faktenliste + Szenendesign): Einen Unter-Agenten starten, der nur die Faktenliste, das Story-Script und die Szenenbeschreibung erhält; er muss Punkt für Punkt Fehler finden.

3. Szene und Story schreiben: Siehe references/new-scene.md.

  • Jeden Prozess als reine Funktion von t schreiben (z. B. update(t, T)), Zeitfenster in der Story in T definieren.
  • Verfolgte Moleküle mit leuchtendem Material, andere mit dunklem Material darstellen. Die Bedeutung von ‚Markierung‘ muss mit dem Experiment übereinstimmen.
  • Größenverhältnisse nur relativ erhalten; auf dem Bild vermerken: „Nicht maßstabsgetreu“. Zeitkompression ebenfalls vermerken.

4. Selbstprüfung mit Musterseiten: Mit --stills eine Momentaufnahme jedes Schritts generieren, zu einem Raster zusammensetzen und prüfen: Ist das Schlüsselereignis im Bildzentrum? Ist es sichtbar? Gibt es Durchdringungen oder Löcher in der Struktur?

  • Bei verdächtigen dunklen Bereichen oder Löchern mit probe.mjs (Raytracing-Sonde) und hidetest.mjs (Einzelobjekt-Ausblendung) lokalisieren, nicht raten.

5. Zweite unabhängige Prüfung (Endfassungs-Musterseiten): Der Unter-Agent spielt die Rolle eines „Professors für Zellbiologie + Art Director für Wissenschaftskommunikation“ und prüft Musterseiten, Untertitel und Prozesscode. Er erstellt eine Liste zwingender Änderungen und eine Bewertung, ob das Material direkt unterrichtet werden kann.

  • Nur wenn alle Fehler und irreführenden Darstellungen behoben sind, darf das Video ausgegeben werden.

6. Ausgabe und Lieferung:

  • Liefergegenstände: Reine 3D-Version + Erklärversion (zwei MP4s) plus Faktenliste und Protokolle beider Prüfrunden.
  • Bei Veröffentlichung chinesische und englische Texte beifügen; kein Hintergrundmusik-Mix.

Webseiten-Version (bench) – Wesentliche Punkte

  • In der Story layout: 'bench' setzen und brand / title / sub / notes (Laufband, muss belegte Fakten enthalten) / clock (Filmsekunden → physiologische Millisekunden) / conv (welches Signal wird pro Schritt hervorgehoben) angeben. Pro Schritt chip / badge / call (Anmerkung: Anker, Titel, Untertitel, Hauptpunkte) definieren.
  • Zahlen auf der Seite dürfen nur drei Quellen haben, die im Karten-Etikett vermerkt sind: MODEL (Szenen-Census-Zählung), TYPICAL (Lehrbuch-Typwerte), TEXTBOOK. Nicht „LIVE“ / „Echtzeit-Mikroskopie“ o. Ä. schreiben, was als echte Daten missverstanden werden könnte.
  • Modelluhr mit Untertiteln und Kurven synchronisieren; Zeitlupenfaktor als echten Bereich angeben (bei Nichtlinearität „nichtlinear“ schreiben).

Nahaufnahme-„Schnittmodus“ und Membrandicke

  • STORY.slab(t): Zweite globale Schnittebene (nur z ≥ Wert), bei Nahaufnahme die Szene in ca. 50–100 nm dicke Scheiben schneiden, sauber wie Elektronenmikroskop-Schnitte.
  • Membran mit shell() als geschlossene Doppelschicht modellieren (Außenseite nach außen, Innenseite nach innen, 5 nm), Material capify, Schnittflächen als Vollfarbbänder darstellen; Schlüsselereignisse (Fusionspore, Endozytose-Grübchen) auf der Schnittebene platzieren, Kamera nahezu von oben, damit Ω-förmige Konturen sichtbar werden.
  • In der Totale Moleküle/Ionen je nach Kameradistanz vergrößert darstellen (__camDist), in der Fußzeile „Vergrößerte Moleküle in der Totale“ vermerken.

Zwei Rendering-Pipelines (Details in references/two-routes.md)

  • Schnelle Route: Three.js Echtzeit-Rendering (mit N8AO Ambient Occlusion), 49-Sekunden-Video in ca. 15 Minuten fertig, für Iterationen und tägliche Ausgaben.
  • Professionelle Route: export_blender.mjs exportiert die Szene → blender_build.py baut sie in Blender nach, Rendering mit Cycles Path Tracing → record.mjs --overlay-dir generiert die Web-UI-Ebene und überlagert sie. Lokal ca. 17–20 s/Frame, für finale Veröffentlichungen.
  • Es kann immer nur eine Blender-Aufgabe gleichzeitig laufen; zwei führen zu Speichermangel und sofortigem Absturz.

Molekül-„Perlenstil“ (keine Vereinfachung: echte Strukturen)

  • tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group Kette]: Wandelt echte Atomstrukturen in Perlenmodelle um. Membranproteine mit --opm und der OPM-Datenbank-Orientierung.
  • Szenen-Top-Level await fetch('./mol/*.json'), Geometrie mit beadGeo() erzeugen. Perlen oberhalb der Schnittebene komplett entfernen, keine halben Hohlschalen hinterlassen.
  • Platzierung mit Kollisionserkennung auf Perlenebene, 0 Überlappung sicherstellen; node tools/check.mjs site2 "story=..." überprüft.
  • Zählungen müssen stöchiometrisch konsistent sein (z. B. 1 O₂ entspricht PSII-Absorption von 4 Photonen, PSI-Absorption von 4 Photonen, 4 Elektronen, 12 H⁺ in das Thylakoid-Lumen, 2 NADPH, ca. 2,6 ATP). Schematische kontinuierliche Animationen separat als ILLUSTRATIV kennzeichnen.

Morphologische Prinzipien (keine Vereinfachung)

  • Organellen nach realen EM-Formen und -Verhältnissen modellieren, nicht als regelmäßige geometrische Körper. Größen zuerst tabellarisch erfassen (wie in references/morphology-acinar.md), dann codieren.
  • Bei drei Größenordnungen (Zelle 15 μm → Ribosom 25 nm) Strukturen nicht skalieren, sondern die Kamera kontinuierlich heranzoomen (logarithmische Distanzinterpolation); molekulare Ereignisse in der Nahaufnahme betrachten.
  • Geschlossene Strukturen (Vesikel, Mitochondrien, konzentrierte Vakuolen, Zellkerne) bei einem Schnitt als Vollquerschnitt (capify) darstellen, keine Hohlschalen.

Layout-Prinzipien

  • Layout themenspezifisch originell gestalten, keine Referenzvideos kopieren.
  • Standardstil: Dunkel, akademisch: Serifen-Überschrift, Textkörper mit Lehrbuch-Originalzitaten, eine Akzentfarbe (entspricht der Markerfarbe).
  • Jede Zahl auf dem Bild muss eine Quelle haben. Keine unechten Dashboards, falschen Zählungen oder Kurven.
  • Quellen- und Disclaimer-Zeile ständig in der Fußzeile: Schematische Animation · Nicht maßstabsgetreu · Zeit komprimiert · Quellen.

Fertige Beispiele

  • thylakoid: Chloroplast → Grana → Thylakoid-Membran-Lichtreaktion, 9 echte Proteinstrukturen (PSII-LHCII, b₆f, PSI, ATP-Synthase, LHCII, PC, Fd, FNR, Rubisco), englische Bench-Webseite story=thylakoid-en, schnelle und professionelle Route beide realisiert.
  • synapse: Hippocampale glutamaterge Synapse (Axon-Varicosität → pilzförmiger dendritischer Dorn), echter Maßstab 1 Einheit = 20 nm, Aktionspotential → Ca²⁺-Einstrom → Einzelvesikel-Vollfusion → ~4.000 Glutamat-Diffusion → AMPA-Öffnung, Na⁺-Einstrom → Astrozytenaufnahme → Clathrin-vermittelte Endozytose und Wiederauffüllung. Englische Bench-Webseite story=synapse-en, ca. 50 s. Faktenliste und Prüfprotokolle in examples/synapse/.
  • secretion: Meerschweinchen-Pankreas-Azinuszelle, vollständiger Sekretprotein-Weg von freiem Ribosom bis Exozytose, ca. 75 s, 9 Schritte, mit ³H-Leucin-Experiment-Zeitlinie (3/17/117 min, Lehrbuchdaten).

Verwandte Skills