Files
CenaForge/panel
MateuusandClaude Opus 5.5 377536f778 Clipador: quem fala cada palavra (streamer × outra pessoa) e legenda em duas linhas
A fala de colegas no Discord e de outros jogadores saía na legenda como se fosse do
streamer. Agora cada palavra tem falante:

- voz: cada trecho de fala vira uma impressão de voz (WeSpeaker ResNet34-LM, ONNX,
  pesos CC-BY-4.0) na análise do bloco (~0,2 s de CPU por bloco); as vozes da sessão
  são agrupadas sob demanda (0,05 s) e a do streamer é a que mexe a boca na webcam
  (YuNet, nova série `mouth` no rastreio) ou a mais alta no áudio. Sem prova, tudo
  continua como do streamer.
- dados: `scoring.Word.speaker`; `words_json` aceita o 4º elemento; tabela
  `voice_chunks` (CREATE TABLE IF NOT EXISTS, fora da lista de migrações).
- legenda: streamer na posição normal e outra pessoa logo abaixo, em outra cor
  (`caption.otherColor`/`otherSize`); blocos nunca misturam falantes; os dois juntos
  = duas linhas; gancho desvia as duas; vertical e horizontal.
- tradução com `speaker` por linha; juízes recebem a transcrição marcada.
- painel: cor da outra pessoa na configuração, falante na transcrição do editor
  (com correção manual), prévia em duas linhas e "O que falam" no modal.
- doc/clipador/FALANTES.md com abordagem, licenças e qualidade medida na sessão 15.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 03:57:00 -03:00
..
2026-11-17 16:35:09 -03:00
2026-11-17 16:35:09 -03:00

Painel CenaForge

Painel local (Next.js 16.4 + React 19 + TypeScript + Tailwind 4) para trabalhar com várias histórias, cada uma com seus episódios, assets e votação A/B nos comentários, e para mandar pedidos aos agentes de código (Claude Code e Codex) pela CLI, como no VS Code.

pnpm install          # na raiz do repositório
pnpm panel            # http://127.0.0.1:4500

Só escuta em 127.0.0.1. Não há login: é uma ferramenta local.

O que tem

