feat: Instalado essentia-tensorflow no venv whisperx-transcricao (

- Instalado essentia-tensorflow no venv whisperx-transcricao (usado pelo painel CEP), corrigindo erro "A classificação musical precisa do suporte TensorFlow do Essentia" no catálogo de trilhas.
- Ligada a classificação de emoção da fala (ProviderDeEmocaoHuggingFace) ao scanner via nova flag `classificar_emocao`, e adicionado emoção/confiança como critério de desempate secundário no zoom da skill editar-por-voz.
- Zoom do caminho Python (aplicar_plano_de_edicao.py) passou a usar adjustment layer numa faixa de vídeo própria, em vez de escalar o clipe inteiro via set_clip_properties — mesma técnica já usada pelo executor .mjs do painel CEP.
- Adicionado campo "Carregar por ID" na aba Editar Vídeo do painel CEP (step 2), para carregar um plano do SQLite direto pelo plano_id quando ele não está associado a nenhum video_id conhecido (ex.: plano de um vídeo que este banco nunca escaneou).
- Trocado o campo de ID numérico por uma lista suspensa (novo listar_planos_de_edicao.py + RepositorioDePlanos.listar_todos_os_planos) que mostra data/hora e a intenção registrada pela skill em cada plano salvo, para escolher sem decorar o id.

Resumo:
- 15 arquivos alterados
- 2 novos
- 13 modificados
- 0 removidos

 13 files changed, 451 insertions(+), 65 deletions(-)

Arquivos:
  - .jhonny/analises.db
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/engine/editor/aplicador_de_plano_de_edicao.py
  - code/engine/editor/escrita/escrita_no_editor.py
  - code/engine/executar_scanner.py
  - code/engine/persistencia/repositorio_de_planos.py
  - code/engine/scanner/configuracao_visual.py
  - code/engine/testes/duplos_de_premiere.py
  - code/engine/testes/test_aplicador_de_plano_de_edicao.py
  - code/engine/testes/test_escrita_no_editor.py
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/01-leitura-do-json.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/05-zoom.md
  - code/engine/listar_planos_de_edicao.py
  - code/engine/testes/test_configuracao_visual_do_scanner.py
This commit is contained in:
João Henrique
2026-09-10 16:04:15 -04:00
parent 2c9bdf2ff0
commit dd341e7d4c
15 changed files with 520 additions and 64 deletions
@@ -63,12 +63,13 @@ class AplicadorDePlanoDeEdicao:
2. O gancho para abertura vem depois dos cortes. Ele localiza o trecho por
tempo da mídia original e cria uma cópia no começo da sequência.
3. Marcadores e zooms por último, depois que a timeline já está no
formato final. Zoom (``set_clip_properties``) muda uma propriedade do
*clipe inteiro*, não de um trecho dele — se dois zooms caíssem em
instantes diferentes do mesmo clipe ainda não dividido pelos cortes,
o segundo sobrescreveria o primeiro no clipe inteiro, e a divisão
posterior faria os dois pedaços herdarem só o último valor. Cortar
primeiro garante que cada zoom já encontra um clipe próprio.
formato final: ambos precisam do instante *definitivo* na timeline,
e cortes/gancho deslocam clipes. Zoom não altera o clipe original —
cria uma adjustment layer numa faixa de vídeo própria, recortada no
trecho exato do zoom, e escala só essa camada (mesma técnica do
executor do painel CEP, ``scripts/apply-editorial-actions.mjs``). A
faixa de ajuste é criada uma vez por plano, na primeira ação de zoom,
e reaproveitada pelas seguintes.
A cada ação a timeline ativa é lida de novo no Premiere — nunca se
reaproveita uma leitura anterior — porque a ação anterior pode ter
@@ -106,9 +107,11 @@ class AplicadorDePlanoDeEdicao:
self.conversor_de_timeline = conversor_de_timeline
self.escrita = escrita
self.mapeador = mapeador
self._indice_da_faixa_de_ajuste: int | None = None
def aplicar(self, plano: PlanoDeEdicao) -> ResultadoDaAplicacao:
"""Aplica todas as ações de ``plano`` e devolve o resultado de cada uma."""
self._indice_da_faixa_de_ajuste = None
ganchos = plano.acoes_do_tipo(TipoDeAcao.GANCHO)
pontuais = [
acao for acao in plano.acoes
@@ -132,8 +135,8 @@ class AplicadorDePlanoDeEdicao:
self._aplicar_marcador(acao, arquivo_de_origem)
return ResultadoDaAcao(acao, True, "marcador criado")
if acao.tipo is TipoDeAcao.ZOOM:
quantidade = self._aplicar_zoom(acao, arquivo_de_origem)
return ResultadoDaAcao(acao, True, f"zoom aplicado em {quantidade} clipe(s)")
self._aplicar_zoom(acao, arquivo_de_origem)
return ResultadoDaAcao(acao, True, "zoom aplicado via camada de ajuste")
if acao.tipo is TipoDeAcao.TEXTO:
self._aplicar_texto_como_marcador(acao, arquivo_de_origem)
return ResultadoDaAcao(
@@ -155,7 +158,14 @@ class AplicadorDePlanoDeEdicao:
conteudo = str(acao.parametros.get("content", ""))
self.escrita.adicionar_marcador(instante, "TEXTO (aplicar manualmente)", f"{conteudo} — {acao.motivo}")
def _aplicar_zoom(self, acao: AcaoDeEdicao, arquivo_de_origem: str) -> int:
def _aplicar_zoom(self, acao: AcaoDeEdicao, arquivo_de_origem: str) -> None:
"""Cria uma adjustment layer cobrindo o trecho do zoom e a escala.
Traduz ``[acao.inicio, acao.fim]`` (coordenadas de origem) para o
intervalo correspondente na timeline atual usando os clipes de
vídeo já cortados. Ao contrário do fluxo antigo, a ação não é mais
dividida por clipe: sempre gera uma única camada de ajuste.
"""
fator_de_escala = float(acao.parametros.get("scale", 1.3))
faixa_de_video = self._faixa_de_video(self._timeline_atual())
clipes = self._clipes_do_arquivo(faixa_de_video, arquivo_de_origem)
@@ -164,9 +174,12 @@ class AplicadorDePlanoDeEdicao:
raise ErroDeMapeamentoDeTempo(
f"Nenhum clipe de vídeo de {arquivo_de_origem!r} sobrepõe {acao.inicio}-{acao.fim}s de origem para o zoom."
)
for clipe in alvos:
self.escrita.aplicar_zoom(clipe.identificador, fator_de_escala)
return len(alvos)
primeiro, ultimo = alvos[0], alvos[-1]
inicio_na_timeline = self._borda_de_entrada(primeiro, acao.inicio)
fim_na_timeline = self._borda_de_saida(ultimo, acao.fim)
if self._indice_da_faixa_de_ajuste is None:
self._indice_da_faixa_de_ajuste = self.escrita.garantir_faixa_de_ajuste()
self.escrita.aplicar_zoom(self._indice_da_faixa_de_ajuste, inicio_na_timeline, fim_na_timeline, fator_de_escala)
def _aplicar_corte(self, acao: AcaoDeEdicao, arquivo_de_origem: str) -> ResultadoDaAcao:
"""Remove, em cada faixa afetada, todos os clipes contidos no intervalo do corte.
@@ -249,20 +262,36 @@ class AplicadorDePlanoDeEdicao:
f"A faixa {faixa.identificador!r} não começa em 0s; o gancho foi recusado."
)
alvos = [
clipe
for faixa in faixas_afetadas
for clipe in self._clipes_do_arquivo(faixa, arquivo_de_origem)
if self._sobrepoe(clipe, acao.inicio, acao.fim)
]
# A ferramenta de gancho do bridge exige um par já isolado: ela lê
# o in/out do próprio clipe, não recebe limites de origem à
# parte. Por isso, ao contrário do fluxo antigo (que passava o
# clipe inteiro que continha o trecho), aqui é preciso dividir
# cada faixa nas bordas do gancho antes de duplicar — o mesmo
# padrão de isolamento que ``_preparar_alvos_da_faixa`` usa para
# cortes.
alvos: list[Clipe] = []
for faixa in faixas_afetadas:
inicio_real = self._dividir_e_conferir(acao.inicio, faixa, arquivo_de_origem)
fim_real = self._dividir_e_conferir(acao.fim, faixa, arquivo_de_origem)
clipes_apos_a_divisao = self._clipes_do_arquivo(self._faixa_atualizada(faixa), arquivo_de_origem)
isolados = [
clipe for clipe in clipes_apos_a_divisao
if inicio_real - _TOLERANCIA_DE_BORDA_EM_SEGUNDOS <= clipe.intervalo_na_timeline.inicio
and clipe.intervalo_na_timeline.fim <= fim_real + _TOLERANCIA_DE_BORDA_EM_SEGUNDOS
]
if len(isolados) != 1:
raise ErroDeMapeamentoDeTempo(
f"A divisão do gancho na faixa {faixa.identificador!r} não isolou exatamente um clipe "
f"(encontrado(s) {len(isolados)})."
)
alvos.append(isolados[0])
if len(alvos) != 2:
raise ErroDeMapeamentoDeTempo(
"O Premiere não localizou exatamente um clipe de vídeo e um de áudio para a ação hook."
)
self.escrita.duplicar_trecho_vinculado_para_o_inicio(
[clipe.identificador for clipe in alvos],
acao.inicio,
acao.fim,
)
return ResultadoDaAcao(acao, True, "gancho vinculado duplicado no início")
except ErroDeEdicao as erro:
+51 -17
View File
@@ -117,44 +117,78 @@ class EscritaNoEditor:
def duplicar_trecho_vinculado_para_o_inicio(
self,
identificadores_dos_clipes: list[str],
inicio_na_origem: float,
fim_na_origem: float,
) -> None:
"""Copia parte de um par de vídeo e áudio para o início da sequência.
"""Copia para o início um par de vídeo e áudio já isolado por corte.
A ferramenta externa executa inserção com ripple, mantém a ocorrência
original intacta e confirma posição, duração e sincronismo. A operação
é recusada quando os identificadores não formam um par simples.
A ferramenta externa lê o in/out do próprio clipe — por isso os dois
identificadores precisam já corresponder exatamente ao trecho do
gancho, isolado por ``split_clip`` antes desta chamada. Executa
inserção com ripple, mantém a ocorrência original intacta e confirma
posição, duração e sincronismo. A operação é recusada quando os
identificadores não formam um par simples.
"""
if len(identificadores_dos_clipes) != 2:
raise ErroDeEscritaNoEditor("O gancho exige exatamente um clipe de vídeo e um de áudio.")
try:
self.cliente_mcp.chamar(
"duplicate_linked_range_to_start",
{
"node_ids": identificadores_dos_clipes,
"source_in_seconds": inicio_na_origem,
"source_out_seconds": fim_na_origem,
},
{"node_ids": identificadores_dos_clipes},
)
except ErroDeFerramentaMCP as erro:
raise ErroDeEscritaNoEditor(
f"Não foi possível duplicar o par vinculado {identificadores_dos_clipes!r} no início: {erro}"
) from erro
def aplicar_zoom(self, identificador_do_clipe: str, fator_de_escala: float) -> None:
"""Aplica um punch-in no clipe, escalando-o por ``fator_de_escala`` (1.0 = tamanho original).
def garantir_faixa_de_ajuste(self) -> int:
"""Cria uma faixa de vídeo nova, no topo da pilha, para hospedar camadas de ajuste de zoom.
Levanta :class:`ErroDeEscritaNoEditor` se o Premiere recusar a
alteração.
Devolve o índice da faixa criada. Chamado uma única vez por plano —
quem chama guarda o índice e reaproveita para todos os zooms do
plano, o mesmo padrão do executor do painel CEP
(``scripts/apply-editorial-actions.mjs``).
"""
try:
resultado = self.cliente_mcp.chamar("add_track", {"track_type": "video", "count": 1})
except ErroDeFerramentaMCP as erro:
raise ErroDeEscritaNoEditor(f"Não foi possível criar a faixa de ajuste para zoom: {erro}") from erro
return int(resultado["totalTracks"]) - 1
def aplicar_zoom(
self,
indice_da_faixa_de_ajuste: int,
inicio_na_timeline: float,
fim_na_timeline: float,
fator_de_escala: float,
) -> None:
"""Aplica um punch-in criando uma adjustment layer sobre o trecho, sem tocar o clipe original.
Reproduz, no caminho Python, a técnica já usada pelo executor do
painel CEP: move o playhead para o início do trecho, cria a camada
de ajuste na faixa indicada, ajusta sua duração e posição para
cobrir exatamente ``[inicio_na_timeline, fim_na_timeline)``, e
escala só essa camada por ``fator_de_escala`` (1.0 = tamanho
original).
Levanta :class:`ErroDeEscritaNoEditor` se o Premiere recusar
qualquer um dos passos.
"""
duracao = fim_na_timeline - inicio_na_timeline
try:
self.cliente_mcp.chamar("set_playhead_position", {"time_seconds": inicio_na_timeline})
resultado = self.cliente_mcp.chamar(
"add_adjustment_layer", {"track_index": indice_da_faixa_de_ajuste}
)
identificador_da_camada = resultado["nodeId"]
self.cliente_mcp.chamar("trim_clip", {"node_id": identificador_da_camada, "new_out_seconds": duracao})
self.cliente_mcp.chamar(
"set_clip_properties", {"node_id": identificador_do_clipe, "scale": fator_de_escala * 100}
"move_clip", {"node_id": identificador_da_camada, "new_start_seconds": inicio_na_timeline}
)
self.cliente_mcp.chamar(
"set_clip_properties", {"node_id": identificador_da_camada, "scale": fator_de_escala * 100}
)
except ErroDeFerramentaMCP as erro:
raise ErroDeEscritaNoEditor(
f"Não foi possível aplicar zoom no clipe {identificador_do_clipe!r}: {erro}"
f"Não foi possível aplicar zoom em {inicio_na_timeline:.3f}-{fim_na_timeline:.3f}s: {erro}"
) from erro
def adicionar_marcador(self, instante_da_timeline: float, nome: str, comentario: str) -> None: