Clipador: fontes em inglês (juízes em inglês, painel em português) e monitor de uso da IA

Clipador em inglês (doc/clipador/IDIOMAS.md):
- Fonte en-US: analista, editor e varredura com prompts, glossário de chat e saída em inglês;
  a mesma resposta traz o bloco `pt` (tradução para o painel, sem chamada extra).
- Fala do corte traduzida por frase (clips.translation_json, migração v13) e
  POST /v1/clips/{id}/translate.
- caption.translation (só para desenvolver): português embaixo da legenda em inglês.
- Risada e gírias do chat em inglês na heurística (LMAO, LOL, 💀, 😭, no way, bruh...).
- Idioma do público → código do Whisper (en-US dava 422 no serviço de voz).
- Painel: bloco "Em português" no corte, análise/resumo em PT, título traduzido na lista,
  coluna "Ao vivo" mostra a gravação ativa da fonte.

IA: monitor de uso do limite (ai-usage) e 4º provedor (Antigravity CLI).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-18 03:07:09 -03:00
co-authored by Claude Opus 5.5
parent ed31d52df0
commit 20a9805d2a
52 changed files with 1808 additions and 311 deletions
+52
View File
@@ -0,0 +1,52 @@
# Clipador — fontes em outro idioma (inglês)
Decisão do dono (18/11/2026), ao começar com lives gringas (ex.: twitch.tv/tfue jogando ROB RUN):
> A equipe não fala inglês e não precisa falar. O **vídeo sai em inglês** (título, legenda, hashtags, gancho na
> tela); **para a equipe, tudo aparece em português** no painel. Se a fonte está em inglês, **os juízes trabalham
> em inglês**.
## Regra de ouro
| O quê | Idioma |
| --- | --- |
| Transcrição (Whisper) | o da fonte (`language` da fonte/sessão → `X-Language`) |
| Prompts dos juízes (analista, editor, varredura) | **inglês** para fonte `en-*` (`ANALYST_SYSTEM_EN`, `JUDGE_SYSTEM_EN`, `SCAN_SYSTEM_EN`) |
| Glossário de chat no prompt | inglês (`CHAT_GLOSSARY_EN`: LMAO, LOL, 💀, 😭, KEKW, "no way", "bruh", "cooked", "W/L"…) |
| Perfil do jogo no prompt | inglês (`profile_ai_json`; o painel mostra a tradução `profile_json`) |
| Gancho na tela, título, legenda do post, hashtags do momento | **inglês** (é o que publica) |
| O que o painel mostra | **português**: bloco `pt` da mesma resposta da IA + fala traduzida |
Espanhol (`es-419`) ainda usa os prompts em português com a linha "Idioma de saída: …" (`output_language_note`).
## Onde está cada coisa
- `clipper/app/judge.py`: `lang_key(language)` → `"en"` | `"pt"`; prompts e schemas `*_EN`; os schemas em inglês
exigem o bloco `pt` (analista: `what_happened`, `screen`, `speech`, `chat_meaning`, `hook`; editor: `title`,
`caption`, `reason`; varredura: `summary_pt` e `pt` de cada momento). **Sem chamada extra**: a tradução vem na mesma
resposta. `analysis_block` tira o `pt` antes de passar a análise ao editor.
- `Judge.translate_lines`: a fala do corte em frases (`subtitles.phrases`: pausa > 0,7 s, fim de frase, 16 palavras ou
6 s) → português, mesma quantidade. Uma chamada por corte mantido, reaproveitada enquanto cobrir o trecho.
- `Engine.translate_clip` grava em `clips.translation_json` (`{language, startS, endS, model, lines: [{s, e, text, pt}]}`);
`POST /v1/clips/{id}/translate` refaz (409 em fonte em português).
- `clipper/app/scoring.py`: risada/susto/hype/clip do chat também em inglês; palavras faladas de reação (modo sem
chat) em inglês (`bro`, `bruh`, `what`, `holy`, `wait`…).
- Painel: modal do corte com o bloco **"Em português"** (título, legenda e "O que ele fala", frase a frase com o
original embaixo); análise e motivo em português; lista com a tradução do título (🇧🇷); resumo "Agora na live" em
português (`memory[].summaryPt`).
## Legenda em português no vídeo (só para desenvolver)
`caption.translation` (configuração do corte; padrão **desligado**): o vídeo sai com a legenda em inglês e, logo
embaixo, a frase traduzida em português (metade do tamanho, azul claro, quebra de linha automática). Serve para a
equipe conferir se a IA entendeu a fala. **Nunca publicar com isto ligado** — desligue no canal (Configuração do corte
→ "Tradução em português embaixo (teste)") e renderize de novo. Sem tradução disponível, o vídeo sai igual ao normal
(o estilo `Trans` nem entra no ASS).
## Como começar uma fonte gringa
1. Fontes → adicionar o link com idioma **English (US)**.
2. O jogo precisa de perfil em inglês com as gírias do público gringo (Jogos → pedir à IA "acrescente as gírias que
streamers americanos e o chat deles usam"). Perfil antigo só em português: `POST /v1/games/{id}/translate`.
3. Câmera: a detecção local (YuNet) acha o rosto nos 2 primeiros blocos, como em qualquer fonte.
4. Para a fase de teste, ligue "Tradução em português embaixo (teste)" na configuração do corte do canal.