ll-video-progress

Barra de Progreso de Capítulos para Video

Flujo del Usuario

1. Primero verifica si el usuario ya ha subido un archivo SRT en esta conversación o ha proporcionado explícitamente la ruta del archivo SRT a usar. Solo se pueden leer subtítulos de esta fuente. Si la conversación actual no tiene un SRT proporcionado por el usuario, debes responder: "Por favor, sube primero el archivo de subtítulos SRT de este video. Usaré una tabla para sugerirte una división en capítulos según los subtítulos y, una vez que confirmes, crearé la barra de progreso." Luego espera a que el usuario lo proporcione; en este punto no se realiza búsqueda de archivos, lectura de subtítulos, análisis de contenido ni generación de la barra de progreso. No está permitido buscar archivos SRT en la máquina local, en el espacio de trabajo actual, en proyectos anteriores, en directorios de descargas, en otras conversaciones o en la memoria. Tampoco se puede seleccionar un SRT que parezca adecuado. Se pueden reutilizar archivos ya proporcionados por el usuario en la conversación actual sin solicitar otro; si hay varios archivos y el usuario no especifica cuál usar, pregunta primero. Si un archivo especificado no se puede leer, pide al usuario que lo suba de nuevo o verifique la ruta, sin buscar archivos alternativos. Solo cuando el usuario pida explícitamente ver un estilo o crear una muestra de duración fija, se puede usar contenido de muestra incorporado; una frase como "genérame una barra de progreso" no es una excepción.
2. Lee el SRT completo y sugiere una cantidad de capítulos basada en la semántica del contenido, los cambios de tema, la duración del video y las necesidades del usuario, sin un límite máximo fijo de segmentos; la división especificada por el usuario tiene prioridad. Primero di: "Sugiero dividirlo en X segmentos", y luego debes enumerar las sugerencias de división usando la tabla de abajo. Espera la confirmación del usuario antes de continuar; si el usuario solicita fusionar o dividir, actualiza toda la tabla y vuelve a confirmar. No uses listas de texto sin formato en lugar de tablas y no pidas al usuario que verifique los códigos de tiempo.
3. Después de confirmar la división en capítulos, si la proporción del video no se ha especificado en la sesión actual, debes preguntar: "¿La proporción de tu video es 4:3, 16:9 o 3:4? También puedes indicarme otra proporción." Espera la respuesta antes de continuar; no se debe asumir una proporción predeterminada basada en los subtítulos, muestras antiguas o el tamaño de vista previa del Playground. Si la proporción ya se ha acordado o hay un video original para verificar el tamaño, úsala directamente sin volver a preguntar.
4. Ejecuta scripts/playground_server.mjs de esta habilidad, abre el progressUrl devuelto en esta ejecución y muestra la muestra dinámica real. El script de inicio reutilizará automáticamente el servicio de la misma versión, cambiando el puerto si está ocupado por otro programa o una versión anterior; no trates la ocupación del puerto predeterminado como un error de instalación, no reutilices páginas antiguas de versiones no verificadas ni finalices procesos desconocidos. Deja que el usuario responda con el nombre del estilo, sin pedirle que juzgue la implementación de la animación o la codificación. Los estilos ya seleccionados no se vuelven a elegir.
5. Solo procesa personajes después de que el usuario seleccione "Personaje líder" o "Texto líder". Lee el personaje predeterminado personal guardado localmente según references/characters.md. Si el usuario ha especificado un personaje para esta sesión, se usa esa selección; de lo contrario, si hay un personaje predeterminado personal, se usa directamente, informando brevemente, sin solicitar ni generar de nuevo. Si no hay un registro, entonces pregunta si el usuario desea proporcionar una imagen personalizada; si no, se usa un personaje incorporado. No responder no significa que no haya. Después de la confirmación del usuario sobre el efecto de caminar del nuevo personaje personalizado, se guarda en user-data/characters/ dentro de la instalación de la habilidad como predeterminado para la próxima vez; si el usuario especifica que es solo para esta sesión, no se cambia el predeterminado. No se pregunta, lee ni guarda personajes cuando se selecciona un estilo sin personaje. Las imágenes originales, fotogramas de acción y configuraciones personales no deben escribirse en assets públicos, SKILL.md, commits de Git o GitHub; al actualizar la instalación, se conserva el user-data local.
6. Según la proporción de video confirmada, los capítulos y el estilo, guarda la configuración, realiza dry-run, genera, verifica y entrega un MOV ProRes 4444 estrecho de acuerdo con references/rendering.md. Si los subtítulos se añaden, eliminan o cambian de velocidad después de la creación, es necesario resincronizar.

Formato de Salida Fijo para Sugerencias de División

