HyperFrames
Use esta habilidade quando o usuário pedir ao Parsifal para criar um vídeo com HyperFrames, como um vídeo vertical de 30 segundos, uma introdução curta, um micro-trailer cinematográfico, uma promoção de produto, legendas animadas, visuais técnicos no estilo HUD, uma conversão de site para vídeo ou uma renderização de motion graphics com HTML/CSS/JS.
O HyperFrames trata o HTML como a fonte de verdade do vídeo. Construa cenas de vídeo como composições HTML com layout CSS e animação JavaScript, valide o layout e renderize o resultado para MP4.
Configuração
Se o HyperFrames não estiver instalado ou a habilidade oficial estiver faltando, instale-a primeiro:
parsifal skills install official/creative/hyperframes
Use npx hyperframes para operações do projeto. O HyperFrames requer Node.js e FFmpeg. Se a renderização ou a pré-visualização falhar, execute:
npx hyperframes doctor
Fluxo de trabalho
- Converta a solicitação do usuário em um breve resumo de produção: duração, proporção de tela, plataforma de destino, idioma, estilo, necessidade de música ou narração e caminho de saída final.
- Para resumos incompletos, use valores padrão razoáveis. Use 1080x1920 para vídeo vertical curto, 1920x1080 para vídeo horizontal, 30 fps e saída MP4.
- Crie ou reutilize um projeto HyperFrames:
npx hyperframes init my-video --non-interactive
- Escreva a composição em HTML/CSS/JS. Certifique-se de que o layout do quadro hero estático esteja correto antes de adicionar animação.
- Valide antes de renderizar:
npx hyperframes lint
npx hyperframes inspect --samples 15
- Pré-visualize quando for útil:
npx hyperframes preview
- Renderize o vídeo final:
npx hyperframes render --output final.mp4 --quality standard
Use --quality draft para iterações rápidas e --quality high para entrega final quando o usuário solicitar uma exportação refinada.
Regras de composição
- Use um elemento raiz com
data-composition-id,data-widthedata-height. - Use
data-start,data-durationedata-track-indexpara clipes temporizados. - Registre timelines GSAP de forma síncrona em
window.__timelines. - Use CSS como estado final do layout e anime a partir ou para esse estado.
- Mantenha a reprodução de mídia sob o runtime do HyperFrames. Não chame manualmente
play(),pause()ou posicione a mídia. - Evite lógica de animação não determinística, como
Math.random()ouDate.now(), a menos que use um gerador com semente. - Não use repetições infinitas. Calcule contagens de repetições finitas a partir da duração da composição.
- Verifique se texto, legendas, painéis de interface e elementos HUD permanecem dentro do quadro em cada timestamp inspecionado.
Entrega
Ao finalizar, informe ao usuário:
- o caminho do MP4 renderizado;
- a URL de pré-visualização se um servidor de pré-visualização estiver em execução;
- quaisquer suposições feitas sobre duração, proporção de tela, estilo, narração ou música;
- quaisquer problemas de validação que permaneçam não resolvidos.
Não pare após escrever o HTML. Uma tarefa do HyperFrames só é concluída após a composição ter sido verificada com lint e inspect, e renderizada para MP4, a menos que o usuário peça explicitamente apenas os arquivos fonte.