concept-reel: reels explicativos de conceptos sin voz en off

Concept Reel · 概念短片

Deja que la imagen explique una frase: el público reconoce al sujeto, ve el cambio y entiende la causa y el efecto. Entrega un proyecto ejecutable, storyboard y fuentes de hechos, así como una vista previa o el producto final dentro del alcance solicitado.

Este directorio de skill contiene un motor compartido; el proyecto puede crearse dentro del proyecto del usuario. Las rutas engine/ y scripts/ son relativas a este directorio de skill; usa las rutas reales al invocarlos. El formato fijo actual es 1920×1080 horizontal; 30 fps por defecto, pero los proyectos nuevos pueden configurar la velocidad de fotogramas.

Lectura según la tarea

• Para crear o ajustar tomas: primero lee Guía de producción, luego Métodos de explicación visual.
• Para escribir film.js o usar herramientas: lee API del motor.
• Para seleccionar o expandir estilos: lee 15 estilos y selección, usa --list-styles / --describe-style ID para consultar recetas; las apariencias antiguas B/C están en Apariencias compatibles. Sigue las preferencias del usuario si ya hay un estilo elegido.
• Para ajustar el texto: lee Guion.
• Para películas largas, capítulos, curvas acumulativas y eventos: lee Experiencia en películas largas.
• Para problemas de composición o transiciones: lee Diseño y Gramática visual.
• Si necesitas un brief: lee Ejemplos de prompts; para ejemplos de revisión, lee Métodos de análisis.

Principios de creación

• Primero decide qué debe entender el público, luego elige el sujeto y la acción. Las figuras geométricas pueden usarse para gráficos y cantidades abstractas; al describir objetos reales, deben tener formas recognoscibles.
• Los cambios en los subtítulos deben ocurrir en pantalla. Los números provienen de cálculos; las indicaciones, condiciones aplicables y hechos inciertos deben marcarse claramente; los hechos importantes deben tener fuentes verificables.
• Solo un foco visual principal a la vez. Los subtítulos pueden ser estables, con títulos, palabras clave y etiquetas dispuestos según el sujeto y el espacio en blanco.
• Unifica la tipografía, el significado del color y la sensación de movimiento; elige el centro de gravedad de la toma, el plano y la densidad de información según el contenido. El preset de estilo es un punto de partida; se puede ajustar la paleta y el movimiento, combinando un estilo principal y uno secundario.
• Calcula el tiempo de lectura de pausa solo después de que los subtítulos se muestren completamente; las imágenes y el razonamiento requieren tiempo adicional. Primero deja que la conclusión se detenga, luego desaparece.
• La animación está determinada por t. Usa una semilla fija para números aleatorios; no decidas la imagen basándote en el reloj en tiempo real, temporizadores o estado acumulado entre fotogramas.
• Los ejemplos originales son para aprender el método de implementación; las nuevas películas deben crearse en torno a su propio tema, texto y storyboard. Las fuentes y los límites del material se encuentran en NOTICE.

Flujo de trabajo

Determina el alcance de la entrega. Identifica el tema, el texto existente, las tomas defectuosas actuales, la duración, el estilo, la música de fondo y si se necesita una exportación completa. Avanza directamente con las elecciones que puedan inferirse del contexto; solo aclara los requisitos faltantes que afecten el resultado. Cuando el usuario haya autorizado la producción completa, continúa hasta terminarla, sin pedir aprobación por fases repetidamente.

Organiza los hechos y el storyboard. Escribe una frase que resuma el problema central y una tabla de hechos (hecho, fuente, condiciones aplicables, nivel de certeza). Registra por toma: tiempo, tarea narrativa, sujeto y centro de gravedad, texto y orden de lectura, acción, pausa completa de lectura y sonido. Primero resuelve las frases que no se puedan dibujar claramente, luego ordena el tiempo. Conserva el significado original del texto existente; si es necesario modificar hechos o estructura, explica las razones.

Lleva el estilo a la representación visual. Cuando no haya un estilo definido, considera 2–3 direcciones según el sujeto, las relaciones espaciales, la densidad de información, el tono del movimiento y el costo de implementación, luego elige una opción adecuada para el contenido. El storyboard debe registrar las razones de la selección, las características reconocibles y los límites de implementación. Usa la galería de estilos para explorar movimientos, pero aún así crea tu propia película según los hechos y el storyboard. Los presets 3D, vidrio y líquido son adaptables a Canvas; los renders realistas complejos requieren implementación aparte; los subtítulos de variedades siguen siendo en horizontal.

