Communitygithub.com

bio-viz-film · Bio 3D Explicador (v2)

Transforma conceitos de biologia celular, virologia e biologia molecular em vídeos 3D explicativos de nível professoral e prontos para uso comercial, com cenas seccionadas programáticas em Three.js e renderização cinematográfica (profundidade de campo, brilho, AO cozido).

O que é bio-viz-film · Bio 3D Explicador (v2)?

O bio-viz-film é uma habilidade especializada para agentes de IA (como Claude Code, Cursor, Codex etc.) que gera vídeos 3D de alta qualidade para explicar processos de biologia celular, virologia e biologia molecular, como síntese e transporte de proteínas secretoras, exocitose, invasão viral e mitose. Ele combina cenas seccionadas programáticas em Three.js com efeitos cinematográficos (profundidade de campo, glow, AO cozida) e suporta múltiplos formatos de saída: desde vídeos puramente visuais (sem texto) até layouts acadêmicos com títulos, legendas de livros didáticos, navegação de vias, legendas e fontes. A habilidade impõe um rigoroso protocolo de precisão científica: construção de uma tabela de fatos com fontes → lista de proibições de cena → duas rodadas de revisão independente (científica e visual). O usuário pode solicitar animações de células, vírus, organelas ou capítulos de livros didáticos, e o sistema gera o vídeo correspondente com narração original e controle de qualidade. As plataformas suportadas incluem qualquer ambiente que execute JavaScript/Node.js (Three.js r170+), com ferramentas de captura de quadros, estilos personalizáveis e modos rápido e profissional (Blender Cycles para renderização final).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que bio-viz-film · Bio 3D Explicador (v2) faz?

Objetivo: Professores não encontram erros, alunos entendem de primeira, e o visual atinge padrão comercial. Precisão acima de estética; não inventar dados, não inventar processos.

Índice

template/site2/   ← Motor atual (v2)
  index.html        Layout explicativo (original: escuro acadêmico, título serifado, navegação de via à direita)
  engine.js         Renderizador, câmera, timeline, pós-processamento (profundidade de campo + brilho), sobreposição de explicação
  lib.js            Aleatoriedade com semente, construção instanciada, pool dinâmico, AO cozida
  scene-*.js        Cenas programáticas, exporta build(scene, seed) → { anchors, update(t,T), palette }
  story-*.js        Roteiro da história: etapas, tomadas, legendas, janelas de tempo do processo, legendas, fontes
  vendor/           Three r170 + addons (postprocessing / environments etc.)
template/site/    ← Motor antigo v1 (estilo dashboard, célula/vírus; problemas científicos conhecidos em references/pitfalls.md, não recomendado)
template/tools/   record.mjs gravação quadro a quadro · sheet2.py montagem de amostras · probe.mjs sonda de raios · hidetest.mjs inspeção objeto por objeto
references/       accuracy-protocol.md (leitura obrigatória) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/         secretion: Exemplo completo da seção 3.2 do livro didático chinês (RENJIAO, 1º ano do Ensino Médio) "Síntese e Transporte de Proteínas Secretoras" + registro de cinco rodadas de revisão

Formatos de Saída (Layout opcional)

?layout=EfeitoAdequado para
cleanApenas cena 3D, sem qualquer texto ou elemento de páginaEdição secundária, narração, fundo
lecture (padrão)Versão acadêmica escura: número da etapa + título serifado + frase original do livro didático, navegação de via à direita, legenda, fonte no rodapéVídeos explicativos, publicação
notesVersão de apostila clara: moldura 3D arredondada à esquerda, à direita lista completa de etapas (etapa atual expandida com frase original), legenda, dados experimentais, fonteSlides de aula, projetor em sala
dashboardPainel de monitoramento: painel direito mostra em tempo real a contagem de moléculas marcadas em cada compartimento (contagem do próprio modelo, com nota "não são valores experimentais")Apresentação de pesquisa, demonstração de "processo"
benchPágina web estilo bancada clara (estilo dashboard popular): barra superior (campo de visão, etapa, relógio do modelo) + conhecimento real em marquee + janela 3D com moldura (rótulos com mira fixada em estruturas 3D, escala em tempo real) + barras de contagem do modelo + barra de etapas + três mini cartões (curva típica / curva de contagem do modelo / diagrama do livro didático). Vertical 1080×1350 idealPublicação no Twitter/X, Xiaohongshu
PersonalizadoCrie um arquivo <nome>.js em layouts/, exportando meta / css / html / mount / update quatro itens, use ?layout=<nome> para chamarPor tema ou requisito personalizado
  • No story pode-se definir layout: 'notes' para layout padrão; --size 1080x1920 para saída vertical, cada layout se adapta automaticamente.
  • Regras para novos layouts:
    • Cada número na tela deve ser real (proveniente de fonte ou estado do modelo);
    • Não copiar vídeos de referência; o layout deve ser projetado de acordo com o tema;
    • O corpo 3D usa meta.camShift para ceder espaço ao texto.

Modo Showreel (Chamativo) — para atrair atenção e impressionar

