IA: Claude, Codex e Gemini com login, chave de API e IA reserva; Configurações em subpáginas
- Configurações → IA (/settings/ai): um cartão por IA para instalar/atualizar a CLI pelo painel, ligar, entrar com a conta (OAuth pela própria CLI, num terminal) ou colar a chave de API, e testar. Chaves cifradas com a DPAPI do Windows em data/ai/vault.bin; só vão para a CLI no ambiente da chamada. - Gemini CLI como terceiro agente do painel (stream-json, edição automática, shell só o liberado). - IA reserva: execução que cai por indisponibilidade (cota, 429, login, chave, rede) pausa a IA e recomeça a mesma tarefa na próxima pronta da ordem; migração v10 (agent_runs.fallback_of). - Configurações viraram subpáginas (IA, Publicação, Apps das redes, Navegador, Sobre os modos), também no menu lateral; links antigos apontam para a subpágina certa. - Contrato com o Clipador em doc/ia.md; skill do CenaForge atualizada até a 1.51.0. O login gratuito do Gemini CLI para conta pessoal foi encerrado pelo Google (IneligibleTierError): para conta pessoal, use a chave do AI Studio. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -7,6 +7,50 @@ Versão semântica da **skill** (não do projeto):
|
||||
|
||||
Mantido pelo subagente `cenaforge-skill-updater`. Entradas mais novas no topo.
|
||||
|
||||
## 1.51.0 — 18/11/2026
|
||||
|
||||
IA: três provedores (Claude Code, Codex, Gemini CLI), login ou chave de API no cofre e IA reserva.
|
||||
- `references/ai.md` (novo): onde mexer (`panel/src/lib/ai.ts`, `agents.ts`, `app/api/ai/`, `ai-settings.tsx`,
|
||||
`clipper/app/ai_settings.py`, `judge.py`), regras (só o painel escreve `data/ai/`, chave só no ambiente da chamada,
|
||||
quando a reserva troca), estado verificado. Contrato completo em `doc/ia.md`.
|
||||
- `references/panel.md`: banco v10 (`agent_runs.fallback_of`); "Agentes e modelos" com 3 provedores, reserva e
|
||||
Configurações em subpáginas (`SETTINGS_SECTIONS`).
|
||||
- `references/clipper.md`: juiz com `gemini` e reserva por chamada; chave só pelo cofre do painel.
|
||||
- `references/gotchas.md`: seção "IA" com 168–172 (OAuth do Gemini encerrado, `CODEX_API_KEY`, terminal de login no
|
||||
Windows, custo da DPAPI, CLI fora do PATH). O 167 já era do perfil de jogo (1.50.0); numeração ajustada.
|
||||
- `references/tools.md`: Gemini CLI como candidata (não instalada aqui, nunca executada); `--version` de Claude e Codex.
|
||||
- `SKILL.md`: versão, `description`, esquema v10, linha "IA" em "Onde mexer", invariante da chave de API.
|
||||
- Evidência (reexecutada): `claude` 2.1.314, `codex-cli` 0.169.0, `gemini` ausente; `ai.test.ts` 21/21; `pnpm test:clipper`
|
||||
335 passed. Informado, não reexecutado: painel 104/104, ida e volta do cofre. Não verificado: Gemini com chave, `@arquivo`
|
||||
de imagem no juiz, envelope de erro do `-o json`, UI no navegador.
|
||||
|
||||
## 1.50.0 — 18/11/2026
|
||||
|
||||
Clipador: perfis de jogo bilíngues, missões e gatilhos de fim, cadastro de jogo pelo painel, semente do GTA VI.
|
||||
- `references/clipper.md`: banco em v12; seção "Perfil do jogo" reescrita (`profile` pt × `profileAi` en, aliases,
|
||||
`missions`, `end_triggers`, rotas novas `POST/DELETE /v1/games`, `translate`, `PUT ?lang=`, seções novas do refine,
|
||||
sementes, proxy/timeouts); linhas de "Onde mexer" e de páginas; evidência.
|
||||
- `references/panel.md`: `/clipper/games` em lista + modal (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`);
|
||||
ícones dos subitens da sidebar.
|
||||
- `references/gotchas.md`: novo 167 (serviço sem reiniciar, `profileAi: null`, alias, missões não oficiais do GTA VI).
|
||||
- `SKILL.md`: versão, `description` (perfil bilíngue, missões, cadastro de jogo) e faixa de itens do Clipador.
|
||||
- Evidência: conferido em `clipper/app/main.py`, `db.py` (v12), `judge.py` (`mission_lines`), `intel.py`,
|
||||
`panel/src/lib/clipper.ts` e `doc/clipador/JOGOS.md`; `pnpm test:clipper` → 335 passed (reexecutado). Não verificado:
|
||||
IA real, UI no navegador, banco real em v12, `pnpm typecheck`.
|
||||
|
||||
## 1.49.0 — 18/11/2026
|
||||
|
||||
Clipador: interface em subpáginas, parar à mão pausa o monitor, idioma por fonte/sessão/canal.
|
||||
- `references/clipper.md`: banco em v11; linha "Páginas `/clipper/*`" reescrita (grupo `(studio)`, provider, shell, páginas);
|
||||
linha nova de pausa do monitor e idioma em "Onde mexer"; seção "Parar é parar e idioma"; evidência.
|
||||
- `references/panel.md`: seção `/clipper` reescrita (tabela rota, conteúdo, arquivos; `clipper-studio.tsx` apagado,
|
||||
`clipper-queue.tsx` e `clipper-sessions.tsx` reduzidos); esquema do painel v9 (`accounts.language`, `languages.ts`).
|
||||
- `references/gotchas.md`: novo 166 (fonte que não volta a gravar depois de parar à mão; rotas novas exigem reiniciar o Clipador).
|
||||
- `SKILL.md`: versão, `description`, linhas de página e de armadilhas.
|
||||
- Evidência: conferido em `doc/clipador/REDESIGN.md`, `clipper-shell.tsx` (`CLIPPER_SECTIONS`), `clipper/app/db.py` (v11),
|
||||
`main.py` (`StopIn`, `check_language`), `panel/src/lib/db.ts` (v9) e `languages.ts`; `pnpm test:clipper` → 287 passed
|
||||
(reexecutado). Não verificado: páginas no navegador, banco real em v11, `pnpm typecheck` e testes do painel.
|
||||
|
||||
## 1.48.0 — 17/11/2026
|
||||
|
||||
Cartoon: acabamento de ilustração dos personagens (detalhe de rosto/corpo, acessórios, enquadramento e textura).
|
||||
|
||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,44 @@
|
||||
# IA: três provedores, login/chave e IA reserva
|
||||
|
||||
Fonte do contrato: **`doc/ia.md`** (arquivos, ambiente de cada chamada, o que conta como indisponível, Gemini
|
||||
headless). Não duplique aqui; este arquivo diz onde mexer e o que não quebrar. Sempre pela **CLI oficial**
|
||||
(`claude`, `codex`, `gemini`), nunca SDK/HTTP direto.
|
||||
|
||||
## Onde mexer
|
||||
|
||||
| Mudança | Arquivo(s) | Também atualizar |
|
||||
|---|---|---|
|
||||
| Configurações, cofre, detecção, instalação, login, teste, `providerEnv`, `isAvailabilityError`, pausa, `readyChain`/`nextFallback` | `panel/src/lib/ai.ts` | `panel/src/lib/ai.test.ts`, `doc/ia.md` |
|
||||
| Agente do painel por provedor (`geminiArgs`, `normalizeGemini`, `--resume`, shell liberado), troca de IA ao cair | `panel/src/lib/agents.ts` (`prompts.ts`, `types.ts` para `AgentProvider`) | `ai.test.ts` (argumentos e eventos do Gemini) |
|
||||
| Execução que continua outra que caiu | coluna `agent_runs.fallback_of` (migração v10 em `panel/src/lib/db.ts`), `followUpRunOf` (segue `resume_of` **e** `fallback_of`) | `publishing-db.test.ts` (conta de migrações) |
|
||||
| API | `panel/src/app/api/ai/route.ts` (`GET/PUT /api/ai`), `.../ai/[provider]/route.ts` (`POST {action: install\|login\|verify\|test\|resume}`, `PUT/DELETE` = chave) | guarda `Origin`/JSON (gotchas, item 125) |
|
||||
| Tela | `panel/src/components/ai-settings.tsx` em `panel/src/app/settings/ai/page.tsx`; seletor de provedor em `agent-console.tsx` e `story-composer.tsx` | — |
|
||||
| Subpáginas de Configurações | `panel/src/app/settings/{ai,publishing,apps,browser,modes}/page.tsx` + `layout.tsx`; seções em `SETTINGS_SECTIONS` de `components/settings-shell.tsx` (o menu lateral `sidebar-nav.tsx` as lê como `children`); `/settings` redireciona para `/settings/ai` | seção nova = entrada em `SETTINGS_SECTIONS` + pasta |
|
||||
| Juiz do Clipador (3 provedores, reserva por chamada) | `clipper/app/judge.py` (`_gemini`, `find_gemini`, `parse_gemini_output`), leitura de settings e cofre `clipper/app/ai_settings.py` (DPAPI por `ctypes`), `main.py`, `config.py`, `intel.py` | `clipper/tests/test_ai_fallback.py`, `conftest.py`, `clipper/README.md` |
|
||||
|
||||
## Regras
|
||||
|
||||
- **Só o painel escreve** `data/ai/settings.json` e `data/ai/vault.bin`; o Clipador só lê (relê por `mtime`). Cofre =
|
||||
DPAPI `CurrentUser`, entropia `CenaForge.AI.vault.v1`; a chave nunca volta à tela (só "existe" + 4 últimos
|
||||
caracteres). Nunca copie chave para skill, log ou prompt.
|
||||
- Chave de API entra **só no ambiente da chamada** (`providerEnv`); não troque o login global da CLI.
|
||||
- **Reserva:** erro de indisponibilidade (cota, 429, login, chave, rede, CLI fora, tempo) → a IA entra em pausa
|
||||
(`cooldownMin`, em memória por processo) e a **mesma tarefa recomeça** na próxima IA pronta de `order`. Erro de
|
||||
conteúdo (JSON/schema inválido) **não** troca. O juiz faz o mesmo por chamada.
|
||||
- Gemini no agente: `-o stream-json --approval-mode auto_edit --skip-trust`, `--resume <sessão>`, shell só os comandos de
|
||||
`GEMINI_ALLOWED_SHELL` via `--allowed-tools run_shell_command(...)`. No juiz: `-o json --approval-mode plan`, prompt
|
||||
pelo stdin, frames copiados para pasta temporária **fora do repo** (`@arquivo` respeita o `.gitignore`).
|
||||
- Status de login: `claude auth status --json` (`loggedIn`, `authMethod`, `subscriptionType`); `codex login status`
|
||||
(texto, "Logged in using ChatGPT").
|
||||
- Instalação: Claude pelo instalador nativo (`irm https://claude.ai/install.ps1 | iex`); Codex e Gemini por
|
||||
`npm install -g`. O painel procura também em `~/.local/bin` e `%APPDATA%\npm`.
|
||||
|
||||
## Estado verificado (18/11/2026)
|
||||
|
||||
- Nesta máquina: `claude` 2.1.314 e `codex` 0.169.0 (`--version` reconferido pela skill); `gemini` **não instalado**
|
||||
(`command not found`).
|
||||
- `pnpm --filter cenaforge-panel test:panel` inclui `ai.test.ts`: 21 testes, 21 passaram (reexecutado pela skill; um
|
||||
usa a DPAPI real). Clipador: `pnpm test:clipper` → 335 passed (reexecutado). Suíte do painel 104/104: informada.
|
||||
Ida e volta real do cofre painel → Clipador: informada, não repetida.
|
||||
- **Não verificado:** Gemini com chave real, `@arquivo` de imagem no juiz, envelope de erro do `-o json`, a UI
|
||||
`/settings/ai` no navegador, troca de IA no meio de um agente real. Armadilhas: gotchas, itens 168–172.
|
||||
@@ -12,7 +12,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
|
||||
|
||||
| O quê | Onde |
|
||||
|---|---|
|
||||
| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 10, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão)). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova |
|
||||
| Banco do Clipador | `data/clipper/clipper.db` (`PRAGMA user_version` 12, `SCHEMA` em `clipper/app/db.py`: v1 tabelas, v2 `settings`, v3 jogo/varredura/emotes/configuração do corte — colunas novas em `sessions`, `channels.settings_json`, `chat.emotes`, `clips.learned`, tabelas `games` e `emotes`; v4 `edits` (`clip_id`, `project_json`, `rev`, `cover`, `exported_at`, `created_at`, `updated_at`); v5 `face_track`; v6 `games.notes_json`/`games.edited_at`; v7 `edits.origin` (`ai`/`user`) + `edits.ai_project_json`; v8 `clips.aspect` (`vertical`/`horizontal`, padrão `vertical`, gravado no render); v9 `sessions.capture_json` (o que a captura gravou de fato; sessões antigas `NULL`); v10 tabela `deleted_clips` (marca do corte apagado, `ON DELETE CASCADE` com a sessão); v11 `channels.monitor_paused_at`/`monitor_paused_session`/`language` e `sessions.language`, padrão `''` = `CLIPPER_LANGUAGE`; v12 `games.profile_ai_json` (perfil em inglês), `translated_at`, `aliases_json`). Migra ao subir o serviço. **Nunca altere uma migração já aplicada** (o banco real estava em v4 quando a v7 nasceu): coluna nova = `ALTER` numa versão nova |
|
||||
| Blocos gravados (`.ts` de 30 s + `segments.csv`) e frames | `data/clipper/sessions/<id>/` (frames em `frames/`) |
|
||||
| Pesos do rastreio de reação (YuNet, MediaPipe, OpenSeeFace) | `data/clipper/models/`, fixados (URL imutável + sha256) em `clipper/models.lock.json` |
|
||||
| Cortes prontos | `output/clipper/<sessão>/clip-<id>.mp4` + `clip-<id>.jpg` |
|
||||
@@ -29,12 +29,13 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
|
||||
| Busca de quadro dentro de bloco `.ts` (`seek_args`, `grab_frame`) e emenda de resolução/codec (`uniform_segments`) | `clipper/app/media.py`; `clipper/app/editor_render.py`; `face.grab_bgr` e tamanho do quadro por bloco (`_frame_size`) em `face.py` | gotchas, itens 107–108 |
|
||||
| Retomada de live (`Engine.live_check`, `keep_live`, `RESUME_DELAYS_S`, `resume_interrupted`), render que falha (`recover_orphan_renders`, `ORPHAN_RENDER_S` 300, `MAX_RENDER_ATTEMPTS` 3), cortes duplicados (`SAME_PEAK_S` 10, `SAME_MOMENT_OVERLAP` 0,6, `KEPT_STATUSES`/`VETO_STATUSES`, `discard_pending_duplicates`) | `clipper/app/worker.py` | `clipper/tests/test_resume.py`, `clipper/tests/test_render_and_duplicates.py` |
|
||||
| Apagar cortes (`delete_clip`, `delete_many`, `select_ids`, `MAX_BATCH` 500, recusas `BUSY`/`PUBLISHED`/`CHANGED`, marca `marks`/`mark_spans`, arquivos só dentro das pastas do Clipador) | `clipper/app/clip_delete.py`; rotas em `main.py` (`ClipsDeleteIn`); marca lida em `worker.py` (veto depois do juiz) e na varredura (`intel.py`) | `clipper/tests/test_clip_delete.py`; `METHODS` em `panel/src/lib/clipper.ts`; seção "Apagar cortes" abaixo |
|
||||
| Parar à mão e pausa do monitor (`Engine.stop_session(id, pause_monitor=True)`, `StopIn.pauseMonitor`), idioma por fonte/sessão (`check_language`, visões de fonte/sessão/corte com `language` resolvido; Whisper e `judge.output_language_note`) | `clipper/app/worker.py`, `main.py`, `db.py` (v11), `judge.py`; painel `ACCOUNT_LANGUAGES` em `panel/src/lib/languages.ts` | `clipper/tests/test_monitor_pause_and_language.py` (9); seção "Parar é parar e idioma" abaixo |
|
||||
| Chat (IRC anônimo da Twitch com `CAP REQ :twitch.tv/tags` → emotes nativos e `room-id`; Pusher da Kick, emotes `[emote:id:NOME]`) | `clipper/app/chat.py` | — |
|
||||
| Heurística: pesos, base de 3 min, mínimo proporcional (`_required_messages`), reações (`min_reactions`), chat fraco (`sparse_rate` 0,5 msg/s), momentos do chat/áudio/rosto (`_chat_moments`/`_audio_moments`/`_face_moments`; `face_*` em `Params`), `pick_peaks`, `fit_window` (duração de todo corte automático) | `Params` e funções em `clipper/app/scoring.py`; alvo `min_target` em `layout.py` | `clipper/tests/test_scoring.py` (regressões de falso positivo, chat fraco e rosto), `test_duration_banner_fonts.py` |
|
||||
| Rastreio de reação — E/S: backends (MediaPipe; plano B OpenSeeFace), download sob demanda com sha256, recorte FFmpeg 6 qps, laço `face` | `clipper/app/face.py` (`for_scoring`, `must_wait`, `view`, `reset`); laço `_face_loop` e uso de `must_wait` na decisão do corte em `worker.py`; bancada `clipper/tools/face_bench.py` | `clipper/tests/test_face.py`, `clipper/models.lock.json`, `doc/FACE_BAKEOFF.md` |
|
||||
| Rastreio de reação — lógica pura: sinal por segundo contra o neutro do streamer, rótulos, `reaction_moments`, `summarize` (linha do analista), `locate_cam` (câmera pelo rosto) | `ReactionParams` e funções em `clipper/app/reaction.py` | `clipper/tests/test_reaction.py` |
|
||||
| Emotes: catálogo 7TV/BTTV/FFZ (canal + global, TTL 1 h, fonte que falha é ignorada), emojis, peso aprendido (`LEARN_UP`/`LEARN_DOWN` 0,3/0,15) | `clipper/app/emotes.py`; ingestão e aprendizado em `clipper/app/intel.py` (`ingest_chat`, `learn_from_clip`) | `clipper/tests/test_intel.py` |
|
||||
| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador |
|
||||
| Contexto do jogo (categoria a cada `GAME_CHECK_S` 600, `screen_game`, perfil pela web; `clean_profile`, `save_profile`, `refine`, `delete_note`; perfis bilíngues, `add_game`, `delete_game`, `translate`, aliases, `import_seeds` de `clipper/app/seeds/games/*.json`; contrato em `doc/clipador/JOGOS.md`), varredura (`SCAN_*`), webcam (`detect_cam`: YuNet local primeiro, IA só se não achar ou `use_ai`; `CAM_RETRY_S` 300), opções `OPTION_DEFAULTS` (inclui `faceTrack`) | `clipper/app/intel.py` | README do Clipador |
|
||||
| Juízes (analista + editor), prompts, glossário `CHAT_GLOSSARY`, linha "Rosto do streamer: …" do analista, schemas, chamada da CLI, pesquisa e refino do jogo (`PROFILE_SYSTEM`/`research_game`, `REFINE_SYSTEM`/`refine_game`), câmera | `clipper/app/judge.py`; montagem dos 6 frames do analista (8 se o trecho passa de 80 s) em `worker.py` | README do Clipador |
|
||||
| Hashtags da legenda (`to_tag`, `fold`, `split_hashtags`, `compose`, `build_caption`; `MAX_TAGS` 8, `GAME_TAGS` 3, `MOMENT_TAGS` 4) | `clipper/app/hashtags.py`; uso em `judge_clip` de `worker.py`; campo `hashtags` em `judge.py` (`VERDICT_SCHEMA`, `PROFILE_SCHEMA`, `Verdict.hashtags`) e `PROFILE_LISTS`/`clean_profile`/`Intel.session_game` em `intel.py` — ver "Hashtags da legenda" abaixo | `clipper/tests/test_hashtags.py` |
|
||||
| Configuração do corte: camadas padrão ← canal ← sessão ← projeto (`DEFAULTS`, `merge`, `validate`), `format.aspect` (`ASPECTS`, `FRAME_SIZES`, `CANVAS_SIZES`, `aspect()`), `MODES` (5 modos, inclui `cam_only`), `resolved_mode` (queda para `blur` sem câmera; `full` no horizontal), retângulos, legenda, crédito, `duration` (`min_target`), `hook` (`HOOK_STYLES`, `HOOK_ANIMS`, `HOOK_FONT`), `capture`; fontes empacotadas (`PACKAGED_FONTS`, `font_files`, `ass_filter` = `ass=` com `fontsdir` só se o ASS usar uma delas); cadeia de layout reutilizável `layout_chain(settings, src, dst, tail, suffix, mode)` (usada por `video_filter` e pelo editor) | `clipper/app/layout.py`; rotas de settings em `main.py` (devolvem `aspects`, `frames`, `fontFiles`, `hookStyles`, `hookAnims` e `captureQualities`) | `clipper/tests/test_format_and_captions.py` (o vertical precisa continuar batendo com `clipper/tests/data/vertical_golden_sha256.json`); modo novo também em `LayoutMode`/`MODE_LABEL` de `panel/src/components/clipper-client.ts` e `resolvedMode` de `clip-editor-model.ts`; grupo novo também em `CutSettings` (`Aspect`, `aspectOf`, `withFormat` para serviço antigo) |
|
||||
@@ -45,7 +46,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
|
||||
| Legenda (tempo saneado: `clean_words`, `group_words`, `caption_blocks`; `build_ass`) e crédito — usada pelo render do editor e pelo worker, nos dois formatos | `clipper/app/subtitles.py` (`MIN_WORD_S` 0,06, `MIN_STEP_S` 0,04). `media.render_vertical` ainda existe em `media.py`, mas **não** é mais usado pelo render de cortes | `clipper/tests/test_format_and_captions.py`; [gotchas.md](gotchas.md) itens 57–58, 70, 90 |
|
||||
| Rotas HTTP | `clipper/app/main.py` (editor: `editor_api.py`) | `ALLOWED` em `panel/src/lib/clipper.ts` (o proxy recusa caminho fora da regex) e o timeout por rota no mesmo arquivo |
|
||||
| Variáveis do `.env` | `clipper/app/config.py` + `clipper/.env.example` | tabela do README do Clipador |
|
||||
| Página `/clipper` | `panel/src/app/clipper/page.tsx`, `panel/src/components/clipper-*.tsx` (`clipper-cut-settings.tsx` modal do corte em 5 abas, com Gancho e "Qualidade da gravação"; `clipper-games.tsx` aba Jogos e emotes (editar perfil, pedir à IA, pedidos guardados); `clipper-queue.tsx` cartão com a análise, reação do rosto (`FaceSignal`, `FACE_LABEL`), recuo do início `START_STEPS`, botão "Editar"/"Continuar edição", "Apagar" e seleção discreta (`SelectionPill`); `clipper-judge.tsx` interruptor "Rastrear a reação do streamer"; `clipper-sessions.tsx` cartão da sessão (`sessionHealth`, selo de quem achou a câmera, relógio `RecordingClock`, cadência `SummaryCadence`) e cabeçalho em `clipper-studio.tsx`), cliente `clipper-client.ts` | [panel.md](panel.md) |
|
||||
| Páginas `/clipper/*` (grupo de rotas `panel/src/app/clipper/(studio)/`, layout com `ClipperProvider` + `ClipperShell`) | `clipper-provider.tsx` (dados + consulta periódica, `useClipper()`), `clipper-shell.tsx` (`CLIPPER_SECTIONS`, cabeçalho, bloco "Ao vivo agora · N"), páginas `clipper-clips-page.tsx` (+ `clipper-clip-table.tsx` `ClipTable`, `clipper-clip-dialog.tsx` `ClipDialog`, `clipper-clip-parts.tsx`), `clipper-sessions-page.tsx`, `clipper-session-detail.tsx`, `clipper-channels.tsx` (Fontes), `clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx` + `clipper-games.tsx` (emotes), `clipper-settings-page.tsx`; peças compartilhadas em `clipper-sessions.tsx` (`PlatformIcon`, `CutNow`, `RecordForm`, relógio, `sessionHealth`) e utilitários da lista em `clipper-queue.tsx`; `clipper-cut-settings.tsx` modal do corte em 5 abas; `clipper-judge.tsx`; cliente `clipper-client.ts`. Mapa de rotas e papéis em [panel.md](panel.md#página-clipper-clipador) | [panel.md](panel.md) |
|
||||
| Página do editor `/clipper/edit/[clipId]` | `panel/src/app/clipper/edit/[clipId]/page.tsx` + `panel/src/components/clip-editor*.ts(x)` (papel de cada arquivo em [panel.md](panel.md#editor-de-cortes)); tokens `--color-nle-*` e bloco `.nle` em `panel/src/app/globals.css` | [panel.md](panel.md#editor-de-cortes) |
|
||||
| Ponte e proxy do painel | `panel/src/lib/clipper.ts` + `panel/src/app/api/clipper/[...path]/route.ts` | — |
|
||||
| Fontes (canais de live) nos canais de publicação | `linkChannel`/`endChannel`/`accountsForChannel` em `panel/src/lib/accounts.ts`; rotas `panel/src/app/api/accounts/[id]/channels/`; card "Fontes de corte" em `account-manager.tsx`. Na UI "Canais" virou **"Fontes"**; código e rotas seguem `channels` | [panel.md](panel.md) |
|
||||
@@ -64,10 +65,17 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
|
||||
- **Aprendizado dos emotes:** aprovar/rejeitar no painel = ±0,3/0,15 nos emotes de −10 s a +6 s do pico, uma vez por
|
||||
corte (`clips.learned`); a decisão da IA conta com `factor=0.5`. Peso limitado a −1…3.
|
||||
|
||||
## Juízes (decisão do usuário: pela CLI, sem chave de API)
|
||||
## Juízes (decisão do usuário: pela CLI; chave de API só pelo cofre do painel)
|
||||
|
||||
- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`)
|
||||
ou `off` (só a heurística).
|
||||
- Provedores `codex` (padrão `gpt-6-luna`; lista de `~/.codex/models_cache.json`), `claude` (`haiku`/`sonnet`/`opus`),
|
||||
`gemini` (`Judge._gemini`: `gemini -p <instrução curta> -o json --approval-mode plan --skip-trust -m <modelo>`, prompt
|
||||
completo pelo stdin, schema no prompt e JSON extraído de `response`; frames copiados para pasta temporária **fora do
|
||||
repo**, porque `@arquivo` respeita o `.gitignore`) ou `off` (só a heurística).
|
||||
- **IA reserva por chamada** (18/11/2026): `clipper/app/ai_settings.py` lê `data/ai/settings.json` e o cofre
|
||||
`data/ai/vault.bin` (DPAPI por `ctypes`; **só leitura**, quem escreve é o painel). Falha de indisponibilidade (cota,
|
||||
429, login, chave, rede, CLI fora) pausa a IA e a mesma chamada segue na próxima pronta da `order`; erro de conteúdo
|
||||
não troca. Contrato: `doc/ia.md`; visão geral e armadilhas: [ai.md](ai.md). Teste: `clipper/tests/test_ai_fallback.py`.
|
||||
Só vale depois de reiniciar o Clipador (gotchas, item 144). Gemini com chave real e `@arquivo` de imagem: não testados.
|
||||
- **ANALISTA** vê 6 frames (8 se o trecho passa de 80 s) + fala + chat + glossário e devolve `situation`, `what_happened`, `screen`, `speech`,
|
||||
`chat_meaning`, `confidence` (0–1) e início/fim da ação. **EDITOR** vê só texto + a análise e escreve título,
|
||||
legenda, nota e corte. Os dois podem recuar até `duration.backtrackS` (padrão 120 s) antes do candidato.
|
||||
@@ -77,7 +85,7 @@ renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, You
|
||||
- Custo fixo: cada chamada é um processo novo (2 por candidato). `codex_lean_overrides(search, config_file=None)` em
|
||||
`judge.py` enxuga o Codex; o Claude leva `--setting-sources project,local`. Números e limites em
|
||||
[token-economy.md](token-economy.md); teste: `test_codex_lean_overrides`. Vale após reiniciar o Clipador (gotcha 136).
|
||||
- Não adicione chave de API ao juiz sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa.
|
||||
- Chave de API do juiz vem só do cofre do painel (`authMode: "apiKey"`, variável só na chamada); não crie outro caminho de chave sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa.
|
||||
|
||||
## Hashtags da legenda (`hashtags.py`)
|
||||
|
||||
@@ -322,18 +330,59 @@ Teste local do editor sem tocar no serviço do usuário: instância na faixa 450
|
||||
banco, com as regras do item 77 de [gotchas.md](gotchas.md). Teste de UI no painel do usuário sobre um corte real:
|
||||
intercepte as escritas (item 86) e ache as camadas do canvas pelo cursor (item 85).
|
||||
|
||||
## Parar é parar e idioma (18/11/2026)
|
||||
|
||||
Texto completo no README do Clipador ("Parar é parar", "Idioma por fonte e por sessão").
|
||||
|
||||
- **Parar à mão pausa o monitor da fonte.** `POST /v1/sessions/{id}/stop` (corpo opcional `{"pauseMonitor": false}`;
|
||||
padrão `true`) grava `channels.monitor_paused_at` + `monitor_paused_session`; o monitor pula a fonte pausada. Limpam a
|
||||
pausa: `PATCH /v1/channels/{id}` com `{"monitor": true}`, `POST /v1/sessions` (gravar pelo link) e `resume` pelo painel.
|
||||
Queda de live (captura cai sozinha) **não** passa pela pausa: continua `keep_live`, na mesma sessão. Na UI: a fonte
|
||||
mostra "monitor pausado · você parou a sessão #N" com **Religar**; o diálogo de parar tem a opção de voltar a gravar
|
||||
sozinho (marcada = não pausa).
|
||||
- **Idioma.** `language` em `channels` e `sessions` (`pt-BR`, `en-US`, `es-419`; `''` = `CLIPPER_LANGUAGE`), aceito em
|
||||
`POST/PATCH /v1/channels` e `POST /v1/sessions`; as visões de fonte, sessão e corte devolvem o idioma **já resolvido**.
|
||||
O Whisper usa o idioma da sessão; fora de pt-BR os prompts do editor e da varredura recebem a nota de idioma de saída.
|
||||
No painel, `accounts.language` (migração v9 do painel, padrão `pt-BR`) e o aviso no diálogo Publicar quando o idioma do
|
||||
canal difere do idioma do corte. Versões traduzidas de um mesmo corte: **ainda não existem** (próxima etapa).
|
||||
- Sem reiniciar o Clipador as rotas novas não valem; o painel trata `language`/pausa como opcionais e não quebra
|
||||
(gotchas, item 166).
|
||||
|
||||
## Perfil do jogo (aba Jogos)
|
||||
|
||||
Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
|
||||
Fonte do contrato: `doc/clipador/JOGOS.md`; seção "Contexto do jogo" de `clipper/README.md`. Toda rota abaixo devolve a
|
||||
lista inteira (mesma forma de `GET /v1/games`), exceto onde dito.
|
||||
|
||||
**Dois idiomas.** `profile` = português (o que o painel mostra); `profileAi` = inglês (vai nos prompts; `null` = não
|
||||
traduzido, a IA usa `profile`); `aiLanguage` `en-US`; `translatedAt`; `aliases` (união dos dois perfis). Campos novos do
|
||||
perfil: `aliases` (≤ 10), `missions` `[{name, chapter, summary, completion_triggers ≤ 8 de 200 caracteres}]` (até 120;
|
||||
`[]` quando não há lista pública — a IA nunca inventa) e `end_triggers` (≤ 12, sinais gerais de fim de missão).
|
||||
`game_context` (`judge.mission_lines`: `MISSIONS_IN_PROMPT` 25, `MISSIONS_PROMPT_CHARS` 1500) manda terminar o corte de
|
||||
missão logo depois do gatilho de fim. Busca por nome casa `id` **ou** alias (categoria "Grand Theft Auto VI" e tela
|
||||
"GTA 6" = mesmo jogo).
|
||||
|
||||
| Rota | Faz |
|
||||
|---|---|
|
||||
| `GET /v1/games` | perfis com `status`, `model`, `researchedAt`, `editedAt`, `notes` (`[{text, at, section?}]`) e `profile` |
|
||||
| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt |
|
||||
| `PUT /v1/games/{id}` | grava o perfil editado à mão: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources` |
|
||||
| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply` (1–2 frases do que mudou); guarda o pedido (com `section`) e marca `edited_at` |
|
||||
| `GET /v1/games` | perfis com `status`, `error`, `model`, `researchedAt`, `editedAt`, `translatedAt`, `notes` (`[{text, at, section?}]`), `aliases`, `profile`, `profileAi` |
|
||||
| `POST /v1/games` `{name, notes?}` | cadastra (201, `{games, id}`, status `pending`) e pesquisa em segundo plano; 409 se o `id` ou um alias já existe |
|
||||
| `DELETE /v1/games/{id}` | apaga o jogo (sessões não mudam; volta a ser pesquisado se o jogo reaparecer); 404 se não existe |
|
||||
| `POST /v1/games/{id}/research` | refaz o perfil do zero pela web **em inglês** e traduz para português (`RESEARCH_TIMEOUT_S` 420); os pedidos guardados entram no prompt |
|
||||
| `POST /v1/games/{id}/translate` | gera o inglês a partir do português (jogo de antes dos perfis bilíngues) |
|
||||
| `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, grava e deixa o outro desatualizado. Campos: `name`, `summary`, `genre`, `mechanics`, `clip_worthy`, `avoid`, `jargon`, `news`, `hashtags`, `sources`, `aliases`, `missions`, `end_triggers` |
|
||||
| `POST /v1/games/{id}/refine` | `{instruction, search, section, history}` → `{games, reply}`. Aplica no inglês e responde em português. `instruction` 3–1500 caracteres; `search` padrão `true` (`false` = sem web, `TIMEOUT_S` 240); `section` `""` \| `summary` \| `clip_worthy` \| `avoid` \| `mechanics` \| `news` \| `jargon` \| `hashtags` \| `sources` \| `missions` \| `end_triggers` \| `aliases` (`Literal` em `GameRefineIn` de `main.py`, inválido dá 422); `history` `[{role: "user"\|"ai", text ≤1500}]`, máx. 20. A IA devolve o perfil inteiro + `reply`; guarda o pedido (com `section`) e marca `edited_at` |
|
||||
| `DELETE /v1/games/{id}/notes/{index}` | esquece um pedido guardado (o perfil atual fica como está) |
|
||||
|
||||
- Tradução que falha (ou IA desligada): a outra versão fica como estava (na pesquisa, as duas em inglês), `error`
|
||||
explica e `translatedAt` não muda. Tradução nunca mexe em nome, hashtags, fontes e outros nomes, e é recusada se
|
||||
perder missões.
|
||||
- **Sementes:** `clipper/app/seeds/games/*.json` (`{name, aliases, researchedAt, sources, profileAi, profile}`) é
|
||||
importado na subida **só se o jogo não existe**. Hoje: `gta-vi.json` (GTA VI lança 19/11/2026, sem lista oficial de
|
||||
missões; a semente traz 4 do vídeo "An Extended Look" com nomes descritivos **não oficiais** — pesquisar de novo
|
||||
depois do lançamento; gotchas, item 167).
|
||||
- Proxy do painel (`panel/src/lib/clipper.ts`): `ALLOWED` aceita `games/<id>/(research|refine|translate|notes/n)`;
|
||||
`METHODS` dá GET/POST a `games` e PUT/DELETE a `games/<id>`; timeouts: 8 min `research|refine`, 5 min `translate` e
|
||||
`PUT`, 30 s `POST games`.
|
||||
|
||||
- `clean_profile` (`intel.py`) normaliza tudo que entra: apara, tira vazios e duplicados, no máximo 20 itens por lista.
|
||||
São guardados os últimos 30 pedidos.
|
||||
- **Pedido guardado sobrevive a "Pesquisar de novo"** (`research_game(name, title, notes)`; `PROFILE_SYSTEM` manda
|
||||
@@ -344,13 +393,10 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
|
||||
`history`, 400 caracteres cada. `REFINE_SYSTEM` manda mexer só na seção em foco e transformar pedido genérico
|
||||
em item concreto ("reação do streamer conta" → "Streamer grita, xinga ou ri alto logo depois de uma morte ou fuga").
|
||||
`Intel.refine(...)` (`intel.py`) devolve `(profile, reply)`.
|
||||
- Painel (`clipper-games.tsx`): o cabeçalho tem selo de iniciais e os botões "Conversar com a IA" (perfil inteiro),
|
||||
"Editar" (uma linha por item) e "Pesquisar de novo". Cada seção é um cartão com "Pedir à IA", que abre o chat
|
||||
daquela seção (`AiChat`: Enter envia, Shift+Enter quebra linha, chave "Confirmar na web" **desligada** por
|
||||
padrão no painel, embora a API use `search=true` por padrão). Item recém-acrescentado aparece com selo "novo".
|
||||
"Memória da IA" lista os pedidos guardados (com a seção) e tem X. A conversa só existe enquanto o chat está
|
||||
aberto. O que fica salvo é o pedido. Tipo `Game` em `panel/src/components/clipper-client.ts`
|
||||
(`editedAt?`, `notes?[].section?`). Detalhes visuais em [panel.md](panel.md).
|
||||
- Painel: lista em `/clipper/games` e modal por `?game=ID` (`clipper-game-dialog.tsx`, `clipper-game-parts.tsx`); o chat
|
||||
`AiChat` tem a chave "Confirmar na web" **desligada** por padrão, embora a API use `search=true`. A conversa só existe
|
||||
enquanto o chat está aberto; o que fica salvo é o pedido (aba "Pedidos à IA", com X). Tipos `Game`, `GameProfile`,
|
||||
`GameMission` em `panel/src/components/clipper-client.ts`. Detalhes visuais em [panel.md](panel.md).
|
||||
|
||||
## Regras
|
||||
|
||||
@@ -371,6 +417,17 @@ Toda rota abaixo devolve a lista inteira (mesma forma de `GET /v1/games`).
|
||||
|
||||
## Testes e evidência
|
||||
|
||||
Perfis de jogo bilíngues, missões, cadastro e semente do GTA VI (18/11/2026): `pnpm test:clipper` → **335 passed**
|
||||
(reexecutado nesta manutenção, 108 s; bate com o informado); 10 testes em `clipper/tests/test_game_profiles.py`. Não
|
||||
verificado: IA real na pesquisa, tradução e refino bilíngues; modal e lista no navegador; serviço real em v12 (precisa
|
||||
reiniciar); `pnpm typecheck` e testes do painel.
|
||||
|
||||
IA reserva e Gemini no juiz (18/11/2026): `pnpm test:clipper` → **335 passed** (reexecutado pela skill; `test_ai_fallback.py` novo).
|
||||
|
||||
Reformulação da interface e regras de pausa/idioma (18/11/2026): `pnpm test:clipper` → **287 passed** (reexecutado
|
||||
nesta manutenção; 9 testes novos em `clipper/tests/test_monitor_pause_and_language.py`). Não verificado: as páginas no
|
||||
navegador e o banco real em v11 (o serviço precisa reiniciar).
|
||||
|
||||
Os testes não chamam a CLI de IA: `FakeJudge.ask` (`clipper/tests/test_sources_and_api.py`) sempre falha, e o serviço
|
||||
segue pelo caminho de "IA fora". Juiz falso novo precisa cobrir `ask` também.
|
||||
|
||||
@@ -485,7 +542,7 @@ Não verificado:
|
||||
contra o serviço reiniciado;
|
||||
- apagar: rota no serviço real do usuário; arquivo em uso no Windows (deve voltar em `left`); pedido do editor em
|
||||
andamento gravando em `edit-<id>/` depois de apagar; relógio da sessão com movimento reduzido, aba escondida e
|
||||
larguras de 1024/1280; a faixa do topo em `clipper-studio.tsx` ainda mostra o `durationS` real (sem o relógio);
|
||||
larguras de 1024/1280; a faixa do topo (hoje `clipper-shell.tsx`) pode ainda mostrar o `durationS` real (sem o relógio);
|
||||
- duração, gancho, reenquadramento, camadas e captura: live 2K real e HEVC real da Twitch pela captura; gravação longa
|
||||
em 1080p ou 2K com o serviço real; juiz e varredura reais com as durações novas; render real de um projeto feito no
|
||||
editor com reenquadramento e camadas comparado com a prévia (pendente, depois do reinício do serviço); camadas na
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
Cada item: **sintoma → causa → correção → onde está tratado**. Observadas na implementação da
|
||||
prova de conceito com Godot 4.7.2 / FFmpeg 7.1.1 / pnpm 11.22 (16/11/2026). Registro formal em
|
||||
`doc/TEST_RESULT.md`: itens 1–5, 7, 13–15, 17 e 18; itens 30–33 estão em `voice/README.md`
|
||||
("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação.
|
||||
("GPU e CPU"); itens 57–61 estão em `clipper/README.md` ("Armadilhas já resolvidas"); itens 74–76, 87–90 e 103–108 também estão lá e o 78 na seção "Limitações" do editor; itens 79, 81–84 e 92–95 estão em `doc/FACE_BAKEOFF.md` (o 93 também em "Variáveis" de `clipper/README.md`) (o 80, no comentário de `clipper/requirements.txt`); itens 168–172 (IA) seguem `doc/ia.md`; itens 118–128 (publicação) seguem `doc/publicacao/` e o código; itens 151–154 foram informados em 17/11/2026 (parte conferida no código); itens 129–132 foram informados em 17/11/2026 e conferidos no código (`doc_main.gd`, `doc/godot/cenas.md`) e no banco (`agent_runs` 5, 7 e 8); itens 62–67, 77, 85–86, 91, 99–102, 109–112 e as ampliações do 52, do 44, 77, 86 e 87 foram informados em 16–17/11/2026 (não estão em `doc/TEST_RESULT.md`); os demais vieram de erros de compilação ou instalação durante a implementação.
|
||||
Ao descobrir uma nova, registre aqui via `cenaforge-skill-updater`. Os números são estáveis
|
||||
(outros textos os citam): item novo entra na seção do assunto com o próximo número livre.
|
||||
|
||||
@@ -764,10 +764,54 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md).
|
||||
165. **Cartoon: sombra do corpo/barriga em elipse parece mancha.** Correção: elipse + curva de volume (contorno) e sombra
|
||||
lateral recortada por `clipPath`. Onde: `cartoon/src/CharacterFigure.tsx`.
|
||||
|
||||
166. **Clipador: depois de parar a sessão à mão, a fonte não grava de novo (ou as rotas/campos novos "não pegam").**
|
||||
Dois lados. (a) Parar à mão pausa o monitor da fonte de propósito (`monitor_paused_at`): live no ar e nada
|
||||
reabrindo não é falha. Religar = "Religar" em `/clipper/sources`, `PATCH /v1/channels/{id}` `{"monitor": true}`,
|
||||
gravar pelo link ou retomar a sessão; `{"pauseMonitor": false}` no stop evita a pausa. Queda de live sem ninguém
|
||||
parar continua retomando na mesma sessão. (b) Serviço sem `--reload` (item 144): sem reiniciar, `stop` não pausa,
|
||||
`language` não é aceito nem devolvido e a migração v11 não roda; o painel trata os campos como opcionais, então
|
||||
nada quebra, só não pega. Reinicie (é do usuário) e confira `PRAGMA user_version` = 11. Onde:
|
||||
`clipper/app/worker.py`, `main.py` (`StopIn`), `db.py` (v11); teste `clipper/tests/test_monitor_pause_and_language.py`.
|
||||
|
||||
167. **Clipador: perfil do jogo sem versão em inglês, GTA VI ausente ou "cadastrar jogo" que não funciona.** (a) Serviço
|
||||
sem reiniciar (item 144): a migração v12 não roda, `POST /v1/games`, `translate`, `DELETE` e `?lang=` não existem e a
|
||||
semente do GTA VI não é importada (só entra na subida, e só se o jogo não existe: nunca sobrescreve edição).
|
||||
Reinicie (é do usuário) e confira `PRAGMA user_version` = 12. (b) Jogo antigo tem `profileAi: null`: a IA usa o
|
||||
português até rodar `POST /v1/games/{id}/translate` ("Gerar versão em inglês" no modal). (c) Categoria ou tela com
|
||||
outro nome ("Grand Theft Auto VI" × "GTA 6") só cai no mesmo perfil se o nome estiver em `aliases`; cadastro com nome
|
||||
já existente (inclusive alias) dá 409. (d) Missões só entram quando a lista é pública; **a semente do GTA VI traz 4
|
||||
missões do vídeo "An Extended Look" com nomes descritivos, não oficiais** (jogo lança 19/11/2026, sem lista oficial):
|
||||
pesquisar de novo depois do lançamento, sem apagar o jogo. Edição à mão em um idioma é traduzida para o outro; tradução
|
||||
que falha deixa a outra versão como estava e `error` explica. Onde: `clipper/app/intel.py` (`import_seeds`,
|
||||
`add_game`, `translate`), `main.py`, `db.py` (v12), `seeds/games/`; teste `clipper/tests/test_game_profiles.py`.
|
||||
|
||||
## IA: provedores, login e reserva
|
||||
|
||||
Itens 168–172 informados em 18/11/2026 e conferidos contra `doc/ia.md` e o código. Contexto em [ai.md](ai.md).
|
||||
|
||||
168. **Gemini CLI com login Google: `IneligibleTierError: UNSUPPORTED_CLIENT`** (gemini-cli 0.68.0). Causa: o OAuth gratuito
|
||||
"Code Assist for individuals" foi encerrado; o Google manda migrar para o Antigravity. OAuth só com plano elegível
|
||||
(Code Assist Standard/Enterprise, Workspace). Correção: conta pessoal usa **chave do AI Studio** (`authMode: "apiKey"`).
|
||||
O erro conta como indisponibilidade (`IneligibleTier`) e aciona a reserva. Onde: `panel/src/lib/ai.ts`, `doc/ia.md`.
|
||||
169. **`CODEX_API_KEY` só vale no `codex exec`** (confirmado no binário 0.169.0). Para chave sem mexer na conta do usuário,
|
||||
ponha a variável só na chamada (`providerEnv`); **não** use `codex login --with-api-key`, que troca o login global.
|
||||
Mesma regra para `ANTHROPIC_API_KEY` e `GEMINI_API_KEY`. Onde: `providerEnv` em `panel/src/lib/ai.ts`.
|
||||
170. **Terminal de login no Windows: aspas do `cmd` e caminho com espaço ("Program Files").** Forma que funcionou:
|
||||
`cmd /d /c start "<título>" cmd.exe /k "<linha>"` com `windowsVerbatimArguments: true` (testado com caminho em
|
||||
"Program Files"); sem o modo verbatim o Node reescreve as aspas (causa não isolada). Onde: `openLoginTerminal` em
|
||||
`panel/src/lib/ai.ts`.
|
||||
171. **Status das IAs lento (~0,3 s por chamada ao cofre).** Causa: a DPAPI no Node passa por PowerShell. Correção: cofre
|
||||
em cache por `mtime` de `data/ai/vault.bin`; o Clipador lê com `ctypes` (`clipper/app/ai_settings.py`). Não leia o
|
||||
cofre por requisição sem o cache.
|
||||
172. **CLI instalada "não aparece" no painel.** Causa: o PATH do painel é o de quando ele abriu (instalação nova não entra),
|
||||
e o instalador nativo do Claude usa `~/.local/bin` e o npm `%APPDATA%\npm`. Correção: `resolveCommand` procura nesses
|
||||
dois lugares além do PATH; mesmo assim, instalar e não ver = "Verificar" de novo na tela. Gemini no Windows: o
|
||||
`gemini.cmd` exige shell, então roda `node …/@google/gemini-cli/bundle/gemini.js` (mesma família do item 28).
|
||||
|
||||
Relacionadas, já registradas acima:
|
||||
- Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`,
|
||||
`app/dashboard/page.tsx`): item 63 — uma substituição com "\n" não acha o trecho; normalize e grave de volta em CRLF.
|
||||
- `codex.cmd` sem shell: item 28.
|
||||
- Script de patch com regex (`\b`) passado por heredoc: item 44.
|
||||
- Publicador roda sem `--reload`: mudança em `publisher/app/` só vale depois de reiniciar o `pnpm dev` (itens 137, 139, 140, 142, 143, 145 e 147; o Clipador também: 144).
|
||||
- Migração do painel (v3 … v8) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).
|
||||
- Migração do painel (v3 … v10) é aplicada na 1ª requisição depois da recarga do `db.ts`; reiniciar o `pnpm panel`/`pnpm dev` só se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).
|
||||
|
||||
@@ -19,13 +19,15 @@ Fonte: código em `panel/src/lib/` e `panel/README.md`. O painel é do usuário:
|
||||
(ex.: `CutSettingsDialog` de `clipper-cut-settings.tsx`). Não monte um segundo host.
|
||||
- `Button` (`components/ui.tsx`) tipa as props como `ComponentProps<"button">` e aceita `ref` (React 19).
|
||||
|
||||
## Banco (`data/cenaforge.db`, esquema v7)
|
||||
## Banco (`data/cenaforge.db`, esquema v10)
|
||||
|
||||
- Migração em `panel/src/lib/db.ts` (lista `MIGRATIONS`). Banco com dados → cópia em `data/backups/`
|
||||
antes de migrar (`cenaforge-v<atual>-<data>.db`). `foreign_keys = OFF` fora da transação e `PRAGMA
|
||||
foreign_key_check` antes do `COMMIT` de cada versão.
|
||||
- v3: `account_channels` (conta ↔ canal de live do Clipador; `status` `active`/`ended`). O canal
|
||||
vive em `data/clipper/clipper.db`, então não há chave estrangeira para ele.
|
||||
- v9: `accounts.language` (idioma e público do canal de publicação; padrão `pt-BR`; opções em `ACCOUNT_LANGUAGES` de
|
||||
`panel/src/lib/languages.ts`). A v8 (última leitura dos números das redes) não está descrita aqui: ver publishing.md.
|
||||
- v4: reconstrói `stories` (SQLite não altera CHECK) para `kind` aceitar `'documentary'`; mesmas
|
||||
colunas e ids.
|
||||
- v5: publicação real — `publish_jobs`, `app_settings`, `clip_auto_approvals`; `account_networks` e `publications`
|
||||
@@ -35,6 +37,7 @@ Fonte: código em `panel/src/lib/` e `panel/README.md`. O painel é do usuário:
|
||||
- v6: reconstrói `publish_jobs` (ids preservados) com `schedule_source` (`auto`/`manual`/`now`) e `cancel_reason`
|
||||
`unlinked`. Banco real em v6 (`PRAGMA user_version`, conferido em 17/11/2026, antes da v7).
|
||||
- v7: `publish_jobs.origin` (`link`/`manual`, padrão `link`): job criado pelo botão "Publicar" do corte. Ver publishing.md.
|
||||
- v10: `agent_runs.fallback_of` (execução que continuou outra que caiu por indisponibilidade; IA reserva — [ai.md](ai.md)).
|
||||
- API: toda rota `/api/**` passa por `panel/src/proxy.ts` (Host local; escrita exige `Origin` do painel) e corpo por
|
||||
`readJson` (415 sem `Content-Type: application/json`) — gotchas, item 125.
|
||||
- A conexão fica em `globalThis.__cenaforgeDb`; a marca de módulo `checkedThisModule` faz a 1ª chamada de `db()` depois
|
||||
@@ -248,7 +251,13 @@ Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; pers
|
||||
informando o formato (o subagente é uma casca que lê `doc/roteiro/`; sem WebSearch, fato sem fonte fica
|
||||
"a confirmar"); no **Codex** manda ler os guias e escrever sozinho, sem usar `.claude/agents/` (mesma
|
||||
regra no `AGENTS.md`).
|
||||
- Lista de modelos = `models()` (não há mais constante fixa):
|
||||
- **Três provedores** (`claude`, `codex`, `gemini`), configurados em **Configurações → IA** (`/settings/ai`: ligar/desligar,
|
||||
conta ou chave de API, ordem da reserva, instalar, entrar, testar). **IA reserva:** agente que termina com erro de
|
||||
indisponibilidade é pausado e a mesma tarefa recomeça na próxima IA pronta (`agent_runs.fallback_of`; o console segue
|
||||
o `followUpRunId` também nesse caso; vertentes religadas à nova execução). Contrato, API e armadilhas em
|
||||
[ai.md](ai.md). Configurações são subpáginas `/settings/{ai,publishing,apps,browser,modes}` (`/settings` → IA;
|
||||
`SETTINGS_SECTIONS` em `settings-shell.tsx`, também no menu lateral); link antigo `/settings?tab=apps` não existe mais.
|
||||
- Lista de modelos = `models()` (não há mais constante fixa; o Gemini usa `geminiModels()` de `lib/ai.ts`):
|
||||
- Codex: lê `models_cache.json` de `$CODEX_HOME` (padrão `~/.codex`), que a CLI do Codex atualiza
|
||||
sozinha; filtra `visibility === "list"`, ordena por `priority`. Primeira opção "Padrão da CLI (…)"
|
||||
= `model = "..."` do `config.toml`. O id vai em `codex exec -m <slug>`. Em 17/11/2026: 8 modelos
|
||||
@@ -266,8 +275,9 @@ Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; pers
|
||||
em `createStoryFromTextAction`, `app/actions.ts`). Por script: `POST /api/stories {text, title?, kind?, provider?,
|
||||
model?}` (`app/api/stories/route.ts`; `kind` padrão `documentary`, texto 20–20.000 caracteres) cria a história + ep01
|
||||
e dispara o agente `story` → `{storyId, episodeId, runId}` (cabeçalho `Origin`: gotchas, item 125).
|
||||
- O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso do
|
||||
Claude/Codex para a tarefa no meio: continue no outro provedor com o contexto (item 132).
|
||||
- O agente roda dentro do processo do painel: reiniciar o `pnpm panel` o mata (gotchas, item 131). Limite de uso no
|
||||
meio da tarefa: com a reserva ligada o painel recomeça sozinho na próxima IA (item 132 vale só com a reserva
|
||||
desligada ou sem outra IA pronta: continue à mão no outro provedor com o contexto).
|
||||
- Prompt do Codex manda ler texto no PowerShell com `Get-Content -Raw -Encoding UTF8` (gotchas, item 98).
|
||||
|
||||
### Mensagem com o agente rodando
|
||||
@@ -336,6 +346,29 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
|
||||
|
||||
## Página `/clipper` (Clipador)
|
||||
|
||||
Reformulada em 18/11/2026 (`doc/clipador/REDESIGN.md`): deixou de ser uma página com 5 abas e virou **subpáginas** no
|
||||
grupo de rotas `panel/src/app/clipper/(studio)/`. O `layout.tsx` monta `ClipperProvider` (`clipper-provider.tsx`: dados +
|
||||
consulta periódica; `useClipper()`) e `ClipperShell` (`clipper-shell.tsx`: cabeçalho compacto com estado do serviço,
|
||||
bloco "Ao vivo agora · N" com uma linha por live, sub-navegação com contadores). Sub-navegação = `CLIPPER_SECTIONS`; a
|
||||
sidebar (`sidebar-nav.tsx`) mostra os mesmos subitens quando o Clipador está ativo. Seção nova = entrada em
|
||||
`CLIPPER_SECTIONS` + pasta em `(studio)/`.
|
||||
|
||||
| Rota | Conteúdo | Arquivos |
|
||||
|---|---|---|
|
||||
| `/clipper` Cortes | lista `ClipTable` (uma linha por corte; ações rápidas Aprovar/Rejeitar/Publicar), filtros na URL (`?stage ?source ?session ?lang`), modal `ClipDialog` por `?clip=ID` com anterior/próximo | `clipper-clips-page.tsx`, `clipper-clip-table.tsx`, `clipper-clip-dialog.tsx`, `clipper-clip-parts.tsx`; ordenar/apagar/selecionar em utilitários de `clipper-queue.tsx` |
|
||||
| `/clipper/sessions` | lista de sessões; "Gravar pelo link" em diálogo (`RecordForm`) | `clipper-sessions-page.tsx` |
|
||||
| `/clipper/sessions/[id]` | saúde, resumo da IA, tiles, gráfico do chat, emotes, configuração do corte | `clipper-session-detail.tsx` |
|
||||
| `/clipper/sources` | fontes em tabela, "Adicionar fonte" em diálogo, monitor ligado/**pausado** + Religar, idioma da live, canais de publicação | `clipper-channels.tsx` |
|
||||
| `/clipper/games` | jogos em tabela (nome, gênero, estado, missões, última pesquisa/edição), "Adicionar jogo" em diálogo, `?game=ID` abre o modal do jogo e emotes do canal | `clipper-games-page.tsx`, `clipper-game-dialog.tsx` (modal), `clipper-game-parts.tsx` (seções, `AiChat`, editor à mão), `clipper-games.tsx` |
|
||||
| `/clipper/settings` | abas Juiz (IA) / Serviço / Idiomas e públicos | `clipper-settings-page.tsx`, `clipper-judge.tsx` |
|
||||
| `/clipper/edit/[clipId]` | editor em tela cheia, **fora** do grupo `(studio)` | ver "Editor de cortes" |
|
||||
|
||||
`clipper-studio.tsx` foi **apagado**; `clipper-queue.tsx` virou só utilitários da lista (a lista é `ClipTable`);
|
||||
`clipper-sessions.tsx` virou peças compartilhadas (`PlatformIcon`, `CutNow`, `RecordForm`, relógio, `sessionHealth`).
|
||||
Canal de publicação: campo "Idioma e público" em `account-manager.tsx`; aviso de idioma em `clip-publish.tsx`.
|
||||
Os parágrafos abaixo descrevem o comportamento de cada peça; onde falam em "aba", "cartão" ou "fila", leia "página",
|
||||
"linha" e "lista de cortes" (a reescrita deles não foi verificada no navegador).
|
||||
|
||||
- `clipper-cut-settings.tsx`: modal "Configuração do corte" em cinco abas — Formato e duração (com a seção
|
||||
"Qualidade da gravação" e o disco por hora de cada opção, de `captureQualities`) · Câmera e layout · Legenda (com
|
||||
seletor de fonte) · Gancho (estilo, cores, fonte, animação de entrada, "Ver a entrada") · Crédito — com a prévia ao
|
||||
@@ -345,7 +378,7 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
|
||||
- `clipper-client.ts`: tipo `Aspect`, `format` em `CutSettings`, `aspect?` em `Clip`, `aspectOf()` (ausente =
|
||||
vertical) e `withFormat()` (completa a resposta de um serviço antigo sem `format`). Na fila (`clipper-queue.tsx`)
|
||||
o corte horizontal aparece em 16:9.
|
||||
- Aba Sessões (`clipper-sessions.tsx`; cabeçalho em `clipper-studio.tsx`): cartão com cabeçalho (tempo gravado,
|
||||
- Sessão (`clipper-sessions.tsx`, `clipper-session-detail.tsx`): cartão com cabeçalho (tempo gravado,
|
||||
"gravando em L×A · fps" de `capture` e ações), frase de saúde (`sessionHealth()`), painel "o que está acontecendo" (resumo da IA + jogo), quatro blocos
|
||||
(Chat, Transcrição, IA assistiu, Cortes) e barra de ferramentas. **Altura fixa por desenho**: nada pode pular na
|
||||
atualização automática. "Retomar gravação" aparece em toda live que não está gravando (botão principal só em
|
||||
@@ -358,12 +391,12 @@ Limitação: o overlay da Godot só tem `choiceA`/`choiceB` (`scene_config.gd`);
|
||||
atrasou, "gerando o próximo resumo…". O intervalo vem de `/status` → `judge.options.scanIntervalS`
|
||||
(`useScanInterval`; reserva 180 = `OPTION_DEFAULTS` de `intel.py`). Existe porque o dono achou que o resumo
|
||||
travava (gotchas, item 115).
|
||||
- `clipper-games.tsx`: aba Jogos e emotes. O card do jogo tem selo de iniciais (primeira + última palavra, cor
|
||||
por `hueOf`) e os botões "Conversar com a IA", "Editar" e "Pesquisar de novo". Cada seção é um cartão com
|
||||
barra colorida, contador e "Pedir à IA", que abre o chat inline `AiChat` (balões, atalhos de pedido por seção,
|
||||
indicador de digitação, "+N itens novos / −N removidos"). Item novo fica verde com selo "novo". Gírias viram
|
||||
chips, e Fontes e "Memória da IA" ficam recolhidas. A aba também mostra os emotes do canal com usos e peso.
|
||||
Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos).
|
||||
- Jogos (`clipper-games-page.tsx` + `clipper-game-dialog.tsx` + `clipper-game-parts.tsx`; `clipper-games.tsx` guarda
|
||||
os emotes do canal): lista em tabela; o modal tem alternância **Português (você lê) / English (vai para a IA)** e abas
|
||||
Visão geral · Rende corte · Missões · Gatilhos de fim · Termos e hashtags · Fontes · Pedidos à IA, com Pesquisar de
|
||||
novo, Editar, Pedir à IA (`AiChat`: atalhos por seção, "+N itens novos / −N removidos") e Apagar. Editar grava no
|
||||
idioma da alternância e o serviço traduz o outro. Rotas e regras em [clipper.md](clipper.md#perfil-do-jogo-aba-jogos).
|
||||
- Sidebar: os subitens do Clipador usam os mesmos ícones das abas do topo (`sidebar-nav.tsx`, `SubItem.icon`).
|
||||
- `clipper-queue.tsx`: cartão do corte mostra a análise do juiz e recua/avança o início (`START_STEPS`
|
||||
−30/−10/−5/−2/+2 s). `clipper-judge.tsx`: modelos do editor e do analista, varredura, visão, câmera.
|
||||
- **Ordenar a fila** (`clipper-queue.tsx`, seletor "Ordenar" ao lado do filtro de sessão; `QUEUE_SORTS`, `useQueueSort`):
|
||||
@@ -523,4 +556,4 @@ Apagar na fila, relógio da sessão e prévia igual ao render (17/11/2026): `npx
|
||||
(reconferido pela skill). Informado pelo coordenador: porte da legenda em 22 conferências contra o Python; corte 61
|
||||
montado no editor e renderizado pelo serviço com enquadramento, inserção e legenda iguais à prévia em
|
||||
2/3,5/5/6,5/8 s. Não verificado: apagar pela UI contra o serviço real; relógio com movimento reduzido, aba escondida
|
||||
e larguras de 1024/1280; a faixa do topo de `clipper-studio.tsx` ainda usa o `durationS` real.
|
||||
e larguras de 1024/1280; a faixa do topo (hoje `clipper-shell.tsx`) pode ainda usar o `durationS` real.
|
||||
|
||||
@@ -21,9 +21,9 @@ prévia e registre aqui (via `cenaforge-skill-updater`).
|
||||
| Next.js / React / Tailwind | 16.4.6 / 19.3.0 / 4.3.3 | painel (`panel/`) | dependências do workspace | 16/11/2026 |
|
||||
| @xyflow/react | 13.0.1 | árvore de vertentes na aba Fluxo (`panel/src/components/story-flow.tsx`) | dependência do painel | 16/11/2026 |
|
||||
| SQLite | `node:sqlite` (Node 24) | banco do painel, sem dependência nativa | embutido | 16/11/2026 |
|
||||
| Codex CLI | 0.169.0 (`@openai/codex`) | agente no painel (`codex exec --json -m <slug>`, sandbox `workspace-write`); modelos lidos de `~/.codex/models_cache.json` (panel.md, "Agentes e modelos") | `CODEX_BIN` → `.exe` no PATH → `codex.js` ao lado do `codex.cmd` do npm | 17/11/2026 |
|
||||
| Codex CLI | 0.169.0 (`@openai/codex`) | agente no painel (`codex exec --json -m <slug>`, sandbox `workspace-write`); modelos lidos de `~/.codex/models_cache.json` (panel.md, "Agentes e modelos") | `CODEX_BIN` → `.exe` no PATH → `codex.js` ao lado do `codex.cmd` do npm | 17/11/2026 (`--version` reconferido em 18/11/2026) |
|
||||
| API do Wikimedia Commons (`commons.wikimedia.org/w/api.php`) | sem versão (HTTP público, sem chave; User-Agent genérico) | fotos reais por trecho na montagem documental (`panel/src/lib/image-search.ts`), com autor, licença e página de origem nos créditos | chamada direta do painel | 17/11/2026 (`ep01.montage.json`: 5 fotos do Commons com licença CC registrada; MP4 de 88,3 s; licença não conferida na página de cada foto) |
|
||||
| Claude Code CLI | 2.1.314 | agente chamado pelo painel (`-p`, `stream-json`, `--resume`, `--model claude-*-5-5`/`claude-fable-5-2`) | `CLAUDE_BIN` → `PATH` (`claude.exe`) | 17/11/2026 |
|
||||
| Claude Code CLI | 2.1.314 | agente chamado pelo painel (`-p`, `stream-json`, `--resume`, `--model claude-*-5-5`/`claude-fable-5-2`) | `CLAUDE_BIN` → `PATH` (`claude.exe`) → `~/.local/bin` | 17/11/2026 (`--version` reconferido em 18/11/2026) |
|
||||
|
||||
Estilo Cartoon (`cartoon/`, 17/11/2026; contrato e uso em [cartoon.md](cartoon.md)):
|
||||
|
||||
@@ -168,6 +168,7 @@ segurança).
|
||||
|
||||
| Ferramenta | Para quê | Situação |
|
||||
|---|---|---|
|
||||
| Gemini CLI (`@google/gemini-cli`) | terceiro provedor de IA (agentes do painel e juiz do Clipador; [ai.md](ai.md)) | **código pronto, nunca executado de verdade**: não instalado nesta máquina (18/11/2026, `gemini: command not found`); a versão 0.68.0 do contrato (`doc/ia.md`) vem de teste do dono e não foi reverificada aqui. Coberto só por testes sem CLI (`ai.test.ts`, `test_ai_fallback.py`). OAuth gratuito de conta pessoal encerrado (gotchas, item 168); uso real exige chave do AI Studio, ainda não testada. Passa a "Em uso" depois de uma tarefa real concluída por ele |
|
||||
| Meshy | gerar modelos GLB (personagens, objetos) e rig | citada na especificação; não testada |
|
||||
| Mixamo | animações para personagens com rig | citada como não obrigatória; não testada |
|
||||
| `.glb` carregado por `GLTFDocument` em tempo de execução (Godot) | modelos prontos dentro de cenas da biblioteca (`library/<id>/assets/`) | **só documentado** em `doc/godot/cenas.md`; nenhum `.glb` no repositório nem render com ele (17/11/2026). Personagens e barcos atuais são procedurais (`godot/kits/`) |
|
||||
|
||||
Reference in New Issue
Block a user