Papercut QA (Garantia de Qualidade Papercut)
Compara stills quanto ao estilo, não ao conteúdo, contra o Style DNA e o storyboard. Execute por cena durante a construção e uma vez no rolo inteiro antes da renderização final.
Pré-voo
- Instalação: Padrão ou Completa. Os stills precisam de um projeto estruturado com Remotion, e as folhas de contato precisam de Python com numpy e Pillow (
$MOTION_PY). Peças faltando:./install.sh --doctor, depoismotion-setup. - Um projeto
kyframnão precisa de Remotion: invoque o skillkyframantes de inspecionar ou corrigir a saída de uma cena Kyfram. Oqa.shextrai seus stills dos segmentos de cena em cache (core/tools/kyfram_qa.py), então renderize uma vez comcore/tools/render.shantes do QA. Tudo abaixo se aplica sem alterações. - Biblioteca:
$MOTION_LIB, ou a linhaMOTION_LIB=em~/.config/motion-explainer/config.env, ou pergunte uma vez. - Leia primeiro: Style DNA em
$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.mdseção 2, e a folha de fundostyle/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Cada imagem custa cerca de 0,7-1,5k tokens, então abra apenas o que a etapa precisa. - Para densidade,
$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md("Estatísticas de ritmo" no final): as cenas duram em média 2,8 s, 2-4 eventos visuais discretos por cena, um a cada 0,4-0,8 s em uma palavra tônica, uma nova página de legenda a cada 0,6 s. Copie a densidade, não o conteúdo.
1. Renderizar stills
A partir da pasta video/ do projeto:
$MOTION_LIB/core/tools/qa.sh NOME DE-ATE ENESIMO [ESCALA=0.3] [COLUNAS=9]
- Use 4-6 timestamps por verificação. Para uma cena, ENESIMO é aproximadamente sua duração em quadros dividida por 4. Deixe
DE-ATEde fora para o rolo inteiro e aumente ENESIMO. - A saída é
out/qa/NOME_0.jpg(e_1,_2para intervalos mais longos), no máximo 45 quadros por folha. Leia a folha; mantenha as folhas pequenas. - Um comando de QA por cena e nunca duas renderizações ao mesmo tempo. Mantenha as correções em duas rodadas por cena.
- Verifique contra o storyboard: o quadro 0 da cena, seus eventos-chave em suas palavras, nada cortado, nada cobrindo o banner ou as faixas de legenda.
2. Lista de Verificação
- Cada objeto parece de papel: granulação, borda irregular, sombra projetada, sombreamento de peças empilhadas, sem contornos ou gradientes.
- A câmera do mundo se move suavemente. Apenas o banner e os rótulos tremem (gradual, sutil).
- O banner está fixo em posição e colado, 3-7 palavras, um fato cada, nunca repete o narrador. Os banners sozinhos se leem como uma ficha de fatos.
- Cada cenário ilustra uma palavra concreta em sua linha de narrador, números são adereços físicos, e há um cenário de retorno antes do CTA.
- Cada número e rótulo de interface remete à lista de fatos. O roteiro tem pelo menos uma limitação honesta e uma pilha de recursos de exatamente três.
- Legendas: uma etiqueta por palavra, inclinada, aparecendo no início, páginas de 1-3, na faixa de 68-80%, nunca sobre um rosto.
- Saturação apenas em personagens, legendas e sinais.
- Um evento visual em cada palavra tônica, com movimento ambiente sempre em andamento.
- Cortes em mudanças de banner (cenários 1,5-3 s em tours e notícias, até 5 s em um ritmo metafórico), 20% inferiores limpos.
- O bloco HOOK (SAY / WRITE / SHOW / ALIGN) está na tela exatamente como escrito: o quadro 0 mostra o momento SHOW em ação com o título WRITE sobre ele, e a primeira linha do narrador é SAY.
- Cada cena tem um movimento de câmera, no máximo uma virada de página ou rasgo, um puxão de fita ou chicotada para o CTA, e cada transição tem seu efeito sonoro.
- Passagem de humor visível na tela: um formato em todo o rolo, um adereço de figurino por ideia, um ritmo de luta, o adereço do quadro 0 retorna modificado no cenário do CTA, e cada piada é entendida em menos de 1 s e nunca cobre o banner, as legendas ou o número-chave.
- Vocabulário no narrador e banners corresponde ao nível do público em
SERIES.md. - Narrador, legendas e eventos estão sincronizados (percorra o Studio em cada corte).
Para um item reprovado, corrija o arquivo da cena (ou o kit na biblioteca, nunca src/lib/ no projeto) e execute novamente a cena. Reconstrua uma cena com motion-build.
3. Entrega
Abra a pré-visualização do Studio, liste as cenas com durações e diga o que é provisório: narrador, música, efeitos sonoros, assets. Se o narrador for provisório, diga como regravá-lo (motion-voice). Após a postagem, os números vão para motion-strategy para a autópsia.
Verificação de Princípios
Percorra uma cena a 5 qps e verifique contra $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: antecipação antes de cada grande movimento (2), tudo suavizado (6), algo que se arrasta após impactos (5), um adereço focal (3), um ritmo exagerado (10), sombreamento empilhado e uma sombra consistente (11).
Hand-off (Passagem)
As correções voltam para motion-build (cena ou som) ou motion-voice (sincronização). Uma passagem limpa encerra o rolo: renderize com $MOTION_LIB/core/tools/render.sh quando o usuário pedir.