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>
This commit is contained in:
2026-11-18 01:51:12 -03:00
co-authored by Claude Opus 5.5
parent 2d8b1a582d
commit 0567c7454a
55 changed files with 6514 additions and 2506 deletions
+116 -28
View File
@@ -19,7 +19,7 @@ from pathlib import Path
from . import capture, layout, media
from .config import REPO_ROOT
from .db import Database, loads, now
from .judge import JudgeError
from .judge import LANGUAGE_NAMES, JudgeError
from .scoring import timeline as timeline_series
from .scoring import Word
from .sources import SourceError, parse_source
@@ -37,21 +37,43 @@ class UserError(Exception):
self.message, self.status = message, status
# Idiomas aceitos em `language` (fonte e sessão). '' = padrão do serviço (CLIPPER_LANGUAGE). O painel oferece os mesmos.
LANGUAGES = tuple(LANGUAGE_NAMES)
def check_language(value: str | None) -> str | None:
"""None = não mexer; '' = voltar ao padrão; código válido = usar. Outra coisa é erro legível."""
if value is None:
return None
code = value.strip()
if code and code not in LANGUAGES:
raise UserError(f"Idioma inválido: use {', '.join(LANGUAGES)} (ou vazio para o padrão).")
return code
class ChannelIn(BaseModel):
url: str = Field(min_length=3, max_length=300)
displayName: str | None = Field(default=None, max_length=60)
monitor: bool = True
authorized: bool = False
language: str | None = Field(default=None, max_length=12)
class ChannelPatch(BaseModel):
displayName: str | None = Field(default=None, max_length=60)
monitor: bool | None = None
authorized: bool | None = None
language: str | None = Field(default=None, max_length=12)
class SessionIn(BaseModel):
url: str = Field(min_length=3, max_length=300)
language: str | None = Field(default=None, max_length=12)
class StopIn(BaseModel):
"""Parar à mão: `pauseMonitor` (padrão) deixa a fonte com o monitor pausado até você religar."""
pauseMonitor: bool = True
class ManualClipIn(BaseModel):
@@ -62,7 +84,7 @@ class ManualClipIn(BaseModel):
class JudgeIn(BaseModel):
provider: Literal["codex", "claude", "off"]
provider: Literal["codex", "claude", "gemini", "off"]
model: str = Field(default="", max_length=80, pattern=r"^[A-Za-z0-9._:-]*$")
minScore: float = Field(default=6, ge=0, le=10)
# Modelo do ANALISTA (1º juiz, vê os frames); vazio = o mesmo do editor. None = não mexer.
@@ -80,9 +102,17 @@ class GameIn(BaseModel):
name: str = Field(min_length=1, max_length=120)
class MissionIn(BaseModel):
name: str = Field(min_length=1, max_length=160)
chapter: str = Field(default="", max_length=120)
summary: str = Field(default="", max_length=500)
completion_triggers: list[str] = Field(default_factory=list, max_length=8)
class GameProfileIn(BaseModel):
"""Perfil do jogo editado à mão no painel (mesmos campos que a IA devolve)."""
"""Perfil do jogo editado à mão no painel (mesmos campos que a IA devolve), em um dos dois idiomas."""
name: str = Field(default="", max_length=120)
aliases: list[str] = Field(default_factory=list, max_length=10) # outros nomes (categoria, abreviação)
summary: str = Field(default="", max_length=1500)
genre: str = Field(default="", max_length=120)
mechanics: list[str] = Field(default_factory=list, max_length=30)
@@ -92,6 +122,14 @@ class GameProfileIn(BaseModel):
news: list[str] = Field(default_factory=list, max_length=30)
hashtags: list[str] = Field(default_factory=list, max_length=20) # do jogo, a principal primeiro (app/hashtags.py)
sources: list[str] = Field(default_factory=list, max_length=20)
missions: list[MissionIn] = Field(default_factory=list, max_length=120)
end_triggers: list[str] = Field(default_factory=list, max_length=12) # sinais gerais de fim de missão
class GameIn(BaseModel):
"""Jogo cadastrado pelo painel; `notes` = pista para a pesquisa (vira o 1º pedido guardado)."""
name: str = Field(min_length=2, max_length=120)
notes: str = Field(default="", max_length=1500)
class ChatTurnIn(BaseModel):
@@ -102,7 +140,8 @@ class ChatTurnIn(BaseModel):
class GameRefineIn(BaseModel):
instruction: str = Field(min_length=3, max_length=1500)
search: bool = True # deixa a IA confirmar na web (mais lento); sem busca é quase instantâneo
section: Literal["", "summary", "clip_worthy", "avoid", "mechanics", "news", "jargon", "hashtags", "sources"] = ""
section: Literal["", "summary", "clip_worthy", "avoid", "mechanics", "news", "jargon", "hashtags", "sources",
"missions", "end_triggers", "aliases"] = ""
history: list[ChatTurnIn] = Field(default_factory=list, max_length=20) # conversa do chat da seção
@@ -143,6 +182,8 @@ def clip_view(row: dict) -> dict:
"aspect": row.get("aspect") or "vertical",
"createdAt": row["created_at"], "updatedAt": row["updated_at"],
"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"),
# 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")}
@@ -174,14 +215,19 @@ def session_view(row: dict, engine: Engine) -> dict:
# O que a captura gravou de fato (1º bloco de cada execução): qualidade pedida, largura, altura, qps, codec,
# kbps, GB/h e `mixed` (retomada em outra resolução). None = sessão antiga ou ainda sem bloco.
"capture": loads(row.get("capture_json"), None),
# Idioma falado na live (resolvido: o da sessão, senão o padrão do serviço).
"language": row.get("language") or engine.settings.language,
}
def channel_view(row: dict) -> dict:
def channel_view(row: dict, default_language: str = "") -> dict:
return {
"id": row["id"], "platform": row["platform"], "channel": row["channel"], "url": row["url"],
"displayName": row["display_name"], "monitor": bool(row["monitor"]), "authorized": bool(row["authorized"]),
"lastCheckAt": row["last_check_at"], "lastStatus": row["last_status"], "createdAt": row["created_at"],
# Monitor pausado porque você parou uma sessão à mão (não grava de novo até religar).
"monitorPausedAt": row.get("monitor_paused_at"), "monitorPausedBySession": row.get("monitor_paused_session"),
"language": row.get("language") or default_language,
}
@@ -386,27 +432,62 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
engine.intel.set_game(session_id, body.name.strip(), "user")
return session_view(_session(session_id), engine)
def game_view(g: dict) -> dict:
# `profile` = português (o painel mostra); `profileAi` = inglês (vai nos prompts; null = jogo antigo, a IA
# usa `profile`). Contrato em doc/clipador/JOGOS.md.
return {"id": g["id"], "name": g["name"], "status": g["status"], "error": g["error"],
"model": g["model"], "researchedAt": g["researched_at"], "editedAt": g.get("edited_at"),
"notes": loads(g.get("notes_json"), []), "profile": loads(g["profile_json"], None),
"profileAi": loads(g.get("profile_ai_json"), None), "aiLanguage": "en-US",
"translatedAt": g.get("translated_at"), "aliases": loads(g.get("aliases_json"), [])}
@app.get("/v1/games")
def list_games():
return {"games": [{"id": g["id"], "name": g["name"], "status": g["status"], "error": g["error"],
"model": g["model"], "researchedAt": g["researched_at"], "editedAt": g.get("edited_at"),
"notes": loads(g.get("notes_json"), []), "profile": loads(g["profile_json"], None)}
for g in db.all("SELECT * FROM games ORDER BY name")]}
return {"games": [game_view(g) for g in db.all("SELECT * FROM games ORDER BY name")]}
@app.post("/v1/games", status_code=201)
def add_game(body: GameIn):
"""Cadastra um jogo e pesquisa em segundo plano (o jogo aparece `pending` até a pesquisa terminar)."""
try:
gid = engine.intel.add_game(body.name, body.notes)
except LookupError as exc:
raise UserError(str(exc), 409) from exc
except ValueError as exc:
raise UserError(str(exc)) from exc
return {**list_games(), "id": gid}
@app.delete("/v1/games/{game_id}")
def delete_game(game_id: str):
try:
engine.intel.delete_game(game_id)
except JudgeError as exc:
raise UserError(str(exc), 404) from exc
return list_games()
@app.post("/v1/games/{game_id}/research")
def research_game(game_id: str):
"""Pesquisa (de novo) o jogo na web pela IA. Leva de 15 s a alguns minutos. Os pedidos guardados entram junto."""
"""Pesquisa (de novo) o jogo na web pela IA, em inglês, e traduz para português. Leva de 15 s a alguns minutos.
Os pedidos guardados entram junto."""
try:
engine.intel.research(game_id)
except JudgeError as exc:
raise UserError(str(exc)) from exc
return list_games()
@app.put("/v1/games/{game_id}")
def put_game_profile(game_id: str, body: GameProfileIn):
"""Grava o perfil editado à mão. A IA passa a usar na hora."""
@app.post("/v1/games/{game_id}/translate")
def translate_game(game_id: str):
"""Gera a versão da IA (inglês) a partir da portuguesa (jogos de antes dos perfis bilíngues)."""
try:
engine.intel.save_profile(game_id, body.model_dump())
engine.intel.translate(game_id)
except JudgeError as exc:
raise UserError(str(exc)) from exc
return list_games()
@app.put("/v1/games/{game_id}")
def put_game_profile(game_id: str, body: GameProfileIn, lang: Literal["pt", "en"] = "pt"):
"""Grava o perfil editado à mão no idioma `lang` e traduz para o outro. A IA passa a usar na hora."""
try:
engine.intel.save_profile(game_id, body.model_dump(), lang)
except JudgeError as exc:
raise UserError(str(exc), 404) from exc
return list_games()
@@ -440,7 +521,7 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
# ---------- canais
@app.get("/v1/channels")
def list_channels():
return {"channels": [channel_view(r) for r in db.all("SELECT * FROM channels ORDER BY display_name")]}
return {"channels": [channel_view(r, settings.language) for r in db.all("SELECT * FROM channels ORDER BY display_name")]}
@app.post("/v1/channels", status_code=201)
def create_channel(body: ChannelIn):
@@ -449,22 +530,27 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
raise UserError("Para monitorar, use o link do canal (ex.: twitch.tv/alanzoka), não de um vídeo.")
if db.get("SELECT 1 FROM channels WHERE id = ?", source.channel_id):
raise UserError("Esse canal já está na lista.", 409)
db.run("INSERT INTO channels (id, platform, channel, url, display_name, monitor, authorized, created_at)"
" VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
language = check_language(body.language) or ""
db.run("INSERT INTO channels (id, platform, channel, url, display_name, monitor, authorized, created_at, language)"
" VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
source.channel_id, source.platform, source.channel, source.url,
(body.displayName or source.channel.lstrip("@")).strip(), int(body.monitor), int(body.authorized), now())
return channel_view(db.get("SELECT * FROM channels WHERE id = ?", source.channel_id))
(body.displayName or source.channel.lstrip("@")).strip(), int(body.monitor), int(body.authorized), now(), language)
return channel_view(db.get("SELECT * FROM channels WHERE id = ?", source.channel_id), settings.language)
@app.patch("/v1/channels/{channel_id}")
def update_channel(channel_id: str, body: ChannelPatch):
row = db.get("SELECT * FROM channels WHERE id = ?", channel_id)
if not row:
raise UserError("Canal não encontrado.", 404)
db.run("UPDATE channels SET display_name = ?, monitor = ?, authorized = ? WHERE id = ?",
language = check_language(body.language)
db.run("UPDATE channels SET display_name = ?, monitor = ?, authorized = ?, language = ? WHERE id = ?",
(body.displayName or row["display_name"]).strip(),
int(body.monitor if body.monitor is not None else row["monitor"]),
int(body.authorized if body.authorized is not None else row["authorized"]), channel_id)
return channel_view(db.get("SELECT * FROM channels WHERE id = ?", channel_id))
int(body.authorized if body.authorized is not None else row["authorized"]),
language if language is not None else row.get("language") or "", channel_id)
if body.monitor is True:
engine.clear_monitor_pause(channel_id) # "Religar" no painel
return channel_view(db.get("SELECT * FROM channels WHERE id = ?", channel_id), settings.language)
@app.delete("/v1/channels/{channel_id}", status_code=204)
def delete_channel(channel_id: str):
@@ -491,8 +577,9 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
def create_session(body: SessionIn):
source = parse_source(body.url)
channel = db.get("SELECT id FROM channels WHERE id = ?", source.channel_id) if source.channel else None
language = check_language(body.language)
try:
session_id = engine.start_session(body.url, channel["id"] if channel else None)
session_id = engine.start_session(body.url, channel["id"] if channel else None, language=language)
except RuntimeError as exc:
raise UserError(str(exc)) from exc
return session_view(db.get("SELECT * FROM sessions WHERE id = ?", session_id), engine)
@@ -533,8 +620,9 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
return clip_view(_clip(int(cur.lastrowid)))
@app.post("/v1/sessions/{session_id}/stop")
def stop_session(session_id: int):
engine.stop_session(session_id)
def stop_session(session_id: int, body: StopIn | None = None):
"""Para a gravação à mão. Sem corpo (ou `pauseMonitor: true`): a fonte fica com o monitor pausado até religar."""
engine.stop_session(session_id, pause_monitor=body.pauseMonitor if body else True)
return {"ok": True}
@app.post("/v1/sessions/{session_id}/resume")
@@ -566,8 +654,8 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
channel: str | None = None, ids: str | None = None):
"""Filtros opcionais (todos separados por vírgula): `status`, `channel` (fontes, ex.: twitch-alanzoka) e `ids`.
O despachante de publicação do painel usa `channel` + `status=ready,approved` e `ids` para conferir a fila."""
sql = "SELECT c.*, s.channel_id, s.platform, s.url, e.updated_at AS edit_updated_at, e.exported_at AS edit_exported_at, e.cover AS edit_cover, e.origin AS edit_origin FROM clips c JOIN sessions s ON s.id = c.session_id LEFT JOIN edits e ON e.clip_id = c.id WHERE 1 = 1"
params: list = []
sql = "SELECT c.*, s.channel_id, s.platform, s.url, COALESCE(NULLIF(s.language, ''), ?) AS language, e.updated_at AS edit_updated_at, e.exported_at AS edit_exported_at, e.cover AS edit_cover, e.origin AS edit_origin FROM clips c JOIN sessions s ON s.id = c.session_id LEFT JOIN edits e ON e.clip_id = c.id WHERE 1 = 1"
params: list = [settings.language]
if status:
sql += " AND c.status IN (" + ",".join("?" * len(status.split(","))) + ")"
params += status.split(",")
@@ -590,7 +678,7 @@ def create_app(settings: Settings | None = None, engine: Engine | None = None, s
return {"clips": [clip_view(r) for r in db.all(sql, *params)]}
def _clip(clip_id: int) -> dict:
row = db.get("SELECT c.*, s.channel_id, s.platform, s.url, e.updated_at AS edit_updated_at, e.exported_at AS edit_exported_at, e.cover AS edit_cover, e.origin AS edit_origin FROM clips c JOIN sessions s ON s.id = c.session_id LEFT JOIN edits e ON e.clip_id = c.id WHERE c.id = ?", clip_id)
row = db.get("SELECT c.*, s.channel_id, s.platform, s.url, COALESCE(NULLIF(s.language, ''), ?) AS language, e.updated_at AS edit_updated_at, e.exported_at AS edit_exported_at, e.cover AS edit_cover, e.origin AS edit_origin FROM clips c JOIN sessions s ON s.id = c.session_id LEFT JOIN edits e ON e.clip_id = c.id WHERE c.id = ?", settings.language, clip_id)
if not row:
raise UserError("Corte não encontrado.", 404)
return row