- 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>
79 KiB
Armadilhas conhecidas
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 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.
Render (Godot Movie Maker)
-
Primeiro quadro diferente (azulado, sombra diagonal errada). Causa: sombras e radiância do céu ainda não prontas no 1º quadro. Correção: 3 quadros de aquecimento em t = 0, descartados com
-start_number 3. Onde:--warmup-framesemmain.gd;render.tspassa-start_number. -
deltanão é 1/fps mesmo com--fixed-fps(0,025; 0,0333; 0,0417…). Correção: tempo da cena = contador de quadros / fps. Nunca usedeltaem render. Onde:_process_renderemmain.gd. -
Resolução do filme travada na inicialização.
--resolutionecontent_scale_sizeem runtime não mudam o arquivo; janela de 1080×1920 não cabe numa tela de 1080 px. Correção:godot/override.cfgtemporário com o viewport do perfil e janela menor (stretchviewport, aspectkeep). A cena aborta (código 3) se o viewport ≠ config. Onde:render.tsescreve/remove o arquivo; checagem emmain.gd. Consequência: render manual sem o lançador só sai em 540×960. -
--write-movierelativo grava emgodot/, e falha em silêncio. Com a pasta inexistente, nenhum PNG é gravado e a Godot sai com código 0 dizendo "Done recording". Correção: caminho absoluto; o lançador confere os PNGs;main.gdaborta se a pasta não existe. Lição: log de sucesso não prova nada — confira arquivos. -
Quantidade de quadros. Chamar
quit()no_processdo último quadro ainda grava esse quadro: total de PNGs = aquecimento + fps × duração, índices contínuos a partir de 0, padrãoframe%08d.png, maisframe.wav(silencioso, descartado). -
Modo
--headlessnão renderiza 3D válido. Use só para validação, testes e preparação de assets. O render abre uma janela e precisa de backend gráfico. -
Custo do render é a codificação PNG (~105 ms/quadro em 540×960, ~404 ms em 1080×1920), não a GPU. Não prometa tempo sem medir.
-
Cena do documentário (
doc2d/doc3d) reprovada como "quadro preto" ou "moto não termina no ponto". Causa: as checagens do lançador eram da rua — o fundo escuro do documentário (#0d0d10) tem luma ≈ 13, abaixo do piso 20 (MIN_AVERAGE_LUMA), e não há moto. Correção: comkinddoc2doudoc3d,render.tspula a checagem da moto e usaMIN_AVERAGE_LUMA_DOC2D= 4. Fundo novo mais escuro que isso → ajuste o piso, não desligue a checagem. -
Render de cena
doc3dnão termina e enche a pasta de PNGs (17/11/2026: 39 mil quadros, "apply em Nil" em laço). Causa:template.gdcom erro de compilação; o protocolo seguia sem a cena. Correção:doc_main.gdcarrega o script na validação e, secan_instantiate()falha, sai comSCENE_SCRIPT_INVALID(código 2,EXIT_INVALID_CONFIG); osParse Errorcom a linha ficam norender.logdo run. No render, cena semsetup/applytambém sai comSCENE_SCRIPT_INVALID. Se um render antigo travar assim: encerre a Godot e o lançador e apagueoutput/.render.lock. Erros de GDScript mais comuns: itens 9 e 130.
GDScript (Godot 4.7) e TypeScript do lançador
class_namedepende do cache do editor. O projeto roda sem importação prévia; useconst X := preload(...).var x := dicionario.campo + 1.0não compila (tipo não inferível a partir de Variant). Idemvar x := dict.get("k"),var p := nodes[i]e retorno de método de kit chamado por variável tipada comoNode3D. Declare o tipo (var x: float = ...) ou use=.- Comparar valor não-objeto com
null: prefiratypeof(v) == TYPE_NIL. quit()é adiado para o fim do quadro: depois de chamar, marque um sinalizador (_halted) para o_processseguinte não rodar com estado incompleto.- Dentro de comentário de bloco TypeScript,
*/(ex.:godot-*/) encerra o comentário. - "shadows a native class": constante com nome de classe do Godot (
const Sky := preload(...),Camera3D,Environment) não compila. Use outro nome (SkyRigemgodot/library/castaways/template.gd). Guia: "Testar" emdoc/godot/cenas.md.
Composição visual
- Título longo quebra linha: o rótulo cresce para cima (alinhado embaixo) para não invadir as opções. Reserve ~18% inferior livre para a interface da plataforma.
- No fim do plano, câmera baixa (~1,1 m) com leve inclinação para baixo põe o entregador na metade superior e mantém o horizonte; câmera alta deixa o texto cobrindo o personagem.
- Borda do plano do morro vira linha reta no céu: a cumeeira de volumes irregulares resolve.
- Câmera lateral perto dos postes (x = meia pista + 0,5 m): mantenha ≥ 1 m de folga no offset.
- Rodas: a ~4 m/s giram ~26°/quadro; acima de 30°/quadro a simetria de 60° dos raios pode causar efeito estroboscópico.
- Espuma do mar desenhada por elipse não acompanha a costa (anel regular em volta de uma ilha irregular).
Causa: a elipse no shader do mar ignora o contorno real do terreno. Correção: removida; a cor turquesa perto da
costa já marca a transição. Espuma futura precisa seguir a altura do terreno, não uma forma fixa. Onde:
_build_oceanemgodot/library/island/template.gd.
Ferramentas
pnpm doctoré comando nativo do pnpm 11 → usepnpm run doctor.- pnpm 11 bloqueia scripts de instalação não aprovados (erro
ERR_PNPM_IGNORED_BUILDS). Oesbuildestá recusado empnpm-workspace.yaml(allowBuilds: esbuild: false) e funciona assim. - pnpm repassa o
--para o script; o parser do lançador ignora um--solto. - Executável principal da Godot (não o
_console.exe) escreve stdout em pipe normalmente; use-o para poder encerrar a árvore comtaskkill /T. - Heredoc ou
node -e "..."no Bash do agente quebra com barra invertida e aspas (\\vira\; escapes como\bde regex se perdem; às vezes o script inteiro falha). Em 17/11/2026 umnode -ecom regex quebrou o build do painel duas vezes. Texto com barra invertida (caminhos Windows,package.json, regex) ou script com aspas aninhadas: edite com Edit/Write, ou grave o script num arquivo (scratchpad) com Write e execute o arquivo, nunca inline.
Painel
- Portas: o CenaForge usa a faixa 4500–4599 (painel = 4500). A 3100 já é de outro
aplicativo nesta máquina.
EADDRINUSE= porta ocupada: escolha outra da faixa, nunca encerre o processo alheio. - Node não executa
.cmd/.batsem shell (ex.:pnpm.cmd). O painel chama o lançador comonode node_modules/tsx/dist/cli.mjs scripts/cli.ts render …e procura só.exe. - Next.js 16.4 vem com
cacheComponentsligado; o painel desliga (dados sempre dinâmicos) e chamaconnection()antes de ler o SQLite.paramsde página/rota éPromise. - Script
.tsdentro depanel/roda como CommonJS (sem"type": "module"): paraawaitno topo, use.mts. claude -preclama de stdin se a entrada não for fechada: o painel usastdio: ["ignore", …].- Codex fora de repositório Git recusa rodar sem
--skip-git-repo-check.codex exec resumenão aceita--sandboxnem-C: use-c sandbox_mode="workspace-write"e o cwd do processo. - Shims do npm no Windows (
codex,codex.cmd,codex.ps1): o sem extensão é script de shell e o.cmdexige shell. O painel (agents.ts) e o juiz do Clipador (clipper/app/judge.py) executamnode <pacote>/bin/codex.js. - Ruído das CLIs no stderr. Codex: configuração pessoal do usuário (
~/.codex/config.toml, servidor MCP fora do ar) e "Codex is ignoring N unrecognized configuration setting"; Claude Code:[claude-code:unrecognized_model]para id fora da lista interna dele (ex.:claude-fable-5-2), mas o modelo roda normalmente. O painel filtra esses padrões (STDERR_NOISEempanel/src/lib/agents.ts); os avisos de configuração do Codex chegam como itemerror, exibidos como nota. - Ícone some no menu recolhido: SVG dentro de flex encolhe a 0 px ao lado de texto
nowrap. Correção:shrink-0nos ícones (panel/src/components/icons.tsx). - Grade na barra lateral cresce até a largura do texto. Correção:
flex-col+min-w-0(panel/src/components/sidebar-nav.tsx). - Nó do
@xyflow/react13 não responde a clique semonNodeClickno canvas. Correção: o clique sobe até o nó e é tratado noonNodeClick(components/story-flow.tsx). - Foco dentro do canvas rola o contêiner e desalinha a árvore. Correção:
onScrollCapturedesfaz a rolagem esetCentertraz o nó focado para a vista (story-flow.tsx). - Grade sem
grid-cols-1estoura no celular (colunas implícitas crescem até o conteúdo). Correção: declarargrid-cols-1na base e as colunas extras só nos breakpoints. - Mudança de esquema não aparece no painel em dev (ex.: v4 → criar história documental falha no
CHECK de
stories.kind). Causa: a conexão do SQLite fica emglobalThis.__cenaforgeDb(panel/src/lib/db.ts) e a migração só rodava ao abrir o banco. Hoje a marcacheckedThisModulefaz a 1ª chamada dedb()depois da recarga do código migrar o banco aberto (item 138); se odb.tsnão foi recarregado, faça uma requisição ao painel ou peça ao usuário que reinicie opnpm panel(é dele: não reinicie você). Conferir:PRAGMA user_versiondodata/cenaforge.db=MIGRATIONS.length. tsxcomawaitno topo exige arquivo.mts, e o import de módulo local precisa de URLfile:///(caminho Windows cru comC:\ouf:/não é URL e falha no loader ESM). Node puro não resolve import.tssem extensão: rode pelo tsx da raiz,node node_modules/tsx/dist/cli.mjs <script>.mts, com importsfile:///<raiz-do-repo>/panel/src/lib/<módulo>.ts. Complementa o item 25.- Classe de largura não pega em
Select/Inputdopanel/src/components/ui.tsx. Causa: a classe base temw-fullfixo ecx()só concatena (não faz merge de Tailwind como otailwind-merge);w-48passado junto perde para ow-full. Correção: controlar a largura com um<div>em volta (ex.: barra de filtros devoice-cards.tsx). - Patch por string falha nos
.tsxdo painel: os arquivos são CRLF. Correção: normalizar o fim de linha antes de procurar o trecho (ou usar a ferramenta Edit) e gravar de volta em CRLF. - Codex aplica as restrições de ficção a um pedido documental. Causa: o Codex lia
.claude/agents/cenaforge-story-writer.mdcomo instrução, mas é um subagente do Claude. Correção: as regras saíram do subagente paradoc/roteiro/(comum.md+ficcao.md/documental.md); o prompt (writingRules(provider, kind)empanel/src/lib/prompts.ts) manda o Codex ler só o guia do formato e escrever sozinho, e oAGENTS.mdda raiz tem a mesma regra. Regra nova de texto vai para os .md, não para o subagente nem para o código. - Codex retomado depois de interrompido esquece o pedido original. Medido com o Codex 0.169 (
exec+taskkill /T /F+exec resume <thread>): matando logo nothread.started, a sessão retomada não tinha o pedido (respondeu "Nenhuma"); matando depois de umagent_message, lembrou (respondeu "BANANA"). O 1ºitem.completedpode ser um itemerrorde MCP pessoal, que não conta como progresso. Correção: "Corrigir agora" (sendFollowUpempanel/src/lib/agents.ts) exigesession_ideprogressed(algum evento que não sejasystem,stderrnemerror); antes disso, recusa e sugere "Enviar ao terminar". - Acentos quebrados no Codex ("história" no console). Causa: o Windows PowerShell 5.1 lê arquivo UTF-8
sem BOM como ANSI. Correção: o prompt do Codex (
panel/src/lib/prompts.ts) manda ler texto comGet-Content -Raw -Encoding UTF8. Mesma raiz do item 36 (script.ps1precisa de BOM). - Script de teste marca como
interruptedo que o painel está rodando. Causa: importarlib/db.ts(direto ou por outro módulo do painel) abre o banco, e a abertura rodaUPDATE renders/agent_runs SET status = 'interrupted' WHERE status = 'running'. Correção: script fora do painel não importa nada que toque o banco; por isso o FFmpeg da montagem documental fica empanel/src/lib/montage-ffmpeg.ts, sem banco. - Parâmetro extra some da URL de arquivo. Causa:
fileUrl()(panel/src/components/ui.tsx) já devolve/api/files?path=.... Correção: anexar com&v=...(ex.: quebra de cache do áudio emmontage-editor.tsx). - Asterisco no vídeo documental (
*Bothrops insularis*). Causa: o "texto na tela" do roteiro vem com markdown. Correção:loadMontage(panel/src/lib/montage.ts) tira**,__,*,_, crase e aspas externas. - Trecho do MP4 mais longo que a tabela do roteiro (trecho 1: roteiro 0–2 s, fala 4,08 s). Não é erro: a montagem segue a duração real de cada fala (+ pausa), não a coluna "t (s)". Para encurtar, corte o texto falado.
- Primeira montagem logo depois de editar
panel/src/lib/sai com o comportamento antigo (17/11/2026: a 1ª saiu sem o fundo desfocado da foto; a 2ª, certa). Causa provável (não isolada): o Next dev ainda executa o módulo antigo logo após a edição. Correção: confira os quadros da primeira saída depois de mexer no servidor; se vier com o comportamento antigo, gere de novo antes de concluir. - Ctrl+Z do editor de cortes não desfaz slider, arraste nem setas (só em dev). Causa: o React em modo estrito roda
o updater do
setStateduas vezes; a chave/hora de agrupamento ficava num ref alterado dentro do updater, e a 2ª execução "agrupava consigo mesma". Correção: o updater é puro — chave e hora moram no próprio estado. Regra para todosetState((s) => …)do painel: nada de ref, relógio ou efeito lá dentro (leiaDate.now()antes). Onde:useHistoryempanel/src/components/clip-editor-model.ts. - Agente do painel morre ao reiniciar o
pnpm panel(execução #5, cena do estádio, ficouinterrupted). Causa: o agente é processo filho do painel, e a abertura do banco marcarunningcomointerrupted(item 99). Correção: não reinicie o painel com agente rodando; se precisar (ex.: migração, item 51), espere terminar. O painel é do usuário. - Agente para no meio por limite de uso (17/11/2026: Claude na #7, "You've hit your 5-hour limit", e Codex na #8,
"You've hit your usage limit"; as duas ficaram
error). A mensagem aparece no console (data/logs/agents/<id>.jsonl); na #7 a colunaagent_runs.errorficou só "success". Correção: abra nova execução no outro provedor com o contexto de onde parou (arquivos já feitos, o que falta); a #8 (Codex) continuou a cenacastawaysda #7 (Claude). - Claude do painel falha com "Failed to authenticate: OAuth session expired". Causa: o painel lança o
claudesemCLAUDE_CONFIG_DIR, ou seja com~/.claude, e o OAuth dessa config estava expirado (17/11/2026), mesmo com outra conta ativa no terminal. Correção: rodeclaudee/loginnessa config, ou suba opnpm panelcomCLAUDE_CONFIG_DIRda conta ativa (o painel é do usuário, item 131). Onde:panel/src/lib/agents.ts. - Execução do agente custa milhões de tokens / dura dezenas de minutos. Causas medidas: (a) Codex abrindo ~100
imagens em resolução cheia (#8: 6,83 milhões de tokens de entrada, 29 min); (b) página web inteira na pesquisa
(#6: 1,06 milhão); (c) custo fixo de plugins/MCP/skills do usuário carregados pela CLI (#7: ~49 mil por chamada);
(d) retomar conversa longa. Correção:
frame_check.py+ uma imagem por render, pesquisa curta, flags enxutas do painel, nova execução em vez de resume. Detalhes em token-economy.md. -c mcp_servers={}não desliga os MCPs do Codex, ecollaboration(spawn_agentetc., ~5,4 mil caracteres) não sai por-c features.*. Causa: o Codex mescla tabelas do-ccom oconfig.toml. Correção: um-c mcp_servers.<nome>.enabled=falsepor servidor (lidos doconfig.toml) eplugins."<id>".enabled=falsepara computer-use. Acollaborationfica; é parte do fixo. Onde:codexLeanOverridesempanel/src/lib/agents.ts.
Serviço de voz (voice/)
Medidas em 16/11/2026, RTX 2060 SUPER 8 GB, Windows 11.
- Whisper na GPU só falha na 1ª inferência com
RuntimeError: Library cublas64_12.dll is not found: octranslate2enxerga a GPU mesmo sem cuBLAS/cuDNN. Correção: aquecimento real na subida (FasterWhisperEngine.warmup(), 1 s de tom sem VAD — com VAD o silêncio não chega ao modelo e a falha passa) e queda para CPUint8com aviso no log. Onde:voice/app/stt.py(warmup),voice/app/main.py; DLLs emvoice/requirements-cuda.txt. - GPU disputada por jogo (98% de uso, 7,4/8 GB): 6,5 s de fala levaram 41–124 s na GPU
contra 2,7 s na CPU; noutra medição (99%, 7,2 GB) a legenda de 6,5 s ficou > 8 min presa na GPU.
Correção:
VOICE_DEVICE=autoconsulta onvidia-smina subida e usa CPU com < 2048 MiB livres ou ≥ 85% de uso (log:GPU ocupada por outro programa (99% de uso, 1593 MiB livres)); depois do reinício a mesma legenda pelo painel levou 2,5 s (14 palavras +.srt). Só vale na subida: jogo aberto depois → reinicie o serviço ou useVOICE_DEVICE=cpu. Onde:voice/app/device.py. - Edge TTS 403 (
WSServerHandshakeErrordespeech.platform.bing.com) desde out/2026 comedge-tts7.2.8. Correção:edge-tts==7.3.1emvoice/requirements.txt, sem patch. - sha256 do Piper divergente: o lock apontava para
resolve/maine o arquivo mudou no Hugging Face. Correção: URL fixada no commite9ab671f2a0e50a701b34361136ba3e6a3a9eb0cemvoice/models.lock.json. Regra: todo peso novo com URL imutável (commit no HF ou release versionado no GitHub) e sha256. - LRU do cache empatava no Windows (
time.time_ns()anda em passos de ~1 ms). Correção:Store._tick()estritamente crescente emvoice/app/store.py. - Caminho Windows em script do
package.json: ocmdnão aceitavoice/.venv/...como executável; use barra invertida, escrita\\no JSON (vertest:voice:cd voice && .venv\\Scripts\\python -m pytest). scripts/setup.ps1precisa ser UTF-8 com BOM: o PowerShell 5.1 lê sem BOM como ANSI e estraga os acentos. Mantenha o BOM ao editar.- GPU detectada como "sem GPU" (RTX 2060 SUPER → torch
+cpu). Causa:nvidia-smi ... | Select-Object -First 1corta o pipeline, o PowerShell mata o processo e$LASTEXITCODE≠ 0. Correção: capturar a saída inteira com@(nvidia-smi ...)e usar[0]. Onde:scripts/setup.ps1. uv pip install torch==2.11.0aceita a variante errada já instalada (2.11.0+cpusatisfaz). Correção: pedirtorch==2.11.0+cu128(ou+cpu) explicitamente. Evidência: na 2ª rodada o uv trocou- torch==2.11.0+cpupor+ torch==2.11.0+cu128. Onde:scripts/setup.ps1.- stderr do uv vira
NativeCommandErrorcom$ErrorActionPreference = "Stop"no PowerShell 5.1. Correção:"Continue"e conferir$LASTEXITCODEemRun(). Onde:scripts/setup.ps1. - Serviço órfão segurando a 4510 (
WinError 10048) após reinício pelovoice/.env. Causa: oexitdo processo antigo chega depois de o novo subir; um sinalizador globalrestartingfazia o lançador sair no--voice-onlye largar o novo processo. Correção:WeakSetdos processos substituídos +process.on("exit", stopAll); checagem de porta livre antes de subir. Onde:scripts/dev.ts. .pthque não é RVC derruba o Applio comKeyError: 'config'. Correção: vira422 rvc_failedcom mensagem clara. Onde:voice/app/rvc.py,voice/app/errors.py.- Edge TTS
NoAudioReceivedintermitente (visto comen-US-AndrewMultilingualNeural, 1ª tentativa). O serviço não repete: vira502 engine_unavailable(EdgeEngineemvoice/app/engine.py). Correção: repetir a requisição (a 2ª deu certo). - Acentos estragados ao testar o Piper na linha de comando no Windows
(
echo ... | python -m piper: "até" vira lixo). Causa: stdin/stdout fora de UTF-8. Correção:PYTHONUTF8=1ouPYTHONIOENCODING=utf-8no teste manual. O serviço não é afetado. faster_whisper.decode_audio(caminho)falha com o PyAV dovoice/.venv(open() got an unexpected keyword argument 'metadata_errors'). Só em teste avulso: decodifique com ffmpeg para PCM 16 kHz mono e passe o array numpy. O serviço não é afetado: decodifica os bytes com o própriovoice/app/decode.py(av.openem memória).- Mudança de código em
voice/app/não entra no ar compnpm dev/pnpm voice. Causa:scripts/dev.tssobe o uvicorn sem--reload; só reinicia sozinho quandovoice/.envmuda. Correção: reiniciar o serviço (o painel é do usuário: peça). Mudança de catálogo (catalog.json,models.lock.json,user-voices.json) não precisa: é relida na próxima consulta de vozes ou síntese. Exceção: voz de motor novo (ex.:kokoro,google,azure,cloneem 16/11/2026) com o serviço ainda no código antigo → a recarga falha (motor desconhecido), as vozes atuais ficam e o log avisa; só aparece depois de reiniciar (start.bat/pnpm dev). O worker de clonagem também só reinicia sozinho quandovoice/.envmuda. kokoro-v1.0.int8.onnxnão roda no onnxruntime 1.31.0 (NOT_IMPLEMENTEDemConvInteger(10)). Correção: usarkokoro/kokoro-v1.0.fp16.onnx(é o que está novoice/models.lock.json).- Kokoro fp16 inunda o log com centenas de avisos "constant folding" do onnxruntime ao criar
a sessão. Correção:
SessionOptions.log_severity_level = 3(e threads limitadas) emKokoroEngine,voice/app/engine.py. Não é erro; ignore se aparecer em teste avulso. - Recarga do catálogo lenta com muitas vozes Kokoro (todas apontam para o mesmo onnx de
~160 MB e o sha256 era recalculado por voz). Correção: cache de
sha256_filepor (caminho, mtime, tamanho) emvoice/app/catalog.py— 62 vozes: 0,3 s → 0,01 s (informado). - Download dos pesos do Chatterbox trava (~3,3 GB de
ResembleAI/chatterboxparadata/voice/models/clone-hf/): o protocolo Xet do Hugging Face baixou 256 MB em 9 min. Correção:HF_HUB_DISABLE_XET=1(com ele baixou tudo); o worker já define isso eHF_HUB_DISABLE_SYMLINKS_WARNING=1. Onde:voice/clone/worker.py. Atenção: a revisão émain, não fixada em commit nem conferida por sha256 (foge da regra domodels.lock.json). - Chatterbox não cabe no
voice/.venv: fixanumpy<2, torch 2.6 e transformers 5.2.0. Correção: venv própriovoice/.venv-clone(Python 3.12, torch/torchaudio 2.6.0+cu124) e worker HTTP separado na 4511, chamado peloCloneEngine. Nunca instalechatterbox-ttsnovoice/.venv. Onde:scripts/setup.ps1(-Clone),voice/clone/requirements.txt. - Fala clonada longa estoura o tempo: ~1,5 s de processamento por s de áudio na GPU (RTX 2060
SUPER) pode passar de
VOICE_SYNTH_TIMEOUT_S=90. Correção: sintetizar textos longos em partes (o worker já divide em trechos ≤ 280 caracteres, mas o tempo total da requisição conta). A 1ª fala inclui o condicionamento da referência (6,0 s de áudio em 20,5 s; a 2ª, 7,1 s em 10,5 s). speednão muda a voz clonada e todo áudio sai com marca d'água inaudível PerTh. Não é defeito: o Chatterbox não tem controle de velocidade. Para outro ritmo, use outro motor.
Clipador (clipper/)
Itens 57–61 observados em 16/11/2026 na live real (twitch.tv/alanzoka) e nos testes. Contexto em
clipper.md.
- Legenda some ou sai deslocada no corte. Causa: com
-ssdepois do-i, o filtroassvê o tempo do bloco, não o do corte. Correção:-ssantes do-i. Onde:clipper/app/editor_render.py(render atual) eclipper/app/media.py(caminho antigo). - Tag ASS inválida na legenda palavra a palavra. Causa:
.upper()na linha ASS inteira transformava a tag\cem\C, que é inválida. Correção: maiúsculas só no texto da palavra. Onde:clipper/app/subtitles.py(build_ass). - Falsos positivos com o chat calmo. Causa: o emote
clip5k1hmmcasava com\bclip, e 3 mensagens já davam razão 2,35. Além disso, o começo da gravação não tinha base de comparação. Correção: "clip" só como palavra inteira, mínimo de mensagens nos 8 s do pico (hoje proporcional, item 68) e 60 s de aquecimento. Onde:clipper/app/scoring.py(Params,warmup_s); há teste de regressão emclipper/tests/test_scoring.py. - Ao vivo, a explosão do chat era cortada cedo. Causa: um pico menor do começo da explosão
fechava antes do pico maior, que ainda estava crescendo. Correção: o pico é escolhido olhando a
série inteira e só depois é filtrado pelo "assentado" (
limit_s). Onde:pick_peaksemclipper/app/scoring.py. - Chat e vídeo desalinhados na Twitch. Causa: o Streamlink pausa durante o anúncio filtrado.
Correção: o tempo da mensagem é convertido pela hora real em que cada bloco chegou (
wall_endda tabelasegments), não pelo relógio desde o início. Onde:clipper/app/worker.py.
Observadas em 17/11/2026 (fase 2) numa cópia do banco da live do skipnho e nos testes:
- Live de chat pequeno nunca gerava corte. Causa: com ~0,15 msg/s, o mínimo fixo de 12 mensagens
nos 8 s do pico era inalcançável. Correção: mínimo = 3× a mediana recente, entre 4 e 12, exigindo
≥ 2 reações (texto ou emote); com chat < 0,5 msg/s o áudio também propõe momentos; e a varredura da
IA cobre o resto. Onde:
_required_messages,_chat_moments,_audio_momentsemclipper/app/scoring.py; varredura emclipper/app/intel.py. - Título preso à frase solta da transcrição ("Jogando três jogos ao mesmo tempo" num momento de
lag). Causa: um único juiz só com texto. Correção: ANALISTA com 6 frames (8 se o trecho passa de 80 s) + glossário de gírias do
chat (
CHAT_GLOSSARY: "server chinês" = lag) e EDITOR que escreve a partir da análise. Onde:clipper/app/judge.py; frames montados emclipper/app/worker.py. - Crédito em cima do rosto no
cam_top. Causa: crédito no topo fica sobre a webcam. Correção: nocam_topo crédito do topo desce para o pé do painel da câmera (cam_panel_height). Onde:clipper/app/subtitles.py. - Cor errada na legenda ASS. Causa: formatos diferentes — a linha
Styleusa&H00BBGGRR&(com alfa) e a tag\cinline usa&HBBGGRR&(sem alfa); ambos em BGR, não RGB. Correção: sempre converter porass_color(Style) ouass_inline_color(tag). Onde:clipper/app/layout.py. - Chat travando ao baixar emotes. Causa: APIs de 7TV/BTTV/FFZ podem demorar (FFZ) ou dar 404
(7TV em canal sem 7TV). Correção: a thread do chat só lê
EmoteCatalog.cached(); o download (names(), cache de 1 h, fonte com falha ignorada) roda em thread à parte ao chegar oroom-id. Onde:ingest_chatemclipper/app/intel.py,clipper/app/emotes.py. - Código novo do Clipador "não funciona" no painel. Causa: o uvicorn sobe sem
--reload; a UI nova (o Next em dev recarrega sozinho) chama rotas ou manda campos que o serviço antigo não conhece — ex.: um serviço anterior aocam_onlyrecusa o projeto do editor que usa esse modo (validate_project→ 400). Correção: reiniciar o Clipador (start.bat/pnpm dev, que é do usuário — peça a ele; ele pode estar gravando). Mesmo padrão do item 53.
Observadas em 16/11/2026 no editor de cortes, numa cópia do banco (sessão 3 do skipnho) e nos testes:
- Projeto do editor recusado com 400. Causa: o Whisper devolve palavra com duração zero (ex.: "queria"
1020,10–1020,10). Correção: palavra com fim ≤ início ganha 50 ms. Onde:
clipper/app/editor.py(leitura das palavras evalidate_project). - Capa sai vazia. Causa: o mjpeg do FFmpeg 7.1 recusa yuv420p marcado como faixa "tv" (blocos do libx264).
Correção: o quadro intermediário da capa é PNG. Em teste, bloco sintético precisa de
-gcurto; senão o-ssnão acha quadro e o grab sai vazio. Onde: capa emclipper/app/editor_render.py;clipper/tests/test_editor.py. - Gancho vira frase longa cortada ou mostra o tempo da gravação ("Aos 5085s, ele solta que…", corte 25 do
skipnho). Causa: o
hookdo analista às vezes é uma frase descritiva. Correção: só vale com ≤ 8 palavras, ≤ 48 caracteres e sem tempo da gravação; senão usa o título do editor. A menção ao tempo é sempre removida e o texto nunca para no meio de palavra (≤ 60 caracteres). Onde:pick_hookemclipper/app/editor.py(usado porauto_projectedefault_project). - Instância de teste do Clipador apaga a gravação real. Causa: a cópia do banco aponta para os mesmos
.ts; o prune porCLIPPER_KEEP_HOURSe o monitor/varredura da cópia agiriam sobre os arquivos e canais reais. Correção: na instância de teste, semprekeep_hours = 0(pula o prune), canais commonitor = 0na cópia e sem monitor/varredura/contexto (subclasse deEngineque só sobe a fila de cortes); porta na faixa 4500–4599 (ex.: 4521). Derrube a instância e apague a cópia ao terminar. Onde:pruneemclipper/app/worker.py. A cópia também herda as sessões: umEnginecompleto retoma asinterruptedna subida (keep_live), pode gravar uma live de verdade e chamar a CLI de IA. Ao terminar, encerre a árvore de processos inteira (uvicorn, streamlink, ffmpeg). Há várias sessões do Claude neste projeto ao mesmo tempo: uma instância na 4521 pode ser de outra sessão — confira antes de derrubar ou usar. - Emoji sai monocromático no vídeo. Causa: o libass do FFmpeg não desenha emoji colorido. Sem correção por enquanto (limitação registrada no README do Clipador); não prometa emoji colorido na legenda ou no gancho.
Observadas em 16–17/11/2026 no rastreio de reação (bancada e calibração numa cópia do banco, sessão 3 do skipnho;
registro em doc/FACE_BAKEOFF.md):
ImportErrorao carregar o MediaPipe. Causa:from mediapipe.tasks import pythonnão existe nomediapipe1.2.3. Correção: importar os submódulos (from mediapipe.tasks.python import vision,from mediapipe.tasks.python.core.base_options import BaseOptions), e só dentro da função (o serviço e os testes sobem sem cv2/mediapipe). Onde: backendmediapipeemclipper/app/face.py.cv2quebrado ou semFaceDetectorYN. Causa:opencv-python-headlessinstalado junto doopencv-contrib-python(os dois brigam pelo mesmo módulocv2). Correção: sóopencv-contrib-python, o que vem com o MediaPipe. Onde: comentário emclipper/requirements.txt.- Risada não aparece no sinal. Causa: em live,
jawOpenquase nunca passa de 0,1 eeyeWide*fica em ~0, mesmo com recorte apertado. Correção: risada sai do sorriso (mouthSmile*), com z relativo ao neutro do próprio streamer; não exija boca aberta. Onde:labeleReactionParamsemclipper/app/reaction.py. - Streamer partido em dois na detecção da câmera. Causa: agrupar os rostos comparando com o 1º membro do
grupo; quando ele se inclinou (0,8 largura de rosto) virou outro grupo. Correção: agrupar pelo centro
(média corrente) do grupo, tolerância
cluster_faces1,0. Onde:locate_camemclipper/app/reaction.py. - "Sustos" falsos. Causa: o rastreio perde o rosto por instantes e o centro "pula", virando movimento grande.
Correção: movimento só rotula (não entra na intensidade) e só vale com rosto em ≥ 80 % do segundo
(
motion_min_present). Onde:clipper/app/reaction.py. - Streamer de neutro sorridente não gera pico (corte 12 aprovado sem pico). Causa: o z é relativo ao normal
dele, que já é alto. Sem correção: limitação do sinal relativo (
smile_rawsó ajuda no rótulo). Por isso o rosto só reforça o corte (bônus ≤ 0,6) e nunca decide sozinho; não o use como juiz.
Observadas em 17/11/2026 nos testes ao vivo do rastreio (instância isolada na 4521; seção "Testes de 17/11 — ao vivo"
de doc/FACE_BAKEOFF.md):
- Live sem câmera ganha "webcam" (twitch.tv/lofigirl). Causa: o YuNet achou um rosto de 24×34 px colado na
borda (a tela de um notebook desenhado) em 8 de 12 quadros, score 0,61–0,66, e o
locate_camaceitou só pela presença estável. Webcam real dá 0,92–0,94. Correção: confiança média do grupo ≥ReactionParams.min_cam_score(0,7). Onde:locate_camemclipper/app/reaction.py; teste emclipper/tests/test_reaction.py. - Instância de teste com banco novo pega a transcrição de outra sessão. Causa: o serviço de voz (4510) é
compartilhado e guarda a transcrição pela chave
clipper-<sessão>-<bloco>; num banco novo as sessões recomeçam do 1 e colidem com as do banco real. Correção: antes da 1ª sessão, subir osqlite_sequencedesessionsdo banco de teste (ex.: 90000), além deCLIPPER_DATA_DIR/CLIPPER_OUTPUT_DIRdentro do repo. Onde: receita em "Variáveis" declipper/README.md; pastas emclipper/app/config.py. - Analista lê "sem reação marcante no rosto" com o plano B. Causa: o OpenSeeFace não tem blendshapes; os canais
saem 0 e o resumo dizia que não houve reação, o que é falso. Correção: com a série da sessão no backend
openseeface,FaceService.summarydevolve "" (nenhuma linha de rosto vai ao analista). Onde:clipper/app/face.py. - WARNING "pesquisa de jogo falhou: IA desligada" a cada 30 s com o juiz
off. Causa:research_pendingtentava pesquisar o jogo mesmo com a IA desligada. Correção: sai cedo sejudge.enabledfor falso (o jogo ficapending). Onde:Intel.research_pendingemclipper/app/intel.py.
Observadas em 16/11/2026 no teste de UI do editor de cortes redesenhado (Chrome sem janela por CDP):
- Teste automático não acha texto, legenda nem chat no monitor Programa. Causa: a prévia é um
<canvas>; as camadas não são elementos do DOM. Correção: mover o ponteiro sobre o canvas e lerstyle.cursor—"move"= há camada arrastável ali (hitAtempanel/src/components/clip-editor-preview.tsx). Trilhas e palavras da timeline são DOM normal. - Teste de UI grava no corte real do usuário. Causa: o editor salva sozinho 1,2 s depois de cada mudança e o
painel (4500) fala com o Clipador real (4520). Correção: interceptar toda requisição não-GET de
*/api/clipper/*(domínioFetchdo CDP) e responder sem repassar; conferir depois que nada mudou. Para simular dados (ex.: sessão em outro estado), altere só a resposta do GET (requestStage: "Response"). Para testar gravação de verdade, use a instância sobre cópia do banco (item 77). Ligue oFetchantes de navegar, senão os GET da carga da página passam sem alteração. Atalho com Ctrl (Ctrl+Z) precisa ir como eventokeyDown.
Observadas em 16–17/11/2026 no serviço do usuário (sessão 3 do skipnho) e no painel; 87–90 também em "Armadilhas já
resolvidas" de clipper/README.md:
- Cortes presos em
renderingsem mensagem; a capa sai e o vídeo não (10 cortes, ids 42–58). Causa: o serviço foi reiniciado no meio de uma edição de código e subiu com uma versão intermediária da legenda (casava a ênfase porid()da palavra →KeyErrorquando o saneamento mudava palavras); a exceção escapava do render e o corte ficava emrenderingpara sempre. Correção: qualquer exceção no render viraerrorcom a mensagem;renderingórfão há5 min volta para
pending(3ª vez =error). Regra: só reinicie o serviço com a suíte verde; agente que editaclipper/app/trabalha numa cópia e aplica no fim por edição pontual (trecho a trecho), nunca sobrescrevendo o arquivo inteiro: vários agentes e outras sessões mexem emclipper/ao mesmo tempo e a cópia inteira apagaria o trabalho deles. Onde:render_clip,recover_orphan_rendersemclipper/app/worker.py. - Live no ar foi para
processingdepois de reiniciar o serviço. Causa: a retomada da subida checava uma vez só, e timeout/erro dostreamlink --jsonpareciam "offline". Correção:Engine.live_checkseparalive/offline/unknownekeep_livetenta de novo (RESUME_DELAYS_S0…120 s); a sessão ficainterruptedenquanto tenta; a captura que cai no meio passa pelo mesmo caminho. Onde:clipper/app/worker.py; testeclipper/tests/test_resume.py. - O mesmo momento vira vários cortes (pico 1149 s → cortes 42, 47, 49, 51, 52 em cima do 9). Causa: o juiz recua o
trecho para antes do pico (ainda mais com
backtrackS120), e a checagem comparava o candidato só com o trecho final dos cortes. Correção: comparar também o pico e a janela original (reasons.candidateStartS/EndS), em qualquer estado, e conferir de novo depois do juiz (judge.duplicateOf). Onde:clipper/app/worker.py(SAME_PEAK_S,SAME_MOMENT_OVERLAP,discard_pending_duplicates); testeclipper/tests/test_render_and_duplicates.py. - Legenda uma em cima da outra com fala rápida. Causa: o fim de cada bloco (fim da última palavra, no mínimo
+0,25 s) passava do início do seguinte e o libass empilha eventos ativos ao mesmo tempo; o Whisper também devolve
palavras de 0 s e palavras que começam juntas. Correção:
clean_words(ordem, 60 ms mínimos, 40 ms entre inícios, sem sobreposição) ecaption_blocks(fim do bloco cortado no início do seguinte); ênfase casada nos tempos originais. Onde:clipper/app/subtitles.py; testeclipper/tests/test_format_and_captions.py. - Texto truncado longo alarga a página
/clipper. Causa: cartão dentro da grade das abas cresce com o conteúdo intrínseco mesmo comtruncate. Correção:[contain:inline-size]no cartão. Onde: cartão da sessão empanel/src/components/clipper-sessions.tsx.
Observadas em 17/11/2026 (duração mínima, tarja do gancho, fontes, reenquadramento, camadas e qualidade de gravação;
103–108 também em "Armadilhas já resolvidas" de clipper/README.md):
- Cortes automáticos mais curtos que o mínimo (mínimo 60: cortes 43 = 54,6 s, 55 = 46,8 s, 61 = 43,8 s). Causa:
auto_projectadiantava o início para oaction_start_sdo analista sem reimpor o mínimo; juiz e varredura limitavam o fim sem recuar o início. Correção: todo corte automático passa porscoring.fit_windowcomlayout.min_target(minS+ 1 s + 0,1 s de folga, ≤maxS); faltando material, cresce para trás. "Cortar agora" e a edição à mão continuam livres. Teste:clipper/tests/test_duration_banner_fonts.py. - Texto da tarja não desfoca na entrada
slide. Causa: com contorno (\bord> 0), o\blurdo libass desfoca só a borda e o preenchimento fica nítido. Correção: duas camadas ASS — preenchimento com\bord0e\blur18→0, e o contorno por baixo. Assentado, sai idêntico ao de antes (0 px de diferença aos 1500 ms, informado). Onde: gancho/textobanneremclipper/app/editor_render.py. - Fonte empacotada ignorada pelo libass (cai numa fonte padrão, sem erro). Causa: o
fontsdirnão lê subpastas, e a família no ASS precisa ser o nome dentro do arquivo ("Poppins ExtraBold", não "Poppins"). Correção:assets/fonts/plana;familyemassets/fonts/fonts.lock.json; no Windows, caminho absoluto entre aspas com:escapado (layout.ass_filter). Ofontsdirsó entra quando o ASS usa fonte empacotada, para o filtro de projetos antigos (e o SHA de referência do vertical) não mudar. - Zoom variável no tempo não sai com
crop. Causa: ocropdo FFmpeg avaliaw/huma vez só (posição por quadro, tamanho fixo);scalecomeval=frame+cropfixo falhou no encoder e arredonda a posição a pixel inteiro. Correção:perspectivecomeval=frame(4 cantos por quadro, subpixel) e depoisscale. O contadorindoperspectivecomeça em 1 (comin/30a janela ia 1 quadro adiantada). Grafo > 20 000 caracteres vai por arquivo (-/filter_complex). Onde:perspective_filteremclipper/app/reframe.py;editor_render.py. - Quadro errado ao buscar dentro de um bloco
.ts. Causa: o demuxer mpegts trata todo pacote como ponto de busca;-ssantes do-icai num quadro P → em H.264 sai o próximo quadro-chave (até 2 s depois), em HEVC sai quadro cinza (frames do juiz, capa e YuNet; a câmera não era achada). Um 2º-ssdepois do-itambém erra com áudio no bloco. Correção:media.seek_argsbusca 4 s antes,-copyts -start_at_zeroeselect='gte(t,alvo)'(usado porgrab_frameeface.grab_bgr). Render e proxy (concat demuxer) já buscavam certo. - Vídeo para no meio do corte, sem erro (corte de 35 s com 20 s de vídeo). Causa: o trecho atravessa a emenda de
uma retomada em outra resolução ou codec (H.264 → HEVC) e o concat +
filter_complexcorta o vídeo ali. Correção:uniform_segments(editor_render.py) converte os blocos do trecho num intermediário uniforme só nesse caso (render e proxy); o proxy fazfpsantes doscale;face.pymede o tamanho do quadro por bloco.
Observadas em 17/11/2026 (diagnóstico da sessão 3, cartão da sessão, apagar cortes e prévia do editor; 114 também em
"Armadilhas já resolvidas" de clipper/README.md):
- "Não está gerando cortes". Causa quase sempre: a live esfriou, não as regras. Sessão 3 (cópia do banco):
chat de 0,27–0,39 msg/s e 56–78 reações a cada 500 s caiu para 0,04–0,10 msg/s e 2–10 reações; nenhum pico da
heurística em 8872–10350 s, nem com as regras antigas; as antigas dariam 3 candidatos a mais (2 de rosto fraco com
nota 2,5 e 1 na cena do corte 61, rejeitado); zona proibida 34 % × 24 %. Correção: antes de mexer em regra, olhe
msg/s e reações (
GET /v1/sessions/{id}/timeline) eproposals/createdda varredura emsessions.memory_json(e no log). Onde:clipper/app/intel.py(contagem),worker.py(VETO_STATUSES). - "Agora na live" parece travado e o tempo gravado anda aos saltos. Causa: o resumo só muda a cada janela da
varredura (
scanIntervalS, 180 s) edurationSsobe por bloco (30 s). Correção: relógio local que corre entre as consultas, com teto de 45 s ("aguardando o bloco"), e contagem "próximo em m:ss". Onde:RecordingClockeSummaryCadenceempanel/src/components/clipper-sessions.tsx. - Barra de seleção presa no topo da fila reprovada pelo dono. Causa: ação em massa ocupando espaço e cobrindo
o conteúdo. Correção: controles discretos no canto ("Selecionar", "⋯"), caixa do cartão só no hover/foco/modo de
seleção e pílula flutuante pequena; nada pode empurrar a lista. Vale para toda ação em massa nova. Onde:
panel/src/components/clipper-queue.tsx. - Prévia do editor 1–3 px deslocada do render (corte 61, câmera 18 % × 23 %) e blocos de legenda diferentes.
Causa: o FFmpeg recorta em pixel par no yuv420 e o
scale … increasearredonda; a prévia dividia em subpixel; a legenda do painel não saneava os tempos comosubtitles.py. Correção:ffmpegCropFillcom o tamanho desession.capturee portecleanWords/groupWords/captionBlocks(CAPTION_TIMING). Onde:panel/src/components/clip-editor-model.ts; mudousubtitles.pyoulayout_chain, mude o porte junto. - Juiz do Clipador esgota a cota do ChatGPT / chamadas lentas e caras. Causa: cada chamada do juiz é um processo
novo de CLI (2 por candidato) e o Codex carrega ~77 mil caracteres fixos (~19 mil tokens) antes do prompt; uma live de
3,7 h (75 candidatos, ~150 chamadas) gastou ~2,9 milhões de tokens só de fixo. Correção:
codex_lean_overrides(features/MCP/plugins off,systememmodel_instructions_file) e--setting-sources project,localno Claude. Só vale depois de reiniciar o Clipador (porta 4520): o código é lido na partida. Detalhes em token-economy.md. Onde:clipper/app/judge.py.
Publicação (Publicador + despachante do painel)
Regras de projeto informadas em 17/11/2026 (código em panel/src/lib/publishing*.ts e publisher/app/); nenhuma
observada num envio real ainda. Contexto em publishing.md.
-
Job em "Com problema" dizendo que o Publicador terminou sem confirmar o link. Causa: o Publicador devolveu
donesemremoteId/url(comum no modo sessão quando a tela não mostra o link). Correção: por regra nunca virapublishedsem ID/URL (ou rascunho) —readPublisherJobgravafailed. Confira na rede antes de "Tentar de novo", senão o vídeo sai duas vezes. Mesmo cuidado comfailed"interrompido" (Publicador fechado no meio). Todofailedque chegou ao Publicador temmayBeLive: a UI pergunta "Confira na rede se o vídeo já saiu" e a API responde 409 aoretrysem{confirm: true}(retryJobempublishing.ts). -
Job parado em "Esperando: …" sem falhar. Causas, nesta ordem: painel fechado (o laço de 20 s roda dentro do
pnpm panel); publicação pausada em Configurações; Publicador fora (503 → "inicie com pnpm dev"); perfil nãoconnectedno Publicador (409 → o job fica na fila e a rede é reconsultada); "Publicador indisponível ou mal configurado" (401/403/404:PUBLISHER_SERVICE_KEYdiferente ou Publicador antigo — reinicie opnpm dev). Timeout/conexão caída também deixa na fila: o reenvio usa o mesmoclientRefe não duplica. Onde:sendDue. -
Rede em
expiredouneeds_login. Causa: autorização oficial vencida (ex.: YouTube em "Testing" vence em 7 dias) ou a rede pediu login/captcha no modo sessão. Correção: reconectar em Canais de publicação ("Entrar de novo"/reabrir a janela); nunca automatizar login nem captcha. -
Jobs de um corte cancelados sozinhos. Causa: exportar no editor (ou re-renderizar) volta o corte para
pending; jobs não enviados viramcanceledcomcancel_reason = 'source_changed'. Encerrar a fonte ou a história no canal faz o mesmo comunlinked("a fonte/história foi desligada deste canal"). Correção: nenhuma — voltam sozinhos quando o corte fica pronto de novo ou a fonte é religada. Já enviado não é cancelado. -
Ligou a aprovação automática e os cortes antigos não saíram. Não é erro: só cortes criados depois de ligar (
accounts.auto_since) e depois de ligar a fonte ao canal são aprovados sozinhos; religar uma fonte encerrada zeralinked_at, então os cortes do intervalo desligado também não. Antigos: aprovar à mão. -
"Na hora" virou agendado. Causa: limite diário da rede (
daily_limit) já atingido; vai para o próximo horário bom livre. Correção: subir o limite ou esperar. -
TikTok oficial publica só como "Somente eu". Causa: app sem auditoria só permite
SELF_ONLY(conta privada) e a auditoria para uso próprio provavelmente é negada (doc/publicacao/PESQUISA.md). Correção: modo Rascunho (tiktok_mode = 'draft', até 5 pendentes/24 h) ou sessão logada. -
API do painel responde 403 "Acesso recusado…" ou 415 a
curl/script. Causa:panel/src/proxy.tssó aceita Host 127.0.0.1/localhost/[::1] e exige, em POST/PUT/PATCH/DELETE,Origindo mesmo host (ouSec-Fetch-Site: same-origin), senão "Acesso recusado: pedido sem origem do próprio painel";readJson(lib/http.ts, usado em parte das rotas; as outras leemrequest.json()direto) exigeContent-Type: application/json. Correção:curl -X POST -H "Origin: http://127.0.0.1:4500" -H "Content-Type: application/json" -d '{}' http://127.0.0.1:4500/api/.... Não afrouxe a guarda (anti DNS rebinding e CSRF; teste empanel/src/lib/proxy.test.ts). -
Agendado saiu em outro horário depois de reabrir o painel. Causa: horário automático (
schedule_source = 'auto') vencido há > 30 min (STALE_AFTER_MS) é reencaixado no próximo horário bom, sem rajada. Horário manual e "Publicar agora"/"Tentar de novo" não são reencaixados. Onde:needsReflow(publishing-rules.ts),promoteDue. -
Conectar pela API oficial não conclui. Causas: o Publicador reiniciou no meio (o
code_verifierdo PKCE fica só em memória) ou o passo a passo parou de esperar (10 min,WAIT_LIMIT_MSemconnect-wizard.tsx). Correção: clicar Conectar de novo. -
Janela do navegador do modo sessão fecha sozinha. Não é erro: fecha depois de cada envio e do "Já entrei" (saída limpa; mata após 10 s) e quando ociosa (5 min; 15 min se aberta para login), para a porta CDP ficar aberta o mínimo. Fica aberta se a rede pedir login/captcha. Onde:
publisher/app/platforms/session/browser.py. -
Modo sessão: o Chrome abre, a conta está logada, a porta 4540 responde em
/json/version, mas o painel diz "O navegador abriu mas não respondeu". Causa (17/11/2026): o Chrome 157 (157.0.8103.79) não gravaDevToolsActivePortno perfil quando a porta é fixa (--remote-debugging-port=4540), eowns_portdependia só desse arquivo. Correção:owns_portusa oDevToolsActivePortquando existe; senão usa a marcaCenaForgeWindow.json({"pid","port"}, gravada porwrite_window_marklogo depois doPopen) e exige que o PID que escuta na porta (listener_pid,GetExtendedTcpTablevia ctypes, sem psutil) seja exatamente o da marca e que o executável (process_exe_name,QueryFullProcessImageNameW) sejachrome.exe/msedge.exe.active_porttambém lê a marca;open()apaga marca eDevToolsActivePortvelhos. Medido ao vivo:listener_pid(4540)=chrome.exelançado pelo Publicador (o PID doPopené o próprio processo que escuta). Só vale depois de reiniciar opnpm dev(o Publicador roda sem--reload). Variante: se o processo sai logo, o Chrome entregou a URL a uma janela já aberta com o mesmo perfil (sem a nossa porta);_wait_cdp(port, user_dir, process)detecta e mostra "Já existe uma janela do navegador aberta com este perfil. Feche essa janela (a conta continua logada) e tente de novo." — feche a janela, não mexa no código. Testes:test_owns_port_without_devtools_file_uses_window_marketest_wait_cdp_explains_when_profile_window_is_already_openempublisher/tests/test_hardening.py. Onde:publisher/app/platforms/session/browser.py. -
"Publicar" no cartão do corte (ou desligar fonte) falha com "table publish_jobs has no column named origin". Causa (17/11/2026,
POST /api/publishing/clips/75): a v7 do banco (publish_jobs.origin) não tinha sido aplicada no banco já aberto;INSERT ... origineaccounts.endChannel(AND origin = 'link') quebram. Hoje odb()migra sozinho: a conexão fica emglobalThis.__cenaforgeDb, e a marca de módulocheckedThisModule(some a cada recarga do código pelo HMR) faz a 1ª chamada depois da recarga rodarmigrate()no banco aberto, com backup emdata/backups/(cenaforge-v<antiga>-<data>.db). Medido: umGET /api/publishing/summaryno painel em execução levou o banco real auser_version7, com a colunaorigine o backupcenaforge-v6-2026-11-17T16-28-39-725Z.db. O sintoma ainda aparece se o própriodb.tsnão foi recarregado (módulo antigo, sem a marca); na prática qualquer edição emdb.tso recarrega. Correção: fazer qualquer requisição ao painel (ex.:GET /api/publishing/summary, comOriginse não for GET, item 125) ou, se ainda falhar, pedir ao usuário que reinicie opnpm dev(o painel é dele; reiniciar mata agente em execução, item 131). Conferir:PRAGMA user_versiondedata/cenaforge.db=MIGRATIONS.length. Onde:db()empanel/src/lib/db.ts,publishClipempanel/src/lib/publishing.ts. -
Modo sessão (TikTok): job falha com "Locator.set_input_files: Cannot transfer files larger than 50Mb to a browser not co-located with the server", embora o login e a navegação tenham funcionado. Sintoma (17/11/2026): a captura
data/publisher/logs/20261117-133245-tiktok-*.pngmostra o TikTok Studio logado na tela "Selecione o vídeo a enviar"; a falha foi só na entrega do arquivo. A mensagem ao usuário é a genérica "O navegador travou ou mudou de página no meio do envio" (todoPlaywrightErrorcai nela,_with_page); o texto real vem depois de "Detalhe:". Causa: comconnect_over_cdpo Playwright trata o navegador como remoto e recusaset_input_filesacima de 50 MB; os cortes do Clipador têm 100–108 MB (clip-52.mp4com 107,9 MB). Correção:is_local=Truenoconnect_over_cdp(parâmetro existe no playwright 1.65.2 dapublisher/.venv, conferido na assinatura), em_with_page(runner.py, com comentário) e emBrowserManager.close(browser.py). Só127.0.0.1com porta conferida como nossa (owns_port); não use para endereço remoto. Só vale depois de reiniciar opnpm dev(o Publicador roda sem--reload). Evidência:pnpm test:publisher→ 73 passed (reexecutado na skill, 17/11/2026); envio real ainda não refeito. Ao ver "travou ou mudou de página", leia o "Detalhe" antes de culpar o navegador. Onde:publisher/app/platforms/session/runner.py,publisher/app/platforms/session/browser.py. -
TikTok em modo sessão publicou, mas o job falhou com "não confirmou o link". Sintoma (17/11/2026, 1º envio real, público às 13:35): o vídeo está no ar (
https://www.tiktok.com/@vortplay/video/7709179978520284437) e o painel marcoufailed. Causa: depois de publicar, o Studio vai para/tiktokstudio/content, mas a linha nova só mostra o<a href="/@conta/video/<id>">alguns segundos depois; o código antigo procuravaa[href*='/video/']por só 5 s. Correção (2ª versão, 17/11/2026):find_video_url(page, caption, sleep, attempts=12, reads=5, progress)espera 5 s e, a cada tentativa, abre ou RECARREGACONTENT_URL(a lista não se atualiza sozinha; o vídeo novo entra depois de processar), lê 5 vezes a cada 3 s, até 12 cargas (~3 min), e só aceita o link da linha (até 10 ancestrais do<a>) que contémcaption_key(caption)(24 primeiros caracteres da legenda sem #hashtags/@menções): nunca pega o link de outro vídeo. Sem link: step "…não apareceu na lista do Studio em ~3 min; link não encontrado"; o painel mostra "Saiu na rede, mas o link do vídeo não apareceu a tempo… use 'Já saiu: informar o link'" (readPublisherJob). O seletorvideo_linksaiu deSELECTORS. Validado ao vivo, só leitura (informado): legenda certa → link; legenda de outro corte →None. Se acontecer de novo: confira na rede antes de "Tentar de novo" (publicaria duas vezes) e use "Já saiu: informar o link" (mark-published,publishing.md). Só vale depois de reiniciar opnpm dev(item 137). Teste:test_tiktok_link_waits_for_the_list_and_matches_caption(publisher/tests/test_browser.py). Onde:publisher/app/platforms/session/tiktok_studio.py. -
Job manual novo cancelado como "unlinked" (regra antiga) ou despachante ignorando código novo. Causa: o laço de
panel/src/instrumentation.ts(startDispatcher) guarda a funçãotickemglobalThise o HMR não a substitui; o laço seguia com odispatcherTickantigo (sem a regra deorigin = 'manual'). Correção: no fim depanel/src/lib/publishing.ts, ao carregar o módulo,if (state.tick && state.tick !== dispatcherTick) state.tick = dispatcherTick. Regra: todo estado de laço guardado emglobalThisprecisa ser reapontado quando o módulo recarrega. Se o sintoma voltar com outro módulo, aplique o mesmo padrão; reiniciar opnpm devé do usuário (item 131). Onde:panel/src/lib/publishing.ts(bloco final),panel/src/lib/dispatcher.ts. -
Modo sessão (TikTok): falha com "Locator.click: Timeout 30000ms exceeded … waiting for locator("div[contenteditable='true'].public-DraftEditor-content")". Sintoma (17/11/2026): a captura
data/publisher/logs/20261117-134508-tiktok-*.pngmostra o vídeo já carregado e, por cima da página escurecida, um aviso de novidade do Studio, "Veja a prévia do seu vídeo no seu celular", com o botão Entendi. Causa: o aviso bloqueia o clique na legenda (o seletor está certo). O Studio também pré-preenche a legenda com o nome do arquivo ("clip-75"), masfill_textjá faz Ctrl+A/Delete. Correção emcommon.py:TIP_BUTTONSaceita só^(Entendi|Entendido|Ok, entendi|Got it)$;dismiss_tips(page, sleep, rounds=3)fecha esses avisos;click_through(locator, sleep, timeout_ms=8000)clica e, no timeout, fecha os avisos e tenta de novo (sem aviso para fechar, relança o erro original);fill_textusaclick_through. Emtiktok_studio.py,dismiss_tipsroda antes da legenda e antes de "Publicar", e todos os cliques (privacidade, mostrar mais, IA, Publicar, Publicar agora) passam porclick_through. Regra: por esse caminho só se fecham avisos de "entendi"; nunca aceitar ou recusar opções (verificação de conteúdo, música etc.). Outro aviso novo com outro texto de botão: acrescente-o aTIP_BUTTONSsó se fechá-lo não mudar o post. Mensagens:browser_error_text(detail)emrunner.pytroca o genérico "O navegador travou…" por frases para clique com timeout ("aviso do site aberto por cima…"), timeout comum, arquivo > 50 MB e janela fechada; o "Detalhe" técnico continua depois. Testes:test_click_through_closes_tip_and_retriesetest_browser_error_text_explains_common_failures(publisher/tests/test_browser.py);pnpm test:publisher→ 76 passed (reexecutado na skill, 17/11/2026). Só vale depois de reiniciar opnpm dev(item 137); o post desse envio não chegou a ser feito e a correção não foi testada num envio real. O upload de 100+ MB funcionou nesse envio, o que indica que ois_local(item 139) já valia. Onde:publisher/app/platforms/session/common.py,publisher/app/platforms/session/tiktok_studio.py,publisher/app/platforms/session/runner.py. -
Corrigi o código, mas o envio/corte seguinte ainda se comportou como antes. Sintoma (17/11/2026): o envio das 13:50 no TikTok durou 25 s, menos que a busca nova do link, e saiu sem link. Causa: o processo do Publicador (uvicorn :4530) começou às 13:34:25;
tiktok_studio.py(13:46),common.pyerunner.py(13:46–13:47) foram gravados depois, e o serviço roda sem--reload: rodou o código ANTIGO. Vale também para o Clipador (:4520) e a voz. Diagnóstico: comparar o início do processo com a data dos arquivos, antes de culpar a correção:Get-CimInstance Win32_Process -Filter "Name='python.exe'" | Select ProcessId,CreationDate,CommandLine(PowerShell) eGet-Item <arquivo> | Select LastWriteTime. Arquivo mais novo que o processo = reiniciar opnpm dev(do usuário, item 131). Só dê "validado" a mudança em serviço depois de confirmar que o processo é posterior ao arquivo. -
Legenda do corte com
#RobRune#ROBRUNalternando ou tags genéricas (#clã,#loot). Causa (antes de 17/11/2026): o juiz escrevia 3–5 hashtags livres na legenda. Hoje a legenda sai debuild_caption(clipper/app/hashtags.py): texto sem hashtags, tags decompose(canal, até 3 do jogo, até 4 do momento, sem repetidas porfold, até 8) e crédito. Se o perfil do jogo não temhashtags(caso do ROB RUN até a pesquisa ou a edição), vale só o nome do jogo (#ROBRUN): use "Pesquisar de novo" ou edite a seção "Hashtags" na aba Jogos. Legenda de corte antigo não muda; só corte novo ou "Mandar de novo para a IA". Só vale depois de reiniciar o Clipador (item 143). Teste:clipper/tests/test_hashtags.py. -
Modo sessão (Instagram): "Já entrei" responde "não achei o botão Criar do Instagram" com a conta logada. Causa (17/11/2026, inspecionado ao vivo): no layout novo a barra lateral só tem ícones; o botão é
<a>com<svg aria-label="Postar">e abre direto o diálogo "Criar novo post" (sem submenu), com oinput[type=file]dentro do diálogo. O usuário também rodava código antigo (item 143). Correção:SELECTORS["create"]aceita "Postar" (svg, link, botão); mensagem "botão Postar". Risco ligado: no feed cada post tem um botão de ícone "Compartilhar", erole=button ^Compartilhar$podia clicá-lo;next,shareereels_notice_okagora são CSS presos a_DIALOG(div[role='dialog']). Teste:test_buttons_of_the_flow_are_searched_inside_the_dialog. Onde:publisher/app/platforms/session/instagram_web.py. Fluxo e validação: publishing.md. -
Instagram: rótulo de IA não liga, ou a legenda troca
#testepor#testemunho. Causa: com a legenda terminando em#tag/@menção, o Instagram abre a lista de sugestões POR CIMA dos interruptores; um clique forçado (force=True) no rótulo de IA caiu na lista (ensaio de 17/11/2026). O interruptor éinput role=switchsem nome acessível (achado pelo texto da linha,find_ai_switch). Correção:close_suggestionsdigita um espaço no fim (Esc NÃO serve: fecha a caixa de criação); clique forçado removido; depois do clique_is_onconfere e, se não ligou,PublishError(não publica sem o rótulo). Teste:test_instagram_links_and_hashtag_suggestions. Regra geral: nuncaforce=Trueem seletor de modo sessão (clica no que estiver por cima). Para validar seletor com conta real sem publicar, rode sópreparee descarte o rascunho. -
Instagram: o reel saiu em 1:1 (quadrado), sem o topo do rosto do streamer; o TikTok saiu certo. Sintoma (17/11/2026, 1º reel real
/reel/Df2cezTNhY7/, corte 68). Causa: a etapa "Cortar" do diálogo vem em 1:1 e o fluxo clicava em "Avançar" direto. Correção:keep_original_shape(page, sleep)(instagram_web.py), chamada emprepareantes dos "Avançar": clica emsvg[aria-label='Selecionar corte'](ou 'Select crop') dentro do diálogo, escolhe "Original" (opções: Original, 1:1, 9:16, 16:9) e fecha o menu. Sem o ícone ou sem a opção,PublishError: não publica cortado. Sub-armadilha: o botão "Original" tem o texto mais o<title>do svg ("Ícone de contorno de foto"), então:text-is('Original')não casa; usa-se("role","button", r"^\s*Original\b")e:has-textno diálogo. Tambémcommon.findcomvisible=Trueagora olha até 6 ocorrências (nth) até achar uma visível (a primeira pode ser cópia escondida); os falsos de teste ganharamnth. Validado (informado): ensaio sem publicar mostrou a prévia "Novo reel" com o vídeo inteiro 9:16, rosto completo, legenda e rótulo de IA; rascunho descartado. O usuário apagou o reel cortado à mão (a página mostra "Esta página não está disponível"). Só vale depois de reiniciar opnpm dev(item 143); nenhum envio real feito com o formato novo. Onde:publisher/app/platforms/session/instagram_web.py(SELECTORS["crop_toggle"],["crop_original"]),common.py. -
Corte publicado com rótulo de IA, ou "Perfil gerado por IA" sob o nome no Instagram. Regra (pedido do dono, 17/11/2026): corte nunca leva rótulo de IA. Em
sendDue(publishing.ts):aiGenerated = job.source_kind === "clip" ? false : aiGeneratedFor(...), mesmo com o canal em "always". O texto "Perfil gerado por IA" visto no reel NÃO veio do post: o job tinhaaiGenerated: Falsee o canal estava emai_label=auto. Provável rótulo do PERFIL (talvez foto de perfil feita com IA e metadados); não confirmado. Episódio segue a regra deaiGeneratedFor. -
Vídeo publicado foi apagado na rede e o painel ainda o mostra como publicado (ou não deixa publicar de novo). Correção: ação "Apaguei na rede" (
removed), só em jobpublished.markRemoved(id)(publishing.ts) faz UPDATE condicional paracanceled/user, zeraurl,remote_id,published_at, grava o step "Apagado da rede por você…" e apagapublications WHERE job_id(métricas saem em cascata). Depois, "Publicar" no corte reenvia comattempts+1 (novoclientRef). O painel NÃO apaga nada na rede: apague direto lá primeiro (a UI confirma). RotaPOST /api/publishing/jobs/[id]/removed; clientemarkJobRemoved; botão em Publicadas (publishing-board.tsx). Usada no job 3 (Instagram do corte 68). Teste empublishing-db.test.ts. -
Script Python de diagnóstico com
-Iimprime?/falha ao escrever acentos no Windows.python -IignoraPYTHONIOENCODINGePYTHONUTF8. Correção: no script,sys.stdout.reconfigure(encoding="utf-8"). -
YouTube Studio (modo sessão): "Cliquei em Publicar mas o YouTube Studio não confirmou", e o vídeo saiu. Sintoma (17/11/2026): a captura 60 s depois do clique mostrava a caixa de envio ainda aberta, com o botão Publicar. Causa provável (não isolada):
#done-buttoné umytcp-button, não<button>nativo; o Playwright clica nele mesmo desativado e o clique se perde. Correção:is_enabled/wait_enabled(lêdisabled/aria-disableddo elemento e do<button>interno; espera até 10 min),dismiss_tips+click_throughantes de clicar econfirm_published(45 checagens de 2 s; aceita "publicado", "sendo processado" ou a caixa fechar; se o botão segue liberado depois de ~16 s, clica de novo UMA vez). O erro final traz o link visto antes do clique: confira na rede e use "Já saiu: informar o link" (nunca "Tentar de novo" sem conferir). Teste:test_youtube_confirms_when_upload_box_closes_and_retries_once. Só vale depois de reiniciar opnpm dev(item 143). Onde:publisher/app/platforms/session/youtube_studio.py. -
Números do Instagram vêm só com views (curtidas e comentários faltando). Causa: a grade da aba Reels aparece ANTES da resposta de
/api/graphql; parar ao achar a grade perdelike_count/comment_count. Correção: a API tem prioridade e a grade só entra como reserva depois de 3 voltas (instagram_stats,session/stats.py). TikTok e Instagram não têm leitura sem janela logada (página pública devolve só verificação ou nada). Ver publishing.md. -
Corpo JSON com acento por
curl -dno Git Bash chega com UTF-8 inválido (jsontext: invalid UTF-8). Correção: gravar o corpo num arquivo (scratchpad) e enviar com--data-binary @arquivo, comOrigineContent-Type(item 125). Mesmo comcurlo nome "Verificação" virou idteste-verifica-ona API de personagens (17/11/2026): teste acentos por Python/UTF-8. -
Publicar o repositório (Gitea) expondo segredo ou e-mail pessoal. O projeto é PÚBLICO em
https://git.origininteractivestudios.com/Mateuus/CenaForge(Gitea 1.27.3; 1º commit84f30bb, 484 arquivos, ~7,4 MB, 17/11/2026). Fora do git:data/,.env, venvs (incluipublisher/.venv/) eoutput/. Commits neste repositório usam o e-mail noreply do Gitea (git configlocal). Antes de subir: procurar segredos (chave do serviço do Publicador, tokens, e-mails) nos arquivos que vão. Commit e push só quando o dono pedir. -
Capa do vídeo publicado some do dashboard ("Views de cada vídeo") com imagem quebrada. Causa: apagar uma sessão no Clipador (
worker.delete_session) fazrmtreedeoutput/clipper/<sessão>/, levando vídeo e capa, epublish_jobs.coverapontava para lá. Correção (17/11/2026):clipCover()copia a capa paraoutput/publishing/covers/clip-<id>.<ext>(pasta só do painel,keepCover);keepClipCovers()migra jobs antigos no início desyncClipsenquanto o arquivo existe (22 de 25 na hora);metrics.tssó devolve capa que existe no disco. Capa já perdida: a miniatura do próprio Short serve,https://i.ytimg.com/vi/<remote_id>/oar2.jpgé a vertical 1080×1920 (maxresdefaulté 1280×720 horizontal); foi o que se fez no corte 91. Junto: emmetrics.tsa regex do episódio era/^ep(d+)/i(faltava a barra) e o link ia só para a história; agora/^ep(\d+)/i. Onde:panel/src/lib/publishing.ts,panel/src/lib/metrics.ts. -
Cartoon: a síntese de voz não devolve tempos por palavra.
POST /v1/synthesizesó entrega o áudio; tempos vêm da transcrição (/v1/transcribe,X-Detail: words).wordTimingstranscreve o áudio do trecho; sem o serviço de voz, reparte o texto pela duração (aproximado). A montagem antiga (FFmpeg) reparte a legenda por tamanho (captionChunksemmontage-ffmpeg.ts). Onde:panel/src/lib/montage-cartoon.ts. -
Cartoon: o plano sai genérico (rua de casas, noite) quando o texto não cita um lugar conhecido. Observado (17/11/2026, antes dos lugares por peças): história de ilha/cobras saiu em rua de casas. Hoje
LOCATIONScobre 10 lugares (parque, cemitério, bunker, casa…); fora deles cai nas cenas antigas (scenes.tsx, da história de energia). Lugar novo = linha emLOCATIONS(+ peça emplaces.tsxse faltar), nunca cena pronta. Sem lugar, prefiramixed/3d. Onde:panel/src/lib/montage-cartoon.ts. -
TikTok:
#hashtagpublicada vira texto, não hashtag. Diagnóstico (doc/publicacao/TIKTOK_DIAGNOSTICO.md): a página pública do vídeo mostravachallenges: []etextExtra: [], porqueinsert_textcola#tagcomo texto puro. Correção:caption_partssepara texto e tags;type_captioncola o texto, digita cada#tage confirma clicando na sugestão exata (hashtag_options); sem sugestão a tag fica como texto; progresso "N de M hashtags confirmadas". Teste:publisher/tests/test_tiktok_caption.py(3, não reexecutado na skill). Não validado com vídeo real; só vale depois de reiniciar opnpm dev(item 143). Onde:publisher/app/platforms/session/tiktok_studio.py. -
Ler várias páginas públicas do TikTok seguidas devolve o desafio anti-robô
SlardarWAF(1.462 bytes) paracurl/yt-dlp. Um Chrome real passa. Receita para baixar um vídeo de referência (informada, não reexecutada): Playwright comchannel="chrome"e perfil temporário, ler__UNIVERSAL_DATA_FOR_REHYDRATION__(itemStruct.video.bitrateInfo[].PlayAddr.UrlList) e baixar porctx.requestcomReferer: https://www.tiktok.com/. Só para referência/estudo; nunca em stealth no fluxo de publicação (regra em publishing.md). -
Cartoon: HUD, gerador e onomatopeia do exemplo aparecem em todo trecho. Causa: a Remotion completa props ausentes com os
defaultPropsda composição; com o exemplo como padrão, tudo que o spec não trazia vinha do exemplo. Correção:Shottem padrão VAZIO; o exemplo fica na composiçãoSample(só Studio). Campo opcional novo no spec precisa de valor vazio emBLANK. Onde:cartoon/src/Root.tsx. -
Cartoon: o plano errava o assunto do trecho. "um barulho" solto virava "Vrrrum" (agora motor só com gerador/motor/moto/carro perto; barulho genérico = "Crec"); "domingo de sol" virava noite (regra de dia ganhou sol/manhã/domingo/claro); multidão era desenhada na frente do personagem (agora entra antes, pés em y 0,6); onomatopeia cobria a etiqueta do personagem (vai para x 0,76 / y 0,24 quando há personagem). Ao mexer em palavra-chave, rode
montage-cartoon.test.ts. Onde:panel/src/lib/montage-cartoon.ts. -
Regex com
\bescrita por heredoc/Python sem string raw vira um caractere de controle (backspace, 0x08) (aconteceu 2x ao editarmontage-cartoon.ts): a regex deixa de casar, sem erro. User"..."ou o Edit (item 44) e confira comgrep -nP "\x08" <arquivo>que não sobrou nenhum. -
Cartoon: a boca (curva quadrática) só chega à METADE do ponto de controle. Controles da boca ficam no dobro da abertura desejada. Onde:
cartoon/src/CharacterFigure.tsx. -
Script de teste em Python que grava JSON com
open(..., "w")semencodingestraga acento no Windows (cp1252; o render lê UTF-8). Sempreopen(..., "w", encoding="utf-8")(eensure_ascii=Falsese quiser acento legível). Mesma família do item 153. Onde: ao gerarcharacter.json/spec por script. -
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. -
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,stopnão pausa,languagenã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 confiraPRAGMA user_version= 11. Onde:clipper/app/worker.py,main.py(StopIn),db.py(v11); testeclipper/tests/test_monitor_pause_and_language.py. -
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,DELETEe?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 confiraPRAGMA user_version= 12. (b) Jogo antigo temprofileAi: null: a IA usa o português até rodarPOST /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 emaliases; 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 eerrorexplica. Onde:clipper/app/intel.py(import_seeds,add_game,translate),main.py,db.py(v12),seeds/games/; testeclipper/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.
- 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. CODEX_API_KEYsó vale nocodex 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 usecodex login --with-api-key, que troca o login global. Mesma regra paraANTHROPIC_API_KEYeGEMINI_API_KEY. Onde:providerEnvempanel/src/lib/ai.ts.- Terminal de login no Windows: aspas do
cmde caminho com espaço ("Program Files"). Forma que funcionou:cmd /d /c start "<título>" cmd.exe /k "<linha>"comwindowsVerbatimArguments: true(testado com caminho em "Program Files"); sem o modo verbatim o Node reescreve as aspas (causa não isolada). Onde:openLoginTerminalempanel/src/lib/ai.ts. - 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
mtimededata/ai/vault.bin; o Clipador lê comctypes(clipper/app/ai_settings.py). Não leia o cofre por requisição sem o cache. - 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/bine o npm%APPDATA%\npm. Correção:resolveCommandprocura nesses dois lugares além do PATH; mesmo assim, instalar e não ver = "Verificar" de novo na tela. Gemini no Windows: ogemini.cmdexige shell, então rodanode …/@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.cmdsem shell: item 28.- Script de patch com regex (
\b) passado por heredoc: item 44. - Publicador roda sem
--reload: mudança empublisher/app/só vale depois de reiniciar opnpm dev(itens 137, 139, 140, 142, 143, 145 e 147; o Clipador também: 144). - Migração do painel (v3 … v10) é aplicada na 1ª requisição depois da recarga do
db.ts; reiniciar opnpm panel/pnpm devsó se isso não bastar: itens 51 e 138 (reiniciar mata agente em execução: item 131).