¿Qué hace Pulupulu Motion?
Una película aquí es una línea de tiempo en HTML que Chrome renderiza fotograma a fotograma. Nada es un editor de video: tú escribes una página, la CLI la captura a una frecuencia de fotogramas fija, ffmpeg multiplexa el sonido.
Este archivo es el enrutador. Responde: ¿puedo hacer este trabajo?, ¿qué ejecuto primero?, ¿qué tiene que pasar? y qué página tiene el detalle. Carga una página de referencia solo para la parte en la que estás trabajando.
1. Antes de prometer nada
python scripts/doctor.py # solo lectura: python, node, ffmpeg, la CLI, clave, disco
python scripts/doctor.py --project film/ # también: el contrato de la página está presente
Salida 1 significa que no se puede hacer una película en esta máquina. No lo descubras después de escribir escenas. Nunca llames
npx por comando: un viaje de ida y vuelta de red en cada check, still y render es la ralentización
autoinfligida más común en este flujo de trabajo.
Esta herramienta es la elección incorrecta cuando la historia necesita material de archivo que no tiene, el rostro o la apariencia de una persona real, anatomía humana o animal articulada, una acción física realizada de forma continua o sincronía de labios. Renderiza geometría vectorial plana, texto, gráficos, mapas, iconos y objetos codificados por colores bien, y esas otras cosas mal. Dilo en lugar de producir un sustituto: un dibujo sustituto para material de archivo es un problema de procedencia, no una elección de estilo.
2. El flujo de trabajo, en orden
Un latido = una oración = una toma. El tiempo proviene del habla medida, nunca de la invención.
- Brief. Tema, audiencia, plataforma, idioma, si hay narración. Pregunta por un tema faltante; no preguntes si narrar cuando se solicitó un video.
- Storyboard antes que HTML —
references/narration-and-captions.md. El subtítulo son las palabras habladas literales, no un resumen de ellas. - Narrar y medir.
python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, luegogatepara verificar cada frase con ASR. Ruta, voces y límites:references/narration/deepseek-tts.md. - Construir la página desde
timeline.json, no desde el storyboard. Contrato:references/cli.md. Cuando la historia necesite objetos que ninguna biblioteca de iconos tenga, genéralos primero como paneles de impresión —references/generated-assets.md— y ensámblalos; nunca dibujes a mano un sustituto para una fotografía. - Verificar, luego mirar.
pulupulu check ., luegopulupulu still . --at 2,12,24 --out .om/stillsy abre las imágenes fijas. Una página que pasacheckaún puede renderizar en blanco. - Renderizar —
pulupulu render . --format mp4 --fps 30. Bloqueos, fotogramas negros y duraciones incorrectas:references/render-traps.md. - Mezclar y multiplexar con mapeo de flujo explícito —
scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4multiplexa y valida en una sola llamada. Receta manual y la cadena de reducción de volumen:references/workflow.md. - Validar el archivo que entregarás, no la salida más reciente del renderizador:
python scripts/deliver_check.py out/film.mp4 --timeline timeline.json. - Entregar con advertencias honestas: qué está dibujado en lugar de lo obtenido, y qué dice la nota de QA.
3. Puertas de verificación
Solo estas bloquean. Todo lo demás que imprima una herramienta es una nota de lectura: respóndela con un argumento o arréglalo, pero nunca lo reportes como aprobado cuando no lo estaba.
| puerta | comando | qué prueba | si falla |
|---|---|---|---|
| preflight | python scripts/doctor.py | la máquina puede renderizar | detente, reporta qué falta |
| composición | pulupulu check . | contrato de página, ningún archivo faltante | arregla antes de renderizar |
| idioma | python scripts/lang-audit.py film/index.html --lang en | ningún texto en el otro idioma, incluyendo literales de cadena dentro de <script> | traduce el literal, vuelve a ejecutar |
| habla | python scripts/deepseek_voice.py gate beats.json --voice stella | cada frase se transcribe de vuelta a sus propias palabras | reescribe la frase; nunca envíes un fragmento |
| archivo | python scripts/deliver_check.py out/film.mp4 --timeline timeline.json (o --video/--audio/--out para multiplexar primero) | tamaño de fotograma, frecuencia de fotogramas, audio presente y suficientemente largo, pico verdadero, tamaño de entrega | re-multiplexa o re-codifica |
| pops | pulupulu qa out/film.mp4 | sin pops de un solo fotograma | encuentra el elemento de un fotograma |
pulupulu qa también reporta movimiento por segundo, still por ≥ 1 s y apertura plana. Esos son juicios
sobre el ritmo, medidos en una comparación en escala de grises de 96×54, por lo que un movimiento lento de bajo contraste puede leerse como estático. Úsalos
como una razón para mirar, no como un veredicto que obedecer.
Lo que ninguna puerta prueba: que la película es buena, que el ASR escuchó el número correcto (verifica dígitos y sustantivos propios como tokens), o que un subtítulo se encuentra donde la interfaz de usuario de una plataforma no lo cubrirá.
4. Trampas que cuestan un renderizado
Detalle completo y correcciones en references/render-traps.md. Las que detienen un renderizado en seco:
- Escribir
<g>/<rect>/<path>en bruto dentro de un<div>no renderiza nada y no advierte nada. Envuelve cada fragmento de escena en su propio<svg viewBox>. - Una fuente web dentro de
<text>SVG en línea re-rasteriza esa capa cada fotograma. Pon el texto en HTML, o dibújalo como formas. feTurbulencecomo filtro por fotograma — SVG en línea o un fondo CSS — paraliza el renderizador. Hornea el ruido en un mosaico PNG una vez.- Una escala de GSAP a fotograma completo en un SVG en línea re-rasteriza la placa; la composición con translate funciona bien, y una capa de mapa de bits se puede escalar. Cuando un push sea imposible, anima pequeños grupos internos.
repeat: -1hace que la línea de tiempo sea infinita: una película de 87 s silenciosamente se convierte en 117 s. Calcula vueltas finitas.- Después de un renderizado fallido, mata solo el Chrome sin cabeza que dejó.
taskkill //IM chrome.execierra el propio navegador del usuario.
5. Dónde vive el detalle
| trabajando en | página |
|---|---|
| comandos, contrato de página, instalación | references/cli.md |
| los nueve pasos, contrato del proyecto, multiplexación | references/workflow.md |
| storyboard, subtítulos, puerta de un solo idioma | references/narration-and-captions.md |
| paleta, presupuesto de elementos, personalidad, ritmo | references/design-taste.md |
| lenguajes de movimiento, técnicas, capa 3D | references/motion-library.md |
| mejora, demo de producto, cabeza parlante, gramáticas | references/workflows-specialized.md |
| mundos musicales, compositor, efectos de sonido, síntesis de narración | references/audio-and-music.md, references/narration/deepseek-tts.md |
| un renderizado en blanco, bloqueado o de duración incorrecta | references/render-traps.md |
| qué verificar, y en qué orden | references/verification.md |
| recetas de estilo, lenguaje de cámara | references/art-motion/INDEX.md |
| obtención de iconos y vectores, licencias | references/asset-sourcing.md |
| arte generado por un modelo de imagen, recorte de impresiones, montaje | references/generated-assets.md |
| arte vectorial plano, mundos de desplazamiento | references/2d-vector-motion.md |
| qué temas puede manejar este renderizador | references/topic-fit.md |
| sincronización y easing a nivel de subsegundo | references/ui-motion/ |
| publicación de esta habilidad (un commit, v1.0) | references/publishing-skills.md, references/publishing.md |
La ruta de receta de estilo (scripts/art-motion/engine/) es un tiempo de ejecución de 20 MB que deliberadamente no está
en este repositorio: una habilidad no debería hacer que cada agente descargue un motor que quizás nunca use, y un árbol de 37 MB
no puede ser revisado. Se instala fijado y verificado por suma de comprobación, en las rutas exactas que citan las páginas anteriores:
python scripts/install_art_motion.py --check # ¿está ahí?
python scripts/install_art_motion.py # núcleo: lib + demos + escenas, 20 MB
python scripts/install_art_motion.py --with-reference-films # + material de estudio, 14 MB más
Todo lo demás — las puertas de verificación en Python, las especificaciones de clip, la documentación — está en el repositorio y no necesita
instalación. Nunca hagas commit del árbol descargado: .gitignore ya lo cubre.
6. Scripts
| script | hace |
|---|---|
scripts/doctor.py | preflight, solo lectura |
scripts/deepseek_voice.py | probe · speak · cost · lay · beats · asr · gate — narración y su línea de tiempo medida |
scripts/deliver_check.py | valida el archivo entregado: tamaño, tasa, audio, pico, duración contra la línea de tiempo |
scripts/lang-audit.py | puerta de un solo idioma sobre el marcado y los literales de script |
scripts/art-motion/icon_audit.py | familias de iconos, conteo de colores, hoja de contactos |
scripts/art-motion/qa.py | heurísticas de ritmo y pops en un archivo renderizado |
scripts/stamp_credit.py | añade la línea by Alucard0x1 a los archivos de texto |
7. Trabajar con una persona
Muestra fotogramas, no adjetivos. Un fotograma heroico por acto mata una semana de trabajo equivocado. Cuando te corrijan, pon la corrección en esta habilidad en lugar de en una respuesta de chat.
Traspasos: sincronización y prosodia de la narración → habilidad tts-intonation · fusionar o traducir otra
biblioteca → habilidad agent-skill-sourcing · derechos e imagen antes de publicar → habilidad
media-content-safety · obtención de un video de referencia → habilidad streaming-mirror-extraction ·
tomas 3D o basadas en material de archivo → habilidades headless-three-video-render y cinetic · películas
basadas en texto → habilidad kinetic-typography.