Files
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

76 lines
4.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
```jsonc
{
"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.