Files
jhonny-editor/code/plugins/premiere-pro/skills/editar-por-voz/criterios/04-reanalise-do-material-restante.md
T
João Henrique a9e5b5ff58 feat: copiada a skill editar-por-voz e seus critérios para as skil
- copiada a skill editar-por-voz e seus critérios para as skills do projeto
- adaptada a skill editar-por-voz para usar o banco SQLite como fonte oficial
- corrigida a cópia do JSON do tipo de vídeo para priorizar clipboard Unicode
- criado carregador único do contexto de edição por voz a partir do SQLite
- criada entrada para registrar planos no SQLite e reaproveitar o mesmo plano na aplicação
- habilitado carregamento do plano editorial diretamente do SQLite na interface
- corrigido o bloqueio visual da etapa de carregamento do plano salvo
- configurado carregamento automático do plano salvo após selecionar a sequência
- documentada a sequência como raiz de retomada do fluxo de edição
- criada a estrutura local para análise de músicas instrumentais com Essentia

Resumo:
- 22 arquivos alterados
- 11 novos
- 11 modificados
- 0 removidos

 11 files changed, 270 insertions(+), 34 deletions(-)

Arquivos:
  - .jhonny/analises.db
  - CONTEXT.md
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/engine/README.md
  - code/engine/aplicar_plano_de_edicao.py
  - code/engine/integracoes/audio/__init__.py
  - code/engine/persistencia/consultas.py
  - code/engine/requirements-audio.txt
  - code/engine/testes/test_consultas_de_persistencia.py
  - code/tests/cep-tipos-video-encoding.test.ts
  - code/.jhonny/
  - code/engine/carregar_plano_de_edicao.py
  - code/engine/integracoes/audio/contratos.py
  - code/engine/integracoes/audio/modelos_de_analise_musical.py
  - code/engine/integracoes/audio/provider_de_analise_musical_essentia.py
  - code/engine/preparar_edicao_por_voz.py
  - code/engine/registrar_plano_de_edicao.py
  - code/engine/testes/test_analisador_de_musica_essentia.py
  - code/engine/testes/test_carregar_plano_de_edicao.py
  - code/engine/testes/test_registrar_plano_de_edicao.py
  - code/plugins/premiere-pro/skills/editar-por-voz/
2026-09-10 13:09:01 -04:00

2.9 KiB
Raw Blame History

04 — Reanálise do material que sobrou

Escopo: Renormalizar a ênfase sobre o que sobrou, antes de escolher zooms. Quando: Fase 4 — ver a ordem de trabalho em ../SKILL.md.

Não escolha zooms com os números da análise bruta.

O problema

Ênfase e energia são relativas ao conjunto analisado. Energia é normalizada contra o momento mais alto da gravação; ênfase deriva dela.

Se esse momento mais alto foi cortado — uma piada, um grito, uma conversa de bastidor — tudo que sobrou continua pontuado contra uma referência que o espectador nunca verá. As notas do corte final ficam artificialmente comprimidas, e o ranking aponta para as palavras erradas.

Caso real: o pico do vídeo era "Amor, eu tô intacto!" (energia 1,00), descartado na triagem. Todo o material restante estava sendo medido contra ele.

A solução

Depois de definir os cortes, renormalize sobre os sobreviventes. Solicite uma reanálise dos dados persistidos, passando a mídia e a lista de cortes que você já decidiu. Se essa operação não estiver disponível, recalcule somente a normalização necessária por um adaptador controlado e registre a nova versão em analises_versao:

refinar_linha_de_voz(media_path, cortes=[{start, end}, ...], min_gap=8.0)

Ela devolve, numa chamada só, a comparação bruto × sobreviventes, os picos re-ranqueados e os candidatos a zoom. É barata: renormaliza os números já medidos, sem reabrir o áudio.

Efeito medido no mesmo material:

Bruto Só o que sobrou
Ênfase média 0,179 0,197
"Aquela" 0,39 0,42
"mastopexia" 0,26 0,34
"devolver" — 0,35

"mastopexia" só virou candidata legítima depois da reanálise.

As janelas que ela propõe

A seção Zoom Candidates da resposta já vem com três coisas resolvidas:

  1. Pega a palavra de conteúdo mais enfática de cada frase. Artigos e conectivos são filtrados — um "a" falado alto continua sendo um artigo. Sem esse filtro, o ranking bruto apontava para "o", "a", "eu": picos de entrega, não de sentido.
  2. Estende a janela até o fim da frase, não do segmento (ver 05-zoom.md).
  3. Mantém distância mínima entre zooms.

São candidatos, não obrigações. Corte a lista pelo ritmo (07-ritmo.md). Os tempos continuam na mídia original — vão para as ações persistidas no plano e, depois da aprovação, para o adaptador de aplicação do Premiere.

max_zooms limita a lista, mas prefira cortá-la você mesmo: o corte por ritmo é decisão editorial, não um teto numérico.

Princípio geral

"Qual o momento mais forte da gravação?" e "qual o momento mais forte do vídeo final?" são perguntas diferentes sempre que a métrica for relativa.

Toda métrica normalizada precisa ser recalculada quando o conjunto muda — senão ela responde a pergunta errada, silenciosamente.