@danhachuel/thunderbolt 0.2.24 → 0.2.26

package/MANUAL-INSTALACAO.md

@@ -2,7 +2,7 @@
 
 Este manual descreve a instalação local da UI Thunderbolt, baseada no MoneyPrinterTurbo, utilizando o pacote npm `@danhachuel/thunderbolt`. O fluxo recomendado instala automaticamente o ambiente Python, as dependências da aplicação, as dependências do MoneyPrinterTurbo, o Streamlit e o suporte FFmpeg através de `imageio-ffmpeg`.
 
-> **Versão deste manual:** 0.2.24
+> **Versão deste manual:** 0.2.26
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -100,13 +100,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes @danhachuel/thunderbolt@0.2.24 install
+npx.cmd --yes @danhachuel/thunderbolt@0.2.26 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes @danhachuel/thunderbolt@0.2.24 install
+npx --yes @danhachuel/thunderbolt@0.2.26 install
 ```
 
 A instalação normal é **segura para actualizações**: preserva `storage`, Blueprints, Brandings, configurações e artefactos do utilizador. Remove apenas `.venv`, o clone técnico do MoneyPrinterTurbo e dependências que serão recriadas. Uma pasta antiga sem dados do utilizador, como `C:\Users\<utilizador>\AppData\Local\hermes` da tentativa incompleta, pode ser removida; uma pasta antiga que contenha Blueprints, Brandings ou storage é preservada e apenas avisada no terminal. Feche processos Python, Node, Streamlit e MobaXterm que estejam a usar as pastas antes de executar.
@@ -380,7 +380,7 @@ O modo `Pexels/Pixabay` representa materiais de stock. Ao seleccionar `full_ia`,
 
 A aba **Automação** lista os canais e vídeos, permite escolher e guardar **Blueprint padrão** e **Voz padrão** por canal, guarda **Automação ON** e valida horários diários no formato `HH:MM`. Os valores ficam sincronizados com o editor existente no cartão da aba **Canais** e são copiados para novas tarefas. É apenas uma camada de UI nesta versão, sem execução de worker.
 
-A área **Teste de vozes**, dentro de Configurações, é isolada da pipeline. O preview pode ser reproduzido e descarregado de `storage/voice_previews/`.
+A área **Teste de vozes**, dentro de Configurações, é isolada da pipeline. O preview pode ser reproduzido e descarregado de `storage/voice_previews/`. Caminhos vazios, directórios, ficheiros vazios e previews sem permissões de leitura são ignorados com uma mensagem clara, sem traceback. Se uma instalação antiga mostrar que `edge-tts` está em falta, execute `npx.cmd --yes @danhachuel/thunderbolt install`; o detector reinstala apenas a dependência ausente.
 
 ## Upload directo
 

package/README.md

@@ -104,9 +104,9 @@ thunderbolt
 No Windows PowerShell, se `npx` for bloqueado por `npx.ps1`, use directamente `npx.cmd`:
 
 ```powershell
