Communitygithub.com

bio-viz-film · Biología 3D Educativa (v2)

Convierte conceptos de biología celular, virología y biología molecular en videos explicativos 3D de nivel académico y calidad comercial: escenas seccionadas en Three.js con renderizado cinematográfico (desenfoque, resplandor, AO horneado) y pasos que muestran procesos reales.

¿Qué es bio-viz-film · Biología 3D Educativa (v2)?

**bio-viz-film** es un skill para asistentes de IA (como Claude Code, Cursor o Codex) que permite generar videos explicativos 3D de biología celular, virología y biología molecular, con un enfoque en precisión científica y calidad visual comercial. El skill se basa en la creación de escenas seccionadas programáticas usando Three.js, con renderizado cinematográfico (desenfoque de profundidad, resplandor, oclusión ambiental horneada) y una línea de tiempo que muestra los procesos paso a paso (por ejemplo, síntesis y secreción de proteínas, exocitosis, invasión viral). Soporta múltiples formatos de salida: desde videos de pura animación 3D (sin texto) hasta versiones con diseño académico original que incluyen títulos de pasos, texto original de libros de texto, navegación de vías, leyendas y fuentes. El skill integra un riguroso protocolo de precisión científica: mesa de hechos con fuentes → lista de imágenes prohibidas → dos rondas de revisión independiente (científica y visual). Está diseñado para ser usado cuando un usuario solicita "haz una animación de una célula/virus/orgánulo", "convierte este capítulo de libro en animación", "video 3D para tesis/defensa/docencia" o "animación de proteína secretora/exocitosis/mitosis/invasión viral". El flujo de trabajo es detallado: primero se crea una mesa de hechos con fuentes citadas, luego se escribe un guión visual y de escena, se somete a dos rondas de revisión independiente, se generan muestras de fotogramas y finalmente se entregan dos versiones de video (limpia y con diseño académico).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

bio-viz-film · Video Explicativo 3D de Biología (v2)

Objetivo: Que un profesor no pueda encontrar errores, que un estudiante lo entienda a la primera y que la calidad visual sea comercial. La precisión es más importante que la estética; no se inventan datos ni procesos.

Índice

template/site2/   ← Motor actual (v2)
  index.html        Diseño de presentación (original: estilo académico oscuro, títulos con serifa, navegación de vías a la derecha)
  engine.js         Renderizador, cámara, línea de tiempo, postprocesado (desenfoque de profundidad + resplandor), capa de presentación
  lib.js            Semilla aleatoria, construcción por instancias, pool dinámico, AO horneado
  scene-*.js        Escenas programáticas, exportan build(scene, seed) → { anchors, update(t,T), palette }
  story-*.js        Guión de la historia: pasos, tomas, subtítulos, ventanas de tiempo de proceso, leyendas, fuentes
  vendor/           Three r170 + addons (postprocessing / environments, etc.)
template/site/    ← Motor anterior v1 (estilo panel de control, célula/virus; problemas científicos conocidos en references/pitfalls.md, no recomendado)
template/tools/   record.mjs grabación cuadro a cuadro · sheet2.py collage de muestras · probe.mjs sonda de rayos · hidetest.mjs inspección objeto por objeto
references/       accuracy-protocol.md (lectura obligatoria) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/         secretion: ejemplo completo del capítulo 3.2 de Biología de bachillerato "Síntesis y transporte de proteínas secretoras" + registro de cinco rondas de revisión

Formatos de salida (diseño seleccionable)

