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/
This commit is contained in:
João Henrique
2026-09-10 13:09:01 -04:00
parent eda1b1aadc
commit a9e5b5ff58
33 changed files with 1811 additions and 34 deletions
@@ -0,0 +1,56 @@
import tempfile
import unittest
from pathlib import Path
from engine.integracoes.audio import AnalisadorDeMusicaInstrumentalEssentia
class TesteAnalisadorDeMusicaInstrumentalEssentia(unittest.TestCase):
def test_converte_descritores_e_classificacoes(self):
def extrator(_caminho: str):
return {
"metadata": {"audio_properties": {"length": 123.4}},
"rhythm": {"bpm": 92.0, "danceability": 0.61},
"tonal": {"key_edma": {"key": "A", "scale": "minor"}},
"lowlevel": {"average_loudness": 0.35},
"highlevel": {
"genre": {"value": {"ambient": 0.9, "rock": 0.0}},
"mood": {"value": ["calm", "melancholic"]},
},
}, {}
with tempfile.TemporaryDirectory() as pasta:
arquivo = Path(pasta) / "instrumental.wav"
arquivo.write_bytes(b"audio")
resultado = AnalisadorDeMusicaInstrumentalEssentia(extrator).analisar(arquivo)
self.assertEqual(resultado.batidas_por_minuto, 92.0)
self.assertEqual(resultado.tonalidade, "A")
self.assertEqual(resultado.modo, "minor")
self.assertEqual(resultado.generos, ("ambient",))
self.assertEqual(resultado.humores, ("calm", "melancholic"))
def test_rejeita_arquivo_inexistente(self):
analisador = AnalisadorDeMusicaInstrumentalEssentia(lambda _: ({}, {}))
with self.assertRaises(FileNotFoundError):
analisador.analisar("/arquivo/inexistente.wav")
def test_aceita_descritores_com_chaves_pontuadas_do_essentia(self):
def extrator(_caminho: str):
return {
"metadata.audio_properties.length": 10.0,
"rhythm.bpm": 110.0,
"rhythm.danceability": 0.42,
"tonal.key_edma.key": "D",
"tonal.key_edma.scale": "major",
"lowlevel.average_loudness": 0.22,
}, {}
with tempfile.TemporaryDirectory() as pasta:
arquivo = Path(pasta) / "instrumental.wav"
arquivo.write_bytes(b"audio")
resultado = AnalisadorDeMusicaInstrumentalEssentia(extrator).analisar(arquivo)
self.assertEqual(resultado.duracao_em_segundos, 10.0)
self.assertEqual(resultado.batidas_por_minuto, 110.0)
self.assertEqual(resultado.tonalidade, "D")
@@ -0,0 +1,37 @@
"""Testes do carregamento de planos de edição diretamente do SQLite."""
import json
import tempfile
import unittest
from pathlib import Path
from engine.carregar_plano_de_edicao import carregar
from engine.persistencia import abrir_banco
from engine.persistencia.repositorio_de_planos import RepositorioDePlanos, plano_de_dict
class TesteCarregarPlanoDeEdicao(unittest.TestCase):
"""Garante que a interface receba o plano no contrato de aplicação."""
def test_carrega_plano_mais_recente_do_video(self):
with tempfile.TemporaryDirectory() as pasta:
banco = Path(pasta) / "analises.db"
conexao = abrir_banco(banco)
repositorio = RepositorioDePlanos(conexao)
plano_id = repositorio.registrar_plano(plano_de_dict(
{"source": "Sequência", "actions": [
{"kind": "cut", "start": 1, "end": 2, "reason": "repetição"},
]}, video_id="video-1", tipo_de_video="depoimento",
))
conexao.close()
carregado = carregar(banco, video_id="video-1")
self.assertEqual(carregado["plano_id"], plano_id)
self.assertEqual(carregado["video_id"], "video-1")
self.assertEqual(carregado["actions"][0]["kind"], "cut")
self.assertEqual(carregado["actions"][0]["reason"], "repetição")
if __name__ == "__main__":
unittest.main()
@@ -15,7 +15,9 @@ from engine.dominio import Clipe, Faixa, IntervaloDeTempo, Timeline
from engine.persistencia import (
ConsultasDeAnalises,
ErroDeConsultaInvalida,
EdicaoDeVideo,
RepositorioDeAnalisesSQLite,
RepositorioDeEdicoes,
RepositorioDeRetakesSQLite,
RepositorioDeTimelineSQLite,
)
@@ -95,6 +97,24 @@ class TesteConsultasDeAnalises(unittest.TestCase):
with self.assertRaises(ErroDeConsultaInvalida):
self.consultas.consultar_resumo_do_video("")
def test_consultar_contexto_da_edicao_carrega_edicao_mais_recente_e_falas(self) -> None:
RepositorioDeEdicoes(self.consultas.conexao).registrar(EdicaoDeVideo(
video_id=VIDEO_ID,
sequencia="Sequência",
origem="/videos/entrada.mp4",
tipo_de_video="depoimento",
configuracao={"objetivo": "Gerar confiança"},
))
contexto = self.consultas.consultar_contexto_da_edicao()
self.assertIsNotNone(contexto)
self.assertEqual(contexto["edicao"]["tipo_de_video"], "depoimento")
self.assertEqual(contexto["edicao"]["configuracao"]["objetivo"], "Gerar confiança")
self.assertEqual(contexto["video"]["video_id"], VIDEO_ID)
self.assertEqual(len(contexto["falas"]), 1)
self.assertEqual(contexto["falas"][0]["texto"], "Hoje nós vamos mostrar como funciona o sistema.")
def test_consultar_status_da_analise_expoe_falantes_e_metricas(self) -> None:
status = self.consultas.consultar_status_da_analise(VIDEO_ID)
@@ -0,0 +1,43 @@
"""Testes da entrada de planos de edição no banco SQLite."""
import json
import tempfile
import unittest
from pathlib import Path
from engine.persistencia import EdicaoDeVideo, RepositorioDeEdicoes, abrir_banco
from engine.registrar_plano_de_edicao import registrar
class TesteRegistrarPlanoDeEdicao(unittest.TestCase):
"""Garante que o plano é associado ao contexto editorial mais recente."""
def test_registra_plano_e_descobre_video_pela_origem(self):
with tempfile.TemporaryDirectory() as pasta:
banco = Path(pasta) / "analises.db"
conexao = abrir_banco(banco)
RepositorioDeEdicoes(conexao).registrar(EdicaoDeVideo(
video_id="video-1", sequencia="Depoimento", origem="/v.mp4",
tipo_de_video="depoimento", configuracao={"legendas": True},
))
conexao.close()
arquivo = Path(pasta) / "plano.json"
arquivo.write_text(json.dumps({
"source": "/v.mp4",
"actions": [{"kind": "cut", "start": 1, "end": 2}],
}), encoding="utf-8")
plano_id = registrar(arquivo, banco, tipo_de_video="depoimento")
conexao = abrir_banco(banco)
linha = conexao.execute(
"SELECT video_id, tipo_de_video FROM planos_de_edicao WHERE id = ?",
(plano_id,),
).fetchone()
conexao.close()
self.assertEqual(dict(linha), {"video_id": "video-1", "tipo_de_video": "depoimento"})
if __name__ == "__main__":
unittest.main()