-npx.cmd --yes @danhachuel/thunderbolt@0.2.24 install
-npx.cmd --yes @danhachuel/thunderbolt@0.2.24 doctor
-npx.cmd --yes @danhachuel/thunderbolt@0.2.24
+npx.cmd --yes @danhachuel/thunderbolt@0.2.26 install
+npx.cmd --yes @danhachuel/thunderbolt@0.2.26 doctor
+npx.cmd --yes @danhachuel/thunderbolt@0.2.26
 ```
 
 Como alternativa, pode permitir scripts para o seu utilizador:
@@ -189,7 +189,7 @@ O agente musical guarda os ficheiros em `storage/music/`, aceita formatos de áu
 
 ## Teste de vozes
 
-A área **Configurações > Teste de vozes** é isolada da pipeline. Permite escolher Edge/Azure Speech ou um provider HTTP configurado, seleccionar voz/ID, alterar a velocidade, sintetizar uma amostra, reproduzi-la e descarregá-la. O áudio é guardado em `storage/voice_previews/` e nunca altera vídeos ou tarefas.
+A área **Configurações > Teste de vozes** é isolada da pipeline. Permite escolher Edge/Azure Speech ou um provider HTTP configurado, seleccionar voz/ID, alterar a velocidade, sintetizar uma amostra, reproduzi-la e descarregá-la. O áudio é guardado em `storage/voice_previews/` e nunca altera vídeos ou tarefas. Se uma instalação antiga não tiver `edge-tts`, execute `npx.cmd --yes @danhachuel/thunderbolt install`; o instalador detecta a dependência em falta sem reinstalar componentes válidos.
 
 ## MCP e integrações externas opcionais
 

package/app/main.py

@@ -22,7 +22,7 @@ from hermes_ui.blueprints import create_blueprint_from_link, list_branding_files
 from hermes_ui.metadata_cleaner import build_description, clean_video_metadata, list_edit_records, metadata_manifest, normalize_tags, save_edit_record, store_external_video
 from hermes_ui.mcp import detect_local_service, install_skill_locally, load_integrations, read_packaged_skill, update_integration
 from hermes_ui.music import list_music_files, materialize_suno_audio, request_suno_generation, store_music_file
-from hermes_ui.voice_preview import DEFAULT_SAMPLE, synthesize_preview
+from hermes_ui.voice_preview import DEFAULT_SAMPLE, load_preview_file, synthesize_preview
 from integrations.platforms import IntegrationResult, TikTokAdapter, YouTubeAdapter
 from integrations.youtube_direct_upload import YouTubeDirectUploader
 from integrations.local_runtime import MoneyPrinterRuntime
@@ -129,9 +129,18 @@ st.markdown("""
 .content-value { color:#f4f8fb; font-size:1.8rem; font-weight:700; margin-top:.3rem; }
 .stage { border-left:3px solid #35a7ff; padding:.65rem .8rem; margin:.4rem 0; background:#101d2a; border-radius:8px; }
 .small-muted { color:#8ba6bb; font-size:.85rem; }
-/* Cores dos chips BaseWeb dentro do mesmo campo, identificadas pelo destino e não por posição. */
+/* Cores dos chips por identidade da plataforma, sem depender da ordem de selecção. */
+[data-testid="stMultiSelectTagsContainer"] span[data-tag] { color:#ffffff !important; border:0 !important; font-weight:700 !important; }
+[data-testid="stMultiSelectTagsContainer"] span[data-tag] span[title],
+[data-testid="stMultiSelectTagsContainer"] span[data-tag] button,
+[data-testid="stMultiSelectTagsContainer"] span[data-tag] svg { color:#ffffff !important; fill:#ffffff !important; }
+[data-testid="stMultiSelectTagsContainer"] span[data-tag][aria-label="YouTube"] { background:#ff0000 !important; }
+[data-testid="stMultiSelectTagsContainer"] span[data-tag][aria-label="TikTok"] { background:#000000 !important; }
+[data-testid="stMultiSelectTagsContainer"] span[data-tag][aria-label="Instagram"] { background:#e1306c !important; }
+[data-testid="stMultiSelectTagsContainer"] span[data-tag][aria-label="Facebook Pages"] { background:#1877f2 !important; }
+/* Compatibilidade com versões BaseWeb que usam data-baseweb=tag. */
 [data-testid="stMultiSelect"] [data-baseweb="tag"] { color:#ffffff !important; border:0 !important; font-weight:700 !important; }
-[data-testid="stMultiSelect"] [data-baseweb="tag"]:has(button[aria-label*="YouTube"]) { background:#ff4b4b !important; }
+[data-testid="stMultiSelect"] [data-baseweb="tag"]:has(button[aria-label*="YouTube"]) { background:#ff0000 !important; }
 [data-testid="stMultiSelect"] [data-baseweb="tag"]:has(button[aria-label*="TikTok"]) { background:#000000 !important; }
 [data-testid="stMultiSelect"] [data-baseweb="tag"]:has(button[aria-label*="Instagram"]) { background:#e1306c !important; }
 [data-testid="stMultiSelect"] [data-baseweb="tag"]:has(button[aria-label*="Facebook Pages"]) { background:#1877f2 !important; }
@@ -1048,16 +1057,22 @@ def render_settings():
         preview_rate = st.selectbox("Velocidade", ["-20%", "-10%", "+0%", "+10%", "+20%"], index=2, key="voice_preview_rate")
     preview_text = st.text_area("Texto de teste", value=DEFAULT_SAMPLE, max_chars=1000, height=110, key="voice_preview_text")
     if st.button("Testar voz", type="primary", key="voice_preview_generate"):
+        st.session_state.pop("voice_preview_path", None)
         try:
             preview_path = synthesize_preview(preview_text, preview_provider, preview_voice, settings, preview_rate)
             st.session_state["voice_preview_path"] = str(preview_path)
             st.success("Amostra de voz gerada. Este ficheiro é apenas um preview.")
         except Exception as exc:
             st.error(f"Não foi possível gerar o preview: {exc}")
-    preview_path = Path(st.session_state.get("voice_preview_path", ""))
-    if preview_path.exists():
-        st.audio(preview_path.read_bytes(), format="audio/mpeg")
-        st.download_button("Descarregar amostra", data=preview_path.read_bytes(), file_name=preview_path.name, mime="audio/mpeg", key="voice_preview_download")
+    preview_value = str(st.session_state.get("voice_preview_path", "") or "").strip()
+    loaded_preview = load_preview_file(preview_value)
+    if loaded_preview:
+        preview_path, preview_data = loaded_preview
+        st.audio(preview_data, format="audio/mpeg")
+        st.download_button("Descarregar amostra", data=preview_data, file_name=preview_path.name, mime="audio/mpeg", key="voice_preview_download")
+    elif preview_value:
+        st.session_state.pop("voice_preview_path", None)
+        st.warning("A amostra de voz anterior não é um ficheiro de áudio legível e foi removida do estado local. Teste a voz novamente.")
 
 
 def render_mcp():

package/hermes_ui/voice_preview.py

@@ -26,7 +26,10 @@ def _edge_voice_name(value: str) -> str:
 
 
 async def _save_edge_async(text: str, voice: str, output: Path, rate: str) -> None:
-    import edge_tts
+    try:
+        import edge_tts
+    except ModuleNotFoundError as exc:
+        raise RuntimeError("A dependência edge-tts não está instalada. Execute `npx.cmd --yes @danhachuel/thunderbolt install` para completar a instalação.") from exc
 
     kwargs: dict[str, Any] = {"rate": rate}
     if "boundary" in inspect.signature(edge_tts.Communicate).parameters:
@@ -97,6 +100,23 @@ def _save_openai_compatible(text: str, voice: str, output: Path, settings: dict[
         output.write_bytes(response.content)
 
 
+def load_preview_file(path_value: str | Path) -> tuple[Path, bytes] | None:
+    """Return a readable non-empty preview file, never a directory or empty path."""
+    raw_path = str(path_value or "").strip()
+    if not raw_path:
+        return None
+    candidate = Path(raw_path)
+    try:
+        if not candidate.is_file():
+            return None
+        data = candidate.read_bytes()
+    except (OSError, PermissionError):
+        return None
+    if not data:
+        return None
+    return candidate, data
+
+
 def synthesize_preview(text: str, provider: str, voice: str, settings: dict[str, Any], rate: str = "+0%") -> Path:
     text = (text or "").strip()
     if not text:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "main": "scripts/cli.mjs",
   "type": "module",