Clipador: grupo dev (camadas só do vídeo de revisão) e render com dev=False

Base comum para três frentes em paralelo (vídeo final ao aprovar, dublagem, falantes):
- layout: grupo `dev` {translation, dub}; `dev_flags(cfg, dev)` desliga tudo no vídeo final;
  `caption.translation` vira legado de `dev.translation`.
- editor_render.build_project_ass / render_project e editor_api.translation_for: parâmetro
  `dev` (padrão True = revisão; False = final, sem camadas de desenvolvimento).
- Painel: switch da tradução passa a gravar em `dev.translation`.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-18 03:09:31 -03:00
co-authored by Claude Opus 5.5
parent 20a9805d2a
commit 54eac7cebf
6 changed files with 55 additions and 16 deletions
+4 -4
View File
@@ -121,11 +121,11 @@ def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, t
return cover.relative_to(REPO_ROOT).as_posix() if cover else None
def translation_for(engine, clip: dict, project: dict, base: dict) -> list[dict] | None:
"""Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `caption.translation`
ligado e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução que o cubra."""
def translation_for(engine, clip: dict, project: dict, base: dict, dev: bool = True) -> list[dict] | None:
"""Frases traduzidas para a legenda de desenvolvimento (doc/clipador/IDIOMAS.md): só com `dev.translation`
ligado, render de desenvolvimento e fonte em inglês. Traduz o trecho do projeto se ainda não houver tradução."""
cfg = editor.effective_settings(base, project)
if not cfg["caption"].get("translation"):
if not layout.dev_flags(cfg, dev)["translation"]:
return None
ps = editor.pieces(project["cuts"])
if not ps:
+8 -6
View File
@@ -200,11 +200,13 @@ def chat_events(project: dict, chat: list | None, total: float,
def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1: float | None = None,
chat: list | None = None, translation: list[dict] | None = None) -> str:
chat: list | None = None, translation: list[dict] | None = None, dev: bool = True) -> str:
"""ASS do projeto em tempo de saída. [t0, t1] recorta a janela (prévia real de poucos segundos).
`chat` = mensagens da sessão (ChatMessage) para o bloco de chat na tela, se o projeto pedir.
`translation` = frases da fala com tradução ({s, e, text, pt}, tempo da sessão; `clips.translation_json`):
com `caption.translation` ligado, o português sai embaixo da legenda (só para desenvolver, IDIOMAS.md)."""
com `dev.translation` ligado, o português sai embaixo da legenda (só para desenvolver, IDIOMAS.md).
`dev=False` = vídeo final (depois de aprovar): nenhuma camada de desenvolvimento (`layout.dev_flags`)."""
flags = layout.dev_flags(cfg, dev)
cap, cred = cfg["caption"], cfg["credit"]
total = output_duration(project["cuts"])
t1 = total if t1 is None else min(t1, total)
@@ -217,7 +219,7 @@ def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1
# normal fica idêntico ao de antes).
tsize = max(30, int(size * 0.5))
trans_style = (f"Style: Trans,Arial,{tsize},&H00FFE79B,&H00FFE79B,&H00000000,&H80000000,-1,0,0,0,100,100,0,0,1,"
f"{max(3, ow // 2)},2,8,60,60,0,1\n") if cap.get("translation") and translation else ""
f"{max(3, ow // 2)},2,8,60,60,0,1\n") if flags["translation"] and translation else ""
header = f"""[Script Info]
ScriptType: v4.00+
PlayResX: {cw}
@@ -315,7 +317,7 @@ Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
intro = "\\fscx85\\fscy85\\t(0,90,\\fscx100\\fscy100)" if preset == "pop" and i == 0 else ""
event(0, start, end, "Caption", f"{{{at(start)}{intro}}}" + " ".join(parts))
if cap.get("translation") and translation:
if flags["translation"] and translation:
# Só para desenvolver (doc/clipador/IDIOMAS.md): a frase traduzida em português, menor e em azul claro,
# logo embaixo da legenda em inglês (\\an8 = cresce para baixo; \\q0 = quebra a linha se for longa).
for line in translation:
@@ -609,7 +611,7 @@ def has_audio_stream(ffprobe: str | None, file: Path) -> bool:
def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segments: list[tuple[Path, float, float]],
project: dict, base_cfg: dict, credit: str, out_file: Path, repo_root: Path,
out_range: tuple[float, float] | None = None, timeout: float = 900, chat: list | None = None,
cover_file: Path | None = None, translation: list[dict] | None = None) -> None:
cover_file: Path | None = None, translation: list[dict] | None = None, dev: bool = True) -> None:
"""Renderiza o projeto (ou só a saída [a, b] para a prévia real). `segments` = (arquivo, início, fim) da sessão.
`chat` = mensagens da sessão (para o chat na tela); `cover_file` = capa já renderizada, posta nos 2 primeiros
quadros quando o projeto pede (`cover.atStart`)."""
@@ -628,7 +630,7 @@ def render_project(ffmpeg: str, ffprobe: str | None, encoder: list[str], segment
stem = out_file.stem
segs, uniform = uniform_segments(ffmpeg, ffprobe, segs, work, stem) # emenda de resolução/codec (retomada)
ass_file = work / f"{stem}.ass"
ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation)
ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation, dev)
ass_file.write_text(ass_text, encoding="utf-8")
input0, concat = _concat_input(work, stem, segs, in0, in1 - in0)
+20 -2
View File
@@ -91,10 +91,13 @@ DEFAULTS: dict = {
"caption": {
"enabled": True, "font": "Arial Black", "size": 84, "color": "#FFFFFF", "highlight": "#FFE500",
"outline": "#000000", "outlineWidth": 7, "y": None, "uppercase": True, "maxWords": 3,
# Só para desenvolver (fonte em inglês, doc/clipador/IDIOMAS.md): a tradução em português da fala embaixo
# da legenda em inglês. Desligado = o vídeo publicável; nunca publicar com isto ligado.
# Legado (18/11/2026, manhã): virou `dev.translation`. Ainda lido por `dev_flags` (camadas já salvas).
"translation": False,
},
# Camadas SÓ DE DESENVOLVIMENTO (doc/clipador/IDIOMAS.md): entram no vídeo de revisão (antes de aprovar) e NUNCA no
# vídeo final — o render com `dev=False` ignora este grupo inteiro. `translation`: português embaixo da legenda;
# `dub`: dublagem em português por TTS com a voz original abaixada.
"dev": {"translation": False, "dub": False},
"credit": {"enabled": True, "position": "top", "size": 44},
"duration": {"minS": 60, "maxS": 90, "backtrackS": 120},
"format": {"aspect": "vertical"},
@@ -122,6 +125,16 @@ def merge(*layers: dict | None) -> dict:
return out
def dev_flags(settings: dict, dev: bool = True) -> dict:
"""Camadas de desenvolvimento ligadas neste render. `dev=False` (vídeo final, depois de aprovar) = tudo desligado.
`caption.translation` (legado) conta como `dev.translation`."""
if not dev:
return {"translation": False, "dub": False}
group = {**DEFAULTS["dev"], **(settings.get("dev") or {})}
return {"translation": bool(group["translation"] or (settings.get("caption") or {}).get("translation")),
"dub": bool(group["dub"])}
def _rect(value, name: str) -> dict | None:
if value is None:
return None
@@ -180,6 +193,11 @@ def validate(settings: dict) -> dict:
if key in cap:
o[key] = bool(cap[key])
out["caption"] = o
dev = settings.get("dev")
if dev is not None:
if not isinstance(dev, dict):
raise LayoutError("dev precisa ser um objeto")
out["dev"] = {k: bool(dev[k]) for k in ("translation", "dub") if k in dev}
cred = settings.get("credit")
if cred is not None:
o = {}
+17
View File
@@ -148,3 +148,20 @@ def test_voice_language_maps_audience_codes_to_whisper_codes():
from app.worker import voice_language
assert voice_language("en-US") == "en" and voice_language("es-419") == "es" and voice_language("pt-BR") == "pt-BR"
assert voice_language("en-GB") == "en" and voice_language("") == "pt-BR"
def test_dev_layers_never_reach_the_final_render(tmp_path):
"""Contrato `dev` (18/11/2026): camadas de desenvolvimento só no vídeo de revisão; `dev=False` = vídeo final limpo."""
assert layout.DEFAULTS["dev"] == {"translation": False, "dub": False}
assert layout.validate({"dev": {"translation": True, "dub": True, "x": 1}})["dev"] == {"translation": True, "dub": True}
cfg = layout.merge({"dev": {"translation": True, "dub": True}})
assert layout.dev_flags(cfg) == {"translation": True, "dub": True}
assert layout.dev_flags(cfg, dev=False) == {"translation": False, "dub": False}
assert layout.dev_flags(layout.merge({"caption": {"translation": True}}))["translation"] is True # legado
clip = {"session_id": 1, "start_s": 10.0, "end_s": 75.0, "peak_s": 50.0, "title": "x", "source": "chat"}
words = [Word(20, 20.4, "No"), Word(20.4, 20.8, "way")]
lines = [{"s": 20.0, "e": 20.8, "text": "No way", "pt": "Não acredito"}]
p = validate(editor.auto_project(clip, None, words, [], 100.0, cfg), tmp_path)
eff = editor.effective_settings(cfg, p)
assert "Não acredito" in editor_render.build_project_ass(p, eff, "x", translation=lines)
assert "Não acredito" not in editor_render.build_project_ass(p, eff, "x", translation=lines, dev=False)