Página Para quê
Dashboard (/dashboard) Totais e desempenho por rede, conta, história e episódio (melhores e piores), views por dia, filtro por conta. Enquanto não há integração com as redes, os números são simulados (selo visível; gerar/apagar).
Histórias (/) Criar e listar histórias: interativa (o público escolhe entre 2–4 vertentes por episódio, "Vertentes por decisão"), linear ou documental (vídeo único sobre fatos reais, com nomes reais e fontes). Regras de roteiro de cada formato: doc/roteiro/. Excluir (lixeira no cartão ou no topo da história): os arquivos vão para data/trash/.
História (/stories/<id>) Abas Episódios (estágios, assets, envio), Fluxo (árvore estilo n8n: início, vertentes candidatas/escolhidas/descartadas, "Preparar vertentes" com a IA) e Canais de publicação que publicam a história.
Canais de publicação (/accounts) Cada canal agrupa perfis de YouTube, TikTok e Instagram, conectados por API oficial ou sessão logada, e se liga a histórias e a fontes do Clipador; regras de aprovação e horário por canal.
Publicações (/publishing) Fila de publicação: aguardando aprovação, agendadas, publicando, publicadas e com problema.
Configurações (/settings) Pausar publicações, horários bons por rede, apps das redes (Client ID/Secret) e navegador do modo sessão.
Episódio (/stories/<id>/episodes/<n>) Roteiro, cena (chamada e opções), render prévia/final com player, comentários, apuração e fechamento da votação, criação do próximo episódio a partir da escolha vencedora.
Assets (/assets) Biblioteca compartilhada e assets exclusivos de cada história; envio e promoção para a biblioteca.
Vozes (/voices) Estado do serviço de voz (GPU/CPU e motivo), ouvir cada voz com velocidade, adicionar/remover voz de personagem (RVC: .pth + .index, origem e licença obrigatórias), testar legenda (texto, frases ou palavras; baixa .srt) e configurações (dispositivo, Whisper, RVC). Fala com voice/ (127.0.0.1:4510) por /api/voice/*; detalhes em voice/README.md.
Editor de corte (/clipper/edit/<id>) Tela cheia (sem o menu lateral), aberto pelo botão "Editar" do cartão do corte no Clipador. O corte chega com o projeto que a IA montou (gancho, legenda pop, zoom no pico, silêncios). Você ajusta o trecho pela transcrição ou pela timeline, legenda animada, textos, zoom, narração, música e capa, e exporta. Detalhes em clipper/README.md.
Agente (/agent) Pedido para Claude ou Codex, com tarefa (livre, roteiro, cena), modelo e contexto (história/episódio). Saída ao vivo, custo, cancelar, continuar a conversa, histórico.

Onde ficam os dados

O quê Onde
Metadados e estado (histórias, episódios, renders, assets, comentários, decisões, execuções de agente) data/cenaforge.db (SQLite via node:sqlite, embutido no Node 24; ignorado pelo Git)
Logs de agentes e renders data/logs/
Roteiros stories/<história>/biblia.md, stories/<história>/epNN.md
Cena renderizável config/<história>-epNN.json
Assets da história stories/<história>/assets/<tipo>/<asset-id>/ (arquivo + asset.json)
Biblioteca de assets assets/library/<tipo>/<asset-id>/
Vídeos output/runs/ (gerados pelo lançador pnpm render)
Vertentes de um episódio stories/<história>/<file_key>.md (ex.: ep02-b.md), opções em <file_key>.choices.json, cena em config/<história>-<file_key>.json
Backups antes de migrar o banco data/backups/
Configuração da voz voice/.env (chave, porta, dispositivo, Whisper, RVC)
Pesos de voz e vozes de personagem data/voice/models/ (Piper, Whisper, rvc/<id>/) e data/voice/user-voices.json

Agentes (Claude / Codex)

  • O painel chama a CLI no servidor com cwd = raiz do repositório e o pedido como argumento, sem shell e com a entrada padrão fechada.
  • Claude: claude -p … --output-format stream-json --verbose --permission-mode acceptEdits --allowedTools …. Edição automática só dentro do projeto. Bash só para os comandos liberados em src/lib/agents.ts (CLAUDE_ALLOWED_TOOLS): render, verify, testes, typecheck, doctor e scripts da skill. "Continuar conversa" usa --resume <sessão>.
  • Codex (codex-cli 0.169.0, npm install -g @openai/codex@0.169.0 e codex login): codex exec --json --skip-git-repo-check --sandbox workspace-write -C <raiz>. O repositório não é Git, por isso --skip-git-repo-check. "Continuar conversa" usa codex exec resume <sessão> com -c sandbox_mode="workspace-write", porque a retomada não aceita --sandbox/-C. No Windows o npm instala codex.cmd, e o painel executa o codex.js do pacote pelo Node. O Codex informa tokens, não custo em US$. O Codex lê o AGENTS.md da raiz, que remete ao CLAUDE.md.
  • Um agente por vez; cancelar encerra a árvore de processos.
  • Modelo: escolhido no console e no "Nova história com IA". A lista do Codex vem do cache da própria CLI (~/.codex/models_cache.json), e o padrão é o model do ~/.codex/config.toml. No Claude, as tarefas cena e vertentes usam Sonnet 5.5 por padrão; as demais usam o padrão da CLI. O custo de cada execução aparece no histórico (o Codex informa tokens, não US$).
  • Comentários do público nunca entram no prompt. Só a escolha A/B já fechada.

Votação

Regra (src/lib/decisions.ts):

  • 1 voto por conta, e vale o último voto explícito.
  • Só conta comentário que começa com A ou B ("A", "opção B", "B!", "voto no A").
  • Comentário que cita as duas opções é ambíguo e não conta.
  • Empate ou zero votos exigem decisão manual com justificativa.

Fechar a votação grava uma fotografia imutável (decisions.snapshot_json), e o próximo episódio herda a escolha vencedora. Por enquanto, os comentários são colados no painel (autor: texto); a integração com o Instagram é fase futura.

Limitações atuais

  • A cena Godot ainda usa só o cenário de rua e o entregador provisório. Assets enviados ficam catalogados, mas ainda não são carregados pela Godot: é o próximo passo, com o nó adaptador de GLB.
  • Sem testes automatizados do painel nesta versão. A lógica foi testada por script (ver doc/TEST_RESULT.md).
  • Porta 4500. Convenção do projeto: serviços locais do CenaForge usam a faixa 4500–4599, para não conflitar com outros projetos da máquina.