Flujo de trabajo estándar de edición de video
Secuencia clave: Preguntar requisitos → Obtener todo el material → Revisar cada archivo → Seleccionar tomas según narrativa → Edición fina → Audio → Verificar → Entregar solo el producto final. Por defecto, no se colocan descargas ni archivos intermedios en el disco local del usuario.
0. Preguntar todo al inicio
Propósito/plataforma, relación de aspecto (horizontal 16:9 / vertical 9:16), duración objetivo, ritmo (rápido/lento), audio (solo BGM/sonido ambiente/narración), subtítulos y títulos, estilo de color (lo decide el usuario, no se fija un filtro de antemano).
1. Obtención del material (sin ocupar disco local del usuario)
El material se descarga en el directorio de trabajo persistente del asistente; el MCP de la nube generalmente solo administra archivos, no permite descargas ni edición en la nube; el cliente oficial con una sola conexión suele ser más rápido y estable, combinado con un watchdog de descarga para reanudación y reinicio automático. Usa ffprobe para verificar la cantidad e integridad.
2. Revisar cada archivo, sin omitir ninguno
Para cada archivo, extrae varios fotogramas y genera una rejilla para ver todo; anota la escena, iluminación, composición, y si se usa o descarta con la razón.
3. Selección de tomas (narrativa + variedad)
Línea emocional: apertura impactante → establecimiento → desarrollo → clímax → cierre con espacio; alterna planos lejanos/cercanos, luz/sombra, agua/puente/bosque/curva/paisaje amplio, evitando repeticiones monótonas; registra archivo fuente + punto de entrada exacto.
4. Edición fina
Unifica la relación de aspecto y fps; ajusta el color según la solicitud del momento, con una atmósfera general, adaptable por toma, no reutilices filtros anteriores; ritmo lento con transiciones suaves; procesamiento por pasos para baja memoria, con posibilidad de reinicio idempotente.
5. Subtítulos (solo si el usuario lo pide)
Letra blanca delgada con sombra suave, fade in/out, sin tapar el paisaje; chino con Noto CJK.
6. Audio
Solo BGM: descarta el sonido ambiente, ajusta la duración, afade para fade in/out, loudnorm para un volumen confortable en móviles (aproximadamente I=-16).
7. Compresión y empaquetado
Control VBV para ajustar el tamaño (ampliar tasa de bits para material con granulado o atmósfera fuerte); H264 + AAC, -movflags +faststart.
8. Verificación
ffprobe para especificaciones; blackdetect para detectar fotogramas negros; rejillas para verificar color/orden/sin omisiones/inicio y fin de música; rehacer segmentos dañados.
9. Entrega
Solo entrega el archivo final mediante present_files; incluye una tabla breve con especificaciones y puntos de procesamiento; itera según retroalimentación, modificando solo lo indicado por el usuario.
Navegación de recursos
Los scripts están en scripts/ (ya tienen permisos de ejecución, solo hay que ajustar los parámetros según las indicaciones):
make_grid.py: Extrae fotogramas y genera rejillas para revisar (paso 2)make_clips.py: Recorta tomas + ajuste de color/atmósfera, genera fragmentos unificados (paso 4; los filtros son valores de ejemplo, reescribir según sea necesario)join.py: Transiciones suaves xfade + negro al inicio/final, permite orden personalizado de tomas (pasos 4/7)verify_final.py: Verificación final de especificaciones + fotogramas negros + rejillas (paso 8)download_watchdog.sh: Watchdog para descargas de archivos grandes, evita OOM, reinicio automático (paso 1)recover.sh: Restaura el cliente y bibliotecas después de un reinicio del disco del sistema (paso 1)
La documentación de referencia está en references/ (leer solo cuando sea necesario):
full-workflow.md: Análisis completo del flujo de trabajo + lista real de tomas de un vlog en moto, parámetros de filtros, experiencia en cinco iteracionestroubleshooting.md: Todos los problemas y soluciones sobre obtención en la nube, baja memoria, restablecimientos del sistema, inicio de sesión, códecs, etc.
La información sensible (cookies de cuenta, códigos de verificación, números de teléfono) no se escribe en ningún script, documento o registro.