diff --git a/.claude/skills/cenaforge/CHANGELOG.md b/.claude/skills/cenaforge/CHANGELOG.md index e64a954..b8b6fc3 100644 --- a/.claude/skills/cenaforge/CHANGELOG.md +++ b/.claude/skills/cenaforge/CHANGELOG.md @@ -7,6 +7,32 @@ Versão semântica da **skill** (não do projeto): Mantido pelo subagente `cenaforge-skill-updater`. Entradas mais novas no topo. +## 1.53.0 — 18/11/2026 + +IA: monitor de uso do limite e 4º provedor (Antigravity CLI). +- `references/ai.md`: seções "Monitor de uso e limite" (leituras sem gastar token, `overLimit`, `usage.json`, `over_limit` no + Clipador, regra de "pronta") e "Antigravity (`agy`)"; tabela "Onde mexer" com `ai-usage.ts`, `antigravityArgs`, ação `usage`. +- `references/gotchas.md`: 175 (OAuth do Gemini, AI Pro/Ultra), 176 (`/usage` no Git Bash), 177 (permissões do `agy`), + 178 (handshake do `codex app-server`), 179 (IA "pronta" sem estar). +- `references/tools.md`: Antigravity CLI como candidata (1.5.10, desligada, sem tarefa real); `references/panel.md`: 4 provedores. +- `SKILL.md`: versão, `description`, linha "IA" em "Onde mexer", faixa de itens. +- Evidência: `pnpm --filter cenaforge-panel run test:panel` 117/117 (reexecutado); `agy` 1.5.10, `claude` 2.1.314, + `codex-cli` 0.169.0 (`--version`). Informado, não reexecutado: `ai.test.ts` 30, Clipador 346, leituras reais de uso, "Testar" + do Antigravity em 15 s. Não verificado: troca antecipada em tarefa real, UI no navegador, Gemini com chave. + +## 1.52.0 — 18/11/2026 + +Clipador: fontes em inglês (vídeo em inglês, equipe vê português). +- `references/clipper.md`: banco em v13 (`clips.translation_json`); linha "Onde mexer" e seção "Fonte em inglês" (prompts `*_EN`, + bloco `pt` na mesma chamada, `translate_clip`/`translate_lines`, `caption.translation` com estilo `Trans`, `scoring.py` em + inglês, `voice_language`, como começar uma fonte gringa, painel); "Idioma" e "Testes e evidência" atualizados. +- `references/gotchas.md`: 173 (`en-US` voltava 422 no serviço de voz) e 174 (coluna "Ao vivo" com checagem velha). +- `references/panel.md`: linhas de `/clipper` e `/clipper/sources`. +- `SKILL.md`: versão, `description` (fonte em inglês), linha do Clipador, faixa de itens. +- Evidência: `pnpm test:clipper` → 346 passed (reexecutado, 101 s); conferidos no código `VOICE_LANGUAGES`, migração v13, + `caption.translation`, estilo `Trans`, `Intel.lang`, rota `translate`; corte 259 (sessão 15, Tfue) informado, não reexecutado. + Não verificado: IA real, painel no navegador, `pnpm typecheck`. + ## 1.51.0 — 18/11/2026 IA: três provedores (Claude Code, Codex, Gemini CLI), login ou chave de API no cofre e IA reserva. diff --git a/.claude/skills/cenaforge/SKILL.md b/.claude/skills/cenaforge/SKILL.md index 60edd4b..efbb3c8 100644 --- a/.claude/skills/cenaforge/SKILL.md +++ b/.claude/skills/cenaforge/SKILL.md @@ -1,11 +1,11 @@ --- name: cenaforge -description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; estilo "Cartoon" (desenho 2D em Remotion, pacote `cartoon/`: lugares montados por peças a partir do texto, sem cenário pronto; biblioteca de personagens criados uma vez e reaproveitados entre histórias — aba "Personagens", elenco por história, agente "character" —; paleta da série, etiquetas, onomatopeias e legenda palavra por palavra; personagem com rig de expressões e ações de movimento combináveis, fala sincronizada com a narração, acabamento de ilustração: formato de cabeça, nariz, pálpebra, rugas, acessórios de profissão, enquadramento close/medium e textura de papel); ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude Code, Codex ou Gemini CLI) no painel, IA (provedores, entrar com a conta ou chave de API no cofre, ordem e IA reserva quando uma cai por cota/login/rede, Configurações em subpáginas), mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo bilíngue (português para ler, inglês para a IA) editável/refinável pela IA, com missões, gatilhos de fim de missão e outros nomes (aliases), cadastro e apagar jogo pelo painel, tradução do perfil e semente do GTA VI, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), interface em subpáginas (Cortes com modal, Sessões, Fontes, Jogos, Ajustes), parar a sessão à mão (pausa o monitor da fonte, "Religar"), idioma da fonte, da sessão e do canal de publicação (en-US, es-419), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada e com "Horário específico" por rede, ordenar a fila de cortes, capa que sumiu do dashboard, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou, YouTube Studio que "não confirmou" a publicação, hashtag do TikTok que não vira hashtag (legenda colada), botão "Publicar no " nos cartões de Publicações), números dos posts (views, curtidas, comentários) lidos das redes e mostrados no Dashboard (leitura automática a cada N horas, "Atualizar números agora"), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge". +description: Produz e altera vídeos narrativos do projeto CenaForge — cena 3D (rua) ou do documentário (2D: título, contador, mapa do litoral de SP, `kind: "doc2d"`; 3D da biblioteca de cenas `godot/library/`, ex.: ilha com farol de dia/entardecer/noite, náufragos no costão, `kind: "doc3d"`; peças `godot/kits/`: pessoa articulada com poses e barco; cena dentro de outra) descrita por JSON, animada por tempo de cena na Godot, gravada pelo Movie Maker e convertida em MP4 pelo FFmpeg. Use sempre que o pedido envolver criar, renderizar ou ajustar um vídeo, episódio ou cena (câmera, movimento, cenário, personagem, moto, luz, texto e opções A/B, áudio, resolução), validar um MP4, gerar narração (TTS: Edge, Piper, Kokoro, Google, Azure Speech) ou escolher/filtrar voz, clonar voz a partir de uma gravação (Chatterbox, com consentimento), vozes de personagem (RVC/Applio) ou transcrição com tempos para legenda (.srt) pelo serviço de voz local ou pela página Vozes do painel, histórias interativas com vertentes e votação A–D, lineares ou documentais (vídeo único sobre fatos reais, com fontes) e onde ficam as regras de roteiro (doc/roteiro/), leitor de roteiro do painel (trechos, narração × duração alvo, fontes), criar cena 3D nova na biblioteca (`template.gd` + `manifest.json`, guia `doc/godot/cenas.md`, tarefa "Cena no Godot" do agente), montagem do vídeo documental em MP4 no painel ("Gerar vídeo automático" num clique: plano por regras, fotos reais do Wikimedia Commons, narração e cenas 2D/3D da Godot; "Gerar de novo" por trecho e "Refazer tudo do zero"; estilo "Tudo em 3D" com cartão de foto real por cima e cartões de informação em sequência; estilo "Cartoon" (desenho 2D em Remotion, pacote `cartoon/`: lugares montados por peças a partir do texto, sem cenário pronto; biblioteca de personagens criados uma vez e reaproveitados entre histórias — aba "Personagens", elenco por história, agente "character" —; paleta da série, etiquetas, onomatopeias e legenda palavra por palavra; personagem com rig de expressões e ações de movimento combináveis, fala sincronizada com a narração, acabamento de ilustração: formato de cabeça, nariz, pálpebra, rugas, acessórios de profissão, enquadramento close/medium e textura de papel); ou manual: áudio por trecho com números por extenso, visual por trecho — foto com fundo desfocado, animação 2D, cena 3D da biblioteca, clipe ou cartela —, texto na tela, legenda e créditos, pelo FFmpeg), excluir história no painel (vai para data/trash/), escolha de agente e modelo (Claude Code, Codex, Gemini CLI ou Antigravity) no painel, IA (provedores Claude, Codex, Gemini e Antigravity, entrar com a conta ou chave de API no cofre, ordem e IA reserva quando uma cai por cota/login/rede, monitor de uso do limite e troca antes de bater, Configurações em subpáginas), mensagem ou correção ao agente durante a execução (Corrigir agora / Enviar ao terminar), termos episódio × vídeo na interface, contas e dashboard (métricas simuladas) do painel, Clipador (cortes automáticos de live da Twitch/Kick/YouTube, verticais 9:16 ou horizontais 16:9 para YouTube, com duração configurável e mínimo garantido, qualidade de gravação configurável até 2K: chat e emotes, heurística, varredura da IA, juízes analista e editor pela CLI, contexto do jogo e perfil do jogo bilíngue (português para ler, inglês para a IA) editável/refinável pela IA, com missões, gatilhos de fim de missão e outros nomes (aliases), cadastro e apagar jogo pelo painel, tradução do perfil e semente do GTA VI, webcam achada sem IA e layout do corte, rastreio de reação do rosto do streamer (YuNet, MediaPipe, expressões que reforçam o corte), legenda com hashtags do canal, do jogo e do momento, editor de cortes em tela cheia no padrão de editor de vídeo, com timeline de uma trilha por camada e projeto de edição feito pela IA (trechos com layout próprio e trecho mudo, câmera inteira e editável na Fonte, legenda animada editável arrastando, gancho em tarja animada, fontes empacotadas, textos, zoom, reenquadramento do jogo com keyframes, camadas inseridas (recorte da tela em destaque), chat da live na tela, narração, música, capa também no início, export pelo FFmpeg), interface em subpáginas (Cortes com modal, Sessões, Fontes, Jogos, Ajustes), parar a sessão à mão (pausa o monitor da fonte, "Religar"), idioma da fonte, da sessão e do canal de publicação (en-US, es-419), fonte de live em inglês (juízes em inglês, vídeo em inglês, painel em português, fala traduzida frase a frase, legenda em português embaixo para teste), retomada de live que caiu, cortes duplicados descartados (o rejeitado ou apagado não volta), render que falha, fila de aprovação com apagar corte (um, selecionados ou a aba inteira), relógio da gravação e cadência do resumo no cartão da sessão, prévia do editor igual ao render (legenda e recorte), "não sai corte" (live fria × regras) e fontes ligadas aos canais de publicação), publicação automática em YouTube, TikTok e Instagram (serviço Publicador, canais de publicação, conectar rede pela API oficial ou sessão logada, aprovação manual ou automática, horários bons e limite por dia, botão "Publicar" no corte aprovado, inclusive sem fonte ligada e com "Horário específico" por rede, ordenar a fila de cortes, capa que sumiu do dashboard, fila "Publicações", Configurações, job que falhou, pede login ou pede "Confira na rede", "Já saiu: informar o link" quando o vídeo foi ao ar mas o job falhou, YouTube Studio que "não confirmou" a publicação, hashtag do TikTok que não vira hashtag (legenda colada), botão "Publicar no " nos cartões de Publicações), números dos posts (views, curtidas, comentários) lidos das redes e mostrados no Dashboard (leitura automática a cada N horas, "Atualizar números agora"), chamar a API do painel por script (cabeçalhos `Origin` e JSON; criar história com agente por `POST /api/stories`), agente que parou no limite de uso ou morreu ao reiniciar o painel, instalar/subir o projeto (setup.bat, start.bat, pnpm dev), ou trocar/adicionar ferramentas de 3D, voz ou render neste repositório — mesmo que o usuário não diga "skill" nem "CenaForge". --- # CenaForge — vídeo a partir de cena descrita por JSON -**Versão da skill: 1.51.0** (18/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md). +**Versão da skill: 1.53.0** (18/11/2026) — histórico em [CHANGELOG.md](CHANGELOG.md). Mantida pelo subagente `cenaforge-skill-updater` (ver "Manutenção" no fim). ## Regra zero @@ -113,11 +113,11 @@ Interativa = 2–4 vertentes, mas o overlay só desenha `choiceA`/`choiceB`. Tab | Publicação nas redes (Publicador, despachante, canais de publicação, fila, Configurações) | `publisher/app/` · `panel/src/lib/` (`publisher.ts`, `publishing.ts`, `publishing-rules.ts`, `dispatcher.ts`, `settings.ts`) · `panel/src/instrumentation.ts` · botão "Publicar" do corte `components/clip-publish.tsx` · números dos posts: `publisher/app/platforms/stats.py` + `session/stats.py`, `panel/src/lib/metrics-sync.ts`, `metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx` — tabela em [references/publishing.md](references/publishing.md) | `publisher/tests/` (`test_stats.py`), `panel/src/lib/publishing-*.test.ts`, `doc/publicacao/PLANO.md` se mudar o contrato | | Localizar executáveis / encoders | `scripts/lib/tools.ts` | [references/tools.md](references/tools.md) | | Painel: páginas, API, votação, agentes (prompt por provedor, lista de modelos `models()`, mensagem durante a execução `sendFollowUp`) | `panel/src/app/`, `panel/src/lib/` (`agents.ts`, `prompts.ts`, `decisions.ts`, `assets.ts`, `renders.ts`); console em `components/agent-console.tsx` | `panel/README.md`; `AGENTS.md` se mudar regra do Codex | -| IA: provedores (Claude/Codex/Gemini), login ou chave, cofre, IA reserva, Configurações → IA | `panel/src/lib/ai.ts` (+ `agents.ts`, `app/api/ai/`), `components/ai-settings.tsx`, `settings-shell.tsx`; juiz: `clipper/app/ai_settings.py`, `judge.py` — contrato `doc/ia.md`, resumo em [references/ai.md](references/ai.md) | `panel/src/lib/ai.test.ts`, `clipper/tests/test_ai_fallback.py` | +| IA: provedores (Claude/Codex/Gemini/Antigravity), login ou chave, cofre, IA reserva, monitor de uso e limite, Configurações → IA | `panel/src/lib/ai.ts`, `ai-usage.ts` (+ `agents.ts`, `app/api/ai/`), `components/ai-settings.tsx`, `settings-shell.tsx`; juiz: `clipper/app/ai_settings.py`, `judge.py` — contrato `doc/ia.md`, resumo em [references/ai.md](references/ai.md) | `panel/src/lib/ai.test.ts`, `clipper/tests/test_ai_fallback.py` | | Painel: página Vozes (`/voices`) | servidor `panel/src/lib/voice.ts` + `panel/src/app/api/voice/*`; cliente `panel/src/components/voice-*.ts(x)` (`voice-client.ts` tipos e `uploadWithProgress`; `voice-cards.tsx` catálogo e filtros; `voice-clone-form.tsx`; `AzureForm` em `voice-studio.tsx`) | `voice/README.md` se mudar o contrato; largura de `Select`/`Input`: gotchas item 62 | | Regra de roteiro (idioma, overlay, ficção, documental, formato de `biblia.md`/`epNN.md`) | `doc/roteiro/comum.md`, `ficcao.md`, `documental.md` | nada no código; `.claude/agents/cenaforge-story-writer.md` só aponta para lá | | Painel: vertentes, votação A–D, contas, dashboard, excluir história (`deleteStory`), migração do banco | `branches.ts`, `decisions.ts`, `flow.ts`, `accounts.ts`, `metrics.ts`, `stories.ts`, `db.ts` em `panel/src/lib/` — ver [references/panel.md](references/panel.md) | `panel/README.md` | -| Clipador: captura e qualidade de gravação (`capture.py`), retomada de live, chat/emotes, heurística, duplicados, varredura, juízes, jogo, formato (vertical/horizontal), duração mínima (`fit_window`), layout/webcam, rastreio de reação (rosto), legenda, gancho/tarja e fontes (`assets/fonts/`), reenquadramento e camadas inseridas (`reframe.py`), render, apagar cortes (`clip_delete.py`, tabela `deleted_clips`), editor de cortes, páginas `/clipper/*` (grupo `(studio)`), pausa do monitor e idioma, canais nas contas | `clipper/app/` · `panel/src/lib/clipper.ts` (regex `ALLOWED`, métodos `METHODS` + timeout por rota) · `panel/src/components/clipper-*.tsx` (moldura `clipper-shell.tsx`, páginas em `panel/src/app/clipper/(studio)/`) e `clip-editor*.ts(x)` — tabela em [references/clipper.md](references/clipper.md) | `clipper/tests/`, `clipper/README.md`; peso novo em `clipper/models.lock.json` (URL imutável + sha256) | +| Clipador: captura e qualidade de gravação (`capture.py`), retomada de live, chat/emotes, heurística, duplicados, varredura, juízes, jogo, formato (vertical/horizontal), duração mínima (`fit_window`), layout/webcam, rastreio de reação (rosto), legenda, gancho/tarja e fontes (`assets/fonts/`), reenquadramento e camadas inseridas (`reframe.py`), render, apagar cortes (`clip_delete.py`, tabela `deleted_clips`), editor de cortes, páginas `/clipper/*` (grupo `(studio)`), pausa do monitor e idioma, fonte em inglês (`*_EN`, `translate_clip`, `voice_language`), canais nas contas | `clipper/app/` · `panel/src/lib/clipper.ts` (regex `ALLOWED`, métodos `METHODS` + timeout por rota) · `panel/src/components/clipper-*.tsx` (moldura `clipper-shell.tsx`, páginas em `panel/src/app/clipper/(studio)/`) e `clip-editor*.ts(x)` — tabela em [references/clipper.md](references/clipper.md) | `clipper/tests/`, `clipper/README.md`; peso novo em `clipper/models.lock.json` (URL imutável + sha256) | | Hashtags da legenda do corte (canal, jogo, momento) | `clipper/app/hashtags.py` (+ `judge.py`, `intel.py`, `worker.py`; painel `clipper-games.tsx`) — ver [references/clipper.md](references/clipper.md) | `clipper/tests/test_hashtags.py` | | Painel: leitor de roteiro (trechos, narração, fontes; página `/stories/[storyId]/episodes/[number]/roteiro`) | parser puro `panel/src/lib/script-doc.ts` (`parseScript`, `WORDS_PER_SECOND`) + `panel/src/components/script-reader.tsx` — ver [references/panel.md](references/panel.md) | formato do roteiro em `doc/roteiro/` (cabeçalho da tabela de trechos) | | Painel: montagem documental (um clique ou manual; estilo `mixed`/`3d`/`cartoon`; áudio, visual e cartão de foto por trecho → MP4) | estado/banco/modo automático/"Gerar de novo" `panel/src/lib/montage.ts`; FFmpeg **sem banco** `montage-ffmpeg.ts` (cartão, textos em sequência); plano do trecho (`planShot`, `planShot3d`) e render Godot **sem banco** `montage-godot.ts`; biblioteca `scene-library.ts`; fotos `image-search.ts`; fala por extenso `speech-text.ts`; UI `components/montage-editor.tsx`; rotas `app/api/episodes/[id]/montage/` — ver [references/panel.md](references/panel.md#montagem-documental) | `doc/roteiro/comum.md` e `documental.md` se mudar regra de narração/trecho | @@ -222,10 +222,10 @@ serviço de voz, Clipador, publicação ou Cartoon. As que mais custam caro: (`override.cfg`); `--write-movie` relativo falha em silêncio com código 0. - Regex em `node -e`/heredoc/Python sem string raw perde ou corrompe `\` e `` (itens 44 e 162): edite pelo Edit. - Reiniciar o `pnpm panel` mata o agente em execução; limite de uso: a IA reserva recomeça a tarefa sozinha; sem ela, - continue à mão no outro provedor (131–135, 168–172; [references/ai.md](references/ai.md)). + continue à mão no outro provedor (131–135, 168–172, 175–179; [references/ai.md](references/ai.md)). - **Correção que "não pegou" = serviço Python rodando código antigo (sem `--reload`): compare o início do processo com o `LastWriteTime` do arquivo antes de validar (143).** -- IA, login e chave (168–172). Publicação/modo sessão (137–155, 158–159), Cartoon (156, 157, 160–165) e Clipador (144, 166, 167): ver o item citado em gotchas. +- IA, login, chave, limites e Antigravity (168–172, 175–179). Publicação/modo sessão (137–155, 158–159), Cartoon (156, 157, 160–165) e Clipador (144, 166, 167, 173, 174): ver o item citado em gotchas. ## Manutenção desta skill diff --git a/.claude/skills/cenaforge/references/ai.md b/.claude/skills/cenaforge/references/ai.md index f08cb1e..3bfaf74 100644 --- a/.claude/skills/cenaforge/references/ai.md +++ b/.claude/skills/cenaforge/references/ai.md @@ -1,17 +1,18 @@ -# IA: três provedores, login/chave e IA reserva +# IA: provedores, login/chave, IA reserva e monitor de uso Fonte do contrato: **`doc/ia.md`** (arquivos, ambiente de cada chamada, o que conta como indisponível, Gemini headless). Não duplique aqui; este arquivo diz onde mexer e o que não quebrar. Sempre pela **CLI oficial** -(`claude`, `codex`, `gemini`), nunca SDK/HTTP direto. +(`claude`, `codex`, `gemini`, `agy`), nunca SDK/HTTP direto. `antigravity` é o 4º provedor (começa **desligado**). ## Onde mexer | Mudança | Arquivo(s) | Também atualizar | |---|---|---| | Configurações, cofre, detecção, instalação, login, teste, `providerEnv`, `isAvailabilityError`, pausa, `readyChain`/`nextFallback` | `panel/src/lib/ai.ts` | `panel/src/lib/ai.test.ts`, `doc/ia.md` | -| Agente do painel por provedor (`geminiArgs`, `normalizeGemini`, `--resume`, shell liberado), troca de IA ao cair | `panel/src/lib/agents.ts` (`prompts.ts`, `types.ts` para `AgentProvider`) | `ai.test.ts` (argumentos e eventos do Gemini) | +| Agente do painel por provedor (`geminiArgs`, `normalizeGemini`, `antigravityArgs`, `normalizeAntigravity`, `--resume`/`--conversation`, shell liberado), troca de IA ao cair | `panel/src/lib/agents.ts` (`prompts.ts`, `types.ts` para `AgentProvider`) | `ai.test.ts` (argumentos e eventos do Gemini) | | Execução que continua outra que caiu | coluna `agent_runs.fallback_of` (migração v10 em `panel/src/lib/db.ts`), `followUpRunOf` (segue `resume_of` **e** `fallback_of`) | `publishing-db.test.ts` (conta de migrações) | -| API | `panel/src/app/api/ai/route.ts` (`GET/PUT /api/ai`), `.../ai/[provider]/route.ts` (`POST {action: install\|login\|verify\|test\|resume}`, `PUT/DELETE` = chave) | guarda `Origin`/JSON (gotchas, item 125) | +| Monitor de uso (leitura sem gastar token, `overLimit`, `usage.json`) | `panel/src/lib/ai-usage.ts` (`refreshUsage`, `ensureUsageMonitor`, `normalizeClaude`), `overLimit` em `lib/ai.ts`; `refreshUsage({maxAgeMs: 60_000})` nos 4 pontos que chamam `startRun` (`actions.ts`, `api/agent/runs`, `api/stories`, `api/characters/[id]/agent`); juiz: `AiConfig.over_limit` em `clipper/app/ai_settings.py` | `ai.test.ts`, `test_ai_fallback.py`, `doc/ia.md` | +| API | `panel/src/app/api/ai/route.ts` (`GET/PUT /api/ai`), `.../ai/[provider]/route.ts` (`POST {action: install\|login\|verify\|test\|resume\|usage}`, `PUT/DELETE` = chave) | guarda `Origin`/JSON (gotchas, item 125) | | Tela | `panel/src/components/ai-settings.tsx` em `panel/src/app/settings/ai/page.tsx`; seletor de provedor em `agent-console.tsx` e `story-composer.tsx` | — | | Subpáginas de Configurações | `panel/src/app/settings/{ai,publishing,apps,browser,modes}/page.tsx` + `layout.tsx`; seções em `SETTINGS_SECTIONS` de `components/settings-shell.tsx` (o menu lateral `sidebar-nav.tsx` as lê como `children`); `/settings` redireciona para `/settings/ai` | seção nova = entrada em `SETTINGS_SECTIONS` + pasta | | Juiz do Clipador (3 provedores, reserva por chamada) | `clipper/app/judge.py` (`_gemini`, `find_gemini`, `parse_gemini_output`), leitura de settings e cofre `clipper/app/ai_settings.py` (DPAPI por `ctypes`), `main.py`, `config.py`, `intel.py` | `clipper/tests/test_ai_fallback.py`, `conftest.py`, `clipper/README.md` | @@ -33,12 +34,37 @@ headless). Não duplique aqui; este arquivo diz onde mexer e o que não quebrar. - Instalação: Claude pelo instalador nativo (`irm https://claude.ai/install.ps1 | iex`); Codex e Gemini por `npm install -g`. O painel procura também em `~/.local/bin` e `%APPDATA%\npm`. +## Monitor de uso e limite + +- **Leituras sem gastar token** (`ai-usage.ts`): Claude `claude -p "/usage"` (texto, US$ 0, modelo ``) e + `rate_limit_event` de cada execução (`normalizeClaude`); Codex `codex app-server` (`account/rateLimits/read`); + Antigravity `agy -p "/usage" --output-format stream-json`. **Gemini CLI: sem leitura**, só reativo (429). +- Renova a cada 5 min (`ensureUsageMonitor`, ligado pelo `GET /api/ai`) e antes de cada tarefa (`maxAgeMs: 60_000`). +- `overLimit` (`lib/ai.ts`): a IA bateu o limite, ou janela ainda valendo >= `fallback.usageLimitPercent` (padrão 90, + faixa 50-100). Leitura com mais de 30 min não decide. `startRun` troca para a próxima IA livre; **em retomada + (`resume`) não troca**. +- O painel escreve `data/ai/usage.json`; o Clipador lê por `AiConfig.over_limit` e põe a IA acima do limite depois das + livres em `fallback_chain`. UI: bloco "Uso do limite" por cartão, campo do limite no cartão da reserva, + `POST /api/ai/[provider] {action:"usage"}`. +- **Pronta:** IA cujo último teste falhou por indisponibilidade (login/cota) **não** é "pronta"; Gemini em modo conta só + conta como pronto depois de um teste que passou. "Testar" continua habilitado. + +## Antigravity (`agy`) + +- `agy.exe` em `~/.gemini/bin` (fora do PATH; `AGY_BIN` sobrescreve). Sem instalador por linha de comando + (`install.command` null; a UI mostra o site). Login conferido por `agy models`; atualizar = `agy update`. +- Agente: `agy -p --output-format stream-json --mode accept-edits [--conversation ]`; shell **só** por regra + exata `command()` via `--settings` (gotchas 177). Eventos e formatos: `doc/ia.md`, "Antigravity no painel". +- Começa desligado. **Aviso de termos:** a FAQ do Google diz que embrulhar o `agy` em programa de terceiro "não é + suportado" nos planos pessoais; a decisão de ligar é do usuário. O juiz do Clipador **não** usa antigravity. + ## Estado verificado (18/11/2026) -- Nesta máquina: `claude` 2.1.314 e `codex` 0.169.0 (`--version` reconferido pela skill); `gemini` **não instalado** - (`command not found`). -- `pnpm --filter cenaforge-panel test:panel` inclui `ai.test.ts`: 21 testes, 21 passaram (reexecutado pela skill; um - usa a DPAPI real). Clipador: `pnpm test:clipper` → 335 passed (reexecutado). Suíte do painel 104/104: informada. - Ida e volta real do cofre painel → Clipador: informada, não repetida. +- Nesta máquina: `claude` 2.1.314, `codex` 0.169.0, `agy` 1.5.10 (`--version` reconferido); `gemini` **não instalado**. +- `pnpm --filter cenaforge-panel run test:panel`: 117/117 (reexecutado pela skill). `ai.test.ts` 30 testes (informado). + Clipador: 346 passed (informado; reexecutado na 1.52.0). +- Leituras reais informadas: Claude 4% / 67%; Codex janela de 5 h em 100% (`rate_limit_reached`), semanal 29%; + Antigravity 12% / 5%. "Testar" do Antigravity respondeu "ok" em 15 s. - **Não verificado:** Gemini com chave real, `@arquivo` de imagem no juiz, envelope de erro do `-o json`, a UI - `/settings/ai` no navegador, troca de IA no meio de um agente real. Armadilhas: gotchas, itens 168–172. + `/settings/ai` no navegador, troca de IA no meio de um agente real, troca antecipada por `overLimit` em tarefa real. + Armadilhas: gotchas, itens 168-172 e 175-179. diff --git a/.claude/skills/cenaforge/references/clipper.md b/.claude/skills/cenaforge/references/clipper.md index 394c243..b8b9fd2 100644 --- a/.claude/skills/cenaforge/references/clipper.md +++ b/.claude/skills/cenaforge/references/clipper.md @@ -12,7 +12,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You | O quê | Onde | |---|---| -| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 12, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão); v11 `channels.monitor_paused_at`/`monitor_paused_session`/`language` e `sessions.language`, padrão `''` = `CLIPPER_LANGUAGE`; v12 `games.profile_ai_json` (perfil em inglês), `translated_at`, `aliases_json`). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova | +| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 13, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão); v11 `channels.monitor_paused_at`/`monitor_paused_session`/`language` e `sessions.language`, padrão `''` = `CLIPPER_LANGUAGE`; v12 `games.profile_ai_json` (perfil em inglês), `translated_at`, `aliases_json`; v13 `clips.translation_json`, fala do corte em frases + português). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova | | Blocos gravados (`.ts` de 30 s + `segments.csv`) e frames | `data/clipper/sessions//` (frames em `frames/`) | | Pesos do rastreio de reação (YuNet, MediaPipe, OpenSeeFace) | `data/clipper/models/`, fixados (URL imutável + sha256) em `clipper/models.lock.json` | | Cortes prontos | `output/clipper//clip-.mp4` + `clip-.jpg` | @@ -30,6 +30,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You | Retomada de live (`Engine.live_check`, `keep_live`, `RESUME_DELAYS_S`, `resume_interrupted`), render que falha (`recover_orphan_renders`, `ORPHAN_RENDER_S` 300, `MAX_RENDER_ATTEMPTS` 3), cortes duplicados (`SAME_PEAK_S` 10, `SAME_MOMENT_OVERLAP` 0,6, `KEPT_STATUSES`/`VETO_STATUSES`, `discard_pending_duplicates`) | `clipper/app/worker.py` | `clipper/tests/test_resume.py`, `clipper/tests/test_render_and_duplicates.py` | | Apagar cortes (`delete_clip`, `delete_many`, `select_ids`, `MAX_BATCH` 500, recusas `BUSY`/`PUBLISHED`/`CHANGED`, marca `marks`/`mark_spans`, arquivos só dentro das pastas do Clipador) | `clipper/app/clip_delete.py`; rotas em `main.py` (`ClipsDeleteIn`); marca lida em `worker.py` (veto depois do juiz) e na varredura (`intel.py`) | `clipper/tests/test_clip_delete.py`; `METHODS` em `panel/src/lib/clipper.ts`; seção "Apagar cortes" abaixo | | Parar à mão e pausa do monitor (`Engine.stop_session(id, pause_monitor=True)`, `StopIn.pauseMonitor`), idioma por fonte/sessão (`check_language`, visões de fonte/sessão/corte com `language` resolvido; Whisper e `judge.output_language_note`) | `clipper/app/worker.py`, `main.py`, `db.py` (v11), `judge.py`; painel `ACCOUNT_LANGUAGES` em `panel/src/lib/languages.ts` | `clipper/tests/test_monitor_pause_and_language.py` (9); seção "Parar é parar e idioma" abaixo | +| Fonte em outro idioma (inglês): prompts `*_EN`, schemas com bloco `pt`, `lang_key`, `translate_lines`, `translate_clip`, `voice_language`, `phrases`, legenda `Trans` | `clipper/app/judge.py`, `intel.py` (`Intel.lang`), `worker.py`, `subtitles.py`, `scoring.py`, `layout.py`, `editor_render.py`, `editor_api.py` (`translation_for`), `main.py`; painel `clipper-client.ts`, `clipper-clip-dialog.tsx`, `clipper-clip-parts.tsx`, `clipper-clip-table.tsx`, `clipper-session-detail.tsx`, `clipper-cut-settings.tsx` | `clipper/tests/test_english_source.py` (9); seção "Fonte em inglês" abaixo | | Chat (IRC anônimo da Twitch com `CAP REQ :twitch.tv/tags` → emotes nativos e `room-id`; Pusher da Kick, emotes `[emote:id:NOME]`) | `clipper/app/chat.py` | — | | Heurística: pesos, base de 3 min, mínimo proporcional (`_required_messages`), reações (`min_reactions`), chat fraco (`sparse_rate` 0,5 msg/s), momentos do chat/áudio/rosto (`_chat_moments`/`_audio_moments`/`_face_moments`; `face_*` em `Params`), `pick_peaks`, `fit_window` (duração de todo corte automático) | `Params` e funções em `clipper/app/scoring.py`; alvo `min_target` em `layout.py` | `clipper/tests/test_scoring.py` (regressões de falso positivo, chat fraco e rosto), `test_duration_banner_fonts.py` | | Rastreio de reação — E/S: backends (MediaPipe; plano B OpenSeeFace), download sob demanda com sha256, recorte FFmpeg 6 qps, laço `face` | `clipper/app/face.py` (`for_scoring`, `must_wait`, `view`, `reset`); laço `_face_loop` e uso de `must_wait` na decisão do corte em `worker.py`; bancada `clipper/tools/face_bench.py` | `clipper/tests/test_face.py`, `clipper/models.lock.json`, `doc/FACE_BAKEOFF.md` | @@ -342,12 +343,47 @@ Texto completo no README do Clipador ("Parar é parar", "Idioma por fonte e por sozinho (marcada = não pausa). - **Idioma.** `language` em `channels` e `sessions` (`pt-BR`, `en-US`, `es-419`; `''` = `CLIPPER_LANGUAGE`), aceito em `POST/PATCH /v1/channels` e `POST /v1/sessions`; as visões de fonte, sessão e corte devolvem o idioma **já resolvido**. - O Whisper usa o idioma da sessão; fora de pt-BR os prompts do editor e da varredura recebem a nota de idioma de saída. + O Whisper usa o idioma da sessão (pela fronteira `voice_language`, ver abaixo); espanhol mantém os prompts em português com a nota de idioma de saída; inglês tem juízes próprios (seção "Fonte em inglês"). No painel, `accounts.language` (migração v9 do painel, padrão `pt-BR`) e o aviso no diálogo Publicar quando o idioma do - canal difere do idioma do corte. Versões traduzidas de um mesmo corte: **ainda não existem** (próxima etapa). + canal difere do idioma do corte. Versão do corte em outro idioma para publicar: **ainda não existe**; a tradução em português guardada é só para a equipe ler. - Sem reiniciar o Clipador as rotas novas não valem; o painel trata `language`/pausa como opcionais e não quebra (gotchas, item 166). +## Fonte em inglês (18/11/2026) + +Fonte do contrato: `doc/clipador/IDIOMAS.md`; README do Clipador, "Idioma por fonte e por sessão". Decisão do dono: o +**vídeo sai em inglês** (título, legenda, hashtags, gancho) e **a equipe vê tudo em português** no painel. + +- **Regra:** `judge.lang_key(language)` = `"en"` para `en-*`, senão `"pt"`; `Intel.lang(session)` resolve. Em inglês, analista, + editor e varredura usam `ANALYST_SYSTEM_EN`/`JUDGE_SYSTEM_EN`/`SCAN_SYSTEM_EN`, `CLIP_GUIDE_EN`, `CHAT_GLOSSARY_EN` e + `LABELS` en nos montadores (parâmetro `lang` em `Judge.analyze/judge/scan`). Perfil do jogo no prompt = `profileAi`. +- **Tradução sem chamada extra:** os schemas `*_EN` exigem o bloco `pt` (analista: `what_happened`, `screen`, `speech`, + `chat_meaning`, `hook`; editor: `title`, `caption`, `reason`; varredura: `summary_pt` e `pt` por momento). Vai em + `judge_json.pt`, `memory[].summaryPt`, `reasons.proposalTitlePt/proposalReasonPt`. `analysis_block` tira o `pt` antes do editor. + Campo novo no schema inglês = pôr o `pt` correspondente e mostrar no painel. +- **Fala traduzida:** `Engine.translate_clip(clip_id, lo, hi, force)` (chamada quando o corte é mantido) grava + `clips.translation_json` `{language, startS, endS, model, lines: [{s, e, text, pt}]}`; frases de `subtitles.phrases` + (pausa > 0,7 s, fim de frase com 4+ palavras, 16 palavras ou 6 s) traduzidas por `Judge.translate_lines`. + `POST /v1/clips/{id}/translate` refaz (409 em fonte PT); `clip_view.translation`. +- **Legenda em português no vídeo (só para desenvolver):** `caption.translation` (padrão `false`) → estilo ASS `Trans` + (metade do tamanho, `&H00FFE79B`, `n8` + `\q0`) sob a legenda, seguindo o desvio do gancho; só entra no ASS quando + ligado **e** há tradução (sem isso o ASS é idêntico ao de antes). `editor_api.translation_for` alimenta render e prévia. + **Nunca publicar com isto ligado.** +- **Heurística:** `scoring.py` (`REACTION_PATTERNS`, `SPOKEN_REACTION`) reconhece reação em inglês (lmao, lol, 💀, 😭, no + way, bruh, holy, clutch, goated, clip that…). `judge.output_language_note` agora é vazio também para inglês. +- **Voz:** `worker.VOICE_LANGUAGES`/`voice_language()` converte `en-US` → `en` e `es-419` → `es` antes do Whisper (gotchas, item 173). +- **Começar uma fonte gringa:** Fontes → idioma English (US); jogo com perfil em inglês e gírias do público gringo + (Jogos → "acrescente as gírias…", ou `POST /v1/games/{id}/translate` se o perfil só existe em português); ligar + "Tradução em português embaixo (teste)" na configuração do corte do canal enquanto estiver testando. +- **Painel:** modal do corte com bloco "Em português" (título, legenda, "O que ele fala" frase a frase, botão "Traduzir a + fala"); lista com título traduzido (🇧🇷); resumo da sessão em português; switch em `clipper-cut-settings.tsx`; Fontes: a + coluna "Ao vivo" mostra "gravando #N" da sessão ativa e checagem do monitor com mais de 10 min vira "ao vivo há X" + apagado (gotchas, item 174). +- Medido (18/11/2026, sessão 15, twitch.tv/tfue, ROB RUN, 1080p60 h264, informado pelo coordenador): transcrição em + inglês ok; câmera pela YuNet em 12/12 quadros; corte manual 259 (30–100 s) com título, legenda e hashtags em inglês, + `judge.pt` em português, 27 frases traduzidas e vídeo 1080×1920 com inglês em cima e português embaixo. Não verificado + por mim: o render real (só a suíte foi reexecutada); qualidade da tradução fora desse corte; espanhol ponta a ponta. + ## Perfil do jogo (aba Jogos) Fonte do contrato: `doc/clipador/JOGOS.md`; seção "Contexto do jogo" de `clipper/README.md`. Toda rota abaixo devolve a @@ -417,6 +453,11 @@ missão logo depois do gatilho de fim. Busca por nome casa `id` **ou** alias (ca ## Testes e evidência +Fonte em inglês (18/11/2026): `pnpm test:clipper` → **346 passed** (reexecutado nesta manutenção, 101 s); `test_english_source.py` +novo (9 testes) e ajustes em `test_monitor_pause_and_language.py`, `test_render_and_duplicates.py`, `test_intel.py`. Não +verificado: IA real com prompts em inglês (só o corte 259 informado), painel no navegador, `pnpm typecheck`, banco real em v13 +(o serviço precisa reiniciar). + Perfis de jogo bilíngues, missões, cadastro e semente do GTA VI (18/11/2026): `pnpm test:clipper` → **335 passed** (reexecutado nesta manutenção, 108 s; bate com o informado); 10 testes em `clipper/tests/test_game_profiles.py`. Não verificado: IA real na pesquisa, tradução e refino bilíngues; modal e lista no navegador; serviço real em v12 (precisa diff --git a/.claude/skills/cenaforge/references/gotchas.md b/.claude/skills/cenaforge/references/gotchas.md index 947830d..283d540 100644 --- a/.claude/skills/cenaforge/references/gotchas.md +++ b/.claude/skills/cenaforge/references/gotchas.md @@ -785,9 +785,22 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md). que falha deixa a outra versão como estava e `error` explica. Onde: `clipper/app/intel.py` (`import_seeds`, `add_game`, `translate`), `main.py`, `db.py` (v12), `seeds/games/`; teste `clipper/tests/test_game_profiles.py`. +173. **Clipador: fonte em inglês sem transcrição (422 `language_not_supported` em todo bloco).** Causa: a fonte/sessão + guarda `en-US` (idioma do público), mas o serviço de voz só aceita `pt-BR`, `en` e `es`; antes de 18/11/2026 o idioma + gringo nunca tinha sido testado ponta a ponta. Correção: `worker.voice_language()` (`VOICE_LANGUAGES`) traduz na + fronteira, antes de mandar `X-Language`; idioma novo = entrada ali **e** em `WHISPER_LANGUAGES` de `voice/app/stt.py`. + Sintoma parecido: corte em inglês sem o português no painel = serviço sem reiniciar (item 144; banco precisa estar em + v13) ou corte anterior à mudança (use "Traduzir a fala" / `POST /v1/clips/{id}/translate`). Onde: + `clipper/app/worker.py`; teste `clipper/tests/test_english_source.py`. + +174. **Clipador: Fontes mostrava "ao vivo" por checagem velha e parecia que a gravação estava na fonte errada.** Causa: a + coluna usava a última checagem do monitor (de 2 h antes) como se fosse agora; o Skipnho aparecia "ao vivo" enquanto a + sessão gravando era a do Tfue. Correção: a coluna mostra "gravando #N" da sessão ativa e trata checagem com mais de + 10 min como "ao vivo há X" apagado. Onde: `panel/src/components/clipper-channels.tsx`. + ## IA: provedores, login e reserva -Itens 168–172 informados em 18/11/2026 e conferidos contra `doc/ia.md` e o código. Contexto em [ai.md](ai.md). +Itens 168–172 e 175–179 informados em 18/11/2026 e conferidos contra `doc/ia.md` e o código. Contexto em [ai.md](ai.md). 168. **Gemini CLI com login Google: `IneligibleTierError: UNSUPPORTED_CLIENT`** (gemini-cli 0.68.0). Causa: o OAuth gratuito "Code Assist for individuals" foi encerrado; o Google manda migrar para o Antigravity. OAuth só com plano elegível @@ -808,6 +821,23 @@ Itens 168–172 informados em 18/11/2026 e conferidos contra `doc/ia.md` e o có dois lugares além do PATH; mesmo assim, instalar e não ver = "Verificar" de novo na tela. Gemini no Windows: o `gemini.cmd` exige shell, então roda `node …/@google/gemini-cli/bundle/gemini.js` (mesma família do item 28). +175. **Gemini CLI: nem conta pessoal AI Pro/Ultra entra.** OAuth de conta pessoal encerrado em 18/06/2026; Code Assist + Standard/Enterprise sem assinatura nova desde 09/10/2026. Correção: chave do AI Studio ou o provedor `antigravity` + (conta Google; atenção aos termos, ver [ai.md](ai.md)). Complementa o 168. Onde: `doc/ia.md`. +176. **`/usage` no Git Bash vira caminho e a CLI cobra uma resposta normal.** Causa: o MSYS converte `/usage` em + `C:/Program Files/Git/usage`. Correção no terminal: `MSYS_NO_PATHCONV=1 claude -p "/usage"`. O painel chama sem shell + e não é afetado. `claude -p "/usage"` bem formado custa US$ 0 (``). Onde: `panel/src/lib/ai-usage.ts`. +177. **`agy`: shell recusado em silêncio.** Só vale correspondência exata `command()` em `--settings`; prefixo, + `command(node)`, `command(node:*)` e `command(node -e *)` não liberam. O que não está liberado vira passo `ERROR` + + mensagem `jetski:` no stderr com **código de saída 0**: não confie no código, leia os eventos. Não use + `--dangerously-skip-permissions`. Onde: `antigravityArgs`/`normalizeAntigravity` em `panel/src/lib/agents.ts`. +178. **`codex app-server`: leitura de limites falha sem o handshake.** Ordem: `initialize` → notificação `initialized` → + pedido. `account/read` sem `params` dá "missing field `params`". Onde: `panel/src/lib/ai-usage.ts`. +179. **IA aparecia "pronta" sem estar.** Causa: último teste falhado por login/cota não tirava a IA da cadeia, e o Gemini + em modo conta contava como pronto sem teste. Correção: teste falho por indisponibilidade tira de `readyChain`; + Gemini em conta só depois de um teste que passou; "Testar" segue habilitado. Onde: `panel/src/lib/ai.ts`; + teste `ai.test.ts`. + Relacionadas, já registradas acima: - Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`, `app/dashboard/page.tsx`): item 63 — uma substituição com "\n" não acha o trecho; normalize e grave de volta em CRLF. diff --git a/.claude/skills/cenaforge/references/panel.md b/.claude/skills/cenaforge/references/panel.md index 730eee1..d86ea34 100644 --- a/.claude/skills/cenaforge/references/panel.md +++ b/.claude/skills/cenaforge/references/panel.md @@ -251,10 +251,10 @@ Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; pers informando o formato (o subagente é uma casca que lê `doc/roteiro/`; sem WebSearch, fato sem fonte fica "a confirmar"); no **Codex** manda ler os guias e escrever sozinho, sem usar `.claude/agents/` (mesma regra no `AGENTS.md`). -- **Três provedores** (`claude`, `codex`, `gemini`), configurados em **Configurações → IA** (`/settings/ai`: ligar/desligar, - conta ou chave de API, ordem da reserva, instalar, entrar, testar). **IA reserva:** agente que termina com erro de +- **Quatro provedores** (`claude`, `codex`, `gemini`, `antigravity` — este começa desligado), configurados em **Configurações → IA** (`/settings/ai`: ligar/desligar, + conta ou chave de API, ordem da reserva, instalar, entrar, testar, uso do limite). **IA reserva:** agente que termina com erro de indisponibilidade é pausado e a mesma tarefa recomeça na próxima IA pronta (`agent_runs.fallback_of`; o console segue - o `followUpRunId` também nesse caso; vertentes religadas à nova execução). Contrato, API e armadilhas em + o `followUpRunId` também nesse caso; vertentes religadas à nova execução). Tarefa nova pula a IA acima do limite de uso (`overLimit`; não vale em retomada). Contrato, API e armadilhas em [ai.md](ai.md). Configurações são subpáginas `/settings/{ai,publishing,apps,browser,modes}` (`/settings` → IA; `SETTINGS_SECTIONS` em `settings-shell.tsx`, também no menu lateral); link antigo `/settings?tab=apps` não existe mais. - Lista de modelos = `models()` (não há mais constante fixa; o Gemini usa `geminiModels()` de `lib/ai.ts`): @@ -355,10 +355,10 @@ sidebar (`sidebar-nav.tsx`) mostra os mesmos subitens quando o Clipador está at | Rota | Conteúdo | Arquivos | |---|---|---| -| `/clipper` Cortes | lista `ClipTable` (uma linha por corte; ações rápidas Aprovar/Rejeitar/Publicar), filtros na URL (`?stage ?source ?session ?lang`), modal `ClipDialog` por `?clip=ID` com anterior/próximo | `clipper-clips-page.tsx`, `clipper-clip-table.tsx`, `clipper-clip-dialog.tsx`, `clipper-clip-parts.tsx`; ordenar/apagar/selecionar em utilitários de `clipper-queue.tsx` | +| `/clipper` Cortes | lista `ClipTable` (uma linha por corte; ações rápidas Aprovar/Rejeitar/Publicar), filtros na URL (`?stage ?source ?session ?lang`), modal `ClipDialog` por `?clip=ID` com anterior/próximo; em fonte inglesa, bloco "Em português" e título traduzido na lista ([clipper.md](clipper.md#fonte-em-inglês-18112026)) | `clipper-clips-page.tsx`, `clipper-clip-table.tsx`, `clipper-clip-dialog.tsx`, `clipper-clip-parts.tsx`; ordenar/apagar/selecionar em utilitários de `clipper-queue.tsx` | | `/clipper/sessions` | lista de sessões; "Gravar pelo link" em diálogo (`RecordForm`) | `clipper-sessions-page.tsx` | | `/clipper/sessions/[id]` | saúde, resumo da IA, tiles, gráfico do chat, emotes, configuração do corte | `clipper-session-detail.tsx` | -| `/clipper/sources` | fontes em tabela, "Adicionar fonte" em diálogo, monitor ligado/**pausado** + Religar, idioma da live, canais de publicação | `clipper-channels.tsx` | +| `/clipper/sources` | fontes em tabela, "Adicionar fonte" em diálogo, monitor ligado/**pausado** + Religar, idioma da live, canais de publicação; coluna "Ao vivo" = "gravando #N" (sessão ativa) ou "ao vivo há X" apagado se a checagem tem > 10 min (gotchas, item 174) | `clipper-channels.tsx` | | `/clipper/games` | jogos em tabela (nome, gênero, estado, missões, última pesquisa/edição), "Adicionar jogo" em diálogo, `?game=ID` abre o modal do jogo e emotes do canal | `clipper-games-page.tsx`, `clipper-game-dialog.tsx` (modal), `clipper-game-parts.tsx` (seções, `AiChat`, editor à mão), `clipper-games.tsx` | | `/clipper/settings` | abas Juiz (IA) / Serviço / Idiomas e públicos | `clipper-settings-page.tsx`, `clipper-judge.tsx` | | `/clipper/edit/[clipId]` | editor em tela cheia, **fora** do grupo `(studio)` | ver "Editor de cortes" | diff --git a/.claude/skills/cenaforge/references/tools.md b/.claude/skills/cenaforge/references/tools.md index 6d133bb..d0d8c1e 100644 --- a/.claude/skills/cenaforge/references/tools.md +++ b/.claude/skills/cenaforge/references/tools.md @@ -169,6 +169,7 @@ segurança). | Ferramenta | Para quê | Situação | |---|---|---| | Gemini CLI (`@google/gemini-cli`) | terceiro provedor de IA (agentes do painel e juiz do Clipador; [ai.md](ai.md)) | **código pronto, nunca executado de verdade**: não instalado nesta máquina (18/11/2026, `gemini: command not found`); a versão 0.68.0 do contrato (`doc/ia.md`) vem de teste do dono e não foi reverificada aqui. Coberto só por testes sem CLI (`ai.test.ts`, `test_ai_fallback.py`). OAuth gratuito de conta pessoal encerrado (gotchas, item 168); uso real exige chave do AI Studio, ainda não testada. Passa a "Em uso" depois de uma tarefa real concluída por ele | +| Antigravity CLI (`agy`) | 4º provedor de IA, só agentes do painel (conta Google; substituto do Gemini CLI; [ai.md](ai.md)) | **candidata, desligada por padrão**: `agy` 1.5.10 em `~/.gemini/bin` (verificado em 18/11/2026). Testes informados: "Testar" respondeu "ok" em 15 s; leitura de uso 12%/5%; o painel chamou `-p` sem terminal. Nenhuma tarefa real de vídeo/história concluída por ele. Termos do Google: embrulhar o `agy` em app de terceiro "não é suportado" em planos pessoais (decisão do usuário). Juiz do Clipador não usa. Gotchas 177 | | Meshy | gerar modelos GLB (personagens, objetos) e rig | citada na especificação; não testada | | Mixamo | animações para personagens com rig | citada como não obrigatória; não testada | | `.glb` carregado por `GLTFDocument` em tempo de execução (Godot) | modelos prontos dentro de cenas da biblioteca (`library//assets/`) | **só documentado** em `doc/godot/cenas.md`; nenhum `.glb` no repositório nem render com ele (17/11/2026). Personagens e barcos atuais são procedurais (`godot/kits/`) | diff --git a/clipper/README.md b/clipper/README.md index 14cd863..4a6efe8 100644 --- a/clipper/README.md +++ b/clipper/README.md @@ -67,8 +67,11 @@ a sessão pelo painel. `{"pauseMonitor": false}` no corpo do stop mantém o moni sozinha) continua retomando **na mesma sessão** (`keep_live`), sem passar pela pausa. **Idioma por fonte e por sessão.** `language` em `channels` e `sessions` (`pt-BR`, `en-US`, `es-419`; vazio = `CLIPPER_LANGUAGE`). -A sessão herda o da fonte; a transcrição manda esse idioma ao Whisper e, fora de pt-BR, o contexto do editor e da -varredura ganha a linha "Idioma de saída: …" (título, legenda e hashtags no idioma do público). +A sessão herda o da fonte; a transcrição manda esse idioma ao Whisper. **Fonte em inglês** (18/11/2026): os juízes +trabalham em inglês (prompts, glossário de chat e saída em inglês) e devolvem na mesma resposta um bloco `pt` para o +painel; a fala do corte é traduzida por frase (`clips.translation_json`) e `caption.translation` (só para testar) põe o +português embaixo da legenda. Regras completas: `doc/clipador/IDIOMAS.md`. Espanhol continua com a linha "Idioma de +saída: …" no contexto. ## Contexto do jogo diff --git a/clipper/app/ai_settings.py b/clipper/app/ai_settings.py index 3f74724..b1555fd 100644 --- a/clipper/app/ai_settings.py +++ b/clipper/app/ai_settings.py @@ -19,6 +19,8 @@ import logging import os import sys import threading +import time +from datetime import datetime from pathlib import Path from typing import Protocol @@ -29,6 +31,8 @@ log = logging.getLogger("cenaforge_clipper.ai_settings") AI_PROVIDERS = ("claude", "codex", "gemini") # Pasta padrão dos arquivos do painel. Os testes trocam (conftest) para não ler o data/ai real. DEFAULT_AI_DIR = REPO_ROOT / "data" / "ai" +# Leitura de uso mais velha que isso não decide (o painel relê a cada 5 min). +USAGE_STALE_S = 30 * 60 AUTH_MODES = ("oauth", "apiKey") DEFAULT_COOLDOWN_MIN = 15.0 DEFAULT_SETTINGS: dict = { @@ -180,6 +184,43 @@ class AiConfig: def provider(self, name: str) -> dict: return self.settings()["providers"].get(name, {"enabled": False, "authMode": "oauth"}) + @property + def usage_path(self) -> Path: + return self.folder / "usage.json" + + def over_limit(self, provider: str, now: float | None = None) -> str | None: + """Motivo para a IA sair da frente pelo USO (None = livre), lido de data/ai/usage.json, que o painel grava + a cada 5 min (Claude pelo /usage, Codex pelo app-server; ver doc/ia.md). Mesma regra do painel + (`overLimit` em lib/ai.ts): bateu o limite, ou uma janela ainda valendo em `limitPercent` ou mais. + Leitura com mais de 30 min, arquivo ausente ou inválido: não decide nada.""" + now = time.time() if now is None else now + try: + data = json.loads(self.usage_path.read_text(encoding="utf-8")) + usage = data["providers"][provider] + at = datetime.fromisoformat(str(usage["at"]).replace("Z", "+00:00")).timestamp() + except (OSError, ValueError, KeyError, TypeError): + return None + if now - at > USAGE_STALE_S: + return None + live = [] + for window in usage.get("windows") or []: + resets = window.get("resetsAt") + try: + if resets and datetime.fromisoformat(str(resets).replace("Z", "+00:00")).timestamp() <= now: + continue + live.append((str(window.get("label", "janela")), float(window.get("usedPercent", 0)))) + except (ValueError, TypeError): + continue + hit = [label for label, used in live if used >= 100] + if usage.get("blocked") and hit: + return f"bateu o limite ({', '.join(hit)})" + try: + limit = float(data.get("limitPercent", 90)) + except (TypeError, ValueError): + limit = 90.0 + hot = sorted((w for w in live if w[1] >= limit), key=lambda w: -w[1]) + return f"{hot[0][0]} em {round(hot[0][1])}% (limite {round(limit)}%)" if hot else None + def api_keys(self) -> dict[str, str]: """Chaves do cofre (só as que existem). Cofre ausente = {}; cofre que não abre = {} e `vault_error`.""" with self._lock: diff --git a/clipper/app/db.py b/clipper/app/db.py index df89af8..58aee48 100644 --- a/clipper/app/db.py +++ b/clipper/app/db.py @@ -207,6 +207,11 @@ SCHEMA = [ ALTER TABLE games ADD COLUMN translated_at TEXT; ALTER TABLE games ADD COLUMN aliases_json TEXT NOT NULL DEFAULT '[]'; """, + # v13: fonte em inglês (doc/clipador/IDIOMAS.md): a fala do corte em frases com tempo + tradução em português, + # para o painel e para a legenda de desenvolvimento (inglês em cima, português embaixo). NULL = não traduzido. + """ + ALTER TABLE clips ADD COLUMN translation_json TEXT; + """, ] diff --git a/clipper/app/editor_api.py b/clipper/app/editor_api.py index 9a936a5..6a4b2cd 100644 --- a/clipper/app/editor_api.py +++ b/clipper/app/editor_api.py @@ -112,7 +112,8 @@ def render_clip_edit(engine, clip: dict, session: dict, edit: dict, out: Path, t log.warning("capa do corte %s falhou: %s", clip["id"], exc) cover = None editor_render.render_project(ffmpeg, engine.settings.ffprobe, engine._encoder, segments, project, base, credit, out, - REPO_ROOT, chat=chat_for(engine, project), cover_file=cover) + REPO_ROOT, chat=chat_for(engine, project), cover_file=cover, + translation=translation_for(engine, clip, project, base)) total = editor.output_duration(project["cuts"]) media.thumbnail(ffmpeg, out, min(3.0, total / 2), thumb) # Formato em que ESTE arquivo saiu (camadas padrão ← canal ← sessão ← projeto): a fila desenha o player por ele. @@ -120,6 +121,19 @@ 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.""" + cfg = editor.effective_settings(base, project) + if not cfg["caption"].get("translation"): + return None + ps = editor.pieces(project["cuts"]) + if not ps: + return None + data = engine.translate_clip(clip["id"], ps[0].start, ps[-1].end) + return (data or {}).get("lines") or None + + def chat_for(engine, project: dict) -> list | None: """Mensagens do chat da sessão para o bloco "chat na tela" (só quando o projeto pede).""" if not (project.get("chat") or {}).get("enabled"): @@ -365,7 +379,8 @@ def register(app: FastAPI, engine, clip_view, get_clip) -> None: cover = None editor_render.render_project(ffmpeg, settings.ffprobe, ["-c:v", "libx264", "-preset", "veryfast", "-crf", "24"], segments, project, base, credit, out, REPO_ROOT, - out_range=(a, b), timeout=180, chat=chat_for(engine, project), cover_file=cover) + out_range=(a, b), timeout=180, chat=chat_for(engine, project), cover_file=cover, + translation=translation_for(engine, clip, project, base)) took = time.monotonic() - t return {"file": out.relative_to(REPO_ROOT).as_posix(), "fromS": a, "toS": b, "seconds": round(took, 1), "version": now()} diff --git a/clipper/app/editor_render.py b/clipper/app/editor_render.py index 426f057..fff6267 100644 --- a/clipper/app/editor_render.py +++ b/clipper/app/editor_render.py @@ -200,9 +200,11 @@ 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) -> str: + chat: list | None = None, translation: list[dict] | None = None) -> 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.""" + `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).""" cap, cred = cfg["caption"], cfg["credit"] total = output_duration(project["cuts"]) t1 = total if t1 is None else min(t1, total) @@ -211,6 +213,11 @@ def build_project_ass(project: dict, cfg: dict, credit: str, t0: float = 0.0, t1 credit_align, credit_side, credit_margin = layout.credit_placement(cfg) cw, ch = layout.canvas_size(cfg) font, size, ow = cap["font"], cap["size"], cap["outlineWidth"] + # Legenda em português (desenvolvimento): metade do tamanho; o estilo só entra quando ligada (o ASS do vídeo + # 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 "" header = f"""[Script Info] ScriptType: v4.00+ PlayResX: {cw} @@ -226,7 +233,7 @@ Style: Credit,Arial,{cred['size']},&H00FFFFFF,&H00FFFFFF,&H00000000,&H80000000,- Style: Text,Arial Black,64,&H00FFFFFF,&H00FFFFFF,&H00000000,&H80000000,-1,0,0,0,100,100,0,0,1,6,2,5,60,60,0,1 Style: Box,Arial Black,64,&H00FFFFFF,&H00FFFFFF,&H004D1DE1,&H00000000,-1,0,0,0,100,100,0,0,3,18,0,5,60,60,0,1 Style: Bar,Arial,10,&H00FFFFFF,&H00FFFFFF,&H00000000,&H00000000,0,0,0,0,100,100,0,0,1,0,0,7,0,0,0,1 -Style: Chat,Arial,{(project.get('chat') or {}).get('size', 34)},&H00FFFFFF,&H00FFFFFF,&H78000000,&H00000000,-1,0,0,0,100,100,0,0,3,5,0,1,0,0,0,1 +{trans_style}Style: Chat,Arial,{(project.get('chat') or {}).get('size', 34)},&H00FFFFFF,&H00FFFFFF,&H78000000,&H00000000,-1,0,0,0,100,100,0,0,3,5,0,1,0,0,0,1 [Events] Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text @@ -249,12 +256,17 @@ Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text pos = f"\\pos({cw // 2},{layout.caption_y(cfg)})" dodges = hook_dodges(project, (cw, ch), layout.caption_y(cfg), int(cap["size"]), total) - def at(t: float) -> str: - """Posição da legenda no instante t (saída): desviada enquanto um gancho a cobriria.""" + def y_at(t: float) -> int: + """Altura (centro) da legenda no instante t (saída): desviada enquanto um gancho a cobriria.""" for s, e, y in dodges: if s <= t < e: - return f"\\pos({cw // 2},{y})" - return pos + return y + return layout.caption_y(cfg) + + def at(t: float) -> str: + """Posição da legenda no instante t (saída).""" + y = y_at(t) + return pos if y == layout.caption_y(cfg) else f"\\pos({cw // 2},{y})" # Ênfase: palavra de saída ↔ palavra marcada no projeto (mesmo texto, mesmo instante), casada nos tempos # ORIGINAIS. Depois as palavras são saneadas (ordem, sem sobreposição, duração mínima) — `clean_words` devolve # a mesma quantidade, na mesma ordem — e os blocos abaixo nunca ficam dois na tela ao mesmo tempo. @@ -303,6 +315,17 @@ 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: + # 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: + a, _ = to_output(float(line["s"]), project["cuts"]) + b, _ = to_output(float(line["e"]), project["cuts"]) + if b - a < 0.2 or not str(line.get("pt") or "").strip(): + continue + y = y_at(a) + int(size * 0.62) + event(0, a, b, "Trans", f"{{\\an8\\pos({cw // 2},{y})\\q0}}{_escape(str(line['pt']))}") + cuts = project["cuts"] for o in project["overlays"]: if o["kind"] in ("zoom", "inset"): @@ -586,7 +609,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) -> None: + cover_file: Path | None = None, translation: list[dict] | None = None) -> 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`).""" @@ -605,7 +628,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) + ass_text = build_project_ass(project, cfg, credit, t0, t1, chat, translation) ass_file.write_text(ass_text, encoding="utf-8") input0, concat = _concat_input(work, stem, segs, in0, in1 - in0) diff --git a/clipper/app/intel.py b/clipper/app/intel.py index 06b89c4..52a15b9 100644 --- a/clipper/app/intel.py +++ b/clipper/app/intel.py @@ -23,7 +23,7 @@ from .db import loads, now from .emotes import EmoteCatalog, extract, learn_delta, message_bonus from .face import FaceError, FaceUnavailable from .hashtags import fold, to_tag -from .judge import JudgeError, build_scan_prompt, game_context, output_language_note +from .judge import JudgeError, build_scan_prompt, game_context, lang_key, output_language_note from .scoring import fit_window from .sources import parse_source @@ -470,12 +470,17 @@ class Intel: screen_profile = self.profile(screen) if screen.lower() not in ("", "desconhecido") else None return (screen, screen_profile) if screen_profile else (game or ("" if screen.lower() == "desconhecido" else screen), None) + def lang(self, session: dict) -> str: + """'en' = fonte em inglês (juízes em inglês, tradução para o painel); 'pt' = o resto.""" + return lang_key(session.get("language") or self.e.settings.language) + def context(self, session: dict) -> str: memory = loads(session.get("memory_json"), []) confirmed = session.get("game_source") == "user" and bool(session.get("game")) profile = self.profile(session.get("game", "")) or (None if confirmed else self.profile(session.get("screen_game", ""))) text = game_context(session.get("game", ""), session.get("screen_game", ""), profile, session.get("title", ""), - " | ".join(m["summary"] for m in memory[-3:] if m.get("summary")), confirmed=confirmed) + " | ".join(m["summary"] for m in memory[-3:] if m.get("summary")), confirmed=confirmed, + lang=self.lang(session)) # Sessão em outro idioma (fonte gringa): o editor e a varredura escrevem título/legenda nesse idioma. note = output_language_note(session.get("language") or self.e.settings.language) return f"{text}\n{note}" if note else text @@ -635,10 +640,11 @@ class Intel: "SELECT start_s, end_s, title FROM clips WHERE session_id = ? AND end_s > ? AND start_s < ?", session["id"], back_lo, hi)] existing += clip_delete.mark_spans(self.e.db, session["id"], back_lo, hi) # apagados não voltam pela varredura prompt = build_scan_prompt(self.e.streamer_name(session), session["platform"], lo, hi, back_lo, tl["words"], - tl["chat"], self.context(session), frames, existing, dur["minS"], dur["maxS"]) + tl["chat"], self.context(session), frames, existing, dur["minS"], dur["maxS"], + lang=self.lang(session)) created = 0 try: - data = self.e.judge.scan(prompt, [p for _, p in frames]) + data = self.e.judge.scan(prompt, [p for _, p in frames], lang=self.lang(session)) self.last_scan_error = None except (JudgeError, json.JSONDecodeError) as exc: # Avança mesmo assim: repetir a mesma janela com a CLI quebrada só gastaria cota. @@ -655,10 +661,13 @@ class Intel: log.info("varredura %s %.0f–%.0fs: %d proposta(s), %d candidato(s)", session["id"], lo, hi, len(proposals), created) memory = loads(session.get("memory_json"), []) if data.get("summary") or proposals: - memory.append({"fromS": lo, "toS": hi, "summary": str(data.get("summary") or "")[:240], - "proposals": len(proposals), "created": created}) + item = {"fromS": lo, "toS": hi, "summary": str(data.get("summary") or "")[:240], + "proposals": len(proposals), "created": created} + if data.get("summary_pt"): # fonte em inglês: o resumo vai em inglês à IA e em português ao painel + item["summaryPt"] = str(data["summary_pt"])[:240] + memory.append(item) screen = str(data.get("screen_game") or "") - if screen.lower() in ("desconhecido", "não identificável", "nao identificavel"): + if screen.lower() in ("desconhecido", "não identificável", "nao identificavel", "unknown"): screen = "" self.e.db.run("UPDATE sessions SET scanned_until = ?, memory_json = ?, screen_game = CASE WHEN ? != '' THEN ? ELSE screen_game END WHERE id = ?", hi, json.dumps(memory[-MEMORY_KEEP:], ensure_ascii=False), screen, screen[:120], session["id"]) @@ -684,6 +693,9 @@ class Intel: ts = now() reasons = {"via": "varredura", "scanFromS": lo, "scanToS": hi, "proposalScore": score, "proposalTitle": str(m.get("title", ""))[:100], "proposalReason": str(m.get("reason", ""))[:300]} + pt = m.get("pt") if isinstance(m.get("pt"), dict) else {} + if pt.get("title") or pt.get("reason"): # fonte em inglês: a mesma proposta em português para o painel + reasons |= {"proposalTitlePt": str(pt.get("title", ""))[:100], "proposalReasonPt": str(pt.get("reason", ""))[:300]} self.e.db.run( "INSERT INTO clips (session_id, peak_s, start_s, end_s, score, source, reasons_json, status, created_at, updated_at)" " VALUES (?, ?, ?, ?, ?, 'ai', ?, 'candidate', ?, ?)", diff --git a/clipper/app/judge.py b/clipper/app/judge.py index 8936f83..73b6f46 100644 --- a/clipper/app/judge.py +++ b/clipper/app/judge.py @@ -30,7 +30,7 @@ import sys import tempfile import threading import time -from dataclasses import dataclass +from dataclasses import dataclass, field from datetime import datetime, timezone from pathlib import Path @@ -353,6 +353,8 @@ class Verdict: model: str # Tags DO MOMENTO (sem "#"), escolhidas pela IA; as do canal e do jogo o sistema põe (app/hashtags.py). hashtags: tuple[str, ...] = () + # Fonte em inglês: título, legenda e motivo traduzidos para o painel ({} = sessão em português). + pt: dict = field(default_factory=dict) class JudgeError(RuntimeError): @@ -402,6 +404,163 @@ def extract_json_object(text: str, fences: bool = True) -> dict | None: return None +# ---------------------------------------------------------------- juízes em inglês (fonte gringa) +# Pedido do dono (18/11/2026): "se a fonte está em inglês, os juízes trabalham em inglês". A equipe não fala inglês: +# o vídeo (gancho, título, legenda, hashtags) sai em inglês e a MESMA resposta traz um bloco `pt` com a tradução +# para o painel — sem chamada extra. Regras completas em doc/clipador/IDIOMAS.md. +CLIP_GUIDE_EN = """What makes a good live-stream clip (market research, 2026): +- Opens on the strong moment: viewers decide in 1–2 s. No "like I was saying". +- Explains itself: someone who never saw the stream gets it in a few seconds (minimal context at the start). +- Clip-worthy: strong reaction (jump scare, laughing fit, rage), insane play/comeback, funny fail, beef/drama, a story + that unfolds, a memorable line, and NEW GAME INFO (mechanic, secret, news, comparison) — around launches + (e.g. GTA 6) information is worth as much as a reaction. +- Not clip-worthy: waiting, menus/loading, reading donations/ads, chatter with no hook, stream inside jokes. +- TIMING: streamers usually comment AFTER the action. Go back to the start of the ACTION that triggered the + comment (20 s to 2 min before the line, up to the backtrack limit given) — the clip must show action and reaction. +- Tight ending: end right after the payoff (reaction/resolution).""" + +CHAT_GLOSSARY_EN = """Common chat slang on English-speaking Twitch/Kick/YouTube (read it by context): +- Laughing: "LUL", "LULW", "KEKW", "OMEGALUL", "ICANT", "pepeLaugh", "LMAO", "LMFAO", "LOL", "ROFL", "💀"/"☠️" + ("I'm dead" = so funny), "😭" (crying laughing), "dead", "I'm crying". +- Shock/confusion: "HUH", "?????", "WTF", "OMG", "no way", "nah", "bruh", "monkaS"/"monkaW" (tension), "Aware", + "Clueless" (ironic: he doesn't realise), "COPIUM" (denial), "Sadge" (sad). +- Hype/praise: "Pog", "POGGERS", "PogU", "W"/"dub" (win), "L" (loss), "LETSGO", "Clap", "EZ", "GG", "clutch", + "cracked" (very skilled), "goated", "sheesh", "diff" (skill gap). +- "F" = death/loss; "cooked"/"he's cooked" = doomed; "throwing"/"sold" = blew it; "bot"/"NPC" = bad/robotic play. +- "lag", "ping", "rubberbanding", "desync", "server dying" → the game/stream is lagging; the joke is the lag. +- "clip it"/"CLIP IT" → clip request; "hacker"/"cheater"/"aimbot" → suspected cheating. +- Channel emotes (streamer prefix + base emote, e.g. tfueLUL) carry the same reaction as the base emote.""" + +PT_NOTE = ("The team that reviews clips only reads Brazilian Portuguese: fill `pt` with a faithful Brazilian " + "Portuguese translation of the listed fields (keep game terms, names and slang meaning; do not add facts).") + +ANALYST_SYSTEM_EN = """You are the ANALYST of a live-stream clipping team. You do not write titles: you describe +faithfully WHAT HAPPENED in the segment so the editor can decide. You get game context, a timed transcript (the +streamer speaks English), screen FRAMES with their timestamps and the chat. + +Cross-check all three sources before concluding: speech alone misleads (e.g. "I'm playing three games... I died, I +died" plus chat "server dying?/LMAO" and the screen jumping = the game is lagging and he dies because of the lag). +Chat reacts a few seconds after the event. + +""" + CHAT_GLOSSARY_EN + """ + +Fields (in English): +- situation: the moment type (one from the list; the ids are fixed, keep them as they are). +- what_happened: 2–3 factual sentences of what happened, in order, no exaggeration. +- screen: what the frames show (cite the frame #) — or "frames don't help". +- speech: what the speech reveals (cite the timestamp). +- chat_meaning: what chat is saying/laughing at and why. +- confidence: 0–1, how sure you are (lower it when sources disagree). +- action_start_s: second of the recording where the ACTION that caused the reaction starts (may be before the speech). +- reaction_end_s: second where the reaction/payoff ends. +- hook: what would hook someone in the first 2 seconds of the clip (English, it goes on screen). +- pt: what_happened, screen, speech, chat_meaning and hook translated. """ + PT_NOTE + """ +Do not use tools beyond what was given. Answer only with the requested JSON.""" + +JUDGE_SYSTEM_EN = """You are the EDITOR of live-stream clips for Shorts, TikTok, Reels and YouTube, for an +English-speaking (US) audience. You get a candidate segment of a stream (game context, timed transcript, chat, +emotes) and, when available, the ANALYST's analysis, which already cross-checked screen, speech and chat. Trust the +analysis to understand WHAT happened; your job is to decide whether it makes a clip and write a title and caption +FAITHFUL to it. + +""" + CLIP_GUIDE_EN + """ + +""" + CHAT_GLOSSARY_EN + """ + +Title and caption describe the real situation (if the analysis says lag, the title is about the lag, not about a +random line of the transcript). With analysis confidence < 0.5, be descriptive and do not invent details. +Use the analysis action_start_s/reaction_end_s as the base for start_s/end_s. + +Answer rules: +- keep=false for what doesn't work; score 0–10 (7+ = strong clip; below 5 = discard). +- start_s and end_s in seconds of the recording, INSIDE the window given and within the min/max duration given; + start before the action (context) and end right after the reaction. Never cut mid-sentence. +- title: up to 70 characters, English, catchy but true, written like a native US clip channel (not a literal + translation), nothing that isn't in the speech/screen. +- caption: 1–2 sentences in English, NO hashtags and no links (the system adds channel/game hashtags and credit). +- hashtags: 2 to 4 tags OF THE MOMENT, English, without "#": the mission/activity, event, mode, place, item or + character in THIS segment. Prefer game-profile terms and what streamer and chat say. Nothing generic ("gameplay", + "live", "viral"), nothing that doesn't happen here, and do not repeat the channel or the game name. +- reason: one sentence on why you kept or discarded it (cite the screen if it helped). +- pt: title, caption and reason translated. """ + PT_NOTE + """ +- Do not use tools or read anything beyond what was given. Answer only with the requested JSON.""" + +SCAN_SYSTEM_EN = """You are a live-stream clip editor WATCHING a stream in windows of a few minutes. The streamer +speaks English. You get game context, a timed transcript (seconds of the recording), screen frames with their +timestamps, the chat (may be almost empty) and clips already made in this region. + +""" + CLIP_GUIDE_EN + """ + +""" + CHAT_GLOSSARY_EN + """ + +Task: point out 0 to 2 moments in this window that would make a good clip ON THEIR OWN. If nothing works, return +moments=[] (that's normal most of the time — don't force it). Don't repeat a clip already made. +- start_s/end_s inside the window (may start back to the "backtrack" limit to catch the action), within the + min/max duration given. +- screen_game: the game on screen (or "unknown"); has_webcam: is there a streamer camera in the frame? +- summary: 1 sentence of what's going on in the window (becomes memory for the next windows). +- title/caption/reason in English like an editor would write (title ≤ 70 characters, true). +- summary_pt and each moment's pt (title, reason): translated. """ + PT_NOTE + """ +Do not use tools beyond what was given. Answer only with the requested JSON.""" + + +def _pt_block(*keys: str) -> dict: + return {"type": "object", "properties": {k: {"type": "string"} for k in keys}, "required": list(keys), + "additionalProperties": False} + + +def _with(schema: dict, **extra: dict) -> dict: + """Schema + campos novos obrigatórios (os CLIs exigem `required` com todas as propriedades).""" + return {**schema, "properties": {**schema["properties"], **extra}, "required": [*schema["required"], *extra]} + + +ANALYSIS_SCHEMA_EN = _with(ANALYSIS_SCHEMA, pt=_pt_block("what_happened", "screen", "speech", "chat_meaning", "hook")) +VERDICT_SCHEMA_EN = _with(VERDICT_SCHEMA, pt=_pt_block("title", "caption", "reason")) +SCAN_SCHEMA_EN = _with({**SCAN_SCHEMA, "properties": {**SCAN_SCHEMA["properties"], + "moments": {"type": "array", "items": _with(_MOMENT, pt=_pt_block("title", "reason"))}}}, + summary_pt={"type": "string"}) + +# Tradução da fala de um corte (painel e legenda em português de desenvolvimento): frases numeradas → mesma quantidade. +LINES_SCHEMA = { + "type": "object", + "properties": {"lines": {"type": "array", "items": {"type": "string"}}}, + "required": ["lines"], + "additionalProperties": False, +} +LINES_SYSTEM = """You translate the speech of a live-streamer (auto transcript, may have errors and slang) into +Brazilian Portuguese, for a team that doesn't speak English. You get numbered lines in order; they are one +continuous talk, so use the neighbours as context. Return `lines` with EXACTLY the same number of items, same order, +one translation per line: natural spoken Brazilian Portuguese, short, faithful (keep swearing level, game terms and +names; translate the slang's meaning, e.g. "he's cooked" -> "ele tá ferrado"). If a line is noise, translate it +as is. Answer only with the requested JSON.""" + + +def lang_key(language: str | None) -> str: + """'en' para fonte em inglês (juízes em inglês); 'pt' para o resto (prompts em português + nota de saída).""" + return "en" if (language or "").strip().lower().startswith("en") else "pt" + + +# Rótulos dos prompts montados aqui (o texto do usuário). Mesmas chaves nos dois idiomas. +LABELS = { + "pt": {"live_title": "Título da live", "unknown": "desconhecido", "channel": "Canal", "window": "Janela disponível", + "candidate": "Candidato da heurística", "peak": "pico de reação em", "duration": "Duração do corte", + "signals": "Sinais da heurística", "face": "Rosto do streamer (expressão medida na webcam, relativa ao normal dele)", + "transcript": "Transcrição", "no_speech": "(sem fala transcrita)", "chat_per": "Mensagens do chat por", + "no_chat": "sem chat", "top_emotes": "Emotes mais usados", "none": "nenhum", "chat_sample": "Amostra do chat", + "no_chat_p": "(sem chat)", "frames_none": "Frames: (nenhum)", "frames": "Frames anexados, em ordem", + "new_window": "Janela nova", "back_to": "pode voltar até {s}s para pegar o início de uma ação", + "done": "Cortes já feitos aqui", "analysis": "Análise do ANALISTA (cruzou tela, fala e chat)"}, + "en": {"live_title": "Stream title", "unknown": "unknown", "channel": "Channel", "window": "Available window", + "candidate": "Heuristic candidate", "peak": "reaction peak at", "duration": "Clip duration", + "signals": "Heuristic signals", "face": "Streamer face (expression measured on the webcam, relative to his normal)", + "transcript": "Transcript", "no_speech": "(no transcribed speech)", "chat_per": "Chat messages per", + "no_chat": "no chat", "top_emotes": "Top emotes", "none": "none", "chat_sample": "Chat sample", + "no_chat_p": "(no chat)", "frames_none": "Frames: (none)", "frames": "Attached frames, in order", + "new_window": "New window", "back_to": "may go back to {s}s to catch the start of an action", + "done": "Clips already made here", "analysis": "ANALYST's analysis (cross-checked screen, speech and chat)"}, +} + + # ---------------------------------------------------------------- prompts # Idiomas que o serviço conhece (fonte/sessão `language`; o painel oferece os mesmos). Nome legível para o prompt. LANGUAGE_NAMES = {"pt-BR": "português do Brasil", "en-US": "English (US)", "es-419": "Español (Latinoamérica)"} @@ -412,8 +571,8 @@ def output_language_note(language: str | None) -> str: """Linha que vai no contexto do EDITOR e da VARREDURA quando a saída não é em português: título, legenda e hashtags no idioma do público. Vazia para pt-BR (os prompts já são em português).""" code = (language or "").strip() or DEFAULT_LANGUAGE - if code == DEFAULT_LANGUAGE: - return "" + if code == DEFAULT_LANGUAGE or lang_key(code) == "en": + return "" # inglês: os juízes já trabalham em inglês (ANALYST/JUDGE/SCAN_SYSTEM_EN) name = LANGUAGE_NAMES.get(code, code) return (f"Idioma de saída: {name}. Título, legenda e hashtags em {name}, naturais para o público desse idioma " f"(a transcrição e o chat podem estar em outro idioma; não traduza literalmente, escreva como um editor nativo).") @@ -423,33 +582,39 @@ MISSIONS_IN_PROMPT = 25 MISSIONS_PROMPT_CHARS = 1500 -def mission_lines(profile: dict) -> list[str]: +def mission_lines(profile: dict, lang: str = "pt") -> list[str]: """Gatilhos de fim de missão e as missões (nome + gatilhos) para o prompt, com teto de tamanho: o perfil do GTA pode ter 100+ missões, e o contexto vai em todo julgamento.""" lines: list[str] = [] triggers = [str(t) for t in (profile.get("end_triggers") or [])[:10] if t] if triggers: - lines.append("Sinais de fim de missão/objetivo neste jogo: " + "; ".join(triggers)) + lines.append(("Mission/objective end signals in this game: " if lang == "en" else + "Sinais de fim de missão/objetivo neste jogo: ") + "; ".join(triggers)) missions = [m for m in (profile.get("missions") or []) if isinstance(m, dict) and m.get("name")] if missions: parts, used = [], 0 for m in missions[:MISSIONS_IN_PROMPT]: ends = " / ".join(str(t) for t in (m.get("completion_triggers") or [])[:2] if t) - item = f"{m['name']}" + (f" (fim: {ends})" if ends else "") + item = f"{m['name']}" + (f" ({'end' if lang == 'en' else 'fim'}: {ends})" if ends else "") if used + len(item) > MISSIONS_PROMPT_CHARS: break parts.append(item) used += len(item) + 2 extra = len(missions) - len(parts) - lines.append("Missões da história: " + "; ".join(parts) + (f"; …e mais {extra}" if extra > 0 else "")) + more = (f"; …and {extra} more" if lang == "en" else f"; …e mais {extra}") if extra > 0 else "" + lines.append(("Story missions: " if lang == "en" else "Missões da história: ") + "; ".join(parts) + more) if triggers or missions: - lines.append("Se o trecho é o fim de uma missão, termine o corte logo depois do gatilho de fim " + lines.append("If the segment is the end of a mission, end the clip right after the end trigger " + "(the win/fail moment is the climax)." if lang == "en" else + "Se o trecho é o fim de uma missão, termine o corte logo depois do gatilho de fim " "(o momento de vitória/falha é o clímax).") return lines def game_context(game: str, screen_game: str, profile: dict | None, live_title: str, history: str = "", - confirmed: bool = False) -> str: + confirmed: bool = False, lang: str = "pt") -> str: + if lang == "en": + return _game_context_en(game, screen_game, profile, live_title, history, confirmed) lines = [f"Título da live: {live_title or '(desconhecido)'}"] if confirmed: # O usuário confirmou no painel: não questionar (jogo novo/pouco conhecido lembra outros na tela). @@ -472,7 +637,30 @@ def game_context(game: str, screen_game: str, profile: dict | None, live_title: return "\n".join(lines) -def _transcript(words: list[Word], lo: float, hi: float) -> str: +def _game_context_en(game: str, screen_game: str, profile: dict | None, live_title: str, history: str, + confirmed: bool) -> str: + lines = [f"Stream title: {live_title or '(unknown)'}"] + if confirmed: + lines.append(f"Game CONFIRMED by the user: {game}. The screen may look like a similar game (e.g. GTA, Warzone) " + f"— don't question the game; use the profile below to understand what happens.") + else: + lines.append(f"Game from the platform category: {game or '(unknown)'}") + if screen_game and screen_game.lower() not in (game or "").lower(): + lines.append(f"Game the AI saw on screen recently: {screen_game} (check the frames; the category may be wrong)") + if profile: + lines.append(f"Game profile: {profile.get('summary', '')}") + for key, label in (("clip_worthy", "Clip-worthy in this game"), ("avoid", "Not clip-worthy"), + ("mechanics", "Mechanics/activities (terms for the moment hashtags)"), + ("jargon", "Slang/terms"), ("news", "News")): + if profile.get(key): + lines.append(f"{label}: " + "; ".join(profile[key][:10])) + lines.extend(mission_lines(profile, "en")) + if history: + lines.append(f"What happened earlier in the stream: {history}") + return "\n".join(lines) + + +def _transcript(words: list[Word], lo: float, hi: float, lang: str = "pt") -> str: lines, current, current_t = [], [], None for word in sorted((w for w in words if lo <= w.start <= hi), key=lambda w: w.start): if current_t is None or word.start - current_t > 4 or len(current) >= 14: @@ -482,10 +670,12 @@ def _transcript(words: list[Word], lo: float, hi: float) -> str: current.append(word.word) if current: lines.append(f"[{current_t:.0f}s] {' '.join(current)}") - return "\n".join(lines) or "(sem fala transcrita)" + return "\n".join(lines) or LABELS[lang]["no_speech"] -def _chat_block(chat: list[ChatMessage], lo: float, hi: float, focus: float | None, bucket_s: int = 5) -> str: +def _chat_block(chat: list[ChatMessage], lo: float, hi: float, focus: float | None, bucket_s: int = 5, + lang: str = "pt") -> str: + L = LABELS[lang] buckets: dict[int, int] = {} emotes: dict[str, int] = {} sample: list[str] = [] @@ -498,50 +688,52 @@ def _chat_block(chat: list[ChatMessage], lo: float, hi: float, focus: float | No near = focus is None or focus - 10 <= message.t <= focus + 8 if near and len(sample) < 60: sample.append(f"[{message.t:.0f}s] {message.text[:80]}") - rate = ", ".join(f"{t}s:{n}" for t, n in sorted(buckets.items())) or "sem chat" - top = ", ".join(f"{e}×{n}" for e, n in sorted(emotes.items(), key=lambda kv: -kv[1])[:12]) or "nenhum" - return (f"Mensagens do chat por {bucket_s} s: {rate}\nEmotes mais usados: {top}\n" - f"Amostra do chat:\n" + ("\n".join(sample) or "(sem chat)")) + rate = ", ".join(f"{t}s:{n}" for t, n in sorted(buckets.items())) or L["no_chat"] + top = ", ".join(f"{e}×{n}" for e, n in sorted(emotes.items(), key=lambda kv: -kv[1])[:12]) or L["none"] + return (f"{L['chat_per']} {bucket_s} s: {rate}\n{L['top_emotes']}: {top}\n" + f"{L['chat_sample']}:\n" + ("\n".join(sample) or L["no_chat_p"])) -def _frames_block(frames: list[tuple[float, Path]]) -> str: +def _frames_block(frames: list[tuple[float, Path]], lang: str = "pt") -> str: if not frames: - return "Frames: (nenhum)" - return "Frames anexados, em ordem: " + ", ".join(f"#{i + 1} = {t:.0f}s" for i, (t, _) in enumerate(frames)) + return LABELS[lang]["frames_none"] + return LABELS[lang]["frames"] + ": " + ", ".join(f"#{i + 1} = {t:.0f}s" for i, (t, _) in enumerate(frames)) def build_prompt(streamer: str, platform: str, start_s: float, end_s: float, peak_s: float, words: list[Word], chat: list[ChatMessage], heuristic: dict, live_title: str = "", *, context: str = "", frames: list[tuple[float, Path]] | None = None, backtrack_s: float = DEFAULT_BACKTRACK_S, min_s: float = DEFAULT_MIN_S, max_s: float = DEFAULT_MAX_S, - face: str = "") -> str: + face: str = "", lang: str = "pt") -> str: """Prompt do juiz. Janela = candidato com `backtrack_s` para trás (a ação vem antes do comentário). `face`: resumo do rosto do streamer na janela (face.FaceService.summary); vazio = sem câmera/rastreio.""" lo, hi = max(0.0, start_s - backtrack_s), end_s + CONTEXT_AFTER_S + L, to = LABELS[lang], ("to" if lang == "en" else "a") return ( - f"Canal: {streamer} ({platform})\n" - + (context or f"Título da live: {live_title or '(desconhecido)'}") + "\n\n" - f"Janela disponível: {lo:.0f}s a {hi:.0f}s. Candidato da heurística: {start_s:.0f}s a {end_s:.0f}s; " - f"pico de reação em {peak_s:.0f}s. Duração do corte: {min_s:.0f} a {max_s:.0f} s.\n" - f"Sinais da heurística: {json.dumps(heuristic, ensure_ascii=False)}\n" - + (f"Rosto do streamer (expressão medida na webcam, relativa ao normal dele): {face}\n" if face else "") - + f"{_frames_block(frames or [])}\n\n" - f"Transcrição:\n{_transcript(words, lo, hi)}\n\n" - f"{_chat_block(chat, lo, hi, peak_s)}" + f"{L['channel']}: {streamer} ({platform})\n" + + (context or f"{L['live_title']}: {live_title or '(' + L['unknown'] + ')'}") + "\n\n" + f"{L['window']}: {lo:.0f}s {to} {hi:.0f}s. {L['candidate']}: {start_s:.0f}s {to} {end_s:.0f}s; " + f"{L['peak']} {peak_s:.0f}s. {L['duration']}: {min_s:.0f} {to} {max_s:.0f} s.\n" + f"{L['signals']}: {json.dumps(heuristic, ensure_ascii=False)}\n" + + (f"{L['face']}: {face}\n" if face else "") + + f"{_frames_block(frames or [], lang)}\n\n" + f"{L['transcript']}:\n{_transcript(words, lo, hi, lang)}\n\n" + f"{_chat_block(chat, lo, hi, peak_s, lang=lang)}" ) def build_scan_prompt(streamer: str, platform: str, lo: float, hi: float, back_lo: float, words: list[Word], chat: list[ChatMessage], context: str, frames: list[tuple[float, Path]], - existing: list[tuple[float, float, str]], min_s: float, max_s: float) -> str: - done = "; ".join(f"{a:.0f}–{b:.0f}s ({t[:40]})" for a, b, t in existing) or "nenhum" + existing: list[tuple[float, float, str]], min_s: float, max_s: float, lang: str = "pt") -> str: + L, to = LABELS[lang], ("to" if lang == "en" else "a") + done = "; ".join(f"{a:.0f}–{b:.0f}s ({t[:40]})" for a, b, t in existing) or L["none"] return ( - f"Canal: {streamer} ({platform})\n{context}\n\n" - f"Janela nova: {lo:.0f}s a {hi:.0f}s (pode voltar até {back_lo:.0f}s para pegar o início de uma ação).\n" - f"Duração do corte: {min_s:.0f} a {max_s:.0f} s. Cortes já feitos aqui: {done}\n" - f"{_frames_block(frames)}\n\n" - f"Transcrição:\n{_transcript(words, back_lo, hi)}\n\n" - f"{_chat_block(chat, back_lo, hi, None, bucket_s=10)}" + f"{L['channel']}: {streamer} ({platform})\n{context}\n\n" + f"{L['new_window']}: {lo:.0f}s {to} {hi:.0f}s ({L['back_to'].format(s=f'{back_lo:.0f}')}).\n" + f"{L['duration']}: {min_s:.0f} {to} {max_s:.0f} s. {L['done']}: {done}\n" + f"{_frames_block(frames, lang)}\n\n" + f"{L['transcript']}:\n{_transcript(words, back_lo, hi, lang)}\n\n" + f"{_chat_block(chat, back_lo, hi, None, bucket_s=10, lang=lang)}" ) @@ -563,6 +755,7 @@ def _clean(data: dict, start_s: float, end_s: float, model: str, lo: float | Non title=str(data["title"]).strip()[:100], caption=str(data["caption"]).strip()[:600], reason=str(data["reason"]).strip()[:300], model=model, hashtags=tuple(str(t).strip()[:40] for t in (data.get("hashtags") or [])[:6] if str(t).strip()), + pt={k: str(v).strip()[:600] for k, v in (data.get("pt") or {}).items() if k in ("title", "caption", "reason") and v}, ) @@ -701,7 +894,8 @@ class Judge: def fallback_chain(self) -> list[str]: """Ordem em que `ask` tenta as IAs: a escolhida no juiz primeiro, depois a `order` do painel, só as ligadas, - com CLI e (no modo chave) com chave; as em pausa são puladas. Reserva desligada: só a escolhida. + com CLI e (no modo chave) com chave; as em pausa são puladas e as perto do limite de uso vão para o fim. + Reserva desligada: só a escolhida. Se TODAS as prontas estiverem em pausa, elas voltam como último recurso (melhor tentar do que parar).""" if not self.enabled: return [] @@ -710,9 +904,13 @@ class Judge: if settings["fallback"]["enabled"]: candidates += [p for p in settings["order"] if p != self.provider and p in AI_ENABLED] ready = [p for p in candidates if self._skip_reason(p, settings) is None] - paused = self.pauses() if settings["fallback"]["enabled"] else {} - active = [p for p in ready if p not in paused] - return active or ready + if not settings["fallback"]["enabled"]: + return ready + paused = self.pauses() + # Perto do limite de uso (data/ai/usage.json, do painel): vai para depois das livres, antes das em pausa. + limited = {p for p in ready if p not in paused and self.ai.over_limit(p)} + active = [p for p in ready if p not in paused and p not in limited] + return (active + [p for p in ready if p in limited]) or ready def describe(self) -> dict: cmd = self.command() if self.enabled else None @@ -734,9 +932,11 @@ class Judge: return {"codex": codex_models(), "claude": CLAUDE_MODELS, "gemini": GEMINI_MODELS, "defaults": DEFAULT_MODELS} # ---------- usos - def analyze(self, prompt: str, images: list[Path]) -> dict: - """1º juiz (ANALISTA): o que aconteceu, cruzando tela + fala + chat. Não decide nem escreve título.""" - data = self.ask(ANALYST_SYSTEM, prompt, ANALYSIS_SCHEMA, images, model=self.analyst_model or self.model) + def analyze(self, prompt: str, images: list[Path], lang: str = "pt") -> dict: + """1º juiz (ANALISTA): o que aconteceu, cruzando tela + fala + chat. Não decide nem escreve título. + `lang="en"`: prompt em inglês e bloco `pt` (tradução para o painel) na mesma resposta.""" + system, schema = (ANALYST_SYSTEM_EN, ANALYSIS_SCHEMA_EN) if lang == "en" else (ANALYST_SYSTEM, ANALYSIS_SCHEMA) + data = self.ask(system, prompt, schema, images, model=self.analyst_model or self.model) missing = [k for k in ANALYSIS_SCHEMA["required"] if k not in data] if missing: raise JudgeError(f"análise sem os campos {missing}") @@ -745,13 +945,27 @@ class Judge: def judge(self, prompt: str, start_s: float, end_s: float, images: list[Path] | None = None, *, lo: float | None = None, hi: float | None = None, min_s: float = DEFAULT_MIN_S, - max_s: float = DEFAULT_MAX_S) -> Verdict: - data = self.ask(JUDGE_SYSTEM, prompt, VERDICT_SCHEMA, images or []) + max_s: float = DEFAULT_MAX_S, lang: str = "pt") -> Verdict: + system, schema = (JUDGE_SYSTEM_EN, VERDICT_SCHEMA_EN) if lang == "en" else (JUDGE_SYSTEM, VERDICT_SCHEMA) + data = self.ask(system, prompt, schema, images or []) # Modelo de quem DE FATO respondeu (a reserva pode ter entrado no lugar da escolhida). return _clean(data, start_s, end_s, self.responder(), lo, hi, min_s, max_s) - def scan(self, prompt: str, images: list[Path]) -> dict: - data = self.ask(SCAN_SYSTEM, prompt, SCAN_SCHEMA, images) + def translate_lines(self, lines: list[str]) -> list[str]: + """Fala de um corte (frases em ordem) → português, mesma quantidade. Para o painel e a legenda de + desenvolvimento; o vídeo publicado continua no idioma da fonte.""" + if not lines: + return [] + prompt = "\n".join(f"{i + 1}. {text}" for i, text in enumerate(lines)) + data = self.ask(LINES_SYSTEM, prompt, LINES_SCHEMA, []) + out = [str(x).strip() for x in (data.get("lines") or [])] + if len(out) != len(lines): + raise JudgeError(f"tradução com {len(out)} linhas para {len(lines)} frases", unavailable=False) + return out + + def scan(self, prompt: str, images: list[Path], lang: str = "pt") -> dict: + system, schema = (SCAN_SYSTEM_EN, SCAN_SCHEMA_EN) if lang == "en" else (SCAN_SYSTEM, SCAN_SCHEMA) + data = self.ask(system, prompt, schema, images) if not isinstance(data.get("moments"), list): raise JudgeError("varredura sem a lista de momentos") return data @@ -974,6 +1188,7 @@ def parse_gemini_output(stdout: str) -> dict: return data -def analysis_block(analysis: dict) -> str: - """Análise do 1º juiz no formato que o editor lê.""" - return "Análise do ANALISTA (cruzou tela, fala e chat):\n" + json.dumps(analysis, ensure_ascii=False, indent=1) +def analysis_block(analysis: dict, lang: str = "pt") -> str: + """Análise do 1º juiz no formato que o editor lê (sem o bloco `pt`, que é só para o painel).""" + data = {k: v for k, v in analysis.items() if k != "pt"} + return LABELS[lang]["analysis"] + ":\n" + json.dumps(data, ensure_ascii=False, indent=1) diff --git a/clipper/app/layout.py b/clipper/app/layout.py index ec7e64c..f3e933b 100644 --- a/clipper/app/layout.py +++ b/clipper/app/layout.py @@ -91,6 +91,9 @@ 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. + "translation": False, }, "credit": {"enabled": True, "position": "top", "size": 44}, "duration": {"minS": 60, "maxS": 90, "backtrackS": 120}, @@ -173,7 +176,7 @@ def validate(settings: dict) -> dict: o["y"] = None if cap["y"] is None else float(cap["y"]) if o["y"] is not None and not 0.08 <= o["y"] <= 0.9: raise LayoutError("caption.y vai de 0,08 a 0,9 (fração da altura) ou null = automático") - for key in ("enabled", "uppercase"): + for key in ("enabled", "uppercase", "translation"): if key in cap: o[key] = bool(cap[key]) out["caption"] = o diff --git a/clipper/app/main.py b/clipper/app/main.py index e688442..b2516a2 100644 --- a/clipper/app/main.py +++ b/clipper/app/main.py @@ -184,6 +184,9 @@ def clip_view(row: dict) -> dict: "channelId": row.get("channel_id"), "platform": row.get("platform"), "sessionUrl": row.get("url"), # Idioma da sessão (resolvido no SELECT: o da sessão ou o padrão do serviço). Ausente só em consultas antigas. "language": row.get("language"), + # Fonte em inglês: a fala do corte em frases com a tradução ({language, startS, endS, model, lines: [{s, e, + # text, pt}]}); None = sessão em português ou ainda não traduzido (doc/clipador/IDIOMAS.md). + "translation": loads(row.get("translation_json"), None), # Editor de cortes: existe projeto de edição? (o export renderiza por ele; capa gerada no export) "edit": ({"updatedAt": row["edit_updated_at"], "exportedAt": row.get("edit_exported_at"), "cover": row.get("edit_cover"), "origin": row.get("edit_origin")} @@ -753,6 +756,14 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s engine.wake_clips.set() return clip_view(_clip(clip_id)) + @app.post("/v1/clips/{clip_id}/translate") + def translate_clip(clip_id: int): + """Traduz (de novo) a fala do corte para o português. Só para fonte em inglês; 409 se não couber.""" + _clip(clip_id) + if engine.translate_clip(clip_id, force=True) is None: + raise UserError("Sem tradução: a fonte não está em inglês, a IA está desligada ou não respondeu.", 409) + return clip_view(_clip(clip_id)) + @app.post("/v1/clips/{clip_id}/rejudge") def rejudge(clip_id: int): _clip(clip_id) diff --git a/clipper/app/scoring.py b/clipper/app/scoring.py index 3d5f41a..43575f9 100644 --- a/clipper/app/scoring.py +++ b/clipper/app/scoring.py @@ -24,15 +24,21 @@ from . import reaction # Peso extra por categoria de reação. Uma mensagem pode somar mais de uma. REACTION_PATTERNS: dict[str, tuple[re.Pattern[str], float]] = { - "risada": (re.compile(r"(k{3,}|kek|lul|lmao|lmfao|omegalul|icant|pepelaugh|haha|hehe|rsrs|ksks|😂|🤣|xd\b)", re.I), 1.0), + # Chat em inglês (fonte gringa, 18/11/2026): a risada lá é LMAO/LOL/💀/😭 e "I'm dead", não "kkkk". + "risada": (re.compile(r"(k{3,}|kek|lul|lmao+|lmfao|omegalul|icant|pepelaugh|haha|hehe|rsrs|ksks|😂|🤣|xd\b|" + r"\blo+l+\b|\brofl\b|💀|☠️?|😭|\bi'?m dead\b|\bim crying\b|\bdying\b)", re.I), 1.0), "susto": (re.compile(r"(caralho|crlh|caraca|nossa|meu deus|mds|wtf|omg|que isso|q isso|monkas|monkaw|\bhuh+\b|" - r"😱|😳|\?{3,}|!{3,})", re.I), 1.0), - "hype": (re.compile(r"(\bpog|pogchamp|poggers|\bw+\b|\bgg+\b|\bez\b|insano|absurdo|brabo|🔥)", re.I), 0.7), + r"😱|😳|\?{3,}|!{3,}|\bno+ ?wa+y+\b|\bna+h+\b|\bbru+h+\b|\bholy\b|\bjesus\b|" + r"\boh my god\b|\bwhat the\b)", re.I), 1.0), + "hype": (re.compile(r"(\bpog|pogchamp|poggers|\bw+\b|\bgg+\b|\bez\b|insano|absurdo|brabo|🔥|" + r"\blet'?s ?go+\b|\bletsgo+\b|\bshe+sh\b|\bclutch\b|\bcracked\b|\bgoated\b|\binsane\b|" + r"\bclap\b|\bdub\b)", re.I), 0.7), # Palavra inteira: "clip5k1hmm" (emote) casava com \bclip e dava peso de pedido de clipe. - "clip": (re.compile(r"\b(clip|clips|clipa|clipe|clipou|clipar|clip it|clipit)\b", re.I), 3.0), + "clip": (re.compile(r"\b(clip|clips|clipa|clipe|clipou|clipar|clip it|clipit|clip that|clipped)\b", re.I), 3.0), } -# Palavras faladas que indicam reação (modo sem chat). -SPOKEN_REACTION = re.compile(r"^(caralho|caraca|nossa|meu|deus|socorro|mano|nãããão|não|sim|vai|gente|que|isso|olha)$", re.I) +# Palavras faladas que indicam reação (modo sem chat), em português e em inglês (fonte gringa). +SPOKEN_REACTION = re.compile(r"^(caralho|caraca|nossa|meu|deus|socorro|mano|nãããão|não|sim|vai|gente|que|isso|olha|" + r"bro|bruh|dude|yo|what|no+|oh|wow|holy|fuck|shit|wait|god|jesus|yes+|bro+)$", re.I) @dataclass(frozen=True) diff --git a/clipper/app/subtitles.py b/clipper/app/subtitles.py index 4a86581..4515b07 100644 --- a/clipper/app/subtitles.py +++ b/clipper/app/subtitles.py @@ -96,6 +96,27 @@ def caption_blocks(words: list[Word], max_words: int = MAX_WORDS) -> list[tuple[ return out +PHRASE_GAP_S, PHRASE_MAX_S, PHRASE_MAX_WORDS = 0.7, 6.0, 16 +_SENTENCE_END = (".", "?", "!") + + +def phrases(words: list[Word]) -> list[tuple[float, float, str]]: + """Fala em frases curtas com tempo (início, fim, texto) para traduzir: quebra em pausa > 0,7 s, fim de frase + (. ? !) com 4+ palavras, 16 palavras ou 6 s. A tradução de uma frase inteira sai melhor que a de blocos de 3.""" + out: list[tuple[float, float, str]] = [] + current: list[Word] = [] + for w in clean_words(words): + if current and (w.start - current[-1].end > PHRASE_GAP_S or w.end - current[0].start > PHRASE_MAX_S + or len(current) >= PHRASE_MAX_WORDS + or (current[-1].word.endswith(_SENTENCE_END) and len(current) >= 4)): + out.append((current[0].start, current[-1].end, " ".join(x.word for x in current))) + current = [] + current.append(w) + if current: + out.append((current[0].start, current[-1].end, " ".join(x.word for x in current))) + return out + + def build_ass(words: list[Word], clip_start: float, clip_end: float, credit: str, settings: dict | None = None) -> str: """`words` com tempos da sessão; a saída usa tempos relativos ao início do corte.""" cfg = settings or layout.merge() diff --git a/clipper/app/worker.py b/clipper/app/worker.py index a735ecf..345d7d0 100644 --- a/clipper/app/worker.py +++ b/clipper/app/worker.py @@ -40,7 +40,7 @@ from .intel import Intel from .judge import Judge, JudgeError, analysis_block, build_prompt from .scoring import ChatMessage, Params, Word, find_moments, overlaps from .sources import Source, parse_source -from .subtitles import build_ass +from .subtitles import build_ass, phrases log = logging.getLogger("cenaforge_clipper") LIVE_WINDOW_S = 900 # ao vivo, pontua só os últimos 15 min (o que veio antes já foi decidido) @@ -51,6 +51,15 @@ def rel(path: Path) -> str: # ---------------------------------------------------------------- serviço de voz +# O serviço de voz (voice/app/stt.py, WHISPER_LANGUAGES) aceita "pt-BR", "en" e "es"; fonte e sessão usam o idioma do +# público ("en-US", "es-419"). Tradução num ponto só, aqui na fronteira (medido 18/11/2026: "en-US" voltava 422). +VOICE_LANGUAGES = {"pt-BR": "pt-BR", "en-US": "en", "en": "en", "es-419": "es", "es": "es"} + + +def voice_language(code: str) -> str: + return VOICE_LANGUAGES.get(code, code.split("-")[0] if code and not code.startswith("pt") else "pt-BR") + + class VoiceClient: def __init__(self, url: str | None, key: str | None, language: str): self.url, self.key, self.language = url, key, language @@ -72,7 +81,7 @@ class VoiceClient: if not self.configured: raise RuntimeError("serviço de voz não instalado") headers = { - "X-Service-Key": self.key or "", "Content-Type": "audio/wav", "X-Language": language or self.language, + "X-Service-Key": self.key or "", "Content-Type": "audio/wav", "X-Language": voice_language(language or self.language), "X-Detail": "words", "X-Idempotency-Key": idempotency_key, } response = httpx.post(f"{self.url}/v1/transcribe", content=wav, headers=headers, timeout=180) @@ -877,22 +886,25 @@ class Engine: n_frames = 8 if hi - f_lo > 80 else 6 times = [f_lo + (hi - f_lo) * k / (n_frames - 1) for k in range(n_frames)] frames = self.intel.frames(session, times, f"clip{clip['id']}") + # Fonte em inglês: os juízes trabalham em inglês e devolvem também o português do painel (IDIOMAS.md). + lang = self.intel.lang(session) prompt = build_prompt(streamer, session["platform"], clip["start_s"], clip["end_s"], clip["peak_s"], tl["words"], tl["chat"], heuristic, session["title"], context=self.intel.context(session), frames=frames, backtrack_s=dur["backtrackS"], min_s=dur["minS"], max_s=dur["maxS"], - face=self.face.summary(session, lo, hi)) + face=self.face.summary(session, lo, hi), lang=lang) analysis = None try: # Dois juízes: o ANALISTA (vê os frames) diz o que aconteceu; o EDITOR decide e escreve a partir disso. try: - analysis = self.judge.analyze(prompt, [p for _, p in frames]) + analysis = self.judge.analyze(prompt, [p for _, p in frames], lang=lang) except (JudgeError, json.JSONDecodeError, KeyError, ValueError) as exc: log.warning("analista falhou no corte %s: %s (editor segue sozinho)", clip["id"], exc) - editor_prompt = prompt + ("\n\n" + analysis_block(analysis) if analysis else "") + editor_prompt = prompt + ("\n\n" + analysis_block(analysis, lang) if analysis else "") # Sem análise, o editor recebe os frames; com análise, só texto (mais barato, a tela já foi lida). verdict = self.judge.judge(editor_prompt, clip["start_s"], clip["end_s"], [] if analysis else [p for _, p in frames], - lo=lo, hi=hi, min_s=layout.min_target({"duration": dur}), max_s=dur["maxS"]) + lo=lo, hi=hi, min_s=layout.min_target({"duration": dur}), max_s=dur["maxS"], + lang=lang) # Corte manual: quem decidiu foi você; o juiz só escreve título e legenda (e não mexe no trecho). manual = clip["source"] == "manual" keep = manual or (verdict.keep and verdict.score >= self.min_score) @@ -904,6 +916,8 @@ class Engine: "start_s": verdict.start_s, "end_s": verdict.end_s, "judge": {"model": verdict.model, "keep": verdict.keep, "score": verdict.score, "reason": verdict.reason, "analysis": analysis, + # Fonte em inglês: título/legenda/motivo em português (só o painel lê). + **({"pt": verdict.pt} if verdict.pt else {}), "analystModel": (self.judge.analyst_model or self.judge.model) if analysis else None}} except (JudgeError, json.JSONDecodeError, KeyError, ValueError) as exc: # Falha do juiz não perde o momento: segue com a heurística e registra o motivo. @@ -942,6 +956,8 @@ class Engine: if update["status"] == "pending": # Novo veredito: o projeto que a IA tinha gerado é refeito no render (o que você editou fica). self.db.run("DELETE FROM edits WHERE clip_id = ? AND origin = 'ai'", clip["id"]) + # Fonte em inglês: a fala do corte em português para o painel (falha não segura o corte). + self.translate_clip(clip["id"], update["start_s"], update["end_s"]) verdict_info = update["judge"] or {} if clip["source"] != "manual" and "score" in verdict_info: # Aprendizado fraco pela IA (o forte vem da sua aprovação/rejeição no painel). @@ -950,6 +966,37 @@ class Engine: elif verdict_info["score"] >= 7: self.intel.learn_from_clip(clip, positive=True, factor=0.5) + def translate_clip(self, clip_id: int, lo: float | None = None, hi: float | None = None, + force: bool = False) -> dict | None: + """Fonte em inglês (doc/clipador/IDIOMAS.md): a fala de [lo, hi] (padrão: o trecho do corte) em frases com + tempo da sessão + tradução em português, em `clips.translation_json`. Serve ao painel ("o que ele disse") e à + legenda de desenvolvimento (`caption.translation`). Reaproveita a tradução que já cobre o trecho. + Sessão em português, IA desligada ou falha da IA → None (o corte segue sem tradução).""" + clip = self.db.get("SELECT * FROM clips WHERE id = ?", clip_id) + session = self.db.get("SELECT * FROM sessions WHERE id = ?", clip["session_id"]) if clip else None + if not clip or not session or self.intel.lang(session) != "en" or not self.judge.enabled: + return None + lo = clip["start_s"] if lo is None else lo + hi = clip["end_s"] if hi is None else hi + current = loads(clip.get("translation_json"), None) + if (isinstance(current, dict) and not force and current.get("startS", 1e12) <= lo + 0.5 + and current.get("endS", -1) >= hi - 0.5): + return current + tl = self.load_timeline(session["id"], max(0.0, lo - 30)) + items = phrases([w for w in tl["words"] if lo - 0.3 <= w.start <= hi]) + if not items: + return None + try: + pt = self.judge.translate_lines([text for _, _, text in items]) + except (JudgeError, json.JSONDecodeError, KeyError, ValueError) as exc: + log.warning("tradução da fala do corte %s falhou: %s", clip_id, exc) + return None + data = {"language": "pt-BR", "startS": round(lo, 2), "endS": round(hi, 2), "model": self.judge.responder(), + "lines": [{"s": round(s, 3), "e": round(e, 3), "text": text, "pt": tr} + for (s, e, text), tr in zip(items, pt)]} + self.db.run("UPDATE clips SET translation_json = ? WHERE id = ?", json.dumps(data, ensure_ascii=False), clip_id) + return data + def render_pending(self) -> None: self.recover_orphan_renders() self.discard_pending_duplicates() diff --git a/clipper/tests/test_ai_fallback.py b/clipper/tests/test_ai_fallback.py index 7c1bb8b..ab4a81c 100644 --- a/clipper/tests/test_ai_fallback.py +++ b/clipper/tests/test_ai_fallback.py @@ -311,3 +311,45 @@ def test_api_accepts_gemini(env): # noqa: F811 body = r.json() assert body["provider"] == "gemini" and body["model"] == "gemini-3.5-flash" and "gemini" in body["models"] assert "chain" in body["fallback"] and isinstance(body["pauses"], list) + + +# ---------------------------------------------------------------- uso e limites (data/ai/usage.json do painel) +def write_usage(folder: Path, providers: dict, limit: int = 90, age_s: float = 0) -> None: + import time as _time + from datetime import datetime as _dt, timezone as _tz + iso = lambda t: _dt.fromtimestamp(t, _tz.utc).isoformat().replace("+00:00", "Z") # noqa: E731 + now = _time.time() + data = {"updatedAt": iso(now), "limitPercent": limit, "providers": { + name: {"at": iso(now - age_s), "source": "cli", "blocked": spec.get("blocked", False), "plan": None, "note": None, + "error": None, "windows": [{"id": "five_hour", "label": "Sessão (5 h)", "usedPercent": spec["used"], + "resetsAt": iso(now + spec.get("resets_in", 3600))}]} + for name, spec in providers.items()}} + folder.mkdir(parents=True, exist_ok=True) + (folder / "usage.json").write_text(json.dumps(data), encoding="utf-8") + + +def test_over_limit_rule(ai_dir): + ai = AiConfig(ai_dir, cipher=ReversedCipher(), environ={}) + assert ai.over_limit("claude") is None # sem arquivo + write_usage(ai_dir, {"claude": {"used": 93}, "codex": {"used": 100, "blocked": True}, "gemini": {"used": 50}}) + assert ai.over_limit("claude") == "Sessão (5 h) em 93% (limite 90%)" + assert ai.over_limit("codex") == "bateu o limite (Sessão (5 h))" + assert ai.over_limit("gemini") is None + write_usage(ai_dir, {"claude": {"used": 93}}, limit=95) + assert ai.over_limit("claude") is None + write_usage(ai_dir, {"codex": {"used": 100, "blocked": True, "resets_in": -60}}) + assert ai.over_limit("codex") is None # a janela já zerou + write_usage(ai_dir, {"claude": {"used": 99}}, age_s=3600) + assert ai.over_limit("claude") is None # leitura velha não decide + (ai_dir / "usage.json").write_text("{quebrado", encoding="utf-8") + assert ai.over_limit("claude") is None + + +def test_chain_puts_provider_near_limit_after_free_ones(make_judge, ai_dir): + judge = make_judge(provider="codex") + write_usage(ai_dir, {"codex": {"used": 100, "blocked": True}}) + assert judge.fallback_chain() == ["claude", "codex"] # escolhida no limite: a livre vem antes + write_usage(ai_dir, {"codex": {"used": 95}, "claude": {"used": 97}}) + assert judge.fallback_chain() == ["codex", "claude"] # todas no limite: melhor tentar do que parar + write_settings(ai_dir, {**settings_with(), "fallback": {"enabled": False, "cooldownMin": 15}}) + assert judge.fallback_chain() == ["codex"] # reserva desligada: só a escolhida, mesmo no limite diff --git a/clipper/tests/test_english_source.py b/clipper/tests/test_english_source.py new file mode 100644 index 0000000..d17df4a --- /dev/null +++ b/clipper/tests/test_english_source.py @@ -0,0 +1,150 @@ +"""Fonte em inglês (18/11/2026, doc/clipador/IDIOMAS.md): juízes em inglês com o português do painel na mesma +resposta, risada/gíria do chat em inglês, fala do corte traduzida por frase e legenda em português de desenvolvimento +(desligada por padrão).""" +import json +from pathlib import Path + +from app import editor, editor_render, layout +from app.judge import (ANALYSIS_SCHEMA_EN, JUDGE_SYSTEM_EN, SCAN_SCHEMA_EN, VERDICT_SCHEMA_EN, Judge, Verdict, + analysis_block, build_prompt, lang_key) +from app.scoring import REACTION_PATTERNS, ChatMessage, Word +from app.subtitles import phrases + +from .test_editor import validate +from .test_render_and_duplicates import add_clip +from .test_sources_and_api import env, seed_session # noqa: F401 - fixture reaproveitada + + +class EnglishJudge(Judge): + """Juiz falso: registra o idioma pedido e devolve o bloco `pt`, como os schemas em inglês exigem.""" + + def __init__(self): + super().__init__("codex", "fake", Path(".")) + self.seen: dict = {} + self.translated: list[list[str]] = [] + + def analyze(self, prompt, images, lang="pt"): + self.seen["analyze"] = (lang, prompt) + return {"situation": "jogada", "what_happened": "He robbed the bank.", "screen": "", "speech": "", + "chat_meaning": "", "confidence": 0.9, "action_start_s": 0, "reaction_end_s": 0, "hook": "NO WAY", + "pt": {"what_happened": "Ele roubou o banco.", "screen": "", "speech": "", "chat_meaning": "", "hook": "NÃO ACREDITO"}} + + def judge(self, prompt, start_s, end_s, images=None, lang="pt", **_limits): + self.seen["judge"] = (lang, prompt) + return Verdict(True, 8.0, start_s, end_s, "He robbed the bank solo", "Insane solo heist.", "great play", "fake", + ("heist",), pt={"title": "Ele roubou o banco sozinho", "caption": "Assalto solo insano.", + "reason": "jogada ótima"}) + + def translate_lines(self, lines): + self.translated.append(list(lines)) + return [f"PT: {text}" for text in lines] + + +def _english_session(engine) -> int: + sid = seed_session(engine) + engine.db.run("UPDATE sessions SET language = 'en-US' WHERE id = ?", sid) + words = [[281.0, 281.3, "No"], [281.3, 281.6, "way"], [281.6, 282.0, "bro."], [284.0, 284.4, "Let's"], [284.4, 284.9, "go!"]] + engine.db.run("UPDATE segments SET words_json = '[]' WHERE session_id = ?", sid) + engine.db.run("UPDATE segments SET words_json = ? WHERE session_id = ? AND idx = 9", json.dumps(words), sid) + return sid + + +def test_lang_key(): + assert lang_key("en-US") == "en" and lang_key("en") == "en" + assert lang_key("pt-BR") == "pt" and lang_key("es-419") == "pt" and lang_key("") == "pt" and lang_key(None) == "pt" + + +def test_english_schemas_require_the_portuguese_block(): + assert ANALYSIS_SCHEMA_EN["required"][-1] == "pt" and VERDICT_SCHEMA_EN["required"][-1] == "pt" + assert "summary_pt" in SCAN_SCHEMA_EN["required"] + assert "pt" in SCAN_SCHEMA_EN["properties"]["moments"]["items"]["required"] + # Os CLIs exigem todas as propriedades em `required` (strict). + for schema in (ANALYSIS_SCHEMA_EN, VERDICT_SCHEMA_EN, SCAN_SCHEMA_EN): + assert set(schema["properties"]) == set(schema["required"]) + assert "LMAO" in JUDGE_SYSTEM_EN and "💀" in JUDGE_SYSTEM_EN + + +def test_english_prompt_labels_and_analysis_block_without_pt(): + prompt = build_prompt("Tfue", "twitch", 100, 160, 150, [Word(140, 141, "bro")], [ChatMessage(151, "LMAO")], {}, + "GTA 6 Waiting Room", lang="en") + assert "Channel: Tfue" in prompt and "Transcript:" in prompt and "Chat sample:" in prompt + assert "Transcrição" not in prompt and "Canal:" not in prompt + block = analysis_block({"situation": "jogada", "pt": {"what_happened": "x"}}, "en") + assert block.startswith("ANALYST's analysis") and '"pt"' not in block + + +def test_english_chat_laughter_and_slang_count_as_reaction(): + def tags(text): + return {tag for tag, (pattern, _) in REACTION_PATTERNS.items() if pattern.search(text)} + assert "risada" in tags("LMAO") and "risada" in tags("lol") and "risada" in tags("💀💀") and "risada" in tags("im dead") + assert "risada" in tags("😭😭") and "risada" not in tags("lollipop") + assert "susto" in tags("no way") and "susto" in tags("bruhhh") and "susto" in tags("nahhh") + assert "hype" in tags("LETS GOOO") and "hype" in tags("sheesh") and "hype" in tags("clutch") + assert "clip" in tags("clip that") + + +def test_phrases_split_on_sentence_end_and_pause(): + words = [Word(0, 0.3, "No"), Word(0.3, 0.6, "way"), Word(0.6, 0.9, "bro."), Word(0.9, 1.2, "This"), Word(1.2, 1.5, "is"), + Word(1.5, 1.8, "crazy"), Word(1.8, 2.1, "man."), Word(3.5, 3.8, "Okay")] + assert [t for _, _, t in phrases(words)] == ["No way bro. This is crazy man.", "Okay"] + assert phrases([]) == [] + + +def test_english_session_judges_in_english_and_stores_portuguese(env): # noqa: F811 + client, engine = env + engine.judge = EnglishJudge() + sid = _english_session(engine) + add_clip(engine, sid, 1, "candidate", 285, 270, 340) + engine.judge_clip(engine.db.get("SELECT * FROM clips WHERE id = 1")) + assert engine.judge.seen["analyze"][0] == "en" and engine.judge.seen["judge"][0] == "en" + assert "Transcript:" in engine.judge.seen["judge"][1] and "ANALYST's analysis" in engine.judge.seen["judge"][1] + clip = client.get("/v1/clips/1", headers=_auth()).json() + assert clip["title"] == "He robbed the bank solo" # o vídeo/publicação: inglês + assert clip["judge"]["pt"]["title"] == "Ele roubou o banco sozinho" # o painel: português + assert clip["judge"]["analysis"]["pt"]["what_happened"] == "Ele roubou o banco." + lines = clip["translation"]["lines"] + assert [x["text"] for x in lines] == ["No way bro.", "Let's go!"] + assert lines[0]["pt"] == "PT: No way bro." and clip["translation"]["language"] == "pt-BR" + # Tradução que já cobre o trecho é reaproveitada (sem chamar a IA de novo). + engine.translate_clip(1) + assert len(engine.judge.translated) == 1 + + +def test_portuguese_session_has_no_translation(env): # noqa: F811 + client, engine = env + engine.judge = EnglishJudge() + sid = seed_session(engine) + add_clip(engine, sid, 1, "candidate", 300, 280, 350) + engine.judge_clip(engine.db.get("SELECT * FROM clips WHERE id = 1")) + assert engine.judge.seen["judge"][0] == "pt" and "Transcrição:" in engine.judge.seen["judge"][1] + assert client.get("/v1/clips/1", headers=_auth()).json()["translation"] is None + assert client.post("/v1/clips/1/translate", headers=_auth()).status_code == 409 + + +def test_dev_translation_line_only_when_enabled(tmp_path): + clip = {"session_id": 1, "start_s": 10.0, "end_s": 75.0, "peak_s": 50.0, "title": "He robbed the bank", "source": "chat"} + words = [Word(20, 20.4, "No"), Word(20.4, 20.8, "way"), Word(20.8, 21.2, "bro.")] + lines = [{"s": 20.0, "e": 21.2, "text": "No way bro.", "pt": "Não acredito, mano."}] + for enabled in (False, True): + cfg = layout.merge({"caption": {"translation": enabled}}) + p = validate(editor.auto_project(clip, None, words, [], 100.0, cfg), tmp_path) + ass = editor_render.build_project_ass(p, editor.effective_settings(cfg, p), "twitch.tv/tfue", translation=lines) + has = "Não acredito, mano." in ass and "Style: Trans," in ass + assert has is enabled + # Sem tradução disponível nada muda, mesmo ligado. + cfg = layout.merge({"caption": {"translation": True}}) + p = validate(editor.auto_project(clip, None, words, [], 100.0, cfg), tmp_path) + assert "Style: Trans," not in editor_render.build_project_ass(p, editor.effective_settings(cfg, p), "x") + assert layout.DEFAULTS["caption"]["translation"] is False + assert layout.validate({"caption": {"translation": True}})["caption"]["translation"] is True + + +def _auth(): + from .test_sources_and_api import auth + return auth() + + +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" diff --git a/clipper/tests/test_intel.py b/clipper/tests/test_intel.py index 1d6b8cd..4ca5ee9 100644 --- a/clipper/tests/test_intel.py +++ b/clipper/tests/test_intel.py @@ -114,7 +114,7 @@ class ScanJudge(Judge): super().__init__("codex", "fake", __import__("pathlib").Path(".")) self.prompts = [] - def scan(self, prompt, images): + def scan(self, prompt, images, lang="pt"): self.prompts.append(prompt) return {"screen_game": "ROB RUN", "has_webcam": True, "summary": "tiroteio na base", "moments": [{"score": 8, "start_s": 100, "end_s": 140, "title": "Emboscada", "caption": "c #robrun", diff --git a/clipper/tests/test_monitor_pause_and_language.py b/clipper/tests/test_monitor_pause_and_language.py index 50a0d2c..47e94e9 100644 --- a/clipper/tests/test_monitor_pause_and_language.py +++ b/clipper/tests/test_monitor_pause_and_language.py @@ -138,13 +138,19 @@ def test_language_on_channel_and_session(ready): def test_language_note_reaches_the_ai_context(ready): client, engine = ready assert output_language_note("pt-BR") == "" and output_language_note("") == "" and output_language_note(None) == "" - assert "English (US)" in output_language_note("en-US") + # Inglês (18/11/2026): os juízes trabalham em inglês (prompts próprios), sem a nota; espanhol mantém a nota. + assert output_language_note("en-US") == "" + assert "Español" in output_language_note("es-419") client.post("/v1/channels", json={"url": URL, "language": "en-US"}, headers=auth()) sid = client.post("/v1/sessions", json={"url": URL}, headers=auth()).json()["id"] gringa = engine.db.get("SELECT * FROM sessions WHERE id = ?", sid) - assert "Idioma de saída: English (US)" in engine.intel.context(gringa) + assert engine.intel.lang(gringa) == "en" + assert "Stream title:" in engine.intel.context(gringa) + engine.db.run("UPDATE sessions SET language = 'es-419' WHERE id = ?", sid) + assert "Idioma de saída: Español" in engine.intel.context(engine.db.get("SELECT * FROM sessions WHERE id = ?", sid)) engine.db.run("UPDATE sessions SET language = '' WHERE id = ?", sid) - assert "Idioma de saída" not in engine.intel.context(engine.db.get("SELECT * FROM sessions WHERE id = ?", sid)) + br = engine.db.get("SELECT * FROM sessions WHERE id = ?", sid) + assert "Idioma de saída" not in engine.intel.context(br) and "Título da live:" in engine.intel.context(br) def test_transcription_uses_session_language(ready, monkeypatch): diff --git a/clipper/tests/test_render_and_duplicates.py b/clipper/tests/test_render_and_duplicates.py index 9fd1aab..425a3a0 100644 --- a/clipper/tests/test_render_and_duplicates.py +++ b/clipper/tests/test_render_and_duplicates.py @@ -20,7 +20,7 @@ class RecuoJudge(Judge): super().__init__("codex", "fake", Path(".")) self.back_to = back_to - def analyze(self, prompt, images): + def analyze(self, prompt, images, lang="pt"): return {"situation": "lag_ou_bug", "confidence": 0.9, "action_start_s": 0, "reaction_end_s": 0, "hook": ""} def judge(self, prompt, start_s, end_s, images=None, **_limits): diff --git a/doc/clipador/IDIOMAS.md b/doc/clipador/IDIOMAS.md new file mode 100644 index 0000000..0b0dfe7 --- /dev/null +++ b/doc/clipador/IDIOMAS.md @@ -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. diff --git a/doc/ia.md b/doc/ia.md index d40692b..44768b2 100644 --- a/doc/ia.md +++ b/doc/ia.md @@ -1,5 +1,11 @@ # IA do CenaForge — provedores, login e reserva +> **18/11/2026 — Gemini CLI removido do painel.** O login pela conta pessoal acabou (ver abaixo) e o Antigravity CLI +> (`agy`) o substitui com a mesma conta Google. Os provedores do painel são `claude`, `codex` e `antigravity`. Um +> `settings.json` antigo com `"gemini"` é ignorado. O juiz do Clipador não oferece mais o Gemini na tela; o código +> Python do Gemini (`judge.py`) ficou inativo, porque o painel não liga mais essa IA. As seções sobre o Gemini CLI +> abaixo ficam como histórico do estudo. + Três IAs, sempre pela **CLI oficial** instalada no PC (nunca SDK/HTTP direto): | Provedor | CLI | Instalação (Windows) | Login com a conta (OAuth) | Chave de API (variável) | @@ -80,3 +86,64 @@ Falha que não é culpa do pedido: limite de uso ou cota (`rate limit`, `429`, ` então o schema vai no prompt e o JSON é extraído do texto. Leitura somente: `--approval-mode plan --skip-trust`, rodando numa pasta temporária fora do repositório (o `@arquivo` respeita o `.gitignore`). - Modelos: `gemini models -o json` (não exige login). - No Windows o npm instala `gemini.cmd`; rode `node /node_modules/@google/gemini-cli/bundle/gemini.js`. + +## Estudo: uso e limites de cada IA pela CLI (18/11/2026) + +Objetivo: mostrar quanto de cada IA já foi usado, trocar de IA ANTES de bater o limite e, se bater, mostrar o +uso e quando volta. Medido nesta máquina (claude 2.1.314, codex-cli 0.169.0, gemini-cli 0.68.0). + +| IA | Como ler o uso | Custo da leitura | O que vem | +|---|---|---|---| +| Claude (assinatura) | `claude -p "/usage" --output-format stream-json --verbose` | **zero** (modelo ``, 0 tokens, US$ 0) | texto: "Current session: 2% used · resets …", "Current week (all models): 67%", "Current week (Fable): 24%" | +| Claude (em toda execução) | evento `rate_limit_event` do stream-json (vem logo após o `init`) | zero (já vem junto) | `unifiedWindows.five_hour/seven_day.utilization` (0–1), `resetsAt` (epoch), `status` (`allowed`…), `overageStatus`, `isUsingOverage` | +| Codex (ChatGPT) | `codex app-server` (JSON-RPC por stdin): `initialize` → `initialized` → `account/rateLimits/read` | **zero** (não roda modelo) | `primary` (janela 300 min) e `secondary` (10080 min): `usedPercent`, `resetsAt`; `ordinaryUsageAllowed`, `rateLimitReachedType`, `planType`, créditos de reset grátis | +| Codex (histórico) | `~/.codex/sessions/AAAA/MM/DD/rollout-*.jsonl`, evento `token_count.rate_limits` (`limit_id: "codex"`) | zero | mesmo conteúdo, com a hora em que foi gravado | +| Gemini (chave) | não há consulta de cota restante pela CLI nem pela API do AI Studio | — | só reativo: erro 429 `RESOURCE_EXHAUSTED`; o CLI distingue `RetryableQuotaError` (por minuto, traz `retryDelay`) de `TerminalQuotaError` (cota do dia acabou) | + +Observações: +- No teste, o Codex estava com a janela de 5 h em **100%** (`rate_limit_reached`, `ordinaryUsageAllowed: false`): + com a leitura prévia, o painel o teria pulado em vez de esperar a falha. +- Cuidado no Git Bash: `/usage` vira caminho (`C:/Program Files/Git/usage`) e a CLI cobra uma resposta normal. + O painel chama sem shell, então não é afetado; no terminal use `MSYS_NO_PATHCONV=1`. +- `claude -p "/usage"` devolve texto em inglês, com datas no fuso local: o parser precisa ser tolerante e + preferir o `rate_limit_event` (estruturado) quando houver execução recente. +- Gemini com chave: contar nós mesmos as requisições e tokens do dia (o `result` do stream-json traz `stats`) e + pausar até o reset diário quando vier `TerminalQuotaError`. + +### Implementado (18/11/2026) +- `panel/src/lib/ai-usage.ts`: leitura do Claude (`/usage` + `rate_limit_event` de cada execução) e do Codex + (`app-server`), monitor de 5 min (liga ao abrir Configurações → IA) e releitura antes de cada tarefa (> 60 s). +- `overLimit` (lib/ai.ts): bateu o limite ou janela ainda valendo ≥ `fallback.usageLimitPercent` (padrão 90) → + a tarefa nova começa na próxima IA livre; leitura com mais de 30 min não decide. +- `data/ai/usage.json` (escrito pelo painel): `{updatedAt, limitPercent, providers: {: {at, windows[], blocked, …}}}`. + O juiz do Clipador lê (`AiConfig.over_limit`) e põe a IA perto do limite depois das livres. + +## Gemini pela conta: Antigravity CLI (pesquisa de 18/11/2026) +- O gemini-cli não aceita mais conta pessoal (nem AI Pro/Ultra) desde 18/06/2026; Code Assist Standard/Enterprise + não vende assinatura nova desde 09/10/2026. Fonte: developers.google.com/gemini-code-assist/docs/deprecations/code-assist-individuals +- Substituto oficial: **Antigravity CLI** (`%USERPROFILE%\.gemini\bin\agy.exe`, 1.5.10 nesta máquina, fora do PATH). + Headless parecido com o Claude: `agy -p --output-format stream-json --mode accept-edits [--model] [--effort] + [--conversation ]`; `agy models` funciona com a conta logada (Gemini 4, Gemini 3.8 Flash, Claude, GPT-OSS). +- **Termos:** a FAQ (antigravity.google/docs/faq) diz que embrulhar o `agy` em app de terceiro "is not supported + under consumer plans"; recomenda chave do AI Studio ou Gemini Enterprise. Respostas de funcionários no fórum se + contradizem. Zona cinza: decisão do usuário. +- Os três pontos que estavam em aberto (saída sem TTY, edição com `accept-edits`, formato do stream-json) foram + testados e funcionam: ver "Antigravity no painel" abaixo. + +### Antigravity no painel (implementado em 18/11/2026, agy 1.5.10) +Testado de verdade nesta máquina (prompts mínimos, conta Google logada): +- **Sem terminal funciona:** `agy -p "…" --output-format stream-json` chamado pelo Node respondeu em ~6 s. +- **Eventos:** `{"event":"init","conversation_id"}`, `step_update` (`step_type`: `user_input` | `agent_response` com + `text_delta` | `tool` com `tool_name`, `tool_info.parameters` e `state` ACTIVE/DONE/ERROR; `usage` por passo) e + `{"event":"result","result":{status:"SUCCESS",response,num_turns,usage}}`. Retomada: `--conversation `. +- **Edição:** `--mode accept-edits` grava arquivos sem pedir. +- **Shell:** só com `--settings '{"permissions":{"allow":["command()"]}}'` (vale só na sessão). + Testado: `command(node --version)` libera exatamente essa linha; prefixo, `command(node)`, `command(node:*)` e + `command(node -e *)` NÃO liberam. O que não estiver liberado é recusado (passo `ERROR` + aviso `jetski:` no + stderr; o processo sai com 0). Não usamos `--dangerously-skip-permissions`. +- **Uso, sem cota:** `agy -p "/usage" --output-format stream-json` → `{"event":"command_result","command":{"name":"usage", + "data":{"groups":[{"name":"Gemini Models","buckets":[{"window":"5h"|"weekly","remaining_fraction":0.88,"reset_time"}]}, + {"name":"Claude and GPT models",…}]}}}`. O painel usa o grupo Gemini (modelos padrão do agente). +- **Login:** `agy models` só lista com a conta logada (sem gastar cota); "Entrar com a conta" abre `agy` interativo. +- **Modelos:** `agy models` → linhas `idnome` (18 nesta conta), depois de uma linha "Fetching available models...". +- Começa **desligado**; o juiz do Clipador ainda não usa o Antigravity (só agentes do painel). diff --git a/panel/src/app/actions.ts b/panel/src/app/actions.ts index 6e50a0a..4fd5de4 100644 --- a/panel/src/app/actions.ts +++ b/panel/src/app/actions.ts @@ -1,5 +1,6 @@ "use server"; // Ações de formulário (server actions). Devolvem { error } ou { message } para o formulário. +import { refreshUsage } from "@/lib/ai-usage"; import { revalidatePath } from "next/cache"; import { redirect } from "next/navigation"; import { prepareBranches } from "@/lib/branches"; @@ -54,6 +55,7 @@ export async function createStoryFromTextAction(_prev: FormState, form: FormData const story = createStory({ title, id, logline: "", kind, branchCount: Number(form.get("branchCount") ?? 2) }); // Documental é um vídeo só: sem título de episódio ("Abertura" só faz sentido numa série). const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" }); + await refreshUsage({ maxAgeMs: 60_000 }); // uso das IAs fresco antes de escolher (Configurações → IA) const chosen = String(form.get("provider") ?? ""); const provider: Provider = (PROVIDERS as string[]).includes(chosen) ? (chosen as Provider) : defaultProviderFor("story"); // Modelo escolhido no formulário; vazio = padrão da tarefa (no Codex, o do config.toml). startRun valida. diff --git a/panel/src/app/agent/page.tsx b/panel/src/app/agent/page.tsx index 3913f53..69492f9 100644 --- a/panel/src/app/agent/page.tsx +++ b/panel/src/app/agent/page.tsx @@ -24,7 +24,7 @@ export default async function AgentPage({ searchParams }: { searchParams: Promis const defaults: AgentDefaults = { provider: map(defaultProviderFor), preferred: PREFERRED_PROVIDER, - model: map((k) => ({ claude: defaultModelFor(k, "claude"), codex: defaultModelFor(k, "codex"), gemini: defaultModelFor(k, "gemini") })), + model: map((k) => ({ claude: defaultModelFor(k, "claude"), codex: defaultModelFor(k, "codex"), antigravity: defaultModelFor(k, "antigravity") })), }; return ( diff --git a/panel/src/app/api/agent/runs/route.ts b/panel/src/app/api/agent/runs/route.ts index 48266ad..167e6ee 100644 --- a/panel/src/app/api/agent/runs/route.ts +++ b/panel/src/app/api/agent/runs/route.ts @@ -1,3 +1,4 @@ +import { refreshUsage } from "@/lib/ai-usage"; import { startRun } from "@/lib/agents"; import { errorResponse } from "@/lib/http"; import type { AgentKind, Provider } from "@/lib/types"; @@ -8,6 +9,7 @@ export async function POST(request: Request) { provider: Provider; model?: string; kind: AgentKind; request: string; storyId?: string | null; episodeId?: number | null; resumeRunId?: number | null; }; + await refreshUsage({ maxAgeMs: 60_000 }); // uso das IAs fresco antes de escolher (Configurações → IA) const run = startRun({ ...body, model: body.model ?? "" }); return Response.json({ id: run.id }); } catch (error) { diff --git a/panel/src/app/api/ai/[provider]/route.ts b/panel/src/app/api/ai/[provider]/route.ts index f9e8c0a..b7862a6 100644 --- a/panel/src/app/api/ai/[provider]/route.ts +++ b/panel/src/app/api/ai/[provider]/route.ts @@ -1,4 +1,5 @@ import { clearCooldown, openLoginTerminal, providerStatus, readAiSettings, setApiKey, startInstall, testProvider } from "@/lib/ai"; +import { refreshUsage } from "@/lib/ai-usage"; import { errorResponse, readJson } from "@/lib/http"; import { UserError } from "@/lib/stories"; import { PROVIDERS, type Provider } from "@/lib/types"; @@ -16,12 +17,13 @@ async function mustProvider(ctx: Ctx): Promise { const payload = (refresh = false) => ({ settings: readAiSettings(), providers: providerStatus({ refresh }) }); /** - * Ações de uma IA: {action: "install" | "login" | "verify" | "test" | "resume"}. + * Ações de uma IA: {action: "install" | "login" | "verify" | "test" | "resume" | "usage"}. * install — instala/atualiza a CLI em segundo plano (o log vem no GET /api/ai); * login — abre um terminal com o login da CLI (OAuth no navegador); * verify — refaz a detecção (depois do login ou da instalação); * test — pergunta mínima para confirmar login/chave/cota (devolve {test}); - * resume — tira a IA da pausa da reserva. + * resume — tira a IA da pausa da reserva; + * usage — relê agora quanto do limite (sessão de 5 h, semana) a IA já usou. */ export async function POST(request: Request, ctx: Ctx) { try { @@ -40,6 +42,9 @@ export async function POST(request: Request, ctx: Ctx) { const test = await testProvider(id); return Response.json({ ...payload(), test }); } + case "usage": + await refreshUsage({ only: id }); + return Response.json(payload()); case "resume": clearCooldown(id); return Response.json(payload()); diff --git a/panel/src/app/api/ai/route.ts b/panel/src/app/api/ai/route.ts index 5012d99..6174a7f 100644 --- a/panel/src/app/api/ai/route.ts +++ b/panel/src/app/api/ai/route.ts @@ -1,4 +1,5 @@ import { providerStatus, readAiSettings, updateAiSettings, type AiSettingsPatch } from "@/lib/ai"; +import { ensureUsageMonitor } from "@/lib/ai-usage"; import { errorResponse, readJson } from "@/lib/http"; export const dynamic = "force-dynamic"; @@ -7,13 +8,14 @@ export const dynamic = "force-dynamic"; export async function GET(request: Request) { try { const refresh = new URL(request.url).searchParams.get("refresh") === "1"; + ensureUsageMonitor(); // uso das IAs: relê a cada 5 min enquanto o painel estiver aberto return Response.json({ settings: readAiSettings(), providers: providerStatus({ refresh }) }, { headers: { "Cache-Control": "no-store" } }); } catch (error) { return errorResponse(error); } } -/** Atualiza só o que vier: {providers?: {?: {enabled?, authMode?}}, order?: [...], fallback?: {enabled?, cooldownMin?}}. */ +/** Atualiza só o que vier: {providers?: {?: {enabled?, authMode?}}, order?: [...], fallback?: {enabled?, cooldownMin?, usageLimitPercent?}}. */ export async function PUT(request: Request) { try { const settings = updateAiSettings(await readJson(request)); diff --git a/panel/src/app/api/characters/[id]/agent/route.ts b/panel/src/app/api/characters/[id]/agent/route.ts index cd7df98..f6c2b64 100644 --- a/panel/src/app/api/characters/[id]/agent/route.ts +++ b/panel/src/app/api/characters/[id]/agent/route.ts @@ -1,3 +1,4 @@ +import { refreshUsage } from "@/lib/ai-usage"; import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents"; import { characterFileRel, getCharacter } from "@/lib/characters"; import { errorResponse, readJson } from "@/lib/http"; @@ -12,6 +13,7 @@ export async function POST(request: Request, ctx: Ctx) { const character = getCharacter(id); if (!character) throw new UserError("Personagem não encontrado."); const body = await readJson<{ note?: string }>(request).catch(() => ({} as { note?: string })); + await refreshUsage({ maxAgeMs: 60_000 }); // uso das IAs fresco antes de escolher (Configurações → IA) const provider = defaultProviderFor("character"); const run = startRun({ provider, model: defaultModelFor("character", provider), kind: "character", diff --git a/panel/src/app/api/stories/route.ts b/panel/src/app/api/stories/route.ts index ae5e213..3e37c29 100644 --- a/panel/src/app/api/stories/route.ts +++ b/panel/src/app/api/stories/route.ts @@ -1,6 +1,7 @@ // Criar história com IA pela API (o mesmo que o formulário "Nova história com IA"): cria a história // e o primeiro episódio e põe o agente para escrever. { text, title?, kind?, provider?, model? } // → { storyId, episodeId, runId }. Útil para automação (o coordenador dispara o agente do painel). +import { refreshUsage } from "@/lib/ai-usage"; import { defaultModelFor, defaultProviderFor, startRun } from "@/lib/agents"; import { errorResponse } from "@/lib/http"; import { slugify } from "@/lib/paths"; @@ -20,6 +21,7 @@ export async function POST(request: Request) { for (let n = 2; getStory(id); n++) id = `${base}-${n}`; const story = createStory({ title, id, logline: "", kind, branchCount: 2 }); const ep = createEpisode(story.id, { title: kind === "documentary" ? "" : "Abertura" }); + await refreshUsage({ maxAgeMs: 60_000 }); // uso das IAs fresco antes de escolher (Configurações → IA) const provider: Provider = PROVIDERS.includes(body.provider as Provider) ? (body.provider as Provider) : defaultProviderFor("story"); const model = String(body.model ?? "") || defaultModelFor("story", provider); const run = startRun({ provider, model, kind: "story", request: text, storyId: story.id, episodeId: ep.id }); diff --git a/panel/src/components/agent-console.tsx b/panel/src/components/agent-console.tsx index 691ace7..383a93f 100644 --- a/panel/src/components/agent-console.tsx +++ b/panel/src/components/agent-console.tsx @@ -27,8 +27,8 @@ const KINDS: { id: AgentKind; label: string; description: string; icon: Componen { id: "free", label: "Pedido livre", description: "Ajustes no projeto, testes, iluminação", icon: ChatIcon }, ]; -export const PROVIDER_LABEL: Record = { claude: "Claude Code", codex: "GPT · Codex", gemini: "Gemini" }; -const PROVIDER_SHORT: Record = { claude: "Claude", codex: "GPT", gemini: "Gemini" }; +export const PROVIDER_LABEL: Record = { claude: "Claude Code", codex: "GPT · Codex", antigravity: "Antigravity" }; +const PROVIDER_SHORT: Record = { claude: "Claude", codex: "GPT", antigravity: "Antigravity" }; const PLACEHOLDER: Record = { story: "Ex.: Um entregador recebe um pacote sem remetente; toda vez que tenta entregar, o endereço muda. Suspense leve com humor.", @@ -254,7 +254,7 @@ export function AgentConsole(props: { {/* 4. Pedido */}
-
+
void save("limit", { fallback: { usageLimitPercent: Number(e.target.value) } }, "Limite de uso salvo.")}> + {[...new Set([...LIMIT_OPTIONS, settings.fallback.usageLimitPercent])].sort((a, b) => a - b) + .map((v) => )} + +