?layout=EfectoIdeal para
cleanSolo animación 3D, sin ningún texto ni interfaz webReedición, doblaje, fondos
lecture (por defecto)Versión académica oscura: número de paso + título con serifa + texto original del libro, navegación de vías a la derecha, leyendas, fuentes en pieVideos explicativos, publicación
notesVersión de apuntes en fondo claro: marco redondeado 3D a la izquierda, lado derecho con lista completa de pasos (paso actual expandido con texto original), leyendas, datos experimentales, fuentesDiapositivas, proyección en clase
dashboardPanel de control de seguimiento: panel derecho muestra en tiempo real el recuento de moléculas marcadas en cada compartimento (procedente del propio modelo, con nota de que no son valores experimentales)Presentaciones de investigación, demostración de "procesos"
benchPágina web de banco de trabajo en fondo claro (estilo panel de control moderno): barra superior (campo de visión, paso, reloj del modelo) + conocimientos reales en marquee + ventana 3D con marco (etiquetas fijadas con cruceta sobre estructuras 3D, escala en tiempo real) + barras de recuento del modelo + barra de pasos + tres tarjetas pequeñas (curva típica / curva de recuento del modelo / ilustración del libro). Formato vertical 1080×1350 óptimoPublicaciones en Twitter, Xiaohongshu
PersonalizadoCrea <nombre>.js en layouts/, exporta meta / css / html / mount / update cuatro elementos, usa ?layout=<nombre>Personalización por tema o requisito
  • En el story se puede escribir layout: 'notes' para establecer el diseño por defecto; --size 1080x1920 produce versión vertical, y cada diseño se reajusta automáticamente.
  • Reglas para nuevos diseños:
    • Cada número en pantalla debe ser real (procedente de una fuente o del estado del modelo);
    • No copiar videos de referencia, el diseño debe ser original según el tema;
    • El sujeto 3D debe usar meta.camShift para dejar espacio al texto.

Modo Espectáculo (Showreel) — Para viralizar, para impresionar

Usa el mismo contenido científico que la versión explicativa, solo cambia "cómo se muestra". Se puede indicar directamente en el prompt o con parámetros:

Tú dicesParámetroValores
"Haz un espectáculo / versión impresionante / video corto vertical"?story=<tema>-reel (la historia explicativa se comprime al 0.42 del tiempo, plano secuencia)—
"Estilo brillante / neón / académico / papel"look=vivid colores brillantes tipo caramelo · neon neón sobre fondo oscuro · academic académico oscuro · paper papel
"Cambia la paleta a caramelo / azul hielo / atardecer"palette=textbook · candy · ice · sunset · neon
"Quiero transiciones de barrido de cambio de color"fx=channelsCada nuevo paso, un barrido de píxeles cambia al siguiente "pseudocanal de color" (similar al cambio de canal en microscopía de fluorescencia)
"Títulos grandes / estilo TikTok"layout=reelUn título gancho grande por paso, más etiquetas de pseudocanal y un breve descargo de responsabilidad
"Versión vertical"--size 1080x1920La cámara se aleja automáticamente 1.7x en vertical (portraitZoom)

Reglas:

  • Los pseudocolores solo cambian el color, no alteran la estructura ni el proceso; debe aparecer permanentemente un texto que indique "color es pseudocolor".
  • La versión espectáculo también debe pasar la revisión científica.

Grabación:

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, 30fps, aproximadamente 1/8 del tiempo) para obtener una vista previa y que el usuario confirme, luego grabar la versión final. El grabador bloquea para evitar que dos procesos escriban en el mismo archivo simultáneamente; primero escribe *.partial.mp4, y solo renombra al finalizar; luego decodifica y verifica automáticamente cuadro a cuadro, reportando errores si los hay.

--dpr 2 --scale 1920x1080 significa: renderizar primero al doble de resolución y luego reducir a 1080p, lo que equivale a supermuestreo antialiasing. Para obtener 4K final, quita --scale.

Flujo de trabajo (ningún paso puede saltarse)

1. Mesa de hechos (antes de la animación) — Seguir references/accuracy-protocol.md

  • Para temas de libro de texto: encontrar primero el texto original del libro, que servirá como columna vertebral de los subtítulos; los subtítulos solo escriben conclusiones a nivel de libro de texto; los detalles a nivel universitario van en las notas de la mesa de hechos.
  • Para temas de artículo de investigación: extraer los argumentos del resumen y los pies de figura, cada toma corresponde a una Figura, indicando la fuente (ej. Fig.2b).
  • Producto: review/mesa_de_hechos.md, con columnas: Paso | Texto del subtítulo | Base (sección del libro/DOI) | Estado (verificado/pendiente). El contenido pendiente no puede mostrarse en pantalla.
  • Al mismo tiempo, escribir una lista de imágenes prohibidas, con los errores comunes de este tema (por ejemplo "el ribosoma entra en el retículo endoplasmático" "la proteína flota desnuda en el citoplasma").

