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
@@ -1,5 +1,11 @@
|
||||
"""Integrações locais para análise de áudio."""
|
||||
"""Integrações locais para análise de áudio e música."""
|
||||
|
||||
from .analisador_de_metricas_de_voz import AnalisadorDeMetricasDeVoz
|
||||
from .modelos_de_analise_musical import ResultadoDaAnaliseMusical
|
||||
from .provider_de_analise_musical_essentia import AnalisadorDeMusicaInstrumentalEssentia
|
||||
|
||||
__all__ = ["AnalisadorDeMetricasDeVoz"]
|
||||
__all__ = [
|
||||
"AnalisadorDeMetricasDeVoz",
|
||||
"AnalisadorDeMusicaInstrumentalEssentia",
|
||||
"ResultadoDaAnaliseMusical",
|
||||
]
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
"""
|
||||
Contratos para provedores de análise musical.
|
||||
|
||||
O contrato permite que a aplicação use Essentia, um dublê de teste ou outro
|
||||
provedor no futuro sem conhecer detalhes de carregamento e classificação.
|
||||
"""
|
||||
|
||||
from pathlib import Path
|
||||
from typing import Protocol
|
||||
|
||||
from .modelos_de_analise_musical import ResultadoDaAnaliseMusical
|
||||
|
||||
|
||||
class AnalisadorDeMusica(Protocol):
|
||||
"""Define a operação necessária para analisar um arquivo musical."""
|
||||
|
||||
def analisar(self, arquivo: str | Path) -> ResultadoDaAnaliseMusical:
|
||||
"""
|
||||
Analisa um arquivo de música e devolve seus descritores internos.
|
||||
|
||||
Parâmetros:
|
||||
arquivo: Caminho de um arquivo de áudio existente.
|
||||
|
||||
Retorna:
|
||||
Resultado estruturado da análise musical.
|
||||
|
||||
Pode gerar:
|
||||
FileNotFoundError: quando o arquivo não existir.
|
||||
RuntimeError: quando Essentia não estiver instalado.
|
||||
"""
|
||||
|
||||
...
|
||||
@@ -0,0 +1,35 @@
|
||||
"""
|
||||
Modelos internos para representar análises de músicas instrumentais.
|
||||
|
||||
Este módulo define somente os dados produzidos pela análise. Ele não importa
|
||||
Essentia, não lê arquivos e não transforma o resultado em texto para a
|
||||
interface.
|
||||
"""
|
||||
|
||||
from dataclasses import dataclass, field
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class ResultadoDaAnaliseMusical:
|
||||
"""
|
||||
Representa os descritores calculados para uma música instrumental.
|
||||
|
||||
A classe mantém valores objetivos, como BPM e tonalidade, além das
|
||||
classificações fornecidas pelos modelos disponíveis. Ela não afirma uma
|
||||
interpretação definitiva da intenção artística da música.
|
||||
"""
|
||||
|
||||
caminho_do_arquivo: Path
|
||||
duracao_em_segundos: float | None = None
|
||||
batidas_por_minuto: float | None = None
|
||||
tonalidade: str | None = None
|
||||
modo: str | None = None
|
||||
intensidade: float | None = None
|
||||
dancabilidade: float | None = None
|
||||
generos: tuple[str, ...] = field(default_factory=tuple)
|
||||
humores: tuple[str, ...] = field(default_factory=tuple)
|
||||
instrumentos: tuple[str, ...] = field(default_factory=tuple)
|
||||
etiquetas: tuple[str, ...] = field(default_factory=tuple)
|
||||
provedor: str = "Essentia"
|
||||
modelo: str | None = None
|
||||
@@ -0,0 +1,142 @@
|
||||
"""
|
||||
Adaptador local para análise musical usando Essentia.
|
||||
|
||||
O adaptador concentra a dependência externa e converte seus descritores para
|
||||
``ResultadoDaAnaliseMusical``. Ele não persiste resultados nem conhece a
|
||||
interface do painel. As classificações de gênero, humor e instrumentos são
|
||||
lidas quando os modelos de alto nível instalados retornarem essas categorias.
|
||||
"""
|
||||
|
||||
from pathlib import Path
|
||||
from typing import Any, Callable
|
||||
|
||||
from .modelos_de_analise_musical import ResultadoDaAnaliseMusical
|
||||
|
||||
|
||||
class AnalisadorDeMusicaInstrumentalEssentia:
|
||||
"""
|
||||
Analisa arquivos de áudio localmente por meio do ``MusicExtractor``.
|
||||
|
||||
A criação do extrator é tardia para que a engine continue importável sem
|
||||
Essentia instalada. Um extrator compatível pode ser injetado nos testes,
|
||||
evitando dependência de modelos pesados durante o teste unitário.
|
||||
"""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
extrator: Callable[[str], tuple[Any, Any]] | None = None,
|
||||
nome_do_modelo: str | None = None,
|
||||
) -> None:
|
||||
"""Inicializa o adaptador sem carregar a dependência externa."""
|
||||
self._extrator = extrator
|
||||
self._nome_do_modelo = nome_do_modelo
|
||||
|
||||
def analisar(self, arquivo: str | Path) -> ResultadoDaAnaliseMusical:
|
||||
"""
|
||||
Analisa um arquivo de música instrumental.
|
||||
|
||||
Parâmetros:
|
||||
arquivo: Caminho de áudio que será analisado.
|
||||
|
||||
Retorna:
|
||||
Descritores objetivos e classificações disponíveis.
|
||||
|
||||
Pode gerar:
|
||||
FileNotFoundError: quando o caminho não apontar para um arquivo.
|
||||
RuntimeError: quando Essentia não estiver instalada.
|
||||
ValueError: quando o resultado externo não possuir formato válido.
|
||||
"""
|
||||
caminho = Path(arquivo).expanduser().resolve(strict=False)
|
||||
if not caminho.is_file():
|
||||
raise FileNotFoundError(f"Arquivo de áudio não encontrado: {caminho}")
|
||||
|
||||
dados, _ = self._obter_extrator()(str(caminho))
|
||||
if dados is None:
|
||||
raise ValueError("O Essentia devolveu uma análise vazia.")
|
||||
return self._converter_resultado(caminho, dados)
|
||||
|
||||
def _obter_extrator(self) -> Callable[[str], tuple[Any, Any]]:
|
||||
if self._extrator is not None:
|
||||
return self._extrator
|
||||
try:
|
||||
from essentia.standard import MusicExtractor
|
||||
except ImportError as erro:
|
||||
raise RuntimeError(
|
||||
"A análise musical local precisa da biblioteca Essentia. "
|
||||
"Instale as dependências de requirements-audio.txt."
|
||||
) from erro
|
||||
self._extrator = MusicExtractor()
|
||||
return self._extrator
|
||||
|
||||
def _converter_resultado(
|
||||
self, caminho: Path, dados: Any,
|
||||
) -> ResultadoDaAnaliseMusical:
|
||||
return ResultadoDaAnaliseMusical(
|
||||
caminho_do_arquivo=caminho,
|
||||
duracao_em_segundos=self._numero(self._buscar(dados, "metadata.audio_properties.length")),
|
||||
batidas_por_minuto=self._numero(self._buscar(dados, "rhythm.bpm")),
|
||||
tonalidade=self._texto(self._buscar(dados, "tonal.key_edma.key")),
|
||||
modo=self._texto(self._buscar(dados, "tonal.key_edma.scale")),
|
||||
intensidade=self._numero(self._buscar(dados, "lowlevel.average_loudness")),
|
||||
dancabilidade=self._numero(self._buscar(dados, "rhythm.danceability")),
|
||||
generos=self._etiquetas(dados, ("genre", "genres")),
|
||||
humores=self._etiquetas(dados, ("mood", "moods")),
|
||||
instrumentos=self._etiquetas(dados, ("instrument", "instruments")),
|
||||
etiquetas=self._etiquetas(dados, ("tags", "semantic")),
|
||||
modelo=self._nome_do_modelo,
|
||||
)
|
||||
|
||||
@staticmethod
|
||||
def _buscar(dados: Any, caminho: str) -> Any:
|
||||
"""Busca uma chave pontuada em um resultado Essentia ou devolve None.
|
||||
|
||||
O ``Pool`` do Essentia devolve descritores com a chave completa, como
|
||||
``rhythm.bpm``. Dublês de teste e algumas integrações podem devolvê-los
|
||||
como dicionários aninhados; os dois formatos são aceitos aqui.
|
||||
"""
|
||||
try:
|
||||
return dados[caminho]
|
||||
except (KeyError, IndexError, TypeError):
|
||||
pass
|
||||
valor = dados
|
||||
for parte in caminho.split("."):
|
||||
try:
|
||||
valor = valor[parte]
|
||||
except (KeyError, IndexError, TypeError):
|
||||
return None
|
||||
return valor
|
||||
|
||||
@classmethod
|
||||
def _etiquetas(cls, dados: Any, nomes: tuple[str, ...]) -> tuple[str, ...]:
|
||||
"""Converte classificações externas em uma tupla ordenada de textos."""
|
||||
encontrados: list[str] = []
|
||||
for nome in nomes:
|
||||
valor = cls._buscar(dados, f"highlevel.{nome}.value")
|
||||
if isinstance(valor, dict):
|
||||
encontrados.extend(
|
||||
str(chave) for chave, pontuacao in valor.items()
|
||||
if cls._numero(pontuacao) is not None and float(pontuacao) > 0
|
||||
)
|
||||
elif isinstance(valor, (list, tuple)):
|
||||
encontrados.extend(str(item) for item in valor)
|
||||
elif isinstance(valor, str):
|
||||
encontrados.append(valor)
|
||||
return tuple(dict.fromkeys(encontrados))
|
||||
|
||||
@staticmethod
|
||||
def _numero(valor: Any) -> float | None:
|
||||
"""Converte valores numéricos externos sem aceitar booleanos."""
|
||||
if isinstance(valor, bool) or valor is None:
|
||||
return None
|
||||
try:
|
||||
return float(valor)
|
||||
except (TypeError, ValueError):
|
||||
return None
|
||||
|
||||
@staticmethod
|
||||
def _texto(valor: Any) -> str | None:
|
||||
"""Converte valores textuais externos, ignorando vazios."""
|
||||
if valor is None or isinstance(valor, (dict, list, tuple)):
|
||||
return None
|
||||
texto = str(valor).strip()
|
||||
return texto or None
|
||||
Reference in New Issue
Block a user