JohanDuran/estúdio-de-vídeo

Regras de edição

Siga estas regras sem perguntar novamente. Para saber quais ferramentas existem e como usá-las, leia video-toolkit.

0. Perfil e regras da casa

• Encontre o perfil do canal conforme video-toolkit §0: o studio.json mais próximo acima da pasta de trabalho, senão o canal padrão em ~/.video-studio/config.json. Não encontrou → ofereça /studio-setup.
• house_rules no perfil são as decisões pessoais do usuário (por exemplo "não mexer no áudio do microfone"). Elas substituem os padrões abaixo. Quando o usuário declarar uma nova preferência permanente, adicione-a a house_rules como uma linha curta com o motivo e a data, e informe que você a salvou.

1. Tudo deve ser gratuito

• DaVinci Resolve: edição gratuita, 21.0.x. Nunca sugira atualizar para 21.1 ou posterior: a versão 21.1 tornou o Python scripting exclusivo da versão Studio, o que quebra o Resolve MCP na edição gratuita.
  • Não proponha funcionalidades da API exclusivas da 21.1 (SetSpeed, AddTransition, SetFades, NormalizeAudioLevel, CreateMulticamClip, AutoAlignClips, blanking de saída). Ofereça uma alternativa (keyframes, Fusion, ffmpeg ou uma etapa manual na interface).
  • Não proponha funcionalidades exclusivas do Studio (Isolamento de Voz, Nivelador de Diálogo, redução de ruído temporal/espacial, Super Scale, Magic Mask) sem dizer que são exclusivas do Studio.
  • Se resolve.edition no perfil for studio, as funcionalidades Studio são aceitáveis; a trava da versão 21.0.x ainda se aplica apenas se o usuário depender da ponte integrada ao aplicativo.
• HyperFrames: apenas renderização local. Use a caixa de ferramentas render_hyperframes ou npx hyperframes render.
  • Nunca execute hyperframes cloud render, lambda, cloudrun ou hyperframes auth login.
  • Nunca use funcionalidades que consomem créditos HeyGen: TTS/vozes HeyGen, avatares, media-use resolve --type bgm|sfx (precisa da CLI heygen), ou geração de imagem/música/vídeo por IA que custe créditos. Use a caixa de ferramentas: speak para voz, sfx_search/sfx_generate para som, transcribe para transcrições.
  • Se uma etapa do fluxo de trabalho HyperFrames precisar de algum desses, pule-a ou use a alternativa gratuita e informe.
  • Não incentive o aplicativo desktop HyperFrames ou hyperframes open: o pipeline é Claude + renderização CLI + Resolve MCP. A pré-visualização web do Studio é aceitável para pequenos ajustes do próprio usuário.
• Outras ferramentas: prefira o que já está instalado (ffmpeg, Node, Docker). Não se inscreva ou conecte serviços pagos.
• Voz: Kokoro (local, Apache 2.0) via speak, com a voz e velocidade do perfil. Não use pesos de TTS não comerciais para vídeos do canal.
• Transcrição: WhisperX via caixa de ferramentas transcribe, não do Resolve ou HeyGen. Sem diarização de falantes, a menos que solicitado.
• SFX/música gerados: Stable Audio Open 1.0 via caixa de ferramentas sfx_generate (sua licença do Hugging Face é aceita durante /studio-setup).

2. Estrutura de pastas

<estudio>/
  sfx_library/       sons gerados compartilhados + index.jsonl (reutilizados entre vídeos e canais; toolbox.sfx_library)
  recordings/        gravações originais de qualquer fonte (recordings.folder padrão): somente leitura
  _scratch/          saídas da caixa de ferramentas sem pasta de projeto
  <canal>/           uma pasta por canal
    studio.json      perfil desse canal
    <NomeDoProjeto>/   uma pasta por vídeo, nomeada exatamente como o projeto no Resolve
      plan.md, script.json, short.json
      audio/           narração, mixes
      capture/         capturas de tela feitas para este vídeo
      transcripts/     transcrições por arquivo + <linha_do_tempo>.timeline.* (tempo da linha do tempo)
      timeline/        layouts de faixas capturados
      animations/      projetos e renders HyperFrames
      builds/, renders/, audio_preview/

Um estúdio de canal único pode manter studio.json e as pastas de projeto diretamente em <estudio>/; isso ainda funciona.

• Obtenha o nome do projeto do Resolve (project_manager get_current) quando um estiver aberto; caso contrário, combine com o usuário. Crie a pasta na primeira vez que for necessária.
• Nunca escreva arquivos de projeto na raiz do estúdio, na pasta de outro canal ou ao lado das gravações originais.

3. Gravações originais são somente leitura

• A pasta de gravações (recordings.folder) nunca é alterada: sem sobrescritas, exclusões, renomeações ou arquivos auxiliares. A mídia processada vai para a pasta do projeto como cópias e depois é trocada através do media pool.
• Use recordings.mic_audio_stream para transcrição. Se uma gravação tiver faixas de áudio extras (áudio da área de trabalho, uma duplicata do microfone), aponte isso e não as remova ou silencie sem perguntar.

4. Não altere a menos que solicitado

• Áudio: não equalize, reduza ruído, comprima ou normalize a voz do usuário a menos que ele peça.
• Imagem: não corrija cor ou nitidez a menos que ele peça.

5. Como trabalhar

• Pré-visualize antes de aplicar: para mudanças de áudio/visuais, renderize uma amostra curta de antes/depois em <projeto>/audio_preview/ (ou similar) e deixe o usuário decidir.
• Proponha, depois aplique: mostre cortes propostos, pontos de gatilho e posicionamentos de sobreposição antes de modificar a linha do tempo.
• Sobreposições → Resolve: construa projetos HyperFrames em <projeto>/animations/, renderize como mov (com canal alfa) na taxa de quadros da linha do tempo, importe e coloque em uma faixa de vídeo vazia. Se outra sessão puder estar trabalhando em animations/, construa sobreposições avulsas como seu próprio projeto HyperFrames em uma pasta irmã.
• Zonas seguras para o rosto: quando houver imagem de câmera, meça onde o rosto está (quadros de referência com ffmpeg) antes de posicionar cartões; nunca cubra o rosto.
• Privacidade: nunca mostre nada de channel.never_show. Capturas de tela registram o que estava na tela — verifique cada corte no primeiro e no último quadro.
• Biblioteca de sons: pesquise antes de gerar, registre as decisões do usuário com sfx_mark, nunca exclua arquivos da biblioteca (incluindo os rejeitados). Coloque as seleções em uma faixa de áudio vazia, nunca na Áudio 1.