Communitygithub.com

bio-viz-film · 生物 3D 讲解片 (v2)

Transforme des concepts de biologie cellulaire, virologie et biologie moléculaire en vidéos pédagogiques 3D de qualité professionnelle : scènes procédurales Three.js avec rendu cinématographique et narration scientifique rigoureuse.

Qu'est-ce que bio-viz-film · 生物 3D 讲解片 (v2) ?

Cet agent transforme du contenu scientifique (chapitres de manuels, figures de publications, protocoles expérimentaux) en vidéos 3D explicatives de qualité production, en utilisant Three.js pour générer des scènes procédurales avec rendu cinématographique (profondeur de champ, lueur, AO cuite). Il suit un processus en six étapes, de la table de vérification des faits à la double relecture indépendante, garantissant une exactitude scientifique irréprochable : pas de données inventées, pas de processus falsifiés, pas d'images interdites. L'agent prend en charge plusieurs formats de sortie : vidéo pure sans texte, version conférence avec titres et légendes originales, version notes pour diaporamas, et version web interactive (bench). Il peut générer des vidéos pour des animations de sécrétion, mitose, phagocytose, invasion virale, etc. Le moteur v2 utilise un système de story scripté avec timeline, caméras, sous-titres et légendes, le tout paramétrable via URL. Les scènes sont construites à partir de données réelles de microscopie électronique et de structures PDB, avec des principes de morphologie réaliste (pas de formes géométriques simplifiées). L'agent intègre aussi un mode 'showreel' pour des vidéos virales courtes (TikTok, Twitter) avec des looks personnalisables (vivid, neon, academic, paper) et des transitions de canal pseudo-couleur.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

bio-viz-film · Vidéo explicative 3D de biologie (v2)

Objectif : un professeur ne peut pas y trouver d'erreur, un étudiant comprend du premier coup, la qualité visuelle est professionnelle. L'exactitude prime sur l'esthétique ; ne pas inventer de données, ne pas falsifier de processus.

Sommaire

template/site2/   ← Moteur actuel (v2)
  index.html        Disposition explicative (originale : fond sombre académique, titres avec empattement, navigation latérale droite)
  engine.js         Rendu, caméra, timeline, post-traitement (profondeur de champ + lueur), superposition explicative
  lib.js            Générateur aléatoire basé sur une graine, construction instanciée, pool dynamique, AO cuite
  scene-*.js        Scènes procédurales, exporte build(scene, seed) → { anchors, update(t,T), palette }
  story-*.js        Script narratif : étapes, plans, sous-titres, fenêtres temporelles des processus, légendes, références
  vendor/           Three r170 + addons (postprocessing / environments, etc.)
template/site/    ← Ancien moteur v1 (style tableau de bord, cellule/virus ; problèmes scientifiques connus dans references/pitfalls.md, déconseillé)
template/tools/   record.mjs enregistrement image par image · sheet2.py collage d'échantillons · probe.mjs sonde de rayon · hidetest.mjs masquage objet par objet
references/       accuracy-protocol.md (à lire absolument) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/         secretion : exemple complet du manuel chinois PEP必修1 3.2 « Synthèse et transport des protéines de sécrétion » + 5 rapports de relecture

Formats de sortie (disposition au choix)

