- cartoon/src/rig.ts, motion.ts e lipsync.ts: esqueleto do personagem, curvas de movimento e sincronia labial no estilo Cartoon (Remotion) - CharacterFigure/CharacterCard/Shot/overlays e spec atualizados - Painel: estúdio de personagens e montagem cartoon ajustados - Documentação em doc/cartoon/animacao.md e personagens.md; skill atualizada Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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 emsrc/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.0ecodex 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" usacodex exec resume <sessão>com-c sandbox_mode="workspace-write", porque a retomada não aceita--sandbox/-C. No Windows o npm instalacodex.cmd, e o painel executa ocodex.jsdo pacote pelo Node. O Codex informa tokens, não custo em US$. O Codex lê oAGENTS.mdda raiz, que remete aoCLAUDE.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 é omodeldo~/.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.