JohanDuran/video-studio

/edit-recording — edição longa

Alvo: $ARGUMENTS (um nome de projeto do Resolve, um arquivo de gravação ou vazio = o projeto aberto no Resolve).

Antes de tudo: leia o perfil (video-toolkit §0) e siga as regras-de-edição — a pasta de gravações é somente leitura, sem processamento de áudio/imagem a menos que solicitado, proponha antes de aplicar. Verifique o toolbox_status, e que o MCP do Resolve responda project_manager get_current (edição gratuita: o usuário deve executar Workspace → Scripts → Utility → resolve_bridge com o projeto aberto).

Pasta do projeto: <pasta do canal>/<ProjetoResolve>/ (video-toolkit §0).

Planeje primeiro. Se plan.md na pasta do projeto tiver Status: approved, siga-o: seu objetivo, quais partes manter, quais sobreposições, gráficos, B-roll e sons adicionar, e com qual ferramenta. Sem um plano aprovado, as etapas 1–3 (ler a linha do tempo, transcrever, propor cortes) são aceitáveis porque não alteram nada e informam o plano. Mas antes de adicionar sobreposições, novas filmagens, cenas do Blender, uma nova gravação de tela ou SFX, execute o skill plan: a gravação é o "o que já existe", e o plano decide o que cada parte precisa. Nunca grave nova filmagem de tela a menos que o plano solicite.

Etapas

1. Obter a linha do tempo — projeto atual + linha do tempo do Resolve. Se ainda não houver projeto, crie um a partir das gravações: defina o fps da linha do tempo (recordings.fps / resolve.timeline_fps) e a resolução antes de importar, depois peça ao usuário para definir a taxa de quadros de Reprodução para corresponder (a API não consegue). Importe o(s) arquivo(s) de tela e, se recordings.separate_camera_file, os arquivos de câmera (recordings.camera_file_pattern).
2. Capturar o layout — leia os itens da linha do tempo (Áudio 1 = a faixa de voz) em timeline/<timeline>.audio1.json. Uma sessão pode abranger vários arquivos que o Áudio 1 reproduz consecutivamente; observe cada arquivo de origem que ele usa. Se houver faixas de áudio extras do gravador (áudio da área de trabalho, um microfone duplicado) na linha do tempo, aponte-as e deixe-as.
3. Transcrever — transcreva cada arquivo de origem que o Áudio 1 usa (mic = recordings.mic_audio_stream, vocab do perfil) em transcripts/, depois timeline_transcript → <timeline>.timeline.json/.srt/.txt no tempo da linha do tempo. Execute novamente após qualquer edição que mova ou corte o Áudio 1.
4. Propor cortes — palavras de preenchimento, pausas longas, falsos inícios e retomadas, com timecodes da linha do tempo e as palavras ao redor de cada corte, em uma tabela. Aguarde a aprovação do usuário (todos, alguns ou ajustados).
5. Aplicar cortes — de forma não destrutiva no Resolve (em uma linha do tempo duplicada, ex. <timeline>_corte), depois leia os itens de volta e verifique se há lacunas/sobreposições. Execute novamente a timeline_transcript da etapa 3 na nova linha do tempo.
6. Sobreposições — proponha cartões (títulos, chamadas, terços inferiores, inscreva-se) ancorados a palavras faladas. Meça as zonas seguras para rosto dos clipes de câmera primeiro. Construa um projeto HyperFrames em animations/ (use os skills hyperframes; apenas renderização local), renderize mov com alfa no fps da linha do tempo via render_hyperframes, importe e coloque cada um em uma faixa de vídeo vazia no quadro de gravação da palavra. Cartões sobrepostos vão em faixas separadas. Leia de volta e compare.
7. Som — SFX para sobreposições: sfx_search primeiro, depois sfx_generate; usuário ouve; sfx_mark os veredictos. Pré-misture os sinais de cada sobreposição em um WAV com ffmpeg (a API ignora o volume do clipe) e coloque-o em uma faixa de áudio vazia, nunca no Áudio 1.
8. Renderizar — render prepare_delivery_job (YouTube 1080p/4K no fps da linha do tempo) em <project>/renders/, start, verify_output. Verifique o volume no resultado.

Pronto = uma renderização aprovada em <project>/renders/, com transcrições e projetos de sobreposição mantidos para alterações posteriores.