# Clipador — detecção automática do jogo (18/11/2026) ## Pedido do dono Se ninguém lembrar de dizer o jogo, o Clipador descobre sozinho, **a cada ~3 min**, cruzando tudo o que a live dá (API da plataforma, título, o que a IA lê na tela, chat e fala), tenta acertar, **pede confirmação** e deixa **trocar** se estiver errado. ## Pistas (`app/game_detect.py`, a regra; `app/intel.py`, juntar e aplicar) | Fonte | O que é | Peso máx. | |---|---|---| | `platform` | Categoria da live (Streamlink `--json`), lida a cada 3 min. Categoria genérica ("Just Chatting", "IRL", "Música"…) não conta como jogo. | 0,55 | | `screen` | O jogo que a IA vê nos frames (logo, HUD, texto na tela). A varredura de 3 min já devolve `screen_game` + `screen_game_confidence` (high/medium/low) + `screen_evidence` (o que ela leu/viu). Vale por 15 min. | 0,50 × confiança | | `title` | O título da live cita um jogo cadastrado (nome ou outro nome). | 0,25 | | `chat` | Mensagens dos últimos 6 min citam um jogo cadastrado (mínimo 2 mensagens; força 1 com 6). | 0,35 | | `speech` | Trechos de fala dos últimos 6 min (12 blocos) citam um jogo cadastrado (força 1 com 3). | 0,35 | Nomes iguais viram o mesmo jogo pelos **outros nomes** (`aliases`): categoria "Grand Theft Auto VI" + tela "GTA 6" + chat "gta6" = um jogo só. A busca em texto só acha jogos **cadastrados** (a lista de Jogos) e só por palavra inteira (nome com 4+ letras, ou 3 com número, ex. `cs2`). Acentos não atrapalham. ## Decisão Cada jogo ganha uma nota (ruído-ou das fontes, cada fonte conta uma vez). O estado (`sessions.game_status`): | Estado | Quando | O que o Clipador faz | |---|---|---| | `user` | Você confirmou. | **Nunca troca sozinho.** Se as pistas apontarem outro jogo (várias fontes concordando) em 2 checagens seguidas, grava uma `suggestion` e o painel pergunta "o streamer trocou de jogo?". | | `agreed` | 2+ fontes independentes no mesmo jogo, nota ≥ 0,6. | Aplica. | | `probable` | Uma fonte boa sozinha (só a categoria; ou só a tela com confiança média). | Aplica e pede "Sim, é X". | | `conflict` | Categoria × tela (fontes fortes) em jogos diferentes e sem folga (< 0,25). | **Mantém o jogo atual** e pergunta qual é o certo. | | `unknown` | Sem pista útil (ex.: Just Chatting e nada na tela). | Não mexe. | Trocar de um jogo já definido (sem confirmação do usuário) exige a categoria da plataforma apoiando **ou** a mesma resposta em 2 checagens seguidas (evita trocar por um frame de menu). "Detectar agora" pula essa espera. ## Estado guardado - `sessions.game_status` e `sessions.game_detect_json` (v16): pistas (`platform`, `screen`), `candidates` (até 4, com nota e cada pista), `suggestion`, `pending` (checagens seguidas) e `checkedAt`. - `sessions.game` / `game_source` (`platform` | `screen` | `chat` | `user`) / `games_json` (histórico de trocas) continuam como antes; o perfil do jogo é pesquisado se o jogo é novo. ## Contrato (serviço ↔ painel) - `GET /v1/sessions[/{id}]` ganha `gameStatus` e `gameDetect` = `{checkedAt, candidates[{gid, game, score, sources[{source, game, strength, detail}]}], suggestion|null, platform{game, at}, screen{game, confidence, evidence, at}|null}`. - `PUT /v1/sessions/{id}/game {name}`: confirma (estado `user`, limpa a sugestão). - `POST /v1/sessions/{id}/game/detect` ("Detectar agora"): a IA olha 3 frames dos últimos 2 min, cruza com o resto e aplica na hora. Responde `{result: {status, candidates, suggestion, screen{game, confidence, evidence}}, session}`. Exige IA e visão ligadas (erro 400 em português se não). ## Painel (detalhe da sessão) Selo do estado (confirmado por você · detectado, fontes concordam · provável, confirme · em dúvida · não identificado), "Sim, é X", "Escolher/Trocar jogo" (a lista inclui os candidatos), **Detectar agora**, aviso de conflito com um botão por candidato, aviso de sugestão de troca (jogo confirmado) e "Como o jogo foi descoberto" (categoria, tela com o que a IA leu, e cada candidato com nota e pistas). Na lista de sessões o selo "confirmar" aparece nos mesmos casos. ## Limites conhecidos - Sem a varredura (IA/visão desligadas) não há pista de tela; o botão "Detectar agora" também precisa da IA. - Sem leitor de texto (OCR) próprio: o texto na tela é lido pela IA de visão (`screen_evidence`). - Chat e fala só reconhecem jogos já cadastrados em **Jogos** (os que passaram pela categoria entram sozinhos). - Categoria genérica não vira jogo: a sessão fica sem jogo até a tela, o chat ou você dizerem qual é.