Estilo Cartoon (Remotion), personagens reaproveitáveis e hashtags do TikTok

Estilo Cartoon (novo, sem Godot)
- Pacote cartoon/ (Remotion 4.0.535): cada trecho é um spec JSON desenhado
  em React/SVG e renderizado em MP4; render em lote (empacota uma vez) e
  imagem parada (--still).
- Cenas montadas por peças, sem cenário pronto: paletas (noite, sépia, dia,
  entardecer, cinza), lugar com chão, interno/externo, névoa e 24 peças
  posicionadas por profundidade, foco de luz e vinheta; etiquetas,
  onomatopeias, ondas de som, X vermelho, painel do topo e legenda palavra
  por palavra.
- Montagem documental: "Cartoon" como estilo do vídeo e tipo de visual do
  trecho; plano por regras pelo texto (lugar, objetos, expressão, pose),
  tempos das palavras pela transcrição do áudio, "Gerar de novo" por trecho,
  paleta da série e elenco da história.

Personagens
- Aba Personagens: criar pela descrição, ajustar peça por peça com prévia
  ao vivo, refinar com o agente (tarefa nova "Personagem"); fichas em
  assets/characters/ e elenco em stories/<id>/cast.json. O mesmo personagem
  sai igual em qualquer cena, mudando expressão, pose e objeto na mão.

TikTok
- Hashtags passam a ser digitadas e confirmadas na lista de sugestões do
  TikTok Studio (coladas, viravam texto). Diagnóstico de alcance em
  doc/publicacao/TIKTOK_DIAGNOSTICO.md.

Docs: estudo das referências, doc/cartoon/ (personagens e cenas) e skill
cenaforge 1.46.0.

