@danhachuel/thunderbolt 0.2.16 → 0.2.17

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.16
+> **Versão deste manual:** 0.2.17
 > **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.16 install
+npx.cmd --yes @danhachuel/thunderbolt@0.2.17 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes @danhachuel/thunderbolt@0.2.16 install
+npx --yes @danhachuel/thunderbolt@0.2.17 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.
@@ -345,7 +345,9 @@ Na primeira execução, abra **Configurações** e reveja:
 |---|---|
 | Porta Streamlit | Definir a porta local da UI |
 | Pasta MoneyPrinterTurbo | Indicar o clone local que será sincronizado com `config.toml` |
-| YouTube Data API key | Permitir importar nome, handle e métricas de canais |
+| YouTube Data API Key | Permitir importar nome, handle e métricas públicas de canais |
+| YouTube OAuth Client ID | Identificar a aplicação OAuth 2.0 do Google para operações autenticadas |
+| YouTube OAuth Client Secret | Secret do mesmo cliente OAuth 2.0; não é a Data API Key |
 | TikTok Client ID/Secret | Credenciais da aplicação; Redirect URI, scopes e autorização ficam no TikTok for Developers Playground |
 
 As chaves devem ser inseridas apenas na configuração local. Não as coloque no GitHub, no `package.json`, em blueprints ou em ficheiros de estado versionados.

package/README.md

@@ -103,9 +103,9 @@ thunderbolt
 No Windows PowerShell, se `npx` for bloqueado por `npx.ps1`, use directamente `npx.cmd`:
 
 ```powershell
-npx.cmd --yes @danhachuel/thunderbolt@0.2.16 install
-npx.cmd --yes @danhachuel/thunderbolt@0.2.16 doctor
-npx.cmd --yes @danhachuel/thunderbolt@0.2.16
+npx.cmd --yes @danhachuel/thunderbolt@0.2.17 install
+npx.cmd --yes @danhachuel/thunderbolt@0.2.17 doctor
+npx.cmd --yes @danhachuel/thunderbolt@0.2.17
 ```
 
 Como alternativa, pode permitir scripts para o seu utilizador:

package/app/main.py

@@ -350,7 +350,15 @@ def render_settings():
         st.subheader("Execução local")
         port = st.number_input("Porta Streamlit", 1, 65535, int(settings.get("port", 3030)))
         moneyprinter_path = st.text_input("Pasta do motor de vídeo", settings.get("moneyprinter_path", ""), key="settings_moneyprinter_path")
-        youtube_api_key = st.text_input("YouTube Data API key", settings.get("youtube_api_key", ""), type="password")
+        st.markdown("**YouTube — API pública e OAuth 2.0**")
+        st.caption("A Data API Key consulta canais e estatísticas públicas. O Client ID e o Client Secret são credenciais OAuth 2.0 separadas, usadas para autorizar operações na conta, como upload.")
+        youtube_cols = st.columns(3)
+        with youtube_cols[0]:
+            youtube_api_key = text_setting("YouTube Data API Key", "youtube_api_key", secret=True, help_text="Chave criada em Google Cloud > APIs e serviços > Credenciais > Chave de API.")
+        with youtube_cols[1]:
+            youtube_client_id = text_setting("YouTube OAuth Client ID", "youtube_client_id", help_text="Client ID do OAuth 2.0 criado no Google Cloud.")
+        with youtube_cols[2]:
+            youtube_client_secret = text_setting("YouTube OAuth Client Secret", "youtube_client_secret", secret=True, help_text="Client Secret do mesmo cliente OAuth 2.0.")
 
         with st.expander("Serviço, materiais e rede"):
             cols = st.columns(2)
@@ -448,6 +456,7 @@ def render_settings():
         if st.form_submit_button("Guardar configurações do Thunderbolt", type="primary"):
             settings.update({
                 "port": port, "moneyprinter_path": moneyprinter_path, "youtube_api_key": youtube_api_key,
+                "youtube_client_id": youtube_client_id, "youtube_client_secret": youtube_client_secret,
                 "log_level": log_level, "listen_host": listen_host, "listen_port": listen_port, "video_source": video_source,
                 "endpoint": endpoint, "proxy_http": proxy_http, "proxy_https": proxy_https, "match_materials_to_script": match_materials_to_script,
                 "llm_provider": llm_provider, "openai_api_key": openai_api_key, "openai_base_url": openai_base_url, "openai_model_name": openai_model_name,

package/hermes_ui/storage.py

@@ -29,6 +29,8 @@ DEFAULTS: dict[str, Any] = {
         "video_concurrency": 3,
         "upload_concurrency": 2,
         "youtube_api_key": "",
+        "youtube_client_id": "",
+        "youtube_client_secret": "",
         "llm_provider": "moonshot",
         "moonshot_api_key": "",
         "moonshot_base_url": "",

package/package.json

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