Usa o mesmo conteúdo científico da versão explicativa, apenas muda "como mostrar". Pode ser solicitado diretamente no prompt ou via parâmetros:

Você pode dizerParâmetroValores possíveis
"Faça um showreel / versão impressionante / vídeo curto vertical"?story=<tema>-reel (story explicativo comprimido em 0,42x, plano-sequência)—
"Estilo claro / neon / acadêmico / papel"look=vivid claro e colorido · neon fundo escuro com brilho neon · academic escuro acadêmico · paper papel
"Paleta de cores candy / azul gelo / pôr do sol"palette=textbook · candy · ice · sunset · neon
"Quero transição com varredura de troca de cor"fx=channelsA cada nova etapa, faz a varredura de pixels mudando para o próximo "canal pseudo-cor" (similar a troca de canal em microscopia de fluorescência)
"Título grande / estilo TikTok"layout=reelCada etapa uma frase gancho grande, com etiqueta de canal pseudo-cor e breve aviso de isenção
"Vertical"--size 1080x1920No modo vertical a câmera se afasta 1,7x (portraitZoom)

Regras:

  • Pseudo-cor apenas altera a cor, não modifica estrutura ou processo; na tela deve haver sempre "cores são pseudo-cor".
  • Versão showreel também passa por revisão científica.

Gravação:

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, ~1/8 do tempo) gera uma prévia para o usuário confirmar, depois grava o vídeo final. O gravador trava para evitar que dois processos escrevam no mesmo arquivo; escreve primeiro *.partial.mp4, renomeia após conclusão; no final decodifica e verifica quadro a quadro automaticamente, reportando erros. --dpr 2 --scale 1920x1080 significa: renderiza primeiro em resolução 2x, depois redimensiona para 1080p, como supersampling antialiasing. Para saída 4K, remova --scale.

Fluxo (nenhuma etapa pode ser pulada)

1. Tabela de Fatos (antes do visual) — Seguir references/accuracy-protocol.md

  • Tema de livro didático: primeiro encontrar as frases originais do livro, usar como espinha dorsal das legendas; legendas escrevem apenas conclusões de nível de livro didático; detalhes de nível universitário vão nas notas da tabela de fatos.
  • Tema de artigo: extrair argumentos do resumo e legendas de figuras, cada tomada corresponde a uma Figura, anotar fonte (ex.: Fig.2b).
  • Saída: review/tabela_de_fatos.md, colunas: Etapa | Legenda original | Fonte (seção do livro/DOI) | Status (verificado/pendente). Conteúdo pendente não pode ser exibido.
  • Ao mesmo tempo, escrever a Lista de Proibições de Cena, listando erros comuns deste tema (ex.: "ribossomo entra no lúmen do RE" "proteína flutuando nua no citoplasma").

2. Primeira Rodada de Revisão Independente (Tabela de Fatos + Design de Cena): Iniciar um subagente, fornecer apenas a tabela de fatos, o roteiro da história e a descrição da cena, pedir que ele aponte erros um por um.

3. Escrever Cena e História: Ver references/new-scene.md.

  • Cada processo é escrito como função pura de t (ex.: update(t, T)), janelas de tempo unificadas no T da história.
  • Moléculas rastreadas usam material emissivo, outras moléculas usam material escuro; o significado da "marcação" na tela deve ser consistente com o experimento.
  • Tamanhos mantêm apenas ordem relativa, e na tela escreve "fora de escala real". Compressão de tempo também deve ser indicada.

4. Autoverificação de Amostras: Usar --stills para gerar quadros intermediários de cada etapa, montar em um mosaico para verificar: eventos-chave estão no centro da tela? São visíveis? Estruturas têm interseções ou buracos?

  • Se detectar blocos escuros ou buracos suspeitos, usar probe.mjs (sonda de raios) e hidetest.mjs (ocultar objetos um a um) para localizar, não adivinhar.

5. Segunda Rodada de Revisão Independente (Amostras do Vídeo Final): Subagente atua como "Professor de Biologia Celular + Diretor de Arte de documentário científico", revisa amostras, legendas e código de processo, fornece lista de correções obrigatórias e conclusão "pode ser usado diretamente para ensino".

  • Somente após corrigir todos os problemas de "erro" e "enganoso" pode-se gerar o vídeo final.

6. Geração e Entrega:

  • Entregáveis: dois mp4 (versão puramente visual + versão explicativa), mais a tabela de fatos e registros das duas rodadas de revisão.
  • Publicação com texto em chinês e inglês; não misturar BGM.

Pontos-chave da Versão Web (bench)

  • No story escrever layout: 'bench', e fornecer brand / title / sub / notes (marquee, devem ser fatos com fonte) / clock (tempo de filme → milissegundos fisiológicos) / conv (qual sinal é destacado em cada etapa), cada etapa escrever chip / badge / call (anotação: âncora, título, subtítulo, pontos-chave).
  • Os números na página só podem vir de três fontes, e devem ser identificados com selo no cartão: MODEL (contagem do censo da cena), TYPICAL (valor típico do livro didático), TEXTBOOK. Não escrever termos como LIVE / MICROSCOPIA EM TEMPO REAL que possam ser confundidos com dados reais.
  • O relógio do modelo deve ser consistente com legendas e curvas; o fator de desaceleração escrever em faixa real (não linear se for não linear).