Testes: painel 77/77, cartoon 5/5, Publicador 87/87.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 21:36:48 -03:00
co-authored by Claude Opus 5.5
parent e7ccc91736
commit 0050cf60a7
55 changed files with 5808 additions and 50 deletions
@@ -0,0 +1,99 @@
# Estilo Cartoon (`cartoon/`, Remotion, sem Godot)
Pacote do workspace (`pnpm-workspace.yaml`: `panel` + `cartoon`; nome `cenaforge-cartoon`). Cada trecho da montagem
documental vira um MP4 de desenho 2D com a duração do áudio. Versões e medição: [tools.md](tools.md).
**Princípio (dono, 17/11/2026): a ferramenta "sabe como faz".** Nada de cenário ou template pronto reaproveitado: cada
cena é montada **por peças** a partir do texto (parque de dia, cemitério, bunker…). **Personagens** são o contrário:
criados uma vez, na biblioteca, e reaproveitados em várias histórias. Não crie "cena pronta" nova; crie peça ou regra.
Guias do projeto (fonte de detalhe, não duplicar aqui): `doc/cartoon/cenas.md` (camadas, receitas por situação,
composição), `doc/cartoon/personagens.md` (ficha, agente), estudo de referência `doc/estudo-estilo-cartoon-explicativo.md`.
## Contrato da cena (`cartoon/src/spec.ts`, `schemaVersion` 1; `validateSpec` recusa o resto)
- `width`/`height`/`fps`/`durationS`/`seed`; `camera {push, panX}`; `hud {badge, label, clock, clockMinutesPerSecond}`;
`props` (ícone `house|generator|fuel|battery|phone|door|eye|bulb|solar|warning|money|clock`, `label`, `tone`
`info|danger|ok`, `shake`, `rings`, `crossed`); `texts` (`onomatopoeia|tag|counter|big`); `words [{text, startS, endS,
tone key|danger}]`; `card`. Posições em fração do quadro (0–1).
- `scene.kind`: `street|house|plain|blueprint|card` (cenas antigas) ou **`place`** (por peças). `palette`
(`night|sepia|day|dusk|gray`, `PALETTES` em `places.tsx`), `place`, `light` (`none|spot|vignette`).
- `place {ground grass|street|dirt|floor|sand|water|none, indoor, fog, horizon, elements[{kind, x, z, scale, flip, color}]}`;
`z` 0 = frente, 1 = fundo. 24 peças em `ELEMENTS`: tree, deadtree, pine, bush, rock, mountain, cloud, bench, lamp,
gravestone, cross, fence, house, building, car, sign, door, window, table, bed, shelf, crate, tent, fire.
Peça nova = entrada em `ELEMENTS` + desenho em `cartoon/src/places.tsx`.
- `actors`: `person` com `character {name, caption, look}`, `expression`, `pose`, `item` (objeto na mão), `flip`
(campos antigos `label`/`hair`/`glasses`/`pointing` ainda valem); `crowd` (entra antes do personagem, atrás, pés em y 0,6).
## Peças (`cartoon/src/`)
`places.tsx` (paletas, chão, peças, `LightLayer`), `scenes.tsx` (fundos antigos, espaço 1080×1920), `actors.tsx` (multidão,
pessoa antiga), `CharacterFigure.tsx` (personagem), `icons.tsx`, `overlays.tsx` (etiqueta amarela, onomatopeia com tremor,
anéis de som, X vermelho, HUD com relógio, legenda palavra por palavra em blocos de até 3), `Shot.tsx` (empurrão de
câmera), `Root.tsx` (composições `Shot` = trecho **vazio**, `Sample` = exemplo do Studio, `Character` = cartão),
`colors.ts` (cores sem Remotion; `theme.ts` só carrega fontes). Fontes Anton e Bebas Neue de `assets/fonts/`.
## Render
`tsx cartoon/render.ts --jobs <json>` (`[{spec, out}]`) | `--spec x --out y` | `--sample --out y` | **imagem parada de
personagem:** `tsx cartoon/render.ts --still --props x.json --out y.png [--frame N]`. Empacota uma vez e renderiza todos;
**última linha do stdout = JSON `{ok, results|error}`**. O 1º render baixa o Chrome Headless Shell (~120 MB);
`CARTOON_CHROME` aponta outro Chrome. Studio: `pnpm --filter cenaforge-cartoon studio`. Testes (dentro de `cartoon/`):
`npx tsx --test tests/*.test.ts`; tipos: `pnpm --filter cenaforge-cartoon typecheck`.
## Personagens (biblioteca)
- **Contrato** `cartoon/src/character.ts` (`Character`, `schemaVersion` 1): `id`, `name`, `caption`, `description`,
`kind` `cartoon|3d`, `look {build slim|average|heavy, height 0,6–1,2, skin, hair{style short|side|bun|long|curly|spiky|
bald|cap, color}, beard none|stubble|mustache|full|goatee, glasses none|round|square|sun, brows thin|thick,
top{shirt|jacket|hoodie|dress|uniform, color, accent}, bottom pants|shorts|skirt, shoes}`. `EXPRESSIONS`: neutral, happy,
sad, worried, angry, surprised, scared. `POSES`: stand, point, wave, hold, arms_up, shrug, think. `validateLook`.
- **Desenho** `CharacterFigure.tsx`: SVG puro (sem Remotion), `viewBox` 200×440, pés em (100,440); `t` anima respirar,
piscar e acenar. O painel importa o mesmo componente (prévia ao vivo): dependência `"cenaforge-cartoon": "workspace:*"` em
`panel/package.json`, `transpilePackages` em `panel/next.config.ts`, `exports` do pacote `./character`, `./figure`, `./spec`.
- **Arquivos:** `assets/characters/<id>/character.json`; elenco da história `stories/<id>/cast.json` (`{"cast":[ids]}`).
- **Painel** `panel/src/lib/characters.ts`: `listCharacters`/`getCharacter`/`saveCharacter`/`deleteCharacter` (não apaga
quem está em elenco), `describeToLook` (descrição pt-BR → `look` + `caption` por regras: idade, gênero, criança,
profissão → uniforme/cor, cabelo, barba, óculos, corpo, cor de roupa), `getCast`/`setCast`. Rotas: `GET/POST
/api/characters`, `GET/PUT/DELETE /api/characters/[id]`, `POST /api/characters/[id]/agent`, `GET/PUT
/api/stories/[storyId]/cast`. Página `/characters` (aba "Personagens"; `components/character-studio.tsx`: criar pela
descrição, prévia com expressão/pose, formulário peça por peça, "Refinar com o agente", apagar).
- **Agente:** `AgentKind` `"character"` (`types.ts`; `agents.ts`: orçamento US$ 0,5, Sonnet, Claude preferido; `prompts.ts`
manda ler SÓ `doc/cartoon/personagens.md` e gravar a ficha).
- Para testar a API com acento use Python/UTF-8 (gotchas 153); o `id` sai do nome sem acento.
## Plano no painel (`panel/src/lib/montage-cartoon.ts`, sem banco)
- Tipos vêm de `"cenaforge-cartoon/spec"` (não há mais espelho). `planCartoon(shot, ctx, variant)` com
`PlanContext {hud, cast, palette}` por regras do texto:
- **Lugar:** `LOCATIONS` por palavra (cemitério, bunker/porão, hospital/escritório, casa/quarto, parque, floresta,
acampamento, praia, sítio, rua/cidade) → `placeFor` (peças espalhadas pela semente, longe do centro; cada lugar traz
paleta/luz própria). Sem lugar reconhecido cai nas cenas antigas.
- **Personagem:** `expressionOf`/`poseOf` pelo texto; quem é citado pelo nome entra com a aparência da biblioteca; com 1
personagem só, ele aparece nos trechos pares ou quando o texto diz "ele/ela"; objeto pequeno vai para a mão (`item`).
- Ícones por palavra-chave; "pessoas/vizinhos" vira multidão; "nunca/não" + perigo risca o objeto; sons viram
onomatopeia (motor só com gerador/motor/moto/carro perto; barulho genérico = "Crec"); texto na tela numérico vira `big`,
senão etiqueta; `variant` troca arranjo e seed.
- `wordTimings` (transcreve o áudio com `detail: "words"`; sem o serviço, reparte o texto pela duração; gotchas 156).
`cartoonKey(scene, duração, audio.key)` decide se está atual. `renderCartoonShots`: specs em
`stories/<id>/cartoon/`, MP4 em `output/cartoon/<story>-<file_key>/`.
- **`lib/montage.ts`:** `VisualKind` `"cartoon"`; `ShotVisual.cartoon`/`cartoonVariant`/`cartoonKey`;
`SavedMontage.cartoonPalette` (`CARTOON_PALETTES`); `cartoonCtx(ep)` monta o contexto com o elenco da história. O
automático planeja tudo em cartoon no estilo `"cartoon"`; a etapa 3b renderiza **todos** os trechos desatualizados numa
execução; em `buildSegment` o trecho cartoon **não** recebe texto na tela nem legenda do FFmpeg (já vêm na cena). Mudar a
paleta, ou `PATCH {replanCartoon: true}`, apaga o plano dos trechos Cartoon automáticos (replanejados na próxima
geração); "Gerar de novo" troca `cartoonVariant`; `hudFor` = 2 primeiras palavras do título + "Ep. N".
- **UI** (`montage-editor.tsx`, recebe `storyId`): opção de estilo, bloco `CartoonSetup` (paleta da série + elenco por chips,
só no estilo Cartoon), botão "Cartoon" no trecho, `CartoonPreview`.
- **Testes:** `panel/src/lib/montage-cartoon.test.ts` (9).
## Medido (17/11/2026)
Mesmo personagem em parque (`day`), cemitério (`dusk` + fog + `vignette`) e bunker (`sepia` + `spot` + indoor): 3 trechos de
4 s em ~2,6–2,8 s cada. Plano com elenco "Marta" → parque de dia (acenando) e cemitério (com medo, "Crec") renderizados.
Testes: painel 77/77, cartoon 5/5; `tsc` ok nos dois (informados pelo dono; cartoon 5/5 reexecutado na skill).
## Ainda não existe (próximo passo)
Vistas especiais da referência: corte do subsolo, mapa visto de cima, painel/gráfico, celular, tela dividida. Agente que
escreve o spec de cada trecho (em vez das regras de `planCartoon`). Personagem `kind: "3d"` existe só na ficha. Não prometa.
@@ -708,6 +708,8 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md).
Instagram não têm leitura sem janela logada (página pública devolve só verificação ou nada). Ver [publishing.md](publishing.md).
153. **Corpo JSON com acento por `curl -d` no 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`, com `Origin` e `Content-Type` (item 125).
Mesmo com `curl` o nome "Verificação" virou id `teste-verifica-o` na API de personagens (17/11/2026): teste acentos por
Python/UTF-8.
154. **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º commit `84f30bb`, 484 arquivos,
~7,4 MB, 17/11/2026). Fora do git: `data/`, `.env`, venvs (inclui `publisher/.venv/`) e `output/`. Commits neste
@@ -722,6 +724,38 @@ observada num envio real ainda. Contexto em [publishing.md](publishing.md).
1080×1920 (`maxresdefault` é 1280×720 horizontal); foi o que se fez no corte 91. Junto: em `metrics.ts` a 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`.
156. **Cartoon: a síntese de voz não devolve tempos por palavra.** `POST /v1/synthesize` só entrega o áudio; tempos vêm da
transcrição (`/v1/transcribe`, `X-Detail: words`). `wordTimings` transcreve 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 (`captionChunks`
em `montage-ffmpeg.ts`). Onde: `panel/src/lib/montage-cartoon.ts`.
157. **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 `LOCATIONS` cobre 10
lugares (parque, cemitério, bunker, casa…); fora deles cai nas cenas antigas (`scenes.tsx`, da história de energia).
Lugar novo = linha em `LOCATIONS` (+ peça em `places.tsx` se faltar), nunca cena pronta. Sem lugar, prefira `mixed`/`3d`.
Onde: `panel/src/lib/montage-cartoon.ts`.
158. **TikTok: `#hashtag` publicada vira texto, não hashtag.** Diagnóstico (`doc/publicacao/TIKTOK_DIAGNOSTICO.md`): a página
pública do vídeo mostrava `challenges: []` e `textExtra: []`, porque `insert_text` cola `#tag` como texto puro.
Correção: `caption_parts` separa texto e tags; `type_caption` cola o texto, digita cada `#tag` e 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 o `pnpm dev` (item 143). Onde: `publisher/app/platforms/session/tiktok_studio.py`.
159. **Ler várias páginas públicas do TikTok seguidas devolve o desafio anti-robô `SlardarWAF`** (1.462 bytes) para
`curl`/`yt-dlp`. Um Chrome real passa. Receita para baixar um vídeo de referência (informada, não reexecutada): Playwright
com `channel="chrome"` e perfil temporário, ler `__UNIVERSAL_DATA_FOR_REHYDRATION__`
(`itemStruct.video.bitrateInfo[].PlayAddr.UrlList`) e baixar por `ctx.request` com `Referer: https://www.tiktok.com/`.
Só para referência/estudo; nunca em stealth no fluxo de publicação (regra em publishing.md).
160. **Cartoon: HUD, gerador e onomatopeia do exemplo aparecem em todo trecho.** Causa: a Remotion completa props ausentes
com os `defaultProps` da composição; com o exemplo como padrão, tudo que o spec não trazia vinha do exemplo.
Correção: `Shot` tem padrão VAZIO; o exemplo fica na composição `Sample` (só Studio). Campo opcional novo no spec
precisa de valor vazio em `BLANK`. Onde: `cartoon/src/Root.tsx`.
161. **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`.
162. **Regex com `\b` escrita por heredoc/Python sem string raw vira um caractere de controle (backspace, 0x08)** (aconteceu 2x ao
editar `montage-cartoon.ts`): a regex deixa de casar, sem erro. Use `r"..."` ou o Edit (item 44) e confira com
`grep -nP "\x08" <arquivo>` que não sobrou nenhum.
Relacionadas, já registradas acima:
- Patch por script em arquivos CRLF do painel (`lib/metrics.ts`, `components/metrics-view.tsx`, `dashboard-controls.tsx`,
+8 -2
View File
@@ -99,12 +99,13 @@ Card "Montagem do vídeo" (`components/montage-editor.tsx`) na página do vídeo
"0,0055" → "zero vírgula zero zero cinquenta e cinco", milhar "1.500", km, m², ha, cm, kg, %, "por m²"). Texto na
tela que é pergunta e que a narração não repete entra antes da fala ("Uma cobra por metro quadrado? Não. ...");
- **visual** (`VISUAL_KINDS` em `lib/montage.ts`; rótulo da UI entre parênteses): `image` (Foto), `godot2d`
(Animação 2D), `godot3d` (Cena 3D da biblioteca), `video` (Clipe: envio ou render Godot já feito), `card`
(Animação 2D), `godot3d` (Cena 3D da biblioteca), `cartoon` (Cartoon, Remotion), `video` (Clipe: envio ou render Godot já feito), `card`
(Cartela, sem arquivo). Pode misturar. `ShotVisual`: `scene` + `sceneKey` (Godot), `search {queries, pick}` (foto
da internet), `auto` (escolhido pelo automático; trocar à mão grava `auto: false`), `inset` (cartão de foto por
cima do visual; na UI, `InsetCard`: "Outra foto", "Tirar", "Pôr foto da internet").
- **Estilo do vídeo** (`style` no `.montage.json`, `PATCH {style}`; seletor "Estilo do vídeo" no topo): `"mixed"`
(padrão: foto, 2D e 3D) ou `"3d"` ("Tudo em 3D": todo trecho vira cena 3D da biblioteca, fotos só em cartão).
(padrão: foto, 2D e 3D), `"3d"` ("Tudo em 3D": todo trecho vira cena 3D da biblioteca, fotos só em cartão) ou
`"cartoon"` ("Cartoon: desenho 2D chapado": todo trecho vira cena Remotion; ver "Estilo Cartoon").
Regras de roteiro para isso: "Vídeo todo em 3D" em `doc/roteiro/documental.md` (coluna Imagem = tomada 3D,
`[foto: termos]`, cenas 3D que faltam em "Necessidades de produção").
- **Cartões de informação em sequência:** texto na tela `A; depois: B; depois: C` mostra as partes uma após a outra,
@@ -194,6 +195,11 @@ Card "Montagem do vídeo" (`components/montage-editor.tsx`) na página do vídeo
dentro de outra e `.glb` por `GLTFDocument` em tempo de execução: `doc/godot/cenas.md`.
- Cena nova pelo painel: tarefa "Cena no Godot" do agente (seção "Agentes e modelos").
### Estilo Cartoon (`cartoon/`, Remotion, sem Godot)
Cada trecho vira um MP4 de desenho 2D montado por peças a partir do texto; personagens vêm da biblioteca
(`assets/characters/`). Contrato, peças, render, plano, personagens e integração em `montage.ts`: [cartoon.md](cartoon.md).
### Gerar o MP4 (`startMontageRender(id, { auto, replan })`)
- `auto: false` ("Só montar"): exige áudio atualizado e visual em todos os trechos (menos cartela); as cenas Godot
@@ -166,6 +166,11 @@ confirmou (regra "YouTube Studio"); a confirmação nova não foi testada.**
roda antes da legenda e antes de "Publicar". `TIP_BUTTONS` só aceita `^(Entendi|Entendido|Ok, entendi|Got it)$`:
**nunca aceitar ou recusar opções por esse caminho**, só fechar avisos. Gotchas 142.
- **Legenda do TikTok com hashtags de verdade** (`tiktok_studio.py`: `caption_parts`, `type_caption`, `hashtag_options`):
texto colado; cada `#tag` digitada e confirmada clicando na sugestão exata; sem sugestão fica texto; progresso "N de M
hashtags confirmadas". Corrigido em 17/11/2026 após diagnóstico (`doc/publicacao/TIKTOK_DIAGNOSTICO.md`); **falta
validar com vídeo real** (conferir `challenges`/`textExtra` na página pública). Gotchas 158–159.
- **YouTube Studio (modo sessão): confirmar a publicação** (`youtube_studio.py`; gotchas 151). O `#done-button` é um
componente `ytcp-button`, não um `<button>` nativo: o Playwright clica mesmo desativado e o clique se perde.
`is_enabled`/`wait_enabled` leem `disabled`/`aria-disabled` do elemento e do `<button>` de dentro e esperam até 10 min;
@@ -25,6 +25,19 @@ prévia e registre aqui (via `cenaforge-skill-updater`).
| 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 |
Estilo Cartoon (`cartoon/`, 17/11/2026; contrato e uso em [cartoon.md](cartoon.md)):
| Ferramenta | Versão | Papel | Evidência (17/11/2026) |
|---|---|---|---|
| Remotion (`remotion`, `@remotion/bundler`, `@remotion/renderer`, `@remotion/cli`) | 4.0.535 (fixada; conferida em `cartoon/node_modules`) | cenas 2D vetoriais em React → MP4 por trecho | exemplo de 6 s (180 quadros) em 11,8 s; 3 trechos reais (~21 s de vídeo) em 25,2 s (1º 11,2 s, depois ~4 s cada). Medido pelo dono, não reexecutado aqui |
| React / react-dom | 19.3.0 | componentes das cenas | idem |
| Chrome Headless Shell | baixado pela Remotion no 1º render (~120 MB; versão não registrada); `CARTOON_CHROME` aponta outro Chrome | renderiza os quadros | idem |
| Fontes Anton e Bebas Neue | `assets/fonts/` (`publicDir` = `assets`) | texto das etiquetas e legenda | ver licenças em "Clipador" |
Licença da Remotion: grátis para pessoa física e empresa pequena; empresa maior paga. **Conferir os termos antes de uso
comercial** (não verificado aqui). Testes: `npx tsx --test tests/*.test.ts` em `cartoon/` (5 testes de `spec.test.ts`);
painel: `montage-cartoon.test.ts` (9). Cartoon 5/5 reexecutado em 17/11/2026; painel 77/77 informado pelo dono.
Hardware do teste de referência: i9-13900K, 64 GB, RTX 2060 SUPER. Tempos: prévia 540×960
42–44 s; final 1080×1920 ~160 s. A etapa de render da Godot ocupa 94–96% do total, dominada
pela codificação PNG (105 ms/quadro na prévia, 404 ms no final; ~90–91% do total); GPU