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:
+116
-28
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user