Release film: lo que cambió, mostrado cambiando
Un promo vende el producto; un release film muestra el delta de una versión a personas que ya conocen el producto. Mismo motor, trabajo diferente: el estado anterior importa, cada afirmación está limitada por una etiqueta, y la película es un episodio de una serie.
Este skill extiende site-promo-film, en el directorio hermano ../site-promo-film/. Lee primero su SKILL.md: dirección, el aspecto, prohibiciones, reglas de construcción, trampas del lienzo, imágenes fijas antes del renderizado, renderizar y verificar, todo se aplica sin cambios. Este archivo solo contiene lo que añade un lanzamiento.
| Archivo | Qué es |
|---|---|
template/release.html | El motor más una demo de versión de 16 s: tarjeta de versión → la aplicación tal como era → un nuevo control aterriza en la barra de herramientas y se hace clic (la lista se reordena, las filas se elevan) → un atajo en teclas abre una nueva superficie (una píldora que se abre en un panel) → el resto del registro de cambios → la ruta de actualización se hace clic en un menú de cristal → vuelta a la tarjeta de versión. Diseños ancho y cuadrado desde un solo archivo; cada cambio destacado puede tener su propia luz. |
../site-promo-film/template/film.js | El escenario (fluctuación de subpíxel por subfotograma: nada se mueve o brilla en movimientos lentos), FILM.draw para iconos y símbolos, la línea de tiempo para una película larga, efectos. La plantilla lo carga; documentado en su parte superior y en site-promo-film §5. |
../site-promo-film/template/parts.js | Piezas vectoriales: ventanas, un navegador, un terminal, dispositivos, teclas, un interruptor, un anillo. |
../site-promo-film/template/fx.js | El aspecto — fondo, luz, grano, cristal, ondas de clic — compartido con la plantilla promocional, que lo documenta (su §4). |
../site-promo-film/scripts/render.mjs, contact.mjs, beats.mjs | El renderizador, la hoja de contactos y el ritmo de una banda sonora (site-promo-film §7, El ritmo), usados tal cual: PAGE=release.html node render.mjs …. |
../site-promo-film/scripts/clickcheck.mjs | ¿Se ve cada clic (§3b): la cámara quieta y el cursor en reposo en cada uno de los CLICKS de la página. node clickcheck.mjs release.html, salida 1 si hay un clic que nadie verá. |
../site-promo-film/scripts/deliver.mjs | Las películas terminadas y sus portadas en una carpeta propia, luego la carpeta de trabajo a la Papelera una vez que su kit esté a salvo (site-promo-film §8). |
Copia la plantilla (o el kit del producto, §5), film.js, parts.js, fx.js (y type.js con las fuentes que configura, para titulares en un estilo type.js) y los cuatro scripts en la carpeta de trabajo src/, ~/Downloads/<producto>-<version>-whats-new-work/src/ (~/Downloads es la raíz de trabajo a menos que la configuración diga lo contrario: site-promo-film, la sección Studio), y ejecuta npm i playwright-core allí. La demo se renderiza en 69 s con 16 subfotogramas en 8 trabajadores, 171 s con un aspecto tramado (night); medido en ancho.
Invocado con ? o help, o sin nada mientras no haya nada en la conversación que nombre un lanzamiento: el modo guiado, ../site-promo-film/guide.md. Pregunta qué versión y recorre el brief; no se renderiza nada en él. El Studio (site-promo-film, Studio) escribe un brief de versión también: kind: release, la versión en release.tag; responde las preguntas de §1.
0 — ¿Hay una película en este lanzamiento?
Solo se pregunta una vez que el usuario ha pedido una película: un comando de lanzamiento no lo plantea, y nada aquí se propone por iniciativa propia. Los renders siguen los valores térmicos predeterminados de site-promo-film §7.
- Construye la lista a partir de la etiqueta, nunca de la memoria:
git log --oneline <etiqueta-anterior>..<ref>, los PR fusionados, las notas del borrador de lanzamiento. Una película hecha de "lo que creo que hay" muestra una función que se coló, o una de la versión anterior. - Califica cuando algo que una persona ve o hace de manera diferente se lanza: una nueva superficie, un nuevo control, un rediseño, un nuevo atajo. Las correcciones, la velocidad y los internos no lo hacen; dilo en una línea y para. Una película de un lanzamiento sin nada que mostrar es una tarjeta de título con un número.
- Destaca como máximo tres cambios. El resto va en el rollo del registro de cambios, textual de las notas, o en ninguna parte. Cinco cambios destacados significan tres segundos cada uno, lo que es un pase de diapositivas.
1 — Pregunta, luego espera
Mira primero: las películas anteriores del producto (su kit, §5), las instrucciones del proyecto sobre dónde va el material de lanzamiento, y su modo de demostración o accesorios. Un activo que ni el kit ni el código fuente en la etiqueta tienen (el maestro del icono, un logotipo como vector) se pide en el mismo mensaje, nunca se inventa (site-promo-film §1). Luego pregunta en un mensaje, cada uno con un valor predeterminado:
- Lanzamiento y ref para filmar (predeterminado: la etiqueta;
maincuando aún no está etiquetado, luego vuelve a verificar en la etiqueta). - Cambios destacados (predeterminado: mi elección del registro, una línea cada uno sobre por qué se muestra bien).
- Duración (predeterminado: ~6–8 s por cambio destacado más ~3 s de tarjeta de versión, 15–30 s; duplica eso una vez que haya clics que ver, §3b). Una película de 30 s o más que va a YouTube obtiene capítulos (§6); una más corta no puede: YouTube quiere tres, el primero a las 0:00, cada uno de al menos 10 s.
- Formatos: un máster 16:9 (predeterminado) y un corte cuadrado como segundo diseño.
- Aspecto (predeterminado: el del kit; para una primera película, una hoja de aspectos de un fotograma real, como en site-promo-film §4).
- Dónde va (predeterminado:
<producto>-<version>-whats-new/, entregado como dice site-promo-film §8, que contiene solo las películas terminadas y las portadas, mientras que su carpeta-workpermanece en la raíz de trabajo (~/Downloadspor defecto); el propio lugar del proyecto para el material de lanzamiento cuando sus instrucciones nombren uno). - Música: ninguna por defecto. Los clips de lanzamiento se reproducen automáticamente en silencio, por lo que el texto lo lleva todo.
Luego un storyboard en la cuadrícula de ritmo cuando el producto tiene un kit (el estilo está definido, solo el contenido es una elección), tres cuando esta es su primera película. Espera una señal de aprobación.
2 — Fuente: la aplicación, en la ref
- Lee el código en la ref, no el árbol de trabajo:
git show <ref>:<ruta>. Ver código da las cadenas, símbolos, espaciado y colores; las capturas de pantalla con script del proyecto (modo demo, accesorios) dan proporciones. Nunca una captura con datos reales. - El estado anterior proviene del código fuente de la etiqueta anterior. Recrearlo de memoria es incorrecto exactamente en el detalle que el lanzamiento cambió.
- Cada cadena en pantalla existe en la ref:
git grep -nF -- '<cadena>' <ref>debe acertar, para texto de UI, elementos de menú y el atajo en una tecla (busca la vinculación, no la documentación). Filma en el idioma fuente. - Los titulares son las líneas de beneficio de las notas de lanzamiento, unas pocas palabras: no títulos de PR, y nada que el lanzamiento no haga. Son afirmaciones públicas.
- Un cambio que se lanza desactivado por defecto necesita su interruptor en pantalla. De lo contrario, la película anuncia algo que el espectador no puede encontrar.
3 — Patrones de storyboard
- Abre y cierra en la tarjeta de versión: icono, nombre, "Novedades en X.Y", la versión en el color de acento. Es el fotograma 0 y el último fotograma, aproximadamente 1.5 s a cada lado del punto de bucle.
- Cambio en el lugar. Muestra la superficie tal como era durante un ritmo, luego deja que el cambio ocurra sobre ella: el control aterriza en la barra de herramientas, la lista se reordena, el panel crece una sección. Sin etiquetas de antes/después y sin pantalla dividida: la transición es la explicación. Acerca la cámara a medida que el cambio aterriza, aléjala a medida que se usa.
- Una nueva superficie crece a partir de lo que la abre: el clic, el elemento de menú, el atajo. Un atajo va en teclas en el espacio del titular, presionado en el ritmo que la superficie responde.
- Un cambio destacado, un titular, una interacción. El titular entra cuando el cambio aterriza, no antes: el espectador lo ve, luego lee qué era.
- Un capítulo puede tener su propio color. Con un aspecto que tenga luces, las
keysdel aspecto las recolorean a medida que cada cambio destacado aterriza y devuelven los primeros colores para la tarjeta de versión, como hace la demo. Déjalo fuera cuando los colores del producto signifiquen algo (una cuenta, un estado). - El resto del registro de cambios como un rollo corto en el espacio del titular, una etiqueta ("También en X.Y") y de tres a cinco líneas textuales de las notas, una por ritmo. Solo cuando el resto merezca ser nombrado.
- Cierra en la ruta de actualización, clic real: la propia ruta del producto a la nueva versión (un elemento de menú Buscar actualizaciones…, un botón de tienda, la URL del sitio). Luego la UI se colapsa de nuevo en el icono. En un menú, la fila resaltada es la que está debajo del cursor en ese instante, calculada a partir de la propia pista del cursor, por lo que pasar sobre una fila la ilumina como lo haría un menú real.
- Sin barras de progreso, contadores de capítulos ni insignias "NUEVO": el cambio del titular es el corte del capítulo.
- Cambio en el lugar es el formato, no el único. Cuando la última película del kit ya lo hizo, varía: las notas que se abren en las pantallas que describen, la superficie cambiada en profundidad 3D, un
wipede antes/después en el mismo fotograma, un tutorial del nuevo flujo. site-promo-film §2 tiene el catálogo; una película de lanzamiento toma uno y dice cuál en su storyboard. - Un lanzamiento importante puede tener una película larga (1–3 min, un capítulo por cambio destacado, no un bucle) en la línea de tiempo de site-promo-film §2b, junto al clip corto para publicaciones en redes sociales.
3b — Cada clic se ve
Una película de lanzamiento es principalmente clics, y un clic es un ritmo que el espectador tiene que ver aterrizar. Un corte de 30 s una vez se reprodujo con sus movimientos demasiado rápidos y algunos clics faltaban. Medido: dos clics cayeron mientras el fotograma se movía a 1255 y 1414 px/s, y la mayoría aterrizó en un cursor quieto a 20-45 pt de su objetivo. El corte de 60 s cronometrado por la regla a continuación midió cada clic por debajo de 2 px/s y 1 pt.
- La cámara ha llegado antes del clic. Inicia un movimiento de cámara al menos aproximadamente 1.3 s antes del clic que enmarca, y muévete solo una vez que la UI haya respondido.
- El cursor descansa antes de presionar: dale a cada movimiento aproximadamente dos segundos en resortes lentos (f 0.85 en horizontal, 0.75 en vertical; un salto corto puede ser más rápido), para que se quede quieto durante medio segundo.
- Se queda durante la presión, mantenido el tiempo suficiente para verse (abajo 0.05 s, arriba 0.14 s después), con un anillo más grande; el siguiente movimiento comienza no antes de 0.3 s después de la presión.
- Lo que abre un clic nunca cubre lo que se hizo clic: un panel cae desde debajo de su elemento, una ventana crece desde el lado de la notificación de la que vino, una hoja se cierra 0.15-0.2 s después de presionar su botón. El máster de 60 s inicial hizo crecer la cáscara sobre el elemento clicado en la presión y lo ocultó; las imágenes fijas en tiempos exactos nunca lo mostraron, los fotogramas extraídos del mp4 sí.
- Compruébalo:
node clickcheck.mjs release.htmlantes de la aprobación (mide la cámara en el punto clicado, el recorrido antes de la presión y durante ella; ambas plantillas pasan), y después del renderizado extrae un fotograma del mp4 en cada tiempo de clic (site-promo-film §7). - En un iPhone o un iPad (el
framedel brief, site-promo-film §0) un clic es un toque: no se dibuja ninguna flecha, y un dedo se muestra solo mientras toca (un disco suave que presiona, con la onda del aspecto). La página aún declaraCLICKS, ycurX(t)/curY(t)son donde está el dedo: saltan al siguiente punto tocado entre toques y descansan sobre él antes y después de cada uno, por lo queclickcheck.mjsmide los toques exactamente como mide los clics, y una página sinCLICKSaún sale 2. Las reglas anteriores se mantienen, la cámara está por encima de todas.
4 — Diseño: una ranura y una región libre
La plantilla calcula la cámara en lugar de ajustarla manualmente. fit(rect, head) devuelve la cámara que hace que un rectángulo del mundo llene la región libre (junto a la ranura del titular en ancho, debajo de ella en cuadrado, o todo el fotograma sin titular), limitada a zmax. Tres reglas, cada una medida al construir la demo:
- Con un titular arriba, un primer plano llega hasta el borde de la superficie en el lado de la ranura (
toEdge). Ajusta solo el detalle y el resto de la ventana se desliza debajo del titular, que luego se sitúa mitad sobre el lienzo y mitad sobre la ventana oscura. - En cuadrado, un primer plano mantiene el ancho completo de la superficie, o sus etiquetas de fila se cortan en ambos bordes del fotograma.
- El título de salida se dibuja debajo de la forma que se transforma, por lo que la ventana crece sobre él. Dibujado encima, sus letras que se desvanecen se imprimen a través de la ventana durante medio segundo.
Una segunda relación de aspecto es un segundo diseño, nunca un recorte del primero: la página lee location.hash, y PAGE='release.html#square' pasa el hash a través de render.mjs. El hash también toma el aspecto, unido con &: PAGE='release.html#square&look=night'.
5 — El kit: cada película de un producto parece un mismo programa
La primera película para un producto (o su site-promo film) produce un kit: fuentes, tokens de color, el icono como vector, la tarjeta de versión, el cromo de la ventana, el lenguaje de la cámara, el aspecto (su preajuste y anulaciones: una línea FX.look). Compromételo con el producto, donde sus instrucciones digan (de lo contrario propón un lugar, scripts/film/ por ahora), antes de que se deseche la carpeta de trabajo, para que el próximo lanzamiento comience desde el kit en lugar de desde la plantilla: un storyboard, solo cambia el contenido, y la serie es reconocible. En la tarjeta de versión solo cambia el número.
Lo que un kit conserva es la página, no el motor. El motor es del skill y se copia de nuevo para cada película. La página es el trabajo: las superficies del producto como vectores, cada cadena obtenida de una etiqueta, el tiempo que sobrevivió a las rondas de revisión, y un README de lo que esas rondas enseñaron. La ubicación del kit se almacena en settings.filmKit (site-promo-film, Configuración); por defecto, junto al producto en scripts/film/.