Primero valida las tomas clave. Verifica el entorno, crea el proyecto, luego implementa la parte más difícil o la que mejor represente el estilo. El esqueleto no tiene imágenes de la película terminada; necesita completar SUBS y las funciones de escena. Si ya hay storyboard, se conserva; si hay código fuente, por defecto no se sobrescribe.

python scripts/check_env.py
python scripts/new_film.py --list-styles
python scripts/new_film.py --describe-style isometric
python scripts/new_film.py <directorio_del_proyecto> --style isometric --title "Título" --duration 60 --fps 30
python engine/render.py <directorio_del_proyecto> --serve
python engine/render.py <directorio_del_proyecto> --stills 2.5 8 15
python engine/render.py <directorio_del_proyecto> --motion 8 10 12

Si faltan dependencias del entorno, instálalas según el README; si faltan fuentes, ejecuta python engine/get_fonts.py. Por defecto se usa Chromium incluido; si el usuario necesita Chrome nativo, pasa --browser chrome.

--style ID y --world B/C son mutuamente excluyentes; si no se especifica, se mantiene el C por defecto. Los nuevos estilos del proyecto incluyen una receta STYLE ajustable, que usa VStyles compartido; motion.fps se refiere a la frecuencia de muestreo sugerida para el movimiento del estilo, pero la velocidad de fotogramas real de salida la determina --fps. El esqueleto no genera contenido temático automáticamente.

Revisa y expande. Mira las capturas reales; determina si el sujeto es reconocible, si la acción explica algo, si el texto es legible; verifica si hay obstrucciones en el tamaño de visualización objetivo. Ajusta los problemas encontrados y revisa los momentos relevantes, luego expande toda la película. Una función por escena; los subtítulos se dibujan en la capa más externa del draw. Los capítulos complejos pueden dividirse en archivos, declarados en index.html.

python engine/render.py <directorio_del_proyecto> --sheet 16
python engine/render.py <directorio_del_proyecto> --det
python engine/render.py <directorio_del_proyecto> --clip 0 5 preview

--sheet con un solo valor indica el número de fotogramas a tomar; con múltiples valores indica momentos específicos. Si --det falla, verifica el estado del Canvas, la semilla aleatoria y la caché entre fotogramas; no llames "aprobado" a un fallo.

Exporta y agrega sonido según el alcance autorizado. Cuando se solicite el producto final, realiza el render completo, la exportación de eventos y la síntesis de audio; si solo se necesita código fuente/vista previa, entrega después de completar los resultados correspondientes.

python engine/render.py <directorio_del_proyecto> --jobs 4
python engine/render.py <directorio_del_proyecto> --events
python engine/audio.py <directorio_del_proyecto>
# Si hay música de fondo externa disponible
python engine/audio.py <directorio_del_proyecto> --bgm music.mp3 --bgm-db -8

Los nombres de eventos fr.sfx son: tick, soft, chord, bloom (compatible con flash), rise, thud, tock, stamp, shimmer, hush. Incluso sin música externa, se puede sintetizar sonido de fondo y efectos; explica los resultados reales. --wav-only solo genera la pista de audio sintetizada, sin superponer BGM externo.

Aceptación y entrega. Mira continuamente los clips/película completa exportados y verifica puntos de entrada, lectura estable, acciones clave y puntos medios de transición. Confirma que los hechos y el storyboard coincidan, que el audio y el video estén sincronizados, que los números sean consistentes y que no falten caracteres en las fuentes. Corrige los problemas encontrados y revisa las tomas afectadas. Entrega la ruta del código fuente, la vista previa o renders/final.mp4, y describe brevemente los resultados de la verificación y las limitaciones reales; si no se ha visto completamente alguna parte, indícalo claramente.

Proyecto y artefactos

index.html hace referencia a los recursos compartidos de /engine/ y al film.js local; storyboard.md guarda el storyboard y los hechos. review/ contiene fotogramas clave, audio/ contiene eventos y pistas de audio sintetizadas, renders/ contiene clips y el producto final. Los artefactos generados no se suben por defecto, pero se conserva el código fuente que puede volver a renderizarse.