Modo "Corte Serial" de Aproximação e Espessura da Membrana

  • STORY.slab(t): segundo plano de corte global (mantém apenas z ≥ valor), na aproximação corta a cena em fatias de cerca de 50–100 nm de espessura, limpas como corte de microscópio eletrônico.
  • Membrana usa shell() para criar bicamada fechada com espessura (camada externa voltada para fora, interna para dentro, 5 nm), material capify, corte mostra faixa sólida colorida; eventos-chave (poro de fusão, fosseta de endocitose) colocados no plano de corte, câmera aproximadamente em vista superior, para que o contorno Ω seja visível.
  • Em visão distante, moléculas/íons são ampliados conforme distância da câmera (__camDist), com nota no rodapé "moléculas ampliadas em visão distante".

Duas Rotas de Geração (ver detalhes em references/two-routes.md)

  • Rota Rápida: Renderização em tempo real Three.js (com N8AO oclusão de ambiente), um vídeo de 49 segundos leva cerca de 15 minutos para gerar, para iteração e geração diária.
  • Rota Profissional: export_blender.mjs exporta cena → blender_build.py reconstrói no Blender, renderiza com Cycles path tracing → record.mjs --overlay-dir gera camada de interface web e sobrepõe. Localmente cerca de 17–20 segundos por quadro, para versão final de publicação.
  • Apenas uma tarefa Blender pode ser executada por vez; duas causam falta de memória e falha.

Estilo "Contas" em Nível Molecular (sem simplificar: usar estrutura real)

  • tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group chain]: converte estrutura atômica real em modelo de contas. Para proteínas de membrana adicionar --opm, usando orientação na membrana do banco OPM.
  • Topo da cena await fetch('./mol/*.json'), usar beadGeo() para gerar geometria. Contas acima do plano de corte são descartadas inteiramente, sem meia casca vazia.
  • Ao posicionar, fazer detecção de colisão entre contas para garantir zero intersecção; node tools/check.mjs site2 "story=..." verificar.
  • Contagem deve ser autoconsistente estequiometricamente (ex.: 1 O₂ corresponde a PSII absorver 4 fótons, PSI absorver 4 fótons, transferir 4 elétrons, 12 H⁺ entram no lúmen do tilacoide, gerar 2 NADPH, cerca de 2,6 ATP). Animações contínuas ilustrativas devem ser rotuladas separadamente como ILUSTRATIVO.

Princípios Morfológicos (sem simplificar)

  • Organelas modeladas conforme morfologia e proporções reais de microscopia eletrônica, não desenhadas como formas geométricas regulares. Tamanhos consultados primeiro em tabela (formato de references/morphology-acinar.md), depois codificados.
  • Atravessando três ordens de grandeza (célula 15 μm → ribossomo 25 nm) não escalona estruturas, mas aproxima a câmera continuamente (interpolação logarítmica da distância), eventos moleculares vistos em close.
  • Estruturas fechadas (grânulos, mitocôndrias, vacúolos condensados, núcleo) quando seccionadas mostram corte sólido (capify), sem casca vazia.

Princípios de Layout

  • Layout é original por tema, não copia vídeos de referência.
  • Estilo padrão é acadêmico escuro: título serifado, corpo de texto com frases originais do livro didático, uma cor de destaque (igual à cor do traçador).
  • Cada número que aparece na tela deve ter fonte. Não usar painéis falsos, contagens falsas, curvas falsas.
  • Citações e aviso de isenção permanecem no rodapé: Animação ilustrativa · Fora de escala real · Tempo comprimido · Fonte.

Exemplos Concluídos

  • thylakoid: Cloroplasto → grana → reações de luz na membrana do tilacoide, 9 estruturas proteicas reais (PSII-LHCII, b₆f, PSI, ATP sintase, LHCII, PC, Fd, FNR, Rubisco), versão web bench em inglês story=thylakoid-en, gerado por ambas as rotas rápida e profissional.
  • synapse: Sinapse glutamatérgica do hipocampo (varicosidades axonais → espinha dendrítica em cogumelo), escala real 1 unidade = 20 nm, potencial de ação → influxo de Ca²⁺ → fusão completa de vesícula única → ~4000 glutamato difundindo → abertura de AMPA, influxo de Na⁺ → captação por astrócito → endocitose dependente de clatrina e recarga. Versão web bench em inglês story=synapse-en, cerca de 50 segundos. Tabela de fatos e revisão em examples/synapse/.
  • secretion: Célula acinar pancreática de cobaia, processo completo de proteína secretora desde ribossomo livre até exocitose, cerca de 75 segundos, 9 etapas, incluindo timeline do experimento com ³H-leucina (3/17/117 min, dados de livro didático).

Habilidades Relacionadas