2. Primera ronda de revisión independiente (mesa de hechos + diseño de escena): Crear un subagente, darle solo la mesa de hechos, el guión de la historia y la descripción de la escena, pedirle que encuentre errores uno por uno.

3. Escribir la escena y la historia: Ver references/new-scene.md.

  • Cada proceso se escribe como una función pura de t (ej. update(t, T)), con las ventanas de tiempo unificadas en el T de la historia.
  • Las moléculas rastreadas se representan con material brillante, las demás moléculas con material oscuro; el significado del "marcaje" en pantalla debe coincidir con el experimento.
  • El tamaño solo conserva el orden relativo, y debe indicarse en pantalla "no a escala real". La compresión del tiempo también debe indicarse.

4. Autoverificación de muestras: Usar --stills para generar un fotograma intermedio de cada paso, componer un collage y revisar: si los eventos clave están en el centro del encuadre, si son visibles, si hay estructuras que se intersectan o huecos.

  • Si se detectan manchas oscuras o huecos sospechosos, usar probe.mjs (sonda de rayos) y hidetest.mjs (ocultar objetos uno por uno) para localizarlos, no adivinar.

5. Segunda ronda de revisión independiente (muestras del video final): El subagente interpreta el rol de "profesor de biología celular + director artístico de documental científico", revisa las muestras, los subtítulos y el código de proceso, y proporciona una lista de cambios obligatorios y una conclusión sobre si "puede usarse directamente para docencia".

  • Solo después de corregir todos los problemas de nivel "error" y "engañoso" se puede producir el video.

6. Producción y entrega:

  • Entregables: dos videos mp4 (versión limpia + versión explicativa), además de la mesa de hechos y los registros de las dos rondas de revisión.
  • Publicar con textos en chino e inglés; no mezclar música de fondo.

Puntos clave de la versión web (bench)

  • En el story escribir layout: 'bench', y proporcionar brand / title / sub / notes (marquee, deben ser hechos con fuente) / clock (segundos de película → milisegundos fisiológicos) / conv (qué señal se resalta en cada paso), en cada paso escribir chip / badge / call (anotación: punto de anclaje, título, subtítulo, puntos clave).
  • Los números en la página solo pueden tener tres fuentes, y debe indicarse en la esquina de la tarjeta: MODEL (recuento del censo de la escena), TYPICAL (valor típico de libro de texto), TEXTBOOK. No escribir términos como LIVE / en vivo / microscopía en tiempo real que puedan confundirse con datos reales.
  • El reloj del modelo debe coincidir con los subtítulos y las curvas; el factor de ralentización debe escribirse en valores reales (si es no lineal, indicarlo).

Modo "rebanada" de primeros planos y espesor de membrana

  • STORY.slab(t): segundo plano de recorte global (solo conserva z ≥ valor), en primeros planos corta la escena en una rebanada de aproximadamente 50–100 nm de espesor, limpia como una sección de microscopio electrónico.
  • La membrana se hace con shell() para formar una bicapa cerrada con espesor (capa externa hacia afuera, interna hacia adentro, 5 nm), material capify, el corte muestra una banda de color sólido; los eventos clave (poro de fusión, hoyo de endocitosis) se colocan en el plano de corte, la cámara se aproxima a una vista casi cenital, para que el contorno en Ω sea visible.
  • En planos generales, las moléculas/iones se amplían según la distancia a la cámara (__camDist), con un pie de página que indica "moléculas ampliadas en plano general".

