Communitygithub.com

Forja de fotogramas clave

Antes de renderizar vídeo, fija una biblia de estilo y un fotograma 16:9 por toma para que caras, lugares y objetos dejen de cambiar.

¿Qué es Forja de fotogramas clave?

Segundo paso del banco. Toma el plan de planos y las fichas de personaje, escribe una sola biblia de estilo (género, paleta, luz, materiales) y un primer fotograma en alta por toma: escena, personas y objetos en una imagen. Esos fotogramas son la revisión barata. El muestreo de vídeo empieza solo cuando pasan, en vez de dejar que el texto a vídeo adivine una cara.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abserari/drama-production-skills/tree/HEAD/skills/drama-keyframe-forge

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Drama Keyframe Forge (Fijación de Planos y Consistencia de Activos)

Posición en el pipeline: Etapa de fijación de activos y planos de series cortas.
Núcleo conceptual: Transforma la práctica ineficiente de "ejecutar T2V a ciegas durante 8 minutos, probar suerte y luego descartar por mala calidad" en un flujo donde, antes del muestreo de video, se generan imágenes fijas de cada plano con un modelo de síntesis de imágenes (5 segundos), se verifican a bajo costo y, una vez aprobadas, se alimentan al proceso I2V.


1. Contrato de ejecución, entradas y salidas

  • Entradas:
    1. plan.json y la tabla de planos de la etapa 1;
    2. Hoja de diseño base de personajes (Character Reference Sheet, desacople 2+3 cabezas);
    3. Descripción de escenarios y atrezo clave.
  • Salidas:
    1. style_bible.json: tarjeta maestra de estilo artístico, única e inmutable para toda la serie;
    2. Imagen fija de alta definición (16:9) del primer fotograma de cada plano: segments/segXX_keyframe.png;
    3. Informe de control de calidad del primer fotograma: keyframe_qc.json.

2. SOP rígido: Tarjeta maestra de estilo (Style Bible) y compuerta de fijación previa

Regla de hierro: Toda la serie debe tener un único style_bible.json válido. ¡Está terminantemente prohibido que los prompts de cada plano modifiquen por su cuenta las palabras clave de estilo!

2.1 Los cinco atributos principales de la tarjeta maestra de estilo

Antes de comenzar, deben fijarse los siguientes 5 campos:

  1. Visual Genre (base visual): p. ej., Cinematic retro-future dieselpunk graphic novel style, mature neo-noir tone;
  2. Color Palette (emoción cromática): p. ej., desaturated amber and deep teal contrast, rusty bronze highlights, rich shadow details;
  3. Lighting Base (textura lumínica): p. ej., heavy chiaroscuro lighting, harsh directional rim light, high contrast dramatic shadows;
  4. Environment Base (materiales físicos del escenario): p. ej., weathered rust and scuffed brass, damp asphalt reflections, atmospheric smog;
  5. Quality & Lens (óptica cinematográfica): p. ej., 35mm film grain, Panavision anamorphic lens flare, shallow depth of field, 8k resolution.

2.2 Lista de verificación de fijación previa

Antes de comenzar, el modelo de síntesis de imágenes genera 4 muestras de diferentes encuadres para que un humano las revise y apruebe:

  • Muestra 1 (Plano general, LS): verifica que la iluminación, el tono y la atmósfera material cumplan con lo esperado;
  • Muestra 2 (Plano medio del protagonista, MLS): verifica la vestimenta, la postura y los adornos característicos;
  • Muestra 3 (Primer plano del protagonista, CU): verifica los ojos, el rostro, el peinado y la textura facial;
  • Muestra 4 (Primerísimo primer plano de atrezo clave, ECU): verifica los detalles de superficie dura y la estructura mecánica.

3. SOP rígido: Generación de imagen fija conjunta por plano (Pre-generación I2V)

