Pipeline de Shorts (neutral en temática)
Una lista de edición (<short>/edl.json) más una locución dan como resultado un video terminado: clips en movimiento dentro de una "ventana" temática con foto, subtítulos palabra por palabra, una placa de gancho, un círculo destacado, una portada, una lista de efectos de sonido y una mezcla de audio a -14 LUFS.
Todo lo específico de un canal (temática, idiomas, audiencia, reglas de contenido, estilo visual, voz, créditos, calendario) reside en el archivo CHANNEL.md del proyecto. Léelo primero y sigue sus instrucciones por encima de los valores por defecto indicados a continuación. Si falta o tiene secciones vacías, pregunta al propietario (o copia engine/templates/CHANNEL.md y rellénalo con él) antes de producir nada.
Skills relacionados: shorts-script-voice (temática, guion, voz) y shorts-packaging (archivos finales, textos de subida).
Antes de todo
- Los scripts del kit (
setup.sh,shorts-init.sh,doctor.sh,install-codex.sh) están en la carpetascripts/del kit: la carpeta del plugin, o$SHORTS_HOME/kit/scripts/(setup.sheinstall-codex.shmantienen una copia allí). - Trabaja desde una carpeta de proyecto que contenga
_pipeline/,_tools/,_fonts/,CHANNEL.md(crea una conscripts/shorts-init.sh <dir>). Todos los comandos siguientes se ejecutan desde la raíz de esa carpeta. - Ejecuta
scripts/doctor.sh <project-dir>una vez por máquina. Revisa todas las dependencias (programas del sistema, paquetes de Python, modelos, espacio en disco) y debe terminar con "All good.". Si no:scripts/install-system-deps.shpara ffmpeg/Python/curl,scripts/setup.shpara el resto. La lista completa está enDEPENDENCIES.mddel kit. SHORTS_HOME(por defecto~/.shorts-studio) contiene el entorno virtual de Python y los modelos de voz. Expórtalo si lo pones en otro lugar.- Lee
_pipeline/README.md(referencia del motor) yreferences/edl-notes.mdantes de escribir una lista de edición.
El flujo de trabajo (cada paso tiene su propia verificación)
| # | Paso | Comando / salida | Verificar |
|---|---|---|---|
| 1 | Temática + guion | skill shorts-script-voice | una afirmación, fuentes atribuidas, propietario OK cuando el perfil lo pide |
| 2 | Voz | $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, luego _tools/words.py <short>/vo | lee vo/words.json: cada palabra correcta |
| 3 | Material de archivo | _tools/grab.py <topic> '<url>' <start> <end> --tag NOMBRE (registra en _footage/SOURCES.md), o tus propias grabaciones | hoja de contacto de cada clip; política de CHANNEL.md |
| 4 | Lista de edición | copia references/edl-template.json, cambia el contenido | build.py <edl> --words muestra los tokens de subtítulos |
| 5 | Renderizado | python3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10 min; 4K60 es lento) | sin errores; el archivo es más reciente que el edl |
| 6 | Portada | ... build.py <edl> --cover | "safe-zone violations: none", legible a 180 px de ancho |
| 7 | Verificación | python3 _pipeline/check.py <short>/<nombre>-<tema>-silent.mp4 <short>/edl.json | imprime ALL CHECKS PASS; has mirado cada hoja de contacto |
| 8 | Sonido | $SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <nombre> --strict | -14.0 +/-0.5 LUFS, pico real <= -1.0 dBTP, errores de palabra cerca de 0 |
| 9 | Empaquetado | skill shorts-packaging | archivo + portada + bloque de subida en ready/ |
Hoja de contacto de un clip fuente: ffmpeg -ss <t> -i <archivo> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png
(escribe PNG: la salida JPEG de algunas fuentes falla con "non full-range YUV"). Límites de toma:
ffmpeg -i <archivo> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*".
Temas: case-file (papel de expediente), panel-heist (página de cómic), vice-dusk (atardecer neón), classic; el perfil elige uno.
Cómo es un buen Short (valores por defecto; el perfil los sobreescribe)
- 18-45 s, un argumento desde el gancho hasta la conclusión, un corte cada 1.5-3 s, cada plano se mueve, la placa de gancho está visible desde el fotograma 0
(
hook.y1170 la mantiene alejada de la etiqueta de exposición), un momento destacado con un círculo rojo sobre algo que realmente se vea en el fotograma. - La imagen sigue las palabras. Los subtítulos son frases de 2-3 palabras (
break_before); los nombres permanecen en un solo grupo. - El último plano vuelve al primer fotograma (el video hace un bucle).
- Todo el texto legible permanece dentro de la zona segura del teléfono: y 300-1580, x 130-950 (x <= 860 para y 1000-1600). check.py lo exige.
- Ventana de foto alta
"aspect": "3:4"(900x1200) en clips de 1080p o más; las fuentes de 720p o con letterbox no pueden llenarla.
Lecciones aprendidas con esfuerzo (detalles en references/lessons.md)
- ¿El edl es más reciente que el renderizado? El renderizado está obsoleto. Reconstruye antes de juzgar a check.py.
- Fotogramas congelados (fotogramas consecutivos que apenas difieren durante > 0.3 s) hacen fallar check.py. Las pantallas estáticas, los colores planos y los sujetos inmóviles necesitan movimiento a velocidad constante:
"move_ease": "linear", un rango de zoom de 0.15-0.4 y un paneo de 150+ píxeles de la fuente.floatsolo no es suficiente (el seno se ralentiza hasta cero en sus giros). - Límites de zoom: fuentes 4K <= 1.00, 1080p <= 1.25, 720p <= 1.0 (check.py imprime el límite por clip).
- Superposiciones de creador (marca de agua, cámara facial, tercio inferior, subtítulos, banners estilizados) nunca llegan a la imagen: recorta con la anulación de imagen de
sourcesde nivel superior, mueve el recorte o elige otros fotogramas. Mira cada fotograma de corte. - Honestidad: las etiquetas, los círculos y los subtítulos dicen solo lo que muestra el fotograma; atribuye los hechos a su fuente en la locución.
- Portada: un recorte a sangre de un fotograma fuente; la placa se coloca en
tab_y(330) y oculta la parte superior de la imagen. Para un sujeto cerca de la parte superior, establecetab_yen aproximadamente 1090 ystamp_yen aproximadamente 410. - Un renderizado a la vez (un renderizado 4K60 usa todos los núcleos); nunca inicies un segundo renderizado de la misma carpeta.
Delegar una edición a un subagente
Dale al agente BRIEF.md (creado por shorts-init a partir de references/editor-brief.md) junto con el guion, los archivos de voz y la lista de clips. La sesión principal escribe el guion y la voz, revisa cada fotograma por sí misma y realiza la mezcla de sonido: el informe de un agente es una afirmación, no una prueba. Verifica las marcas de tiempo de los archivos (mp4 silencioso más reciente que el edl, registro de verificación más reciente que el mp4) antes de aceptar.