O que Pulupulu Motion faz?
Um filme aqui é uma linha do tempo em HTML que o Chrome renderiza frame a frame. Nada é um editor de vídeo: você escreve uma página, o CLI captura a tela em uma taxa de quadros fixa, e o ffmpeg muxa o som.
Este arquivo é o roteador. Ele responde: posso fazer este trabalho, o que executo primeiro, o que precisa passar e qual página tem os detalhes. Carregue uma página de referência apenas para a parte em que você está trabalhando.
1. Antes de prometer algo
python scripts/doctor.py # somente leitura: python, node, ffmpeg, o CLI, chave, disco
python scripts/doctor.py --project film/ # também: o contrato da página está presente
Código de saída 1 significa que um filme não pode ser feito nesta máquina. Não descubra isso depois de escrever cenas. Nunca chame
npx por comando: uma viagem de ida e volta na rede a cada check, still e render é a desaceleração autoinfligida
mais comum neste fluxo de trabalho.
Esta ferramenta é a escolha errada quando a história precisa de filmagem que ela não possui, do rosto ou semelhança de uma pessoa real, anatomia humana ou animal articulada, uma ação física realizada de forma contínua ou sincronia labial. Ela renderiza bem geometria vetorial plana, tipo, gráficos, mapas, ícones e objetos coloridos, e essas outras coisas mal. Diga isso em vez de produzir uma imitação: um substituto desenhado para material de arquivo é um problema de proveniência, não uma escolha de estilo.
2. O fluxo de trabalho, em ordem
Um batida = uma frase = um plano. O tempo vem da fala medida, nunca da invenção.
- Briefing. Assunto, público, plataforma, idioma, se há narração. Pergunte por um assunto ausente; não pergunte se deve narrar quando um vídeo foi solicitado.
- Storyboard antes do HTML —
references/narration-and-captions.md. A legenda são as palavras faladas verbatim, não um resumo delas. - Narrar e medir.
python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, depoisgatepara verificar cada frase por ASR. Roteiro, vozes e limites:references/narration/deepseek-tts.md. - Construir a página a partir de
timeline.json, não do storyboard. Contrato:references/cli.md. Quando a história precisa de objetos que nenhuma biblioteca de ícones carrega, gere-os primeiro como painéis de impressão —references/generated-assets.md— e monte-os; nunca desenhe à mão um substituto para uma fotografia. - Verificar, depois olhar.
pulupulu check ., depoispulupulu still . --at 2,12,24 --out .om/stillse abra os stills. Uma página que passa nocheckainda pode renderizar em branco. - Renderizar —
pulupulu render . --format mp4 --fps 30. Travamentos, quadros pretos e comprimentos errados:references/render-traps.md. - Mixar e muxar com mapeamento de stream explícito —
scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4muxa e valida em uma única chamada. Receita manual e a cadeia de ducking:references/workflow.md. - Validar o arquivo que você entregará, não a saída mais recente do renderizador:
python scripts/deliver_check.py out/film.mp4 --timeline timeline.json. - Entregar com ressalvas honestas: o que foi desenhado em vez de originado, e o que a nota de QA diz.
3. Portões (Gates)
Apenas estes bloqueiam. Tudo o mais que uma ferramenta imprime é uma nota de leitura: responda com um argumento ou corrija, mas nunca relate como aprovado quando não foi.
| portão | comando | o que prova | se falhar |
|---|---|---|---|
| preflight | python scripts/doctor.py | a máquina pode renderizar | pare, reporte o que está faltando |
| composição | pulupulu check . | contrato da página, nenhum arquivo ausente | corrija antes de renderizar |
| idioma | python scripts/lang-audit.py film/index.html --lang en | nenhum texto no outro idioma, incluindo literais de string dentro de <script> | traduza o literal, execute novamente |
| fala | python scripts/deepseek_voice.py gate beats.json --voice stella | toda frase é transcrita de volta para suas próprias palavras | reescreva a frase; nunca envie um fragmento |
| arquivo | python scripts/deliver_check.py out/film.mp4 --timeline timeline.json (ou --video/--audio/--out para muxar primeiro) | tamanho do quadro, taxa de quadros, áudio presente e longo o suficiente, pico verdadeiro, tamanho de entrega | remuxe ou recodifique |
| pops | pulupulu qa out/film.mp4 | sem pops de quadro único | encontre o elemento de um quadro |
pulupulu qa também relata movimento por segundo, still por ≥ 1 s e abertura plana. Esses são julgamentos
sobre ritmo, medidos em uma comparação em escala de cinza 96×54, então um movimento lento de baixo contraste pode ser lido como parado. Use-os
como motivo para olhar, não como veredito a ser obedecido.
O que nenhum portão prova: que o filme é bom, que o ASR ouviu o número correto (verifique dígitos e substantivos próprios como tokens), ou que uma legenda está onde a interface de uma plataforma não a cobrirá.
4. Armadilhas que custam uma renderização
Detalhes completos e correções em references/render-traps.md. As que param uma renderização completamente:
<g>/<rect>/<path>brutos escritos dentro de um<div>não renderizam nada e não avisam nada. Envolva cada fragmento de cena em seu próprio<svg viewBox>.- Uma webfont dentro de
<text>SVG inline re-rasteriza essa camada a cada quadro. Coloque texto em HTML, ou desenhe-o como formas. feTurbulencecomo um filtro por quadro — SVG inline ou um fundo CSS — trava o renderizador. Cozinhe o ruído em um tile PNG uma vez.- Uma escala GSAP de quadro inteiro em um SVG inline re-rasteriza a placa; translate compõe bem, e uma camada de bitmap pode ser dimensionada. Quando um push é impossível, anime pequenos grupos internos.
repeat: -1torna a linha do tempo infinita: um filme de 87 s silenciosamente se torna 117 s. Compute voltas finitas.- Após uma renderização falha, mate apenas o Chrome headless que ela deixou para trás.
taskkill //IM chrome.exefecha o navegador do próprio usuário.
5. Onde os detalhes vivem
| trabalhando em | página |
|---|---|
| comandos, contrato da página, instalação | references/cli.md |
| os nove passos, contrato do projeto, mux | references/workflow.md |
| storyboard, legendas, portão de idioma único | references/narration-and-captions.md |
| paleta, orçamento de elementos, personalidade, ritmo | references/design-taste.md |
| linguagens de movimento, técnicas, camada 3D | references/motion-library.md |
| punch-up, demonstração de produto, talking head, gramáticas | references/workflows-specialized.md |
| mundos musicais, compositor, sfx, síntese de narração | references/audio-and-music.md, references/narration/deepseek-tts.md |
| uma renderização em branco, travada ou com comprimento errado | references/render-traps.md |
| o que verificar e em que ordem | references/verification.md |
| receitas de estilo, linguagem de câmera | references/art-motion/INDEX.md |
| como obter ícones e vetores, licenças | references/asset-sourcing.md |
| arte gerada por um modelo de imagem, recorte de impressões, montagem | references/generated-assets.md |
| artesanato vetorial plano, mundos de rolagem | references/2d-vector-motion.md |
| quais assuntos este renderizador pode carregar | references/topic-fit.md |
| tempo e easing em nível de submilissegundo | references/ui-motion/ |
| publicar esta skill (um commit, v1.0) | references/publishing-skills.md, references/publishing.md |
A rota de receitas de estilo (scripts/art-motion/engine/) tem 20 MB de runtime vendido que deliberadamente não está
neste repositório: uma skill não deve fazer cada agente buscar um motor que talvez nunca use, e uma árvore de 37 MB
não pode ser revisada. Ele instala fixado e verificado por checksum, nos caminhos exatos que as páginas acima citam:
python scripts/install_art_motion.py --check # está lá?
python scripts/install_art_motion.py # núcleo: lib + demos + cenas, 20 MB
python scripts/install_art_motion.py --with-reference-films # + material de estudo, mais 14 MB
Todo o resto — os portões Python, as especificações de clipe, a documentação — está no repositório e não precisa de
instalação. Nunca commit a árvore buscada de volta: .gitignore já a cobre.
6. Scripts
| script | faz |
|---|---|
scripts/doctor.py | preflight, somente leitura |
scripts/deepseek_voice.py | probe · speak · cost · lay · beats · asr · gate — narração e sua linha do tempo medida |
scripts/deliver_check.py | valida o arquivo entregue: tamanho, taxa, áudio, pico, duração em relação à linha do tempo |
scripts/lang-audit.py | portão de idioma único sobre marcação e literais de script |
scripts/art-motion/icon_audit.py | famílias de ícones, contagem de cores, folha de contato |
scripts/art-motion/qa.py | heurísticas de ritmo e pop em um arquivo renderizado |
scripts/stamp_credit.py | adiciona a linha por Alucard0x1 a arquivos de texto |
7. Trabalhando com uma pessoa
Mostre quadros, não adjetivos. Um quadro herói por ato mata uma semana de trabalho errado. Quando eles te corrigirem, coloque a correção nesta skill em vez de em uma resposta de chat.
Transferências: tempo de narração e prosódia → skill tts-intonation · mesclar ou traduzir outra
biblioteca → skill agent-skill-sourcing · direitos e semelhança antes de publicar → skill
media-content-safety · obter um vídeo de referência → skill streaming-mirror-extraction ·
planos 3D ou baseados em filmagem → skills headless-three-video-render e cinetic · filmes
prioritariamente tipográficos → skill kinetic-typography.