Contraejemplo (prohibido): ¡Ejecutar T2V directamente con texto en H3 sin tener la imagen fija del primer fotograma del plano!
Síntoma: Debido a que el ruido latente inicial de la difusión 3D es aleatorio, un mismo personaje generado puede cambiar de peinado, sufrir deriva ósea facial (cambio de rostro) y variar el estilo de la ropa al cambiar de plano.

3.1 Pasos para generar la imagen fija conjunta

Para cada segmento (seg01 ~ seg08) en plan.json:

  1. Ensamblar el prompt de generación de imagen del plano:
    • Inyectar la apariencia y vestimenta exclusivas del protagonista;
    • Inyectar la posición de cámara especificada para el plano actual (p. ej., M2_RACK_FOCUS para el enfoque con cambio de plano de un objeto);
    • Inyectar el microescenario y atrezo concretos del plano actual (p. ej., sharp serrated hunting dagger vibrating in tabletop);
    • Inyectar las palabras de estilo e iluminación de style_bible.json.
  2. Usar un modelo de generación rápida (Flux / SDXL) para renderizar imágenes estáticas 16:9 en lote (5~10 segundos/imagen);
  3. Control de calidad en tres niveles (Keyframe Gate Check):
    • Consistencia facial: los rasgos característicos (parche en el ojo, peinado, cicatriz) están claramente alineados;
    • Fidelidad a la posición de cámara: el encuadre y el ángulo se ajustan estrictamente al plano requerido, sin extremidades sobrantes;
    • Superficie dura de atrezo: los bordes de armas, diales y maletines son nítidos, sin deformarse;
  4. Una vez aprobada, renombrar y guardar como segments/{seg_id}_keyframe.png.

4. Scripts de herramientas dedicadas

  • Gestión de fijación y generación del primer fotograma del plano: python scripts/keyframe_gate.py --scan
  • Sincronización del primer fotograma al repositorio de ComfyUI: python scripts/keyframe_gate.py --project <Nombre_del_proyecto> --sync

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

comfy-h3-render-core

短剧工业化管线·第 3 工序:H3 物理视频渲染与防翻车调度。负责与本地 ComfyUI 服务交互,调度 MiniMax H3 进行 Turbo 8-step 视频生成。硬核沉淀:Windows WDDM 驱动锁防御、潜空间 32 整除铁律、单人发音锁定与全员闭嘴抑制指令装配、首帧 I2V 安全注入、分镜间显存防泄漏。

comfy-h3-video-producer

本地 ComfyUI 剧本转视频自动生产管线(MiniMax H3)。用户给剧本要求用 ComfyUI 出分镜视频,或提到"一采二采/超分/班长套件/CSGlide/工作流生成视频"时使用。覆盖:工作流握手(不写死节点号)、导演调度与段规划、H3 提示词、提交与自动监工、一采双检闸门、收片清床音与拼接、断点续产。

drama-audio-soundstage

短剧工业化管线·第 4 工序:声音工程与智能避让配乐。负责 H3 视频生成后的声音精修。硬核沉淀:谱减法音频门控(消灭风噪/电流床音)、Whisper ASR 纯普通话语种漂移拦截、FFmpeg 原生侧链动态避让混音(Sidechain Ducking,台词开口 BGM 瞬降 -14dB,闭嘴扬起)。

drama-director-staging

短剧工业化管线·第 1 工序:编剧与导演分镜调度。负责将剧情大纲或小说文本转化为符合短剧视听规律的工业级分镜。内置:6 大动态运镜轮换决策树、台词纯中文汉字归一化(数字大写)、短剧快节奏 20~28 字密度调控、单人发言与旁观者闭嘴标注。

drama-finishing-upscaler

短剧工业化管线·第 5 工序:终期成片与 1080p 超分增强。负责全集分镜无损拼接与院线级 1080p 超分辨率放大。硬核沉淀:FFmpeg concat 零损耗直拼、RealESRGAN x2plus GPU 独占 FP16 批量超分(~4.8fps)、原生高质量避让音轨无损混流、ffprobe 工业级物理参数验收。

Skills relacionados