Segmento	Título Corto en la Barra	Resumen del Contenido	Texto de Inicio	Texto de Fin
1	Nombre corto del capítulo	De qué trata este segmento	Cita textual del SRT de la primera línea de este segmento	Cita textual del SRT de la última línea de este segmento

Una fila por segmento. El título se usa en la barra de progreso, el resumen ayuda al usuario a evaluar la división y el rango de texto ayuda a localizar. Después de la tabla, pide al usuario que confirme si la adopta o que indique dónde necesita fusionar, dividir o cambiar títulos. El texto original no se puede reescribir como resumen. Si hay demasiados capítulos y el texto no cabe, explica el problema real de maquetación y propone acortar títulos, ajustar el tamaño de fuente u otras soluciones de maquetación, dejando la decisión al usuario; no se deben forzar 5 segmentos para adaptarse a un estilo ni fusionar capítulos confirmados sin autorización.

La información confirmada sigue siendo válida en la sesión actual, no se solicita de nuevo. Sin autorización explícita, no se modifican textos, subtítulos ni se edita el video original.

Estilos Validados

• Fondo blanco difuso (soft-white-green): Barra horizontal rectangular, fondo blanco semitransparente, texto de capítulo blanco y separadores de línea vertical, relleno que avanza con el tiempo del segmento.

• Personaje líder (walking-leading): Sobre la barra anterior, solo añade un personaje que camina al frente del relleno. El personaje tiene la misma altura que la barra, el cuerpo desplazado hacia abajo, sobresaliendo como máximo la mitad de la altura de la barra, sin caminar sobre la parte superior de la barra.

• Línea de puntos (dot-line): Línea fina y puntos que cambian de color con el progreso del capítulo, separación de 6 px entre el texto y los puntos.

• Segmentos cortos (short-segments): Una línea corta por capítulo, coloreada según el tiempo del capítulo, separación de 6 px entre el texto y la línea.

• Texto líder (text-leading): El texto cambia de color con el progreso del capítulo, el personaje camina al frente, sin fondo de barra; texto pequeño sin contorno, dibujado con precisión 4x y composición alfa única.

Los cinco estilos permiten modificar el color de relleno RGB. Los tres nuevos estilos admiten tamaños de fuente de 18 a 72 px (calculados en píxeles de exportación), con valores predeterminados de 24, 26 y 25 px respectivamente, y la altura de salida se adapta automáticamente al texto. El verde es solo el color predeterminado; el código de color seleccionado por el usuario en el Playground se debe escribir en la configuración final, no se puede previsualizar con un cambio de color y exportar con verde.

La fuente de reglas verdadera es references/confirmed-rules.md, y la tabla de registro es assets/progress/styles.json. Solo se muestran y generan estilos validados; los nuevos estilos se registrarán después de que el usuario vea la muestra real y la acepte.

Aceptación y Entrega

• El script verifica el rango de subtítulos, la maquetación de títulos, el tamaño, la decodificación completa, el número de fotogramas, la duración y los píxeles transparentes. El Agente también debe abrir la hoja de contactos, los fotogramas exportados reales y la previsualización dinámica para verificar el bucle del personaje, el recorte, el cambio de capítulo y el color.
• Fondo blanco difuso: 1440×64; Personaje líder: 1440×96, con altura de barra 64, altura máxima del personaje 64, sobresaliendo como máximo 32 hacia abajo. Los tres nuevos estilos tienen tamaños predeterminados de 1440×78, 1440×70 y 1440×96 respectivamente; Texto líder: altura máxima del personaje 64, sobresaliendo como máximo 32 hacia abajo. Al cambiar la altura de la barra, se calcula con la misma proporción; por defecto no se exporta el lienzo completo.
• Se descarga un MOV ProRes 4444 estrecho. El WebM transparente se usa para la previsualización en el navegador; reference-qtrle.mov solo se usa para verificación interna, no se entrega. No uses MP4 normal como sustituto del video transparente.
• Debe ser transparente excepto la barra y el personaje. El color de fondo de previsualización, las líneas diagonales o el patrón de tablero de ajedrez no deben hornearse en el archivo.
• El usuario ya ha verificado que este MOV ProRes 4444 estrecho funciona en CapCut; los archivos nuevos aún deben verificarse, no se puede asumir que el navegador normal o la existencia de alfa signifiquen que cualquier versión de CapCut lo soporta.
• Devuelve un enlace al archivo final con la ruta absoluta, explicando que se coloca en la pista superior del video original, alineado al inicio, manteniendo la velocidad original, cubriendo todo el ancho y moviéndose a la parte superior. Las muestras deben indicar claramente la duración y no pueden hacerse pasar por la barra de progreso de longitud completa del video del usuario.

Para generar animaciones cortas independientes de unos segundos a partir de texto o transiciones de capítulos, usa ll-video-motion; para doblaje, subtítulos de duración completa y edición de metraje continuo, usa ll-video-edit.