Kit de Qualidade Three.js — recursos, método, checklist
Este skill responde a uma pergunta: o que fez nossos vídeos Three.js passarem de 'primitivas empilhadas' para um filme com personagem rigado, cidade real e mise-en-scène limpa? Três coisas: recursos adicionados gradualmente, um método de trabalho e uma revisão sistemática. O skill irmão threejs-code-video contém os detalhes técnicos (pipeline, personagem, câmera, loops, armadilhas); este é a visão geral e o kit inicial.
Conteúdo
| Arquivo | Para que serve |
|---|---|
| references/ressources.md | Inventário completo: repositórios, skills, sites, ferramentas, serviços — o que cada um oferece, como instalar, licença |
| references/methode.md | O modo de fazer, passo a passo, e os 6 alavancas que realmente elevaram a qualidade |
| references/checklist.md | Checklist para marcar: instalação, antes de codificar, durante, antes de enviar |
scripts/install-kit.js | Instala os skills públicos do kit em um projeto (clone + cópia, sem dependência) |
scripts/planche.js | Vídeo → contato (1 imagem/s) para revisar uma renderização completa |
scripts/polyfork-fetch.js | Busca e baixa modelos Polyfork (módulos .mjs parametrizáveis) |
scripts/face-landmarks.py, scripts/face-measure.py | Medir um rosto em foto (MediaPipe) em vez de estimar a olho |
Os recursos em um minuto
| Necessidade | Recurso | Status em nosso projeto |
|---|---|---|
| Three.js atualizado (r186), R3F, shaders, luzes… | 13 skills threejs-* — CloudAI-X/threejs-skills | instalados, consultados a cada composição |
| Renderização de vídeo quadro a quadro | 8 skills Remotion — remotion-dev/skills | instalados |
| Método + template de vídeo em código | skill threejs-code-video + repositório Alex-sia99/threejs-code-video | escrito por nós, público |
| Objetos, cenários, personagens low-poly | Polyfork (polyfork.dev, índice lucas-martinic/polyfork-catalog) | usado no filme v3 — módulos .mjs nunca redistribuídos |
| Corpo animado | esqueleto e clipes Mixamo | corpo rigado do filme v3 |
| Semelhança a partir de foto | img2threejs/img2threejs + MediaPipe Face Landmarker | método 'medir, não estimar' adotado |
| Imagens de referência antes de modelar | Kie.ai nano-banana-2-lite | usado para proporções e cenários |
| Voz, efeitos, música | ElevenLabs, Suno, FFmpeg | pipeline completo |
| Desenho 2D em código (outro estilo) | alexgreensh/anidoodle, html-anime | instalados, fora do Three.js |
Detalhes, links e ressalvas: references/ressources.md.
O método em dez linhas
- Uma referência antes de tudo: vídeo de estilo analisado em contato, imagens de referência, foto medida.
- Os skills antes do código: carregar o skill
threejs-*ouremotion-*pertinente, nunca escrever a API de memória. - Estudar código bom, depois reescrever: ler um módulo bem feito, anotar o método, codificar o seu.
- Tudo é uma função pura do número do quadro: semente fixa, marcha por distância, nenhum estado acumulado.
- Script → voz → timeline: a mise-en-scène se ajusta às falas (
at("l14")), nunca em segundos fixos. - Um workshop por problema: composição
Labpara o rosto,RigLabpara o corpo, série de tentativas para uma dúvida. - Renderizar, assistir, corrigir: imagem fixa → contato por cena → vídeo final revisado a 1 imagem/s.
- Uma auditoria severa por um olhar novo antes de qualquer reformulação.
- Validação humana cedo: o personagem e a direção de estilo antes da renderização longa.
- Capitalizar: cada armadilha encontrada vai para
pitfalls.md, cada método em um skill.
Detalhes: references/methode.md.
Regras não negociáveis
- Nunca enviar uma renderização não assistida. Uma imagem fixa não basta para um filme: revisar o vídeo final em contato.
- O estilo prevalece sobre a precisão. Um rosto fotorrealista em um mundo estilizado foi rejeitado duas vezes; a semelhança passa pela forma e alguns traços nítidos.
- Respeitar as licenças. Polyfork: uso livre em vídeo, módulos
.mjse clipes cozidos nunca em um repositório público nem em um pacote. - Um traço = um volume, um lugar = um objeto reconhecível, uma fala = um visual que a mostra.
Transmitir o kit a um aluno
O kit está publicado no repositório https://github.com/Alex-sia99/threejs-quality-kit: basta enviar este link. O README se dirige ao aluno (pré-requisitos, instalação em 3 etapas, frases para dar ao seu agente); install.js baixa ele mesmo os skills públicos e o projeto inicial, então o repositório permanece leve e atualizado. Nunca adicionar módulos Polyfork .mjs, clipes anim-*.json, chave de API, foto ou voz pessoal.