?layout=EffetAdapté à
cleanImage 3D pure, sans aucun texte ni interface webMontage secondaire, doublage, fond d'écran
lecture (par défaut)Version académique sombre : numéro d'étape + titre avec empattement + phrase du manuel, navigation latérale droite, légendes, référence en basVidéo explicative, publication
notesVersion claire type fiche : cadre 3D arrondi à gauche, liste complète des étapes à droite (étape courante développée), légendes, données expérimentales, référencesCours, projection en classe
dashboardTableau de bord de suivi : panneau droit affiche en temps réel le nombre de molécules marquées dans chaque compartiment (comptage du modèle, avec mention 'pas des valeurs expérimentales')Présentation scientifique, démonstration de processus
benchPage web style paillasse claire (tendance des tableaux de bord viraux) : barre supérieure (champ de vision, étape, horloge du modèle) + connaissances réelles défilantes + fenêtre 3D encadrée (étiquettes ancrées sur les structures 3D avec réticule, échelle en temps réel) + barres de comptage du modèle + barre d'étape + 3 mini-fiches (courbe typique / courbe de comptage / schéma du manuel). Format vertical 1080×1350 optimalTwitter, Xiaohongshu, version web
PersonnaliséCréer <nom>.js dans layouts/, exporter meta / css / html / mount / update, appeler avec ?layout=<nom>Par thème ou sur demande
  • Dans le story, on peut écrire layout: 'notes' pour définir une disposition par défaut ; --size 1080x1920 pour une version verticale, les dispositions s'adaptent automatiquement.
  • Règles pour les nouvelles dispositions :
    • Chaque nombre à l'écran doit être réel (provenant d'une source ou de l'état du modèle) ;
    • Ne pas copier les vidéos de référence, la disposition doit être conçue spécialement pour le thème ;
    • Le sujet 3D utilise meta.camShift pour laisser de la place au texte.

Mode Showreel (vidéo virale) — pour le trafic, pour impressionner

Utilise le même contenu scientifique que la version explicative, mais change seulement la présentation. On peut le demander dans le prompt ou via des paramètres :

