Skill de Produção de Vídeo Pixel Retro 16-Bit
Blueprint de Referência
- Repositório Canônico de Referência:
https://github.com/Lithium023/16bit-video-forNeon - Benchmark de Referência: Documentário de 5m14,5s (314,5s) (AI 发展史), 55 cenas de pixel 16-bit feitas à mão em 5 atos, 155 cues SRT sincronizadas, 9 transições suaves, áudio de 3 faixas (Narração + BGM 16-bit de 5 atos com ducking automático + 94 SFX 16-bit sincronizados) e exportação MP4 1920×1080 H.264/AAC no lado do cliente mais rápida que o tempo real.
- Ao iniciar um novo projeto: Espelhe a arquitetura de módulos e os padrões visuais/áudio/exportação documentados nesta skill e em seus arquivos
references/. Se o usuário fornecer um novo script, áudio de narração ou arquivo SRT, mantenha todo o motor, constituição estética, interface de estúdio e pipeline de exportação MP4 idênticos, enquanto cria novos capítulos específicos do tópico, cenas de pixel, sprites e cues sonoras.
1. Constituição Estética (Innegociável)
Pense em SNES / Chrono Trigger / Sea of Stars / Celeste combinado com gráficos animados de documentário de alta qualidade — quente, rico, atmosférico e cristalino. Nunca minimalismo de wireframe estéril, nunca borrão de baixa resolução bagunçado, nunca néon berrante.
-
Grade de Pixel Virtual Puro 16-Bit (
384×216Paisagem /216×384Retrato):- Desenhe todos os mundos pixel, fundos, céus pontilhados, sprites, adereços e ícones em um canvas virtual fora da tela em
384×216(16:9) ou216×384(9:16). - Por que
384×216? É uma escala inteira exata de 5× para1920×1080(384 × 5 = 1920,216 × 5 = 1080). Copie para o canvas de saída HD comctx.imageSmoothingEnabled = falsepara que cada pixel permaneça perfeitamente nítido, sem tremulação ou desfoque de subpixel. - Trave animações de pixel ociosas/ambientes em uma cadência retro nítida (
stepT = Math.floor(time * 8..10) / 10), enquanto as câmeras panorâmicas, curvas de easing e transições rodam a 60fps sedosos (30fps na exportação).
- Desenhe todos os mundos pixel, fundos, céus pontilhados, sprites, adereços e ícones em um canvas virtual fora da tela em
-
Paleta 16-Bit Coesa de 28 Cores, Cinematográfica e Quente:
- Construa cada cena a partir de uma paleta compartilhada disciplinada (
PAL) abrangendo 6 famílias emocionais: Azul Noturno Profundo/Vazio, Dourado Lâmpada Quente/Creme, Coral Aconchegante/Ameixa, Verde Azulado Fresco/Pinho, Gelo Ártico Invernal e Verde Oliva Monocromático Game Boy (reservado estritamente para cortes bruscos dramáticos de virada de trama como"但其实"). - Nunca use gradientes planos sem textura. Use Pontilhamento Bayer Ordenado 4×4 (
drawDitheredSky,drawDitheredGlow) para costuras de céu, halos de lâmpadas, explosões de amanhecer e dissoluções de pixel. - Consulte
references/visual-and-typography-spec.mdpara tokens hexadecimais exatos, matemática da matriz Bayer e primitivas de desenho de sprite.
- Construa cada cena a partir de uma paleta compartilhada disciplinada (
-
A Lei de Ouro da Tipografia (Texto CJK Sem Embaçamento):
- Nunca desenhe texto chinês pequeno no canvas de baixa resolução
384×216e aumente a escala — caracteres chineses densos (最/魔/幻/澜/疆) se transformarão em uma mancha ilegível ("糊成一坨"). - Títulos e Emblemas Cinéticos na Cena (Sobreposição HD de Duas Camadas): Renderize títulos diretamente no canvas HD (
1920×1080) usando sprites de glifos pixel binários rasterizados a38px(manchetes grandes),32px(subtítulos) ou24px(tags HUD), com um contorno de tinta escura de 1 pixel com 8 vizinhos, sombra projetada escalonada e preenchimento metálico de 3 bandas (realce superior / tom médio / sombra inferior), ampliado via nearest-neighbor (imageSmoothingEnabled = false). - Legendas de Broadcast no Terço Inferior: Mantenha as legendas em tipografia sans-serif original limpa e de alta legibilidade (
Noto Sans SC/ sistema sans-serif negrito dentro de uma pílula escura translúcida sutil com borda âmbar fina emy = 0.905 * h). Não pixele a faixa de legenda principal, a menos que explicitamente solicitado. - Nunca deixe brilhos pontilhados obscurecerem rótulos críticos: Qualquer ano-chave, métrica ou emblema de pico (
2026,1950 — FUTURO) deve estar dentro de uma placa escura de alto contraste nítida com uma borda de pixel dourada/verde azulada desenhada após os brilhos de fundo.
- Nunca desenhe texto chinês pequeno no canvas de baixa resolução
-
Zero Entradas Bruscas e Zero Cortes Secos Acidentais:
- Cada limite de cena deve ter uma transição intencional da biblioteca de 9 transições (
aperture-open,whip-blinds,iris-flash,razor-wipe,invert-strobe,camera-pullback,ember-curtain,gravity-shatter,horizon-burst) com interpolação suave de câmerafromCam → toCame crossfade de tipografia. Mesmo uma reversão dramática usa um wipe de varredura CRT deliberado (invert-strobe), nunca um salto chocante e não motivado. - Cada elemento gráfico com múltiplas partes dentro de uma cena (4 cartões de modalidade, 4 módulos de recurso, 4 caixas, etapas de monolito, banner de ano final) DEVE animar com coreografia proposital — pop-ins de mola escalonados, feixes de energia varrendo conectando hub → nó, placas de RPG se desdobrando ou ticks de odômetro/hodômetro sincronizados com as palavras faladas. Nunca apenas alterne
if (localTime > X) drawBox(). - Cada final/fim merece uma sequência de encerramento criativa de assinatura (por exemplo, floração do horizonte ao amanhecer + personagens olhando para frente + placa se desdobrando + odômetro de ano girando
1950 → 2026 → FUTURO+ arco de estrela brilhante varrendo + acorde maior quente e harmonioso).
- Cada limite de cena deve ter uma transição intencional da biblioteca de 9 transições (
2. Fluxo de Trabalho de Produção Padrão
Siga esta sequência exata ao criar um novo vídeo de pixel 16-bit do zero (ou estendendo um existente):
Passo 1: Ingerir Script, Narração e Temporização SRT
- Analise o áudio de narração real do usuário e o arquivo de legenda
.srt(ou gere um SRT com timestamps precisos alinhados à narração). - Normalize micro-lacunas (
< 0,18s) entre cues adjacentes para que as legendas nunca pisquem por 2 quadros. - Estabeleça
CLIP_DURATIONa partir do tempo final exato do áudio/SRT.
Passo 2: Storyboard e Folha de Batidas (Blueprint de Ritmo)
- Divida o filme em 3–6 Atos Narrativos (cada um com sua própria temperatura de cor e capítulo BGM) e cenas de 3–8 segundos (aproximadamente 1–3 cues de legenda por batida visual).
- Para vídeos longos (>60s), construa iterativamente em capítulos de 30 segundos (
retroPixelChapterTwo.ts,retroPixelChapterThree.ts, etc.) para que cada tomada receba pixel art genuinamente feito à mão, em vez de modelos reciclados. - Atribua a cada cena em
timeline.ts:index,id,title,quote,start,end(estritamente contíguo, sem lacunas/sobreposições cobrindo[0, CLIP_DURATION])transitionIn+transitionLabelvisualBeat(descrição editorial concisa para o painel de storyboard)- cor de destaque
accentpara a faixa da linha do tempo.
Passo 3: Construir o Motor de Pixel Central e os Renderizadores de Capítulo Modulares
Espelhe a separação limpa de interesses do https://github.com/Lithium023/16bit-video-forNeon:
src/video/types.ts—SrtCue,SceneCut,TransitionType,RenderSettings,ExportResolution,ExportStatus.src/video/srtParser.ts— Analisador SRT determinístico,AUDIO_SRC,BGM_SRC,CLIP_DURATION,getActiveCue.src/video/timeline.ts—SCENE_CUTScontíguo, curvas de easing (easeOutExpo,easeOutBack,easeOutCubic,easeInOutQuint,smoothstep),getStaggerProgress,getSceneAtTime,getActiveTransition, energia de narração sintética de fallback.src/video/pixelSprites.ts—PAL,BAYER_4X4,pxRect,pxOutline,pxCircle,pxRing,pxLine,drawDitheredSky,drawDitheredGlow,drawSprite,pxBitmapText, sprites de pixel art reutilizáveis e auxiliares de ambiente (pxPineTree,pxCloud,pxSparkle,pxStarfield).src/video/pixelTypography.ts— Rasterizador de glifos pixel binários em cache (drawPixelString,drawPixelKineticTitle,drawPixelHudTag).src/video/retroPixelRenderer.ts— Pool de buffers virtuais mestre (bufA,bufB,bufDither), calculadora de deriva de câmera, compositor de 9 transições, scanlines CRT, handoff de tipografia e despachante para arquivos modularesretroPixelChapter*.ts.src/video/sceneRenderers.ts—renderVideoFramede nível superior: cena de pixel → vinheta sutil (0,14) → legendas originais limpas no terço inferior → barra de progresso âmbar fina → fade de cauda de 0,25s.
Passo 4: Pontuar o Filme Completo (Sistema de Áudio de 3 Faixas)
Leia references/choreography-and-audio-spec.md para detalhes completos:
- Faixa 1 — Narração: Âncora narrativa mestre (
volume = 1,0, fade de cauda de 0,25s). - Faixa 2 — BGM 16-Bit Multi-Ato: Use faixas 16-bit genuínas de código aberto (CC0 / CC BY 3.0, ex.: OpenGameArt / BoxCat Games / Kevin MacLeod / OSTs chiptune) que combinem com o clima de cada ato, costure-as em uma única faixa BGM sem lacunas com crossfades suaves correspondentes aos timestamps dos atos e aplique ducking automático de narração (
duck = 1 - voiceEnergy * 0,22) em aproximadamente0,58 * bgmVolume. - Faixa 3 — SFX 16-Bit Sincronizados (
retroSfxEngine.ts): Combine SFX de transição automáticos para cada corte de cena + SFX de batida musical colocados manualmente (bipes pentatônicos ascendentes para revelações de 4 cartões, cliques de cristal, zumbidos de corte, ticks de odômetro e um acorde maior de final quente). Todos os SFX sintetizam-se de forma limpa via Web Audio (BaseAudioContext+scheduledTimeopcional) para que a reprodução ao vivo e a exportação MP4 offline soem idênticas.
Passo 5: Visualização NLE de Estúdio e Exportação MP4 1080p no Lado do Cliente
Leia references/mp4-export-and-qa-spec.md para detalhes completos:
- Shell do Estúdio: Espaço de trabalho obsidiana escuro (
#07080B), TopBar (título da marca, navegação de salto de capítulo, única ação primáriaExportar 1080p MP4com progresso ao vivo do estágio + cancelamento instantâneo), Palco Canvas (alternância 16:9 / 9:16, play/pause/scrub/step/velocidade/mudo/tela cheia), linha do tempo visual multi-faixa (blocos de cena + blocos de legenda + cabeça de reprodução) e painel editorial direito (Storyboard e Transições/Fala do Locutor/Ajustes de Cenaincluindo alternância MP41080pvs720p, controles deslizantes BGM/SFX, alternância de legenda, botões de salto de destaque). - Exportação MP4 (
videoExporter.ts): Usemp4-muxer+ WebCodecs (VideoEncoderH.264 +AudioEncoderAAC/Opus) do navegador com mixagem de áudio PCM direto offline + carimbo de SFX por cache, padrão para1920×1080@ 30fps, 14 Mbps (1080×1920para retrato), com fallback automático para MP4MediaRecordernativo do Safari.
Passo 6: Testes Unitários e Verificação Visual no Navegador (Obrigatório)
- Desacople a lógica pura e teste com
node:test(npx tsx --test):- Análise de timestamps SRT e cobertura de cues (
srtParser.test.ts) - Cortes de cena contíguos e transições sem lacunas/sobreposições (
timeline.test.ts) - Validação de pontilhamento Bayer e grade retangular de sprites (
pixelSprites.test.ts) - Cobertura de cues SFX cronológica e janela de acionamento apenas para frente (
retroSfxEngine.test.ts) - Configuração de resolução de exportação, prioridade MIME MP4 e linha do tempo de energia da narração (
videoExporter.test.ts)
- Análise de timestamps SRT e cobertura de cues (
- Suporte ao parâmetro de consulta de URL
?t=<segundos>emApp.tsxpara que verificações automatizadas de navegador headless possam pular diretamente para qualquer cena, ponto médio de transição, batida de animação de entrada e quadro final para inspeção visual. - Verifique se a exportação MP4 ao vivo atinge
Renderizando MP4, cancela de forma limpa de volta ao estado ocioso sem callbacks obsoletos e emite zero erros de console do navegador.
3. Regras e Armadilhas Difíceis a Nunca Repetir
| Armadilha | Causa Raiz | Solução Obrigatória |
|---|---|---|
| Títulos chineses parecem borrados/aglomerados ("糊成一坨") | Renderizar CJK no canvas de baixa resolução 384×216 e depois aumentar a escala | Renderize títulos CJK no canvas HD via sprites de glifos binários de 38px/32px (thresh = 142..148 para CJK, 88 para ASCII) com contorno de 1px de tinta + bisel de 3 bandas; mantenha legendas do terço inferior em sans-serif original limpa |
| Cortes secos entre cenas tardias | transitionIn ausente ou handoff visual incompatível | Cada corte em SCENE_CUTS deve definir um transitionIn proposital; pareie transições temáticas (ex.: flor desabrochando se dissolvendo em cristais de gelo caindo → mergulho gravity-shatter no inverno) |
| Elementos aparecem abruptamente | Desenhar cartões/caixas de UI com if (localTime > t) booleanos crus | Conduza cada elemento com clamp01((localTime - delay) / dur) + easeOutBack / easeOutExpo, conectores de feixe, desdobramento de placas ou contadores giratórios |
| Rótulo do clímax oculto ou parcialmente digitado | Brilho desenhado sobre o rótulo, ou progresso derivado de contador de segmento limitado | Desenhe rótulos dentro de placas escuras emolduradas após brilhos; amarre o progresso da revelação diretamente ao localTime em vez de um parâmetro de curva limitada |
| Exportação MP4 offline trava em 4% | Conectar mais de 90 SFX (~280 BiquadFilterNodes) a um único OfflineAudioContext de 314s | Decodifique narração + BGM uma vez, misture diretamente em PCM Float32Array estéreo, renderize cada SFX curto único em um OfflineAudioContext pequeno de 0,55–1,55s (em cache) e carimbe no PCM |
| Codificação de áudio MP4 offline leva mais de 12s | Alimentar pequenos chunks AudioData de 4096 amostras com polling de drenagem solto | Agrupe AudioData em chunks de 1 segundo (48000 amostras) (~315 chunks para 5m) e aperte o fallback de drenagem para 20ms |
| Clicar em Cancelar durante a renderização MP4 deixa o botão travado | waitForEncoderDrain resolve após cancel() e emite um último onProgress | Envolva onProgress/onComplete/onError em guards !cancelled e verifique if (isCancelled()) return imediatamente após cada await |
4. Arquivos de Referência Nesta Skill
Carregue estas referências conforme necessário durante a execução:
references/visual-and-typography-spec.md— Paleta de coresPALexata, canvas384×216e matemática de escala inteira, pontilhamento Bayer, rasterizador de tipografia pixel e 9 receitas de transição.references/choreography-and-audio-spec.md— Padrões de animação de entrada, crossfade BGM de 5 atos + matemática de ducking e 15 receitas de SFX 16-bit processuais.references/mp4-export-and-qa-spec.md— Pipeline de exportação MP4 no lado do cliente de 4 níveis, mixer PCM offline rápido, especificação de UI de estúdio NLE e lista de verificação de QA unitário e de navegador.