@danhachuel/thunderbolt 0.3.23 → 0.3.25

package/hermes_ui/creative_generation.py

@@ -249,6 +249,60 @@ def _keywords_from_text(*values: str) -> list[str]:
     return result[:15]
 
 
+def generate_thumbnail_prompt(
+    settings: dict[str, Any],
+    channel: dict[str, Any],
+    topic: str,
+    current_prompt: str = "",
+    blueprint: dict[str, Any] | None = None,
+    language: str = "",
+) -> dict[str, Any]:
+    """Create one image prompt while keeping visual direction and lettering separate."""
+    topic = str(topic or "").strip()
+    if not topic:
+        raise CreativeGenerationError("É necessário um tópico para refazer o prompt da thumbnail.")
+    context = channel_context(channel, blueprint)
+    system = (
+        "És um director de arte de thumbnails para YouTube. Refaz um prompt de imagem forte e específico "
+        "para o tópico fornecido, mantendo a intenção visual quando já existir um prompt. "
+        "Separa rigorosamente a imagem sem texto do lettering: image_prompt nunca deve pedir texto renderizado, "
+        "enquanto overlay_text deve ser curto, legível e ter no máximo quatro palavras. "
+        "Responde apenas com JSON válido nas chaves concept, overlay_text, composition, color_palette, subject, "
+        "image_prompt, title_synergy e lettering_prompt."
+    )
+    user = json.dumps(
+        {
+            "channel": context,
+            "language": language or context["language"],
+            "topic": topic,
+            "current_prompt": str(current_prompt or "").strip(),
+            "reference_rules": reference_bundle(),
+            "requirements": {
+                "image_prompt": "cinematic visual direction, no words, letters, logos or watermarks rendered in the image",
+                "overlay_text": "maximum 4 words, emotionally strong, not the full title",
+                "lettering_prompt": "instructions for changing only the lettering after the base image exists",
+            },
+        },
+        ensure_ascii=False,
+    )
+    result = _chat_json(settings, system, user)
+    image_prompt = str(result.get("image_prompt") or "").strip()
+    if not image_prompt:
+        raise CreativeGenerationError("O provider não devolveu um prompt de imagem válido.")
+    overlay_text = _short_overlay(result.get("overlay_text"))
+    return {
+        "concept": str(result.get("concept") or "Thumbnail renovada").strip(),
+        "overlay_text": overlay_text,
+        "composition": str(result.get("composition") or "").strip(),
+        "color_palette": str(result.get("color_palette") or "").strip(),
+        "subject": str(result.get("subject") or topic).strip(),
+        "image_prompt": image_prompt,
+        "title_synergy": str(result.get("title_synergy") or "").strip(),
+        "lettering_prompt": str(result.get("lettering_prompt") or "").strip(),
+        "status": "prompt_ready",
+    }
+
+
 def generate_creative_package(
     settings: dict[str, Any],
     channel: dict[str, Any],

package/hermes_ui/draft_video.py

@@ -0,0 +1,127 @@
+"""Helpers for resuming video creation from persisted scripts and drafts."""
+
+from __future__ import annotations
+
+from typing import Any
+
+VIDEO_SETTING_KEYS = (
+    "video_source",
+    "video_format",
+    "video_concatenation_mode",
+    "match_visuals_to_script_order",
+    "video_transition_mode",
+    "video_aspect_ratio",
+    "maximum_clip_duration",
+    "videos_per_run",
+    "video_encoder",
+)
+
+AUDIO_SETTING_KEYS = (
+    "voiceover_mode",
+    "voiceover_service",
+    "voice",
+    "voiceover_volume",
+    "voiceover_speed",
+    "background_music_source",
+    "background_music_volume",
+)
+
+SUBTITLE_SETTING_KEYS = (
+    "enable_subtitles",
+    "subtitle_font",
+    "subtitle_position",
+    "subtitle_color",
+    "subtitle_background",
+    "subtitle_background_color",
+    "subtitle_rounded_background",
+    "subtitle_font_size",
+    "subtitle_outline",
+    "subtitle_outline_width",
+)
+
+DRAFT_SETTING_SECTIONS = {
+    "Configurações de vídeo": VIDEO_SETTING_KEYS,
+    "Configurações de áudio": AUDIO_SETTING_KEYS,
+    "Configurações de legendas": SUBTITLE_SETTING_KEYS,
+}
+
+
+def keyword_text(value: Any) -> str:
+    """Return keywords as a stable comma-separated string."""
+    if isinstance(value, (list, tuple, set)):
+        values = [str(item).strip() for item in value if str(item).strip()]
+        return ", ".join(values)
+    return str(value or "").strip()
+
+
+def markdown_body(value: Any) -> str:
+    """Remove the local Markdown front matter before using a saved script as input."""
+    text = str(value or "").strip()
+    if text.startswith("---"):
+        parts = text.split("---", 2)
+        if len(parts) == 3:
+            text = parts[2].lstrip("\r\n")
+    return text.strip()
+
+
+def normalise_saved_script(record: dict[str, Any], content: str = "") -> dict[str, Any]:
+    """Map a script-history record or pipeline draft to video-creation fields."""
+    generation_settings = record.get("generation_settings")
+    generation_settings = dict(generation_settings) if isinstance(generation_settings, dict) else {}
+    title = str(record.get("title") or record.get("video_subject") or generation_settings.get("video_subject") or record.get("topic") or "").strip()
+    subject = str(record.get("video_subject") or generation_settings.get("video_subject") or record.get("topic") or title).strip()
+    script = str(record.get("video_script") or generation_settings.get("video_script") or "").strip() or markdown_body(content)
+    keywords = keyword_text(record.get("video_keywords") or record.get("keywords") or generation_settings.get("video_keywords"))
+    if not subject:
+        subject = title
+    return {
+        **record,
+        "title": title or "Roteiro sem título",
+        "video_subject": subject,
+        "video_script": script,
+        "video_keywords": keywords,
+        "generation_settings": generation_settings,
+        "language": str(record.get("language") or generation_settings.get("script_language") or "pt").strip(),
+        "channel_id": str(record.get("channel_id") or "").strip(),
+        "blueprint_id": str(record.get("blueprint_id") or "").strip(),
+    }
+
+
+def missing_setting_sections(settings: dict[str, Any]) -> list[str]:
+    """Return the settings sections that are incomplete in a saved record."""
+    return [
+        label
+        for label, keys in DRAFT_SETTING_SECTIONS.items()
+        if any(key not in settings for key in keys)
+    ]
+
+
+def setting_widget_suffixes() -> tuple[str, ...]:
+    """Return the widget suffixes used by the shared video settings renderer."""
+    return tuple(dict.fromkeys(key for keys in DRAFT_SETTING_SECTIONS.values() for key in keys))
+
+
+def missing_content_fields(record: dict[str, Any]) -> list[str]:
+    """Return the required creative fields that are absent from a saved record."""
+    missing: list[str] = []
+    if not str(record.get("video_subject") or "").strip():
+        missing.append("Video Subject")
+    if not str(record.get("video_script") or "").strip():
+        missing.append("Video Script")
+    if not str(record.get("video_keywords") or "").strip():
+        missing.append("Video Keywords")
+    return missing
+
+
+__all__ = [
+    "AUDIO_SETTING_KEYS",
+    "DRAFT_SETTING_SECTIONS",
+    "SUBTITLE_SETTING_KEYS",
+    "VIDEO_SETTING_KEYS",
+    "keyword_text",
+    "markdown_body",
+    "missing_content_fields",
+    "missing_setting_sections",
+    "normalise_saved_script",
+    "setting_widget_suffixes",
+]

package/hermes_ui/languages.py

@@ -473,9 +473,95 @@ for _language_code, _pipeline_feature_translation in _PIPELINE_FEATURE_TRANSLATI
     UI_TRANSLATIONS[_language_code].update(_pipeline_feature_translation)
 
 
+_DRAFT_VIDEO_TRANSLATIONS: dict[str, dict[str, str]] = {
+    "pt": {
+        "Gerar de Rascunho": "Gerar de Rascunho", "Roteiros guardados": "Roteiros guardados", "Seleccione um roteiro": "Seleccione um roteiro",
+        "Configurações a completar": "Configurações a completar", "Configurações de vídeo": "Configurações de vídeo", "Configurações de áudio": "Configurações de áudio", "Configurações de legendas": "Configurações de legendas",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Roteiro completo: todas as configurações estão disponíveis.", "Seleccione as configurações que pretende completar.": "Seleccione as configurações que pretende completar.",
+        "Continuar criação": "Continuar criação", "Gerar apenas o vídeo": "Gerar apenas o vídeo", "Seleccione um canal para continuar.": "Seleccione um canal para continuar.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.",
+        "Ainda não existem roteiros guardados.": "Ainda não existem roteiros guardados.", "Histórico guardado": "Histórico guardado", "Rascunho local": "Rascunho local", "Origem": "Origem",
+    },
+    "en": {
+        "Gerar de Rascunho": "Generate from Draft", "Roteiros guardados": "Saved scripts", "Seleccione um roteiro": "Select a script",
+        "Configurações a completar": "Settings to complete", "Configurações de vídeo": "Video settings", "Configurações de áudio": "Audio settings", "Configurações de legendas": "Subtitle settings",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Complete script: all settings are available.", "Seleccione as configurações que pretende completar.": "Select the settings you want to complete.",
+        "Continuar criação": "Continue creation", "Gerar apenas o vídeo": "Generate video only", "Seleccione um canal para continuar.": "Select a channel to continue.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "This script does not contain enough content. Return to Scripts and save the topic, script and keywords.",
+        "Ainda não existem roteiros guardados.": "There are no saved scripts yet.", "Histórico guardado": "Saved history", "Rascunho local": "Local draft", "Origem": "Source",
+    },
+    "zh": {
+        "Gerar de Rascunho": "从草稿生成", "Roteiros guardados": "已保存脚本", "Seleccione um roteiro": "选择脚本",
+        "Configurações a completar": "需要完成的设置", "Configurações de vídeo": "视频设置", "Configurações de áudio": "音频设置", "Configurações de legendas": "字幕设置",
+        "Roteiro completo: todas as configurações estão disponíveis.": "完整脚本：所有设置均可用。", "Seleccione as configurações que pretende completar.": "选择要完成的设置。",
+        "Continuar criação": "继续创建", "Gerar apenas o vídeo": "仅生成视频", "Seleccione um canal para continuar.": "选择一个频道以继续。",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "此脚本内容不足。请返回脚本页面并保存主题、脚本和关键词。",
+        "Ainda não existem roteiros guardados.": "还没有保存的脚本。", "Histórico guardado": "已保存历史", "Rascunho local": "本地草稿", "Origem": "来源",
+    },
+    "de": {
+        "Gerar de Rascunho": "Aus Entwurf erstellen", "Roteiros guardados": "Gespeicherte Skripte", "Seleccione um roteiro": "Skript auswählen",
+        "Configurações a completar": "Zu vervollständigende Einstellungen", "Configurações de vídeo": "Videoeinstellungen", "Configurações de áudio": "Audioeinstellungen", "Configurações de legendas": "Untertiteleinstellungen",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Vollständiges Skript: Alle Einstellungen sind verfügbar.", "Seleccione as configurações que pretende completar.": "Wählen Sie die zu vervollständigenden Einstellungen.",
+        "Continuar criação": "Erstellung fortsetzen", "Gerar apenas o vídeo": "Nur Video erstellen", "Seleccione um canal para continuar.": "Wählen Sie einen Kanal, um fortzufahren.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Dieses Skript enthält nicht genügend Inhalt. Kehren Sie zu Skripten zurück und speichern Sie Thema, Skript und Schlüsselwörter.",
+        "Ainda não existem roteiros guardados.": "Es gibt noch keine gespeicherten Skripte.", "Histórico guardado": "Gespeicherter Verlauf", "Rascunho local": "Lokaler Entwurf", "Origem": "Quelle",
+    },
+    "vi": {
+        "Gerar de Rascunho": "Tạo từ bản nháp", "Roteiros guardados": "Kịch bản đã lưu", "Seleccione um roteiro": "Chọn kịch bản",
+        "Configurações a completar": "Cài đặt cần hoàn tất", "Configurações de vídeo": "Cài đặt video", "Configurações de áudio": "Cài đặt âm thanh", "Configurações de legendas": "Cài đặt phụ đề",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Kịch bản hoàn chỉnh: tất cả cài đặt đều khả dụng.", "Seleccione as configurações que pretende completar.": "Chọn các cài đặt bạn muốn hoàn tất.",
+        "Continuar criação": "Tiếp tục tạo", "Gerar apenas o vídeo": "Chỉ tạo video", "Seleccione um canal para continuar.": "Chọn kênh để tiếp tục.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Kịch bản này chưa đủ nội dung. Hãy quay lại Kịch bản và lưu chủ đề, kịch bản cùng từ khóa.",
+        "Ainda não existem roteiros guardados.": "Chưa có kịch bản nào được lưu.", "Histórico guardado": "Lịch sử đã lưu", "Rascunho local": "Bản nháp cục bộ", "Origem": "Nguồn",
+    },
+    "tr": {
+        "Gerar de Rascunho": "Taslakta oluştur", "Roteiros guardados": "Kayıtlı senaryolar", "Seleccione um roteiro": "Bir senaryo seçin",
+        "Configurações a completar": "Tamamlanacak ayarlar", "Configurações de vídeo": "Video ayarları", "Configurações de áudio": "Ses ayarları", "Configurações de legendas": "Altyazı ayarları",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Tam senaryo: tüm ayarlar kullanılabilir.", "Seleccione as configurações que pretende completar.": "Tamamlamak istediğiniz ayarları seçin.",
+        "Continuar criação": "Oluşturmaya devam et", "Gerar apenas o vídeo": "Yalnızca video oluştur", "Seleccione um canal para continuar.": "Devam etmek için bir kanal seçin.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Bu senaryo yeterli içeriğe sahip değil. Senaryolara dönüp konu, senaryo ve anahtar kelimeleri kaydedin.",
+        "Ainda não existem roteiros guardados.": "Henüz kayıtlı senaryo yok.", "Histórico guardado": "Kayıtlı geçmiş", "Rascunho local": "Yerel taslak", "Origem": "Kaynak",
+    },
+    "ru": {
+        "Gerar de Rascunho": "Создать из черновика", "Roteiros guardados": "Сохранённые сценарии", "Seleccione um roteiro": "Выберите сценарий",
+        "Configurações a completar": "Настройки для заполнения", "Configurações de vídeo": "Настройки видео", "Configurações de áudio": "Настройки аудио", "Configurações de legendas": "Настройки субтитров",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Полный сценарий: все настройки доступны.", "Seleccione as configurações que pretende completar.": "Выберите настройки, которые хотите заполнить.",
+        "Continuar criação": "Продолжить создание", "Gerar apenas o vídeo": "Создать только видео", "Seleccione um canal para continuar.": "Выберите канал для продолжения.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "В этом сценарии недостаточно содержимого. Вернитесь в раздел сценариев и сохраните тему, сценарий и ключевые слова.",
+        "Ainda não existem roteiros guardados.": "Сохранённых сценариев пока нет.", "Histórico guardado": "Сохранённая история", "Rascunho local": "Локальный черновик", "Origem": "Источник",
+    },
+    "es": {
+        "Gerar de Rascunho": "Generar desde borrador", "Roteiros guardados": "Guiones guardados", "Seleccione um roteiro": "Selecciona un guion",
+        "Configurações a completar": "Configuraciones que completar", "Configurações de vídeo": "Configuración de vídeo", "Configurações de áudio": "Configuración de audio", "Configurações de legendas": "Configuración de subtítulos",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Guion completo: todas las configuraciones están disponibles.", "Seleccione as configurações que pretende completar.": "Selecciona las configuraciones que quieras completar.",
+        "Continuar criação": "Continuar creación", "Gerar apenas o vídeo": "Generar solo el vídeo", "Seleccione um canal para continuar.": "Selecciona un canal para continuar.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Este guion no tiene contenido suficiente. Vuelve a Guiones y guarda el tema, el guion y las palabras clave.",
+        "Ainda não existem roteiros guardados.": "Todavía no hay guiones guardados.", "Histórico guardado": "Historial guardado", "Rascunho local": "Borrador local", "Origem": "Origen",
+    },
+    "id": {
+        "Gerar de Rascunho": "Buat dari Draf", "Roteiros guardados": "Skrip tersimpan", "Seleccione um roteiro": "Pilih skrip",
+        "Configurações a completar": "Pengaturan yang harus dilengkapi", "Configurações de vídeo": "Pengaturan video", "Configurações de áudio": "Pengaturan audio", "Configurações de legendas": "Pengaturan subtitle",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Skrip lengkap: semua pengaturan tersedia.", "Seleccione as configurações que pretende completar.": "Pilih pengaturan yang ingin dilengkapi.",
+        "Continuar criação": "Lanjutkan pembuatan", "Gerar apenas o vídeo": "Buat video saja", "Seleccione um canal para continuar.": "Pilih kanal untuk melanjutkan.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Skrip ini belum memiliki konten yang cukup. Kembali ke Skrip dan simpan topik, skrip, serta kata kunci.",
+        "Ainda não existem roteiros guardados.": "Belum ada skrip tersimpan.", "Histórico guardado": "Riwayat tersimpan", "Rascunho local": "Draf lokal", "Origem": "Sumber",
+    },
+    "it": {
+        "Gerar de Rascunho": "Genera da bozza", "Roteiros guardados": "Copioni salvati", "Seleccione um roteiro": "Seleziona un copione",
+        "Configurações a completar": "Impostazioni da completare", "Configurações de vídeo": "Impostazioni video", "Configurações de áudio": "Impostazioni audio", "Configurações de legendas": "Impostazioni sottotitoli",
+        "Roteiro completo: todas as configurações estão disponíveis.": "Copione completo: tutte le impostazioni sono disponibili.", "Seleccione as configurações que pretende completar.": "Seleziona le impostazioni da completare.",
+        "Continuar criação": "Continua creazione", "Gerar apenas o vídeo": "Genera solo il video", "Seleccione um canal para continuar.": "Seleziona un canale per continuare.",
+        "Este roteiro não tem conteúdo suficiente. Volte a Roteiros e guarde tópico, roteiro e palavras-chave.": "Questo copione non contiene abbastanza contenuti. Torna a Copioni e salva argomento, copione e parole chiave.",
+        "Ainda não existem roteiros guardados.": "Non ci sono ancora copioni salvati.", "Histórico guardado": "Cronologia salvata", "Rascunho local": "Bozza locale", "Origem": "Origine",
+    },
+}
+for _language_code, _draft_video_translation in _DRAFT_VIDEO_TRANSLATIONS.items():
+    UI_TRANSLATIONS[_language_code].update(_draft_video_translation)
+
+
 _TAB_LABELS = (
     "Blueprints", "Brandings", "Pesquisa pública", "Cadastro manual", "Contas cadastradas", "Biblioteca",
-    "Importar do YouTube", "Canais em lote gmail", "Criar vídeo", "Vídeos", "Novo roteiro/letra", "Histórico guardado",
+    "Importar do YouTube", "Canais em lote gmail", "Criar vídeo", "Gerar de Rascunho", "Vídeos", "Novo roteiro/letra", "Histórico guardado",
     "Clusters encontrados", "Regras de associação", "Dados analisados", "Upload ficheiro", "URL de vídeo", "Vídeos gerados",
     "Pasta local", "Código Python", "Upload convencional", "Upload directo", "Postiz", "Upload-Post", "API Keys",
     "Teste de Voz", "Serviços e modelos", "Fontes de Materiais", "Client MCP", "Servidor MCP", "Skill",
@@ -484,7 +570,7 @@ _TAB_LABELS = (
 TAB_TRANSLATIONS: dict[str, dict[str, str]] = {
     "pt": {label: label for label in _TAB_LABELS},
     "en": {
-        "Blueprints": "Blueprints", "Brandings": "Brandings", "Pesquisa pública": "Public search", "Cadastro manual": "Manual registration", "Contas cadastradas": "Registered accounts", "Biblioteca": "Library", "Importar do YouTube": "Import from YouTube", "Canais em lote gmail": "Bulk Gmail channels", "Criar vídeo": "Create video", "Vídeos": "Videos", "Novo roteiro/letra": "New script/lyrics", "Histórico guardado": "Saved history", "Clusters encontrados": "Found clusters", "Regras de associação": "Association rules", "Dados analisados": "Analyzed data", "Upload ficheiro": "Upload file", "URL de vídeo": "Video URL", "Vídeos gerados": "Generated videos", "Pasta local": "Local folder", "Código Python": "Python code", "Upload convencional": "Conventional upload", "Upload directo": "Direct upload", "Postiz": "Postiz", "Upload-Post": "Upload-Post", "API Keys": "API Keys", "Teste de Voz": "Voice testing", "Serviços e modelos": "Services and models", "Fontes de Materiais": "Media sources", "Client MCP": "MCP client", "Servidor MCP": "MCP server", "Skill": "Skill",
+        "Blueprints": "Blueprints", "Brandings": "Brandings", "Pesquisa pública": "Public search", "Cadastro manual": "Manual registration", "Contas cadastradas": "Registered accounts", "Biblioteca": "Library", "Importar do YouTube": "Import from YouTube", "Canais em lote gmail": "Bulk Gmail channels", "Criar vídeo": "Create video", "Gerar de Rascunho": "Generate from Draft", "Vídeos": "Videos", "Novo roteiro/letra": "New script/lyrics", "Histórico guardado": "Saved history", "Clusters encontrados": "Found clusters", "Regras de associação": "Association rules", "Dados analisados": "Analyzed data", "Upload ficheiro": "Upload file", "URL de vídeo": "Video URL", "Vídeos gerados": "Generated videos", "Pasta local": "Local folder", "Código Python": "Python code", "Upload convencional": "Conventional upload", "Upload directo": "Direct upload", "Postiz": "Postiz", "Upload-Post": "Upload-Post", "API Keys": "API Keys", "Teste de Voz": "Voice testing", "Serviços e modelos": "Services and models", "Fontes de Materiais": "Media sources", "Client MCP": "MCP client", "Servidor MCP": "MCP server", "Skill": "Skill",
     },
     "zh": {
         "Blueprints": "蓝图", "Brandings": "品牌", "Pesquisa pública": "公开搜索", "Cadastro manual": "手动注册", "Contas cadastradas": "已注册账户", "Biblioteca": "库", "Importar do YouTube": "从 YouTube 导入", "Canais em lote gmail": "Gmail 批量频道", "Criar vídeo": "创建视频", "Vídeos": "视频", "Novo roteiro/letra": "新建脚本/歌词", "Histórico guardado": "已保存历史", "Clusters encontrados": "找到的聚类", "Regras de associação": "关联规则", "Dados analisados": "分析数据", "Upload ficheiro": "上传文件", "URL de vídeo": "视频 URL", "Vídeos gerados": "已生成视频", "Pasta local": "本地文件夹", "Código Python": "Python 代码", "Upload convencional": "常规上传", "Upload directo": "直接上传", "Postiz": "Postiz", "Upload-Post": "Upload-Post", "API Keys": "API 密钥", "Teste de Voz": "语音测试", "Serviços e modelos": "服务与模型", "Fontes de Materiais": "媒体来源", "Client MCP": "MCP 客户端", "Servidor MCP": "MCP 服务器", "Skill": "技能",
@@ -848,6 +934,35 @@ _CONTENT_TRANSLATION_ROWS = (
     ("Modo de ligação", "Modo de ligação", "Connection mode", "连接模式", "Verbindungsmodus", "Chế độ kết nối", "Bağlantı modu", "Режим подключения", "Modo de conexión", "Mode koneksi", "Modalità di connessione"),
     ("Metadados removidos e nova cópia criada. O original continua preservado.", "Metadados removidos e nova cópia criada. O original continua preservado.", "Metadata removed and a new copy created. The original remains preserved.", "元数据已移除并创建新副本。原文件仍然保留。", "Metadaten entfernt und eine neue Kopie erstellt. Das Original bleibt erhalten.", "Đã xóa siêu dữ liệu và tạo bản sao mới. Bản gốc vẫn được giữ nguyên.", "Üst veriler kaldırıldı ve yeni bir kopya oluşturuldu. Orijinal korunur.", "Метаданные удалены и создана новая копия. Оригинал сохранён.", "Metadatos eliminados y nueva copia creada. El original se conserva.", "Metadata dihapus dan salinan baru dibuat. File asli tetap dipertahankan.", "Metadati rimossi e nuova copia creata. L'originale è preservato."),
     ("Detalhes da conta Google", "Detalhes da conta Google", "Google account details", "Google 账户详情", "Details des Google-Kontos", "Chi tiết tài khoản Google", "Google hesap ayrıntıları", "Сведения об аккаунте Google", "Detalles de la cuenta de Google", "Detail akun Google", "Dettagli dell'account Google"),
+    ("Refazer Prompt Thumb", "Refazer Prompt Thumb", "Regenerate Thumbnail Prompt", "重新生成缩略图提示词", "Thumbnail-Prompt neu erstellen", "Tạo lại prompt thumbnail", "Küçük resim istemini yeniden oluştur", "Перегенерировать промпт миниатюры", "Regenerar prompt de miniatura", "Buat ulang prompt thumbnail", "Rigenera prompt miniatura"),
+    ("Gerar Imagem", "Gerar Imagem", "Generate Image", "生成图片", "Bild generieren", "Tạo hình ảnh", "Görsel oluştur", "Создать изображение", "Generar imagen", "Buat gambar", "Genera immagine"),
+    ("Refazer Prompt e Gerar Imagem", "Refazer Prompt e Gerar Imagem", "Regenerate Prompt and Generate Image", "重新生成提示词并生成图片", "Prompt neu erstellen und Bild generieren", "Tạo lại prompt và hình ảnh", "İstemi Yeniden Oluştur ve Görseli Üret", "Перегенерировать промпт и создать изображение", "Regenerar prompt y generar imagen", "Buat Ulang Prompt dan Gambar", "Rigenera prompt e genera immagine"),
+    ("Refazer Lettering", "Refazer Lettering", "Regenerate Lettering", "重新生成文字", "Lettering neu erstellen", "Tạo lại chữ", "Yazıyı Yeniden Oluştur", "Перегенерировать надпись", "Regenerar lettering", "Buat ulang lettering", "Rigenera lettering"),
+    ("Upload Image", "Upload Image", "Upload Image", "上传图片", "Bild hochladen", "Tải hình ảnh lên", "Görsel Yükle", "Загрузить изображение", "Subir imagen", "Unggah gambar", "Carica immagine"),
+    ("A gerar a imagem com Nano Banana…", "A gerar a imagem com Nano Banana…", "Generating image with Nano Banana…", "正在使用 Nano Banana 生成图片…", "Bild wird mit Nano Banana generiert…", "Đang tạo ảnh bằng Nano Banana…", "Nano Banana ile görsel oluşturuluyor…", "Создание изображения с помощью Nano Banana…", "Generando imagen con Nano Banana…", "Membuat gambar dengan Nano Banana…", "Generazione immagine con Nano Banana…"),
+    ("A refazer o prompt e a imagem…", "A refazer o prompt e a imagem…", "Regenerating the prompt and image…", "正在重新生成提示词和图片…", "Prompt und Bild werden neu erstellt…", "Đang tạo lại prompt và hình ảnh…", "İstem ve görsel yeniden oluşturuluyor…", "Перегенерация промпта и изображения…", "Regenerando el prompt y la imagen…", "Membuat ulang prompt dan gambar…", "Rigenerazione del prompt e dell'immagine…"),
+    ("A refazer apenas o prompt da thumbnail…", "A refazer apenas o prompt da thumbnail…", "Regenerating only the thumbnail prompt…", "仅重新生成缩略图提示词…", "Nur der Thumbnail-Prompt wird neu erstellt…", "Chỉ tạo lại prompt thumbnail…", "Yalnızca küçük resim istemi yeniden oluşturuluyor…", "Перегенерация только промпта миниатюры…", "Regenerando solo el prompt de la miniatura…", "Membuat ulang prompt thumbnail saja…", "Rigenerazione del solo prompt della miniatura…"),
+    ("A refazer apenas o lettering…", "A refazer apenas o lettering…", "Regenerating only the lettering…", "仅重新生成文字…", "Nur das Lettering wird neu erstellt…", "Chỉ tạo lại chữ…", "Yalnızca yazı yeniden oluşturuluyor…", "Перегенерация только надписи…", "Regenerando solo el lettering…", "Membuat ulang lettering saja…", "Rigenerazione del solo lettering…"),
+    ("Prompt da thumbnail refeito", "Prompt da thumbnail refeito", "Thumbnail prompt regenerated", "缩略图提示词已重新生成", "Thumbnail-Prompt neu erstellt", "Đã tạo lại prompt thumbnail", "Küçük resim istemi yeniden oluşturuldu", "Промпт миниатюры перегенерирован", "Prompt de miniatura regenerado", "Prompt thumbnail dibuat ulang", "Prompt della miniatura rigenerato"),
+    ("Prompt da thumbnail actualizado; a imagem existente foi preservada.", "Prompt da thumbnail actualizado; a imagem existente foi preservada.", "Thumbnail prompt updated; the existing image was preserved.", "缩略图提示词已更新；现有图片已保留。", "Thumbnail-Prompt aktualisiert; das vorhandene Bild wurde beibehalten.", "Đã cập nhật prompt thumbnail; ảnh hiện tại được giữ nguyên.", "Küçük resim istemi güncellendi; mevcut görsel korundu.", "Промпт миниатюры обновлён; существующее изображение сохранено.", "Prompt de miniatura actualizado; la imagen existente se conservó.", "Prompt thumbnail diperbarui; gambar yang ada dipertahankan.", "Prompt della miniatura aggiornato; l'immagine esistente è stata preservata."),
+    ("Thumbnail gerada com sucesso.", "Thumbnail gerada com sucesso.", "Thumbnail generated successfully.", "缩略图生成成功。", "Thumbnail erfolgreich generiert.", "Đã tạo thumbnail thành công.", "Küçük resim başarıyla oluşturuldu.", "Миниатюра успешно создана.", "Miniatura generada correctamente.", "Thumbnail berhasil dibuat.", "Miniatura generata con successo."),
+    ("Prompt da thumbnail e imagem actualizados.", "Prompt da thumbnail e imagem actualizados.", "Thumbnail prompt and image updated.", "缩略图提示词和图片已更新。", "Thumbnail-Prompt und Bild aktualisiert.", "Đã cập nhật prompt và hình ảnh thumbnail.", "Küçük resim istemi ve görsel güncellendi.", "Промпт и изображение миниатюры обновлены.", "Prompt e imagen de miniatura actualizados.", "Prompt dan gambar thumbnail diperbarui.", "Prompt e immagine della miniatura aggiornati."),
+    ("Lettering refeito; a imagem original foi usada como base.", "Lettering refeito; a imagem original foi usada como base.", "Lettering regenerated; the original image was used as the base.", "文字已重新生成；原图用作基础。", "Lettering neu erstellt; das Originalbild wurde als Grundlage verwendet.", "Đã tạo lại chữ; ảnh gốc được dùng làm nền.", "Yazı yeniden oluşturuldu; orijinal görsel temel olarak kullanıldı.", "Надпись перегенерирована; исходное изображение использовано как основа.", "Lettering regenerado; la imagen original se usó como base.", "Lettering dibuat ulang; gambar asli digunakan sebagai dasar.", "Lettering rigenerato; l'immagine originale è stata usata come base."),
+    ("Imagem carregada e vinculada à tarefa.", "Imagem carregada e vinculada à tarefa.", "Image uploaded and linked to the task.", "图片已上传并关联到任务。", "Bild hochgeladen und mit der Aufgabe verknüpft.", "Đã tải ảnh lên và liên kết với tác vụ.", "Görsel yüklendi ve göreve bağlandı.", "Изображение загружено и привязано к задаче.", "Imagen subida y vinculada a la tarea.", "Gambar diunggah dan ditautkan ke tugas.", "Immagine caricata e collegata all'attività."),
+    ("A thumbnail não tem um prompt de imagem para gerar.", "A thumbnail não tem um prompt de imagem para gerar.", "This thumbnail has no image prompt to generate.", "此缩略图没有可生成的图片提示词。", "Für dieses Thumbnail ist kein Bild-Prompt zum Generieren vorhanden.", "Thumbnail này không có prompt hình ảnh để tạo.", "Bu küçük resim için oluşturulacak bir görsel istemi yok.", "У этой миниатюры нет промпта для создания изображения.", "Esta miniatura no tiene un prompt de imagen para generar.", "Thumbnail ini tidak memiliki prompt gambar untuk dibuat.", "Questa miniatura non ha un prompt immagine da generare."),
+    ("A thumbnail precisa de uma imagem existente para refazer o lettering.", "A thumbnail precisa de uma imagem existente para refazer o lettering.", "An existing image is required to regenerate the lettering.", "需要现有图片才能重新生成文字。", "Für die Neugenerierung des Letterings ist ein vorhandenes Bild erforderlich.", "Cần có ảnh hiện tại để tạo lại chữ.", "Lettering'i yeniden oluşturmak için mevcut bir görsel gerekir.", "Для перегенерации надписи требуется существующее изображение.", "Se necesita una imagen existente para regenerar el lettering.", "Diperlukan gambar yang ada untuk membuat ulang lettering.", "È necessaria un'immagine esistente per rigenerare il lettering."),
+    ("Thumbnails", "Thumbnails", "Thumbnails", "缩略图", "Thumbnails", "Thumbnails", "Küçük Resimler", "Миниатюры", "Miniaturas", "Thumbnail", "Miniature"),
+    ("Biblioteca de thumbnails associadas às tarefas da pipeline. Cada acção preserva a imagem anterior no histórico local.", "Biblioteca de thumbnails associadas às tarefas da pipeline. Cada acção preserva a imagem anterior no histórico local.", "Thumbnail library linked to pipeline tasks. Each action preserves the previous image in local history.", "与流程任务关联的缩略图库。每项操作都会在本地历史记录中保留上一张图片。", "Thumbnail-Bibliothek für Pipeline-Aufgaben. Jede Aktion bewahrt das vorherige Bild im lokalen Verlauf.", "Thư viện thumbnail liên kết với các tác vụ pipeline. Mỗi thao tác đều giữ ảnh trước đó trong lịch sử cục bộ.", "Pipeline görevlerine bağlı küçük resim kitaplığı. Her işlem önceki görseli yerel geçmişte korur.", "Библиотека миниатюр, связанная с задачами конвейера. Каждое действие сохраняет предыдущее изображение в локальной истории.", "Biblioteca de miniaturas vinculada a las tareas del flujo. Cada acción conserva la imagen anterior en el historial local.", "Pustaka thumbnail yang terhubung ke tugas alur. Setiap tindakan menyimpan gambar sebelumnya dalam riwayat lokal.", "Libreria di miniature collegata alle attività della pipeline. Ogni azione conserva l'immagine precedente nella cronologia locale."),
+    ("Ainda não existem tarefas com thumbnail gerada ou prompt de imagem disponível.", "Ainda não existem tarefas com thumbnail gerada ou prompt de imagem disponível.", "There are no tasks with a generated thumbnail or available image prompt yet.", "目前没有已生成缩略图或可用图片提示词的任务。", "Es gibt noch keine Aufgaben mit generiertem Thumbnail oder verfügbarem Bild-Prompt.", "Chưa có tác vụ nào có thumbnail được tạo hoặc prompt hình ảnh khả dụng.", "Henüz oluşturulmuş küçük resmi veya kullanılabilir görsel istemi olan görev yok.", "Пока нет задач с созданной миниатюрой или доступным промптом изображения.", "Aún no hay tareas con miniatura generada o prompt de imagen disponible.", "Belum ada tugas dengan thumbnail yang dibuat atau prompt gambar yang tersedia.", "Non ci sono ancora attività con miniatura generata o prompt immagine disponibile."),
+    ("Sem imagem", "Sem imagem", "No image", "无图片", "Kein Bild", "Không có ảnh", "Görsel yok", "Нет изображения", "Sin imagen", "Tidak ada gambar", "Nessuna immagine"),
+    ("Imagem ainda não gerada", "Imagem ainda não gerada", "Image not generated yet", "图片尚未生成", "Bild noch nicht generiert", "Ảnh chưa được tạo", "Görsel henüz oluşturulmadı", "Изображение ещё не создано", "Imagen aún no generada", "Gambar belum dibuat", "Immagine non ancora generata"),
+    ("Canal", "Canal", "Channel", "频道", "Kanal", "Kênh", "Kanal", "Канал", "Canal", "Kanal", "Canale"),
+    ("Tarefa", "Tarefa", "Task", "任务", "Aufgabe", "Tác vụ", "Görev", "Задача", "Tarea", "Tugas", "Attività"),
+    ("Estado", "Estado", "Status", "状态", "Status", "Trạng thái", "Durum", "Статус", "Estado", "Status", "Stato"),
+    ("Variante", "Variante", "Variant", "变体", "Variante", "Biến thể", "Varyant", "Вариант", "Variante", "Varian", "Variante"),
+    ("Ver prompt da thumbnail", "Ver prompt da thumbnail", "View thumbnail prompt", "查看缩略图提示词", "Thumbnail-Prompt anzeigen", "Xem prompt thumbnail", "Küçük resim istemini görüntüle", "Просмотреть промпт миниатюры", "Ver prompt de miniatura", "Lihat prompt thumbnail", "Visualizza prompt miniatura"),
+    ("Suba uma imagem para a associar a esta tarefa e à pipeline.", "Suba uma imagem para a associar a esta tarefa e à pipeline.", "Upload an image to link it to this task and the pipeline.", "上传图片以将其关联到此任务和流程。", "Laden Sie ein Bild hoch, um es mit dieser Aufgabe und der Pipeline zu verknüpfen.", "Tải ảnh lên để liên kết với tác vụ này và pipeline.", "Bu göreve ve pipeline'a bağlamak için bir görsel yükleyin.", "Загрузите изображение, чтобы связать его с этой задачей и конвейером.", "Suba una imagen para vincularla a esta tarea y al flujo.", "Unggah gambar untuk menautkannya ke tugas dan alur ini.", "Carica un'immagine per collegarla a questa attività e alla pipeline."),
+    ("A guardar a imagem carregada…", "A guardar a imagem carregada…", "Saving uploaded image…", "正在保存上传的图片…", "Hochgeladenes Bild wird gespeichert…", "Đang lưu ảnh đã tải lên…", "Yüklenen görsel kaydediliyor…", "Сохранение загруженного изображения…", "Guardando la imagen subida…", "Menyimpan gambar yang diunggah…", "Salvataggio dell'immagine caricata…"),
 )
 UI_CONTENT_TRANSLATIONS: dict[str, dict[str, str]] = {code: {} for code in _CONTENT_TRANSLATION_CODES}
 for _row in _CONTENT_TRANSLATION_ROWS:

package/hermes_ui/thumbnail_generation.py

@@ -1,6 +1,7 @@
 import base64
 import binascii
 import hashlib
+import mimetypes
 import json
 import os
 import tempfile
@@ -72,6 +73,25 @@ def _extract_image_bytes(payload: dict[str, Any]) -> bytes:
     raise ThumbnailGenerationError("O Gemini concluiu a interação, mas não devolveu uma imagem inline.")
 
 
+def _image_input(path: Path) -> dict[str, str]:
+    if not path.is_file():
+        raise ThumbnailGenerationError("A imagem de referência da thumbnail não está disponível no storage.")
+    try:
+        image_data = path.read_bytes()
+    except OSError as exc:
+        raise ThumbnailGenerationError("Não foi possível ler a imagem de referência da thumbnail.") from exc
+    if not image_data:
+        raise ThumbnailGenerationError("A imagem de referência da thumbnail está vazia.")
+    mime_type = mimetypes.guess_type(path.name)[0] or "image/jpeg"
+    if not mime_type.startswith("image/"):
+        mime_type = "image/jpeg"
+    return {
+        "type": "image",
+        "mime_type": mime_type,
+        "data": base64.b64encode(image_data).decode("ascii"),
+    }
+
+
 def _thumbnail_filename(prompt: str, topic: str, variant_index: int, model: str) -> str:
     source = f"{model}\n{topic.strip()}\n{variant_index}\n{prompt.strip()}".encode("utf-8")
     digest = hashlib.sha256(source).hexdigest()[:20]
@@ -84,6 +104,7 @@ def generate_thumbnail_image(
     *,
     topic: str = "",
     variant_index: int = 0,
+    reference_image: str | Path | None = None,
 ) -> Path:
     api_key = str(settings.get("gemini_image_api_key") or "").strip()
     if not api_key:
@@ -95,9 +116,15 @@ def generate_thumbnail_image(
     model = str(settings.get("gemini_image_model") or DEFAULT_GEMINI_IMAGE_MODEL).strip()
     aspect_ratio = str(settings.get("gemini_image_aspect_ratio") or DEFAULT_ASPECT_RATIO).strip()
     image_size = str(settings.get("gemini_image_size") or DEFAULT_IMAGE_SIZE).strip()
+    request_input: str | list[dict[str, str]] = clean_prompt
+    if reference_image:
+        request_input = [
+            {"type": "text", "text": clean_prompt},
+            _image_input(Path(reference_image)),
+        ]
     body = {
         "model": model,
-        "input": clean_prompt,
+        "input": request_input,
         "response_format": {
             "type": "image",
             "mime_type": DEFAULT_MIME_TYPE,