Vous ditesParamètreOptions
« Fais une vidéo virale / version époustouflante / vidéo courte verticale »?story=<sujet>-reel (story explicative compressée par 0.42, plan-séquence)—
« Style lumineux / néon / académique / papier »look=vivid bonbon lumineux · neon fond sombre néon · academic sombre académique · paper papier
« Palette bonbon / bleu glace / coucher de soleil »palette=textbook · candy · ice · sunset · neon
« Transition de balayage changeant de couleur »fx=channelsÀ chaque étape, un balayage de pixels passe au canal pseudo-couleur suivant (similaire au changement de canal d'un microscope à fluorescence)
« Grands titres / style TikTok »layout=reelUn accroche par étape en gros titre, avec étiquette de canal pseudo-couleur et brève clause de non-responsabilité
« Format vertical »--size 1080x1920En vertical, la caméra recule automatiquement de 1.7× (portraitZoom)

Règles :

  • La pseudo-couleur change seulement la couleur, pas la structure ni le processus ; une mention « les couleurs sont des pseudo-couleurs » doit être visible en permanence à l'écran.
  • La version showreel doit aussi passer la relecture scientifique.

Enregistrement :

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 (×1, 30 ips, environ 1/8 du temps) produit un aperçu pour validation par l'utilisateur avant l'enregistrement final. L'enregistreur verrouille le fichier pour éviter deux processus simultanés ; écrit d'abord *.partial.mp4, renomme après fin ; enfin, vérifie image par image automatiquement et signale les erreurs. --dpr 2 --scale 1920x1080 signifie : rendu d'abord en 2× résolution, puis redimensionné en 1080p, équivalent à un anti-aliasing par suréchantillonnage. Pour une sortie 4K, supprimer --scale.

Processus (aucune étape ne peut être sautée)

1. Table de vérification des faits (avant l'image) — exécuter selon references/accuracy-protocol.md

  • Thème de manuel : trouver d'abord la phrase originale du manuel, qui servira de squelette aux sous-titres ; les sous-titres n'écrivent que les conclusions du niveau manuel, les détails de niveau universitaire vont dans les notes de la table.
  • Thème d'article : extraire les thèses du résumé et des légendes de figures, chaque plan correspond à une figure, annoter la référence (ex. Fig.2b).
  • Livrable : review/table-des-faits.md, colonnes : Étape | Phrase du sous-titre | Référence (section manuel/DOI) | Statut (vérifié/en attente). Le contenu en attente ne peut pas être affiché.
  • Écrire en même temps la liste des images interdites, listant les erreurs courantes sur ce thème (ex. « un ribosome entre dans la lumière du RE », « une protéine nue dérive dans le cytoplasme »).

2. Première relecture indépendante (table des faits + conception de scène) : lancer un sous-agent, lui donner seulement la table des faits, le script narratif et la description de scène, lui demander de relever les erreurs une par une.

3. Écrire la scène et l'histoire : voir references/new-scene.md.

  • Chaque processus s'écrit comme une fonction pure de t (ex. update(t, T)), la fenêtre temporelle unifiée dans T du story.
  • Les molécules traquées utilisent un matériau lumineux, les autres un matériau sombre ; la signification du « marquage » à l'écran doit correspondre à l'expérience.
  • Les tailles ne conservent que l'ordre relatif, et une mention « pas à l'échelle réelle » doit figurer à l'écran. La compression temporelle doit aussi être mentionnée.

4. Auto-vérification des échantillons : utiliser --stills pour produire une image intermédiaire de chaque étape, assembler en collage et vérifier : l'événement clé est-il au centre du cadre, visible, les structures ont-elles des intersections ou des trous ?

  • En cas de zones suspectes sombres ou de trous, utiliser probe.mjs (sonde de rayon) et hidetest.mjs (masquage objet par objet) pour localiser, ne pas deviner.

5. Deuxième relecture indépendante (échantillons de la vidéo finale) : le sous-agent joue le rôle de « professeur de biologie cellulaire + directeur artistique de documentaire scientifique », examine les échantillons, les sous-titres et le code des processus, donne une liste des modifications obligatoires et une conclusion sur l'aptitude à l'enseignement.

  • Seulement après avoir corrigé tous les problèmes de type « erreur » et « trompeur », on peut produire la vidéo.

6. Production et livraison :

  • Livrables : version vidéo pure + version explicative (deux mp4), ainsi que la table des faits et les deux rapports de relecture.
  • Accompagner de textes en chinois et en anglais ; pas de BGM mixé.

Points clés de la version web (bench)

  • Dans le story, écrire layout: 'bench' et fournir brand / title / sub / notes (connaissances défilantes, doivent être des faits sourcés) / clock (temps pellicule → ms physiologiques) / conv (quel signal est mis en évidence à chaque étape), pour chaque étape écrire chip / badge / call (annotation : point d'ancrage, titre, sous-titre, points clés).
  • Les nombres à l'écran ne peuvent provenir que de trois sources, avec mention dans le badge de la carte : MODEL (comptage du scène), TYPICAL (valeur typique de manuel), TEXTBOOK. L'échelle et le champ de vision sont calculés en temps réel par la caméra. Ne pas écrire LIVE / microscopie en temps réel ou tout terme pouvant être confondu avec des données réelles.
  • L'horloge du modèle doit être cohérente avec les sous-titres et les courbes ; le ralentissement doit mentionner la plage réelle (non linéaire si non linéaire).

Mode « tranche » en gros plan et épaisseur de membrane

  • STORY.slab(t) : deuxième plan de coupe global (ne conserve que z ≥ valeur), en gros plan, découpe la scène en tranches d'environ 50–100 nm d'épaisseur, nettes comme une coupe de microscopie électronique.
  • La membrane utilise shell() pour créer une bicouche fermée avec épaisseur (couche externe vers l'extérieur, couche interne vers l'intérieur, 5 nm), matériau capify, la coupe affiche une bande de couleur pleine ; les événements clés (pore de fusion, fosse de clathrine) sont placés sur le plan de coupe, la caméra presque en vue de dessus, pour que le profil en Ω soit visible.
  • En plan large, les molécules/ions sont agrandis selon la distance à la caméra (__camDist), avec mention « molécules agrandies en plan large » en bas de page.

Deux voies de production (détails dans references/two-routes.md)

  • Voie rapide : rendu en temps réel Three.js (avec N8AO d'occlusion ambiante), une vidéo de 49 s sort en environ 15 min, pour itération et production quotidienne.
  • Voie professionnelle : export_blender.mjs exporte la scène → blender_build.py reconstruit dans Blender, rendu par lancer de rayons Cycles → record.mjs --overlay-dir génère l'interface web, puis superposition. Environ 17–20 s/image sur machine locale, pour la version finale de publication.
  • Un seul processus Blender à la fois, sinon mémoire insuffisante et plantage.

Style « collier de perles » à l'échelle moléculaire (pas de simplification : structure réelle)

  • tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group chaîne] : transforme la structure atomique réelle en modèle de perles. Pour les protéines membranaires, ajouter --opm, utilise l'orientation dans la membrane de la base OPM.
  • Au niveau supérieur de la scène await fetch('./mol/*.json'), génère la géométrie avec beadGeo(). Les perles au-dessus du plan de coupe sont supprimées entièrement, pas de demi-coquille.
  • Placement avec détection de collision au niveau des perles, garantit 0% d'interpénétration ; node tools/check.mjs site2 "story=..." pour vérifier.
  • Les comptages doivent être stœchiométriquement cohérents (ex. : 1 O₂ correspond à PSII absorbant 4 photons, PSI absorbant 4 photons, transférant 4 électrons, 12 H⁺ dans le lumen thylakoïdien, produisant 2 NADPH, environ 2.6 ATP). Les animations continues à titre illustratif doivent être étiquetées ILLUSTRATIVE.

Principes de morphologie (pas de simplification)

  • Les organites sont modélisés selon leur forme réelle en microscopie électronique et leurs proportions, pas en géométries régulières. Les dimensions sont d'abord recherchées (comme dans references/morphology-acinar.md), puis codées.
  • Sur trois ordres de grandeur (cellule 15 μm → ribosome 25 nm), on ne réduit pas les structures, mais on fait avancer la caméra en continu (interpolation logarithmique de la distance), et on regarde les événements moléculaires en gros plan.
  • Les structures fermées (granules, mitochondries, vésicules condensées, noyau) montrent une section pleine (capify) lors de la coupe, pas de coquille vide.

Principes de disposition

  • La disposition est originale selon le thème, ne pas copier les vidéos de référence.
  • Le style par défaut est académique sombre : titres avec empattement, texte corps en phrases du manuel, une couleur d'accentuation (celle du traceur).
  • Chaque nombre apparaissant à l'écran doit avoir une source. Pas de faux tableaux de bord, faux comptages, fausses courbes.
  • Mentions et clauses de non-responsabilité fixes en bas : Animation illustrative · Pas à l'échelle réelle · Temps compressé · Références.

Exemples réalisés

  • thylakoid : Chloroplaste → granum → réactions photochimiques sur la membrane thylakoïdienne, 9 structures protéiques réelles (PSII-LHCII, b₆f, PSI, ATP synthase, LHCII, PC, Fd, FNR, Rubisco), version web anglaise bench story=thylakoid-en, produite en voie rapide et professionnelle.
  • synapse : Synapse glutamatergique de l'hippocampe (varicosité axonale → épine dendritique en champignon), échelle réelle 1 unité = 20 nm, potentiel d'action → entrée de Ca²⁺ → fusion complète d'une vésicule → diffusion de ~4000 glutamate → ouverture AMPA, entrée de Na⁺ → recapture par astrocytes → endocytose par clathrine et recharge. Version web anglaise bench story=synapse-en, environ 50 s. Table des faits et relecture dans examples/synapse/.
  • secretion : Cellule acineuse pancréatique de cobaye, synthèse de protéine sécrétoire du ribosome libre à l'exocytose complète, environ 75 s, 9 étapes, avec chronologie de l'expérience ³H-leucine (3/17/117 min, données du manuel).

Skills associés