Dos rutas de producción (ver detalles en references/two-routes.md)

  • Ruta rápida: renderizado en tiempo real con Three.js (más N8AO de oclusión ambiental), un video de 49 segundos se produce en unos 15 minutos, para iteración y producción diaria.
  • Ruta profesional: export_blender.mjs exporta la escena → blender_build.py la reconstruye en Blender, renderiza con Cycles path tracing → record.mjs --overlay-dir genera la capa de interfaz web y la superpone. Aproximadamente 17–20 segundos por fotograma en local, para la versión de publicación final.
  • Solo se puede ejecutar una tarea de Blender a la vez; dos agotarían la memoria y provocarían un bloqueo.

Estilo "cuentas" a nivel molecular (sin simplificar: estructura real)

  • tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group chain]: convierte estructuras atómicas reales en modelos de cuentas. Para proteínas de membrana, añadir --opm, usando la orientación en membrana de la base de datos OPM.
  • La escena carga await fetch('./mol/*.json') en el nivel superior y usa beadGeo() para generar la geometría. Las cuentas por encima del plano de corte se descartan por completo, sin dejar cáscaras vacías.
  • Al colocar, se realiza detección de colisiones a nivel de cuentas para garantizar 0 intersecciones; usar node tools/check.mjs site2 "story=..." para verificar.
  • El recuento debe ser químicamente consistente (ej.: 1 O₂ corresponde a PSII que absorbe 4 fotones, PSI absorbe 4 fotones, transfiere 4 electrones, el lumen del tilacoide recibe 12 H⁺, genera 2 NADPH, aproximadamente 2.6 ATP). Las animaciones continuas ilustrativas deben etiquetarse como ILUSTRATIVAS.

Principios de morfología (sin simplificar)

  • Los orgánulos se modelan según la morfología y proporciones reales de microscopía electrónica, no como formas geométricas regulares. Las dimensiones se consultan primero en tablas (como en references/morphology-acinar.md), luego se codifican.
  • Al cruzar tres órdenes de magnitud (célula 15 μm → ribosoma 25 nm), no se escala la estructura, sino que la cámara se acerca continuamente (interpolación logarítmica de distancia), y los eventos moleculares se ven en primer plano.
  • Las estructuras cerradas (gránulos, mitocondrias, vesículas de condensación, núcleo) al ser seccionadas muestran un corte macizo (capify), sin dejar cáscaras vacías.

Principios de diseño

  • El diseño es original según el tema, no se copian videos de referencia.
  • El estilo por defecto es académico oscuro: títulos con serifa, el cuerpo de texto es el texto original del libro, se usa un color de énfasis (igual al color del trazador).
  • Cada número que aparece en pantalla debe tener una fuente. No se usan paneles de control falsos, recuentos falsos ni curvas falsas.
  • Las citas y los descargos de responsabilidad están siempre presentes en el pie: Animación ilustrativa · No a escala real · Tiempo comprimido · Fuente.

Ejemplos completados

  • thylakoid: Cloroplasto → Grana → Reacciones luminosas en la membrana del tilacoide, 9 estructuras proteicas reales (PSII-LHCII, b₆f, PSI, ATP sintasa, LHCII, PC, Fd, FNR, Rubisco), versión web en inglés story=thylakoid-en, producido en ambas rutas rápida y profesional.
  • synapse: Sinapsis glutamatérgica del hipocampo (varicosidades del axón → espina dendrítica en forma de hongo), escala real 1 unidad = 20 nm, potencial de acción → entrada de Ca²⁺ → fusión completa de una sola vesícula → difusión de ~4,000 glutamatos → apertura de AMPA, entrada de Na⁺ → captación por astrocitos → endocitosis mediada por clatrina y recarga. Versión web en inglés story=synapse-en, aproximadamente 50 segundos. Mesa de hechos y revisión en examples/synapse/.
  • secretion: Célula acinar pancreática de cobaya, proceso completo de la proteína secretora desde el ribosoma libre hasta la exocitosis, aproximadamente 75 segundos, 9 pasos, incluye línea de tiempo del experimento con ³H-leucina (3/17/117 min, datos de libro de texto).

Skills relacionados