Files
CenaForge/doc/clipador/JOGOS.md
T
MateuusandClaude Opus 5.5 0567c7454a Clipador: subpáginas, jogos, idioma por canal e juiz com Gemini e IA reserva
- Clipador em subpáginas (Cortes, Sessões, Fontes, Jogos, Ajustes) com moldura comum, lista + diálogo
  dos cortes e submenu na barra lateral.
- Perfis de jogo (o que a IA sabe de cada jogo), parar pausa o monitor e idioma por fonte e por canal
  de publicação (migração v9: accounts.language).
- Juiz: Gemini CLI como terceiro provedor e IA reserva por chamada — se a IA escolhida cair por cota,
  login, chave ou rede, a próxima da ordem de Configurações → IA responde (com pausa da que caiu).
  Lê data/ai/settings.json e o cofre data/ai/vault.bin (DPAPI) escritos pelo painel; contrato em doc/ia.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 01:51:12 -03:00

4.2 KiB
Raw Blame History

Clipador — perfis de jogo bilíngues, missões e gatilhos (18/11/2026)

Pedido do dono

  • Perfil do jogo em português para ler e em inglês para a IA (é o que vai nos prompts).
  • Cadastrar jogo novo pelo painel (antes só nascia quando uma live trazia a categoria).
  • Missões do jogo (quando já estão publicadas na internet) e gatilhos de fim de missão.
  • Jogos em lista; clicar abre um modal (o cartão grande ocupava a tela).
  • GTA 6 completo.

Contrato (serviço clipper/ ↔ painel)

Perfil (mesmo formato nos dois idiomas)

{
  "name": "Grand Theft Auto VI",
  "aliases": ["GTA 6", "GTA VI", "GTA6"],      // outros nomes: a categoria da Twitch e o que a IA vê na tela caem no mesmo jogo
  "summary": "…", "genre": "…",
  "mechanics": [], "clip_worthy": [], "avoid": [], "jargon": [], "news": [], "hashtags": [], "sources": [],
  "missions": [                                   // [] quando ainda não há lista pública confiável
    { "name": "…", "chapter": "…", "summary": "…", "completion_triggers": ["…"] }
  ],
  "end_triggers": ["…"]                           // sinais gerais de fim de missão/objetivo (banner, tela de resultado, fala)
}

GET /v1/games — cada jogo

Campo O que é
profile Perfil em português (o que o painel mostra). Jogos antigos: o perfil que já existia.
profileAi Perfil em inglês (o que vai para a IA). null = ainda não traduzido (a IA usa profile).
aiLanguage "en-US"
translatedAt Quando a versão da IA foi gerada a partir da outra (ou vice-versa).
aliases Atalho de profileAi.aliases ∪ profile.aliases.
demais id, name, status (pending/ready/error), error, model, researchedAt, editedAt, notes (como antes)

Rotas

Rota O que faz
POST /v1/games {name, notes?} Cadastra jogo (status pending) e pesquisa em segundo plano. 409 se já existe (inclusive por alias).
POST /v1/games/{id}/research Pesquisa na web em inglês (missões e gatilhos inclusos) e traduz para português.
PUT /v1/games/{id}?lang=pt|en Grava a edição à mão no idioma lang (padrão pt) e traduz para o outro. Sem IA ligada: grava e marca a outra versão como desatualizada.
POST /v1/games/{id}/refine Pedido à IA (em português): atualiza a versão em inglês e traduz para português. Resposta reply em português.
POST /v1/games/{id}/translate Gera a versão em inglês a partir da portuguesa (jogos antigos).
DELETE /v1/games/{id} Apaga o jogo (sessões não mudam; o perfil é pesquisado de novo se o jogo voltar).

Detalhes da implementação (serviço):

  • POST /v1/games responde {games, id} (201); DELETE responde a lista. PUT ?lang= aceita pt (padrão) ou en.
  • refine aceita também as seções missions, end_triggers e aliases.
  • Tradução que falha (ou IA desligada): a versão traduzida fica como estava (na pesquisa, as duas em inglês) e error explica; translatedAt só muda quando a tradução deu certo. A tradução nunca mexe em nome, hashtags, fontes e outros nomes, e é recusada se perder missões.
  • Limites: até 120 missões, 8 gatilhos por missão (200 caracteres), 10 outros nomes, 12 end_triggers.

Sementes

clipper/app/seeds/games/*.json (formato: {name, aliases, researchedAt, sources, profileAi, profile}) é importado na subida do serviço só se o jogo ainda não existe (nunca sobrescreve edição). O GTA VI vem assim.

Prompts

  • O contexto da IA (game_context) usa profileAi (fallback profile), inclui end_triggers e as missões (nome + gatilhos, limitado) e diz ao editor: corte de missão termina logo depois do gatilho de fim.
  • Busca por nome casa id ou alias (categoria "Grand Theft Auto VI", tela "GTA 6" → mesmo perfil).

Painel

  • /clipper/games: tabela (nome, gênero, estado, missões, última pesquisa/edição) + "Adicionar jogo" (diálogo).
  • Clique abre o modal do jogo: abas Visão geral · Rende corte · Missões · Gatilhos de fim · Termos e hashtags · Fontes · Pedidos à IA; alternância Português (você lê) / English (vai para a IA); ações Pesquisar de novo, Editar, Pedir à IA, Apagar.