Renderização de vídeo longo
Estágio 9 do fluxo de trabalho de vídeo longo. Saída: renders de revisão (baixa qualidade) até o usuário aprovar, depois um vídeo final em alta qualidade.
Uma cena significa um clipe do roteiro, numerado em ordem ao longo do vídeo, como nas etapas anteriores. Os números de cena são embutidos no vídeo de revisão, para que o revisor possa apontar para eles.
Antes de começar
- Encontre o projeto em
~/.long-video/projects/<slug>/. É necessário quevideo-script.mdexista comstatus: approved. - Carregue a configuração do projeto: resolução, proporção de aspecto, modo de legendas (
visuals.captions), necessidades de loudness, plataforma. - Verifique ffmpeg e ffprobe (
ffmpeg -version). O renderizador incluso precisa de ffmpeg com libx264 e libass. - Se
render/já existir, pergunte: continuar (liste as versões) ou reiniciar.
Etapa 1: Inventário
Verifique cada cena e liste o que existe:
| Item | Onde | Usado como |
|---|---|---|
| Clipe de vídeo | clips/scene-<NNN>_clip.* (ou _take2 e posteriores, o que o usuário aprovou) | A imagem da cena |
| Apenas imagens | frames/scene-<NNN>_start.* | Um still com movimento de câmera do roteiro (push-in, pull-out, pan) |
| Voz | audio/lines/scene-<NNN>_<speaker>_<NN>.* | Narração e diálogo |
| Trilhas sonoras | sound/mix/sfx_track.wav, amb_track.wav, music_track.wav | Efeitos, ambiente, música |
Relate as lacunas em uma tabela curta. Uma cena sem clipe e sem imagem é um bloqueador: liste essas cenas e ofereça voltar para long-video-keyframes ou long-video-clips. Voz ou som faltando são permitidos apenas se o usuário optou por pular essas etapas. Se uma etapa foi pulada, não peça novamente.
Se a etapa de clipes foi pulada (clips_mode: images-only), toda cena se torna um still com movimento de câmera extraído do roteiro.
Etapa 2: Escolha a ferramenta de montagem
- Verifique se há um editor de vídeo que Claude possa usar: um servidor MCP de edição conectado nesta sessão, ou uma CLI no dispositivo (FilmCraft:
filmcraft-cli commands; EffectCraft:effectcraft-cli --help). Consulte../long-video-sound/references/tools.md, seção 5. - Se houver um disponível, pergunte: usar (o usuário pode abrir o projeto e ajustá-lo) ou usar o renderizador incluso. Padrão: renderizador incluso. Se o usuário escolher o editor, leia sua lista de comandos e documentação primeiro, trabalhe em uma cópia, peça permissão antes de instalar ou compilar qualquer coisa e mantenha os mesmos nomes de arquivo.
- Diga qual ferramenta será usada.
O restante desta skill descreve o renderizador incluso. Com um editor, faça os mesmos passos através de seus comandos e exporte os arquivos de revisão e final para as mesmas pastas e nomes.
Etapa 3: Construir a lista de edição
Leia references/edl-format.md. Escreva render/edl.json a partir dos arquivos do projeto:
- uma entrada por cena com sua duração (do roteiro, ou o comprimento real do clipe quando menor ou maior dentro da duração da cena), origem da imagem, movimento de câmera para stills e transição de saída,
- posicionamentos de voz: o tempo de início da cena mais um pequeno offset (0,3 s por padrão), linhas em ordem com pequenas lacunas,
- as trilhas sonoras,
- legendas a partir do texto da voz (início e fim da duração de cada arquivo de voz), se a configuração pedir legendas,
- largura, altura e fps da configuração. O fps padrão é 24. O alvo de loudness padrão é -14 LUFS com pico verdadeiro abaixo de -1,5 dBTP.
Regras:
- Use as durações exatas das cenas do roteiro aprovado. Não estique ou encurte a história para caber.
- Um clipe mais longo que sua cena é cortado do final. Um clipe mais curto que sua cena mantém seu último quadro. Relate ambos.
- Uma linha de voz que ultrapassa o final da cena, ou o final do vídeo, é relatada como um aviso.
- Transições:
cutpor padrão.fade(escurecimento) apenas onde o roteiro diz. Cross-dissolves precisam de uma ferramenta de editor. - Verifique o plano antes de renderizar:
node <pasta da skill>/scripts/build-render.mjs render/edl.json review render/review --plan.
Mostre um resumo curto: número de cenas, tempo total de execução contra o alvo, clipes versus stills, avisos. Corrija problemas que podem ser corrigidos sem mudar a história. Pergunte ao usuário sobre qualquer coisa que não possa.
Etapa 4: Renderizar a versão de revisão
Qualidade de revisão: baixa resolução (cerca de 360p), alta compressão, número de cena e tempo embutidos no canto superior esquerdo e legendas se a configuração usar legendas embutidas.
node <pasta da skill>/scripts/build-render.mjs render/edl.json review render/review --version 1
- Saída:
render/review/<slug>_review_v1.mp4, mais um.report.jsoncom duração, tamanho e loudness. - Segmentos de cena são armazenados em cache. Revisões posteriores re-renderizam apenas as cenas alteradas, portanto são muito mais rápidas.
- Para vídeos com mais de alguns minutos, execute o comando em segundo plano e aguarde sua conclusão. Não faça polling.
- Se o modo de legendas for
srt, um arquivo.srté escrito ao lado do vídeo.
Verifique o relatório: duração real versus a planejada, loudness, streams. Em seguida, informe ao usuário o caminho completo e o tamanho.
Diga como revisar: assista ao arquivo, anote o número da cena e o tempo mostrados no canto com cada comentário. Claude não envia ou faz upload do arquivo. O usuário o compartilha com o cliente. Ofereça-se para preparar um upload apenas se o usuário pedir, e pergunte primeiro.
Etapa 5: Coletar alterações
Pergunte: "Alguma alteração? Se estiver finalizado, diga e eu renderizarei a versão de alta qualidade."
O usuário pode colar o feedback do cliente. Leia references/review-feedback.md. Para cada comentário:
- Encontre o número da cena ou o tempo ao qual ele se refere. Se o comentário for vago, faça uma pergunta curta.
- Classifique-o e escolha a rota:
- Nível de edição (corte, duração, ordem, texto da legenda, legendas ativadas ou desativadas, transição, níveis de voz, música ou efeitos): corrija aqui no
edl.jsonou no ganho das trilhas. - Imagem de uma cena (aparência, personagem, composição, movimento): volte para
long-video-keyframesoulong-video-clipspara essas cenas. Novos arquivos recebem nomes com estilo_take2. Em seguida, atualize a lista de edição. - Linha de voz (entrega, pronúncia, redação):
long-video-voicepara essas linhas. Uma alteração de redação no roteiro aprovado precisa da aprovação do usuário e de uma revisão do roteiro. - Som (efeito, ambiente, música):
long-video-soundpara essas pistas, depois mixe novamente. - História ou estrutura (adicionar ou remover cenas):
long-video-director, depois refaça apenas as cenas afetadas a jusante.
- Nível de edição (corte, duração, ordem, texto da legenda, legendas ativadas ou desativadas, transição, níveis de voz, música ou efeitos): corrija aqui no
- Escreva a lista em
render/review-log.mdcom a versão, cena, solicitação, rota e status. - Mostre ao usuário o plano em uma tabela curta. Peça um sim antes de qualquer regeneração que custe créditos ou tempo.
- Aplique as alterações, depois renderize a próxima revisão (
--version 2, e assim por diante). Mantenha todos os arquivos de revisão anteriores. - Informe ao usuário o que mudou, cena por cena, e o novo caminho do arquivo.
Repita até o usuário aprovar. Silêncio ou "parece bom até agora" não é aprovação.
Etapa 6: Renderizar o vídeo final
Somente após o usuário dizer explicitamente que uma versão de revisão específica é final.
- Confirme: "Renderizar o final a partir da revisão v?" Verifique se a lista de edição corresponde a essa versão e se nenhuma solicitação de alteração ainda está aberta no registro de revisão.
- Qualidade final: resolução da configuração, H.264 de alta qualidade (crf 18, preset lento), AAC 192k, normalização de loudness em duas passagens para o alvo, sem rótulos de revisão. Legendas são embutidas apenas se a configuração disser "burned-in". Caso contrário, um arquivo
.srté escrito. - Execute, em segundo plano para vídeos longos:
node <pasta da skill>/scripts/build-render.mjs render/edl.json final render/final
- Verifique com o relatório e
ffprobe: duração corresponde ao plano, resolução e fps estão corretos, há um fluxo de vídeo e um de áudio, loudness está próximo do alvo (dentro de cerca de 1 LU) e o pico verdadeiro está abaixo de -1 dBFS. - Opcionalmente, verifique se há quadros pretos inesperados e silêncio longo:
ffmpeg -i ARQUIVO -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. Relate as descobertas. - Atualize
project.json:"stage": "final-rendered","final_video": "<caminho>"e a versão de revisão aprovada. - Informe ao usuário o caminho completo, tamanho e duração. Lembre-o dos créditos em
sound/credits.mdpara a descrição do vídeo. - Ofereça-se para continuar com
long-video-publish(opções de título do YouTube, descrição, tags e prompt de miniatura). Inicie apenas se o usuário concordar. Não publique ou faça upload. Não inicie nenhum outro estágio posterior, a menos que o usuário peça e esse estágio exista.
Regras
- Nunca renderize o final sem uma aprovação explícita de uma versão de revisão específica.
- Nunca altere o roteiro aprovado. Se o feedback precisar, direcione-o e pergunte.
- Nunca envie, compartilhe ou faça upload de um vídeo sem uma solicitação clara do usuário.
- Nunca exclua renders de revisão anteriores.
- Nunca regenere imagens, clipes, voz ou som sem o sim do usuário no plano.
- Mantenha as mensagens de chat curtas. Coloque a lista de alterações em
render/review-log.md.