drama-keyframe-forge

Drama Keyframe Forge (Forja de Keyframes de Drama - Etapa de Consistência de Storyboard e Ativos)

Posicionamento da Etapa: Etapa de pré-geração de ativos e keyframes para curtas-metragens. Insight Central: Substitui a abordagem ineficiente de "rodar T2V por 8 minutos às cegas e torcer pela sorte, depois refazer na qualidade" por um processo onde, antes da amostragem de vídeo, imagens-chave de storyboard são geradas em 5 segundos com um modelo de imagem, verificadas a baixo custo, e só então alimentadas para execução I2V.

---

1. Contrato de Execução e Entrada/Saída

• Entrada:
  1. plan.json da 1ª etapa e a tabela de storyboard;
  2. Fichas de design base de personagens (Character Reference Sheet, imagens 2+3 cabeças desacopladas);
  3. Descrição de cenários e adereços-chave.
• Saída:
  1. style_bible.json: Cartão mestre de estilo artístico global, único e imutável;
  2. Imagens-chave 16:9 de alta definição para cada storyboard: segments/segXX_keyframe.png;
  3. Relatório de inspeção de portão de qualidade de keyframes: keyframe_qc.json.

---

2. SOP Central: Bíblia de Estilo Global (Style Bible) e Portão de Vento Pré-Estabelecido

Regra de Ferro: Toda a série dramática deve ter um único style_bible.json válido. É estritamente proibido que prompts de segmentos individuais alterem livremente as palavras-chave de estilo centrais!

2.1 Cinco Atributos Principais da Bíblia de Estilo

Antes de iniciar, os seguintes 5 campos devem ser fixados:

1. Visual Genre (Gênero Visual): Ex.: Cinematic retro-future dieselpunk graphic novel style, mature neo-noir tone;
2. Color Palette (Paleta de Cores/Emoção): Ex.: desaturated amber and deep teal contrast, rusty bronze highlights, rich shadow details;
3. Lighting Base (Iluminação/Textura): Ex.: heavy chiaroscuro lighting, harsh directional rim light, high contrast dramatic shadows;
4. Environment Base (Materiais Físicos do Cenário): Ex.: weathered rust and scuffed brass, damp asphalt reflections, atmospheric smog;
5. Quality & Lens (Qualidade/Ótica): Ex.: 35mm film grain, Panavision anamorphic lens flare, shallow depth of field, 8k resolution.

2.2 Lista de Verificação do Portão de Vento Pré-Estabelecido

Antes de iniciar, o modelo de geração de imagem deve gerar 4 amostras de vento em diferentes planos, para aprovação manual:

• Amostra 1 (Plano Geral LS): Verificar se iluminação, tom e ambiente material correspondem ao esperado;
• Amostra 2 (Plano Médio do Protagonista MLS): Verificar roupas, postura e adornos característicos do protagonista;
• Amostra 3 (Close-up do Protagonista CU): Verificar olhos, nariz, boca, cabelo e textura facial;
• Amostra 4 (Close-up Extremo de Adereço-Chave ECU): Verificar detalhes de superfície dura e estrutura mecânica do adereço.

---

3. SOP Central: Geração de Imagens-Chave Conjuntas por Storyboard (Pré-Geração I2V)

Exemplo Ruim (Proibido): Alimentar diretamente texto puro para H3 executar T2V sem uma imagem-chave de primeiro quadro do storyboard! Fenômeno: Devido ao ruído latente aleatório no início da difusão 3D, o mesmo personagem gerado muda de penteado, sofre deriva óssea facial (troca de rosto) e variações de estilo de roupa entre cortes de cena.

3.1 Etapas de Geração de Imagens-Chave Conjuntas

Para cada segmento de storyboard em plan.json (seg01 ~ seg08):

1. Montar Prompt de Geração de Imagem do Storyboard:
   • Injetar a aparência e roupas exclusivas do protagonista;
   • Injetar a posição de câmera especificada para o segmento atual (ex.: M2_RACK_FOCUS foco em adereço);
   • Injetar o microcenário e adereços específicos do segmento atual (ex.: sharp serrated hunting dagger vibrating in tabletop);
   • Injetar as palavras de estilo e iluminação de style_bible.json.
2. Usar modelo rápido de geração de imagem (Flux / SDXL) para renderizar imagens estáticas 16:9 em lote (5~10 segundos/imagem);
3. Três Camadas de Portão de Qualidade (Keyframe Gate Check):
   • Consistência Facial: Marcas registradas (tapa-olho, penteado, cicatriz) claramente alinhadas;
   • Fidelidade à Posição de Câmera: Enquadramento e ângulo estritamente conforme o storyboard, sem membros extras;
   • Superfícies Duras de Adereços: Bordas de armas, mostradores, maletas nítidas, sem derretimento;
4. Após aprovação na inspeção, renomear e salvar como segments/{seg_id}_keyframe.png.

---

4. Scripts de Ferramentas Exclusivas

• Gerenciamento de Vento e Geração de Primeiros Quadros de Storyboard: python scripts/keyframe_gate.py --scan
• Sincronizar Primeiros Quadros para o Repositório ComfyUI: python scripts/keyframe_gate.py --project <nome_do_projeto> --sync