video-studio

/edit-recording — edición de formato largo

Objetivo: $ARGUMENTS (un nombre de proyecto de Resolve, un archivo de grabación o vacío = el proyecto abierto en Resolve).

Antes de nada: lee el perfil (video-toolkit §0) y sigue editing-rules — la carpeta de grabaciones es de solo lectura, sin procesamiento de audio/video a menos que se solicite, propón antes de aplicar. Verifica toolbox_status y que el MCP de Resolve responda project_manager get_current (edición gratuita: el usuario debe ejecutar Workspace → Scripts → Utility → resolve_bridge con el proyecto abierto).

Carpeta del proyecto: <carpeta del canal>/<ResolveProject>/ (video-toolkit §0).

Planifica primero. Si plan.md en la carpeta del proyecto tiene Status: approved, síguelo: su objetivo, qué partes conservar, qué superposiciones, gráficos, metraje B-roll y sonidos añadir, y con qué herramienta. Sin un plan aprobado, los pasos 1–3 (leer la línea de tiempo, transcribir, proponer cortes) están bien porque no cambian nada y ayudan a informar el plan. Pero antes de añadir superposiciones, nuevo metraje, tomas de Blender, una nueva grabación de pantalla o SFX, ejecuta la habilidad plan: la grabación es lo "que ya existe", y el plan decide qué necesita cada parte. Nunca grabes nueva pantalla a menos que el plan lo indique.

Pasos

1. Obtén la línea de tiempo — proyecto actual + línea de tiempo desde Resolve. Si aún no hay proyecto, crea uno a partir de las grabaciones: configura los fps de la línea de tiempo (recordings.fps / resolve.timeline_fps) y la resolución antes de importar, luego pide al usuario que ajuste la velocidad de fotogramas de reproducción para que coincida (la API no puede). Importa los archivos de pantalla y, si recordings.separate_camera_file, los archivos de cámara (recordings.camera_file_pattern).
2. Captura la disposición — lee los elementos de la línea de tiempo (Audio 1 = la pista de voz) en timeline/<timeline>.audio1.json. Una sesión puede abarcar varios archivos que Audio 1 reproduce consecutivamente; anota cada archivo fuente que utiliza. Si hay pistas de audio de grabadora adicionales (audio de escritorio, un micrófono duplicado) en la línea de tiempo, señála y déjalas.
3. Transcribe — transcribe cada archivo fuente que Audio 1 utiliza (micrófono = recordings.mic_audio_stream, vocab del perfil) en transcripts/, luego timeline_transcript → <timeline>.timeline.json/.srt/.txt en tiempos de línea de tiempo. Vuelve a ejecutar esto después de cualquier edición que mueva o recorte Audio 1.
4. Propón cortes — muletillas, pausas largas, falsos comienzos y repeticiones, con códigos de tiempo de línea de tiempo y las palabras alrededor de cada corte, en una tabla. Espera a que el usuario apruebe (todos, algunos o ajustados).
5. Aplica cortes — de forma no destructiva en Resolve (en una línea de tiempo duplicada, p. ej. <timeline>_cut), luego lee los elementos nuevamente y verifica si hay huecos/superposiciones. Vuelve a ejecutar el paso 3 del timeline_transcript en la nueva línea de tiempo.
6. Superposiciones — propón tarjetas (títulos, llamadas, tercios inferiores, suscríbete) ancladas a palabras habladas. Mide primero las zonas seguras para rostros a partir de los clips de cámara. Construye un proyecto HyperFrames en animations/ (usa las habilidades hyperframes; solo renderizado local), renderiza mov con alfa a los fps de la línea de tiempo mediante render_hyperframes, importa y coloca cada uno en una pista de video vacía en el fotograma de grabación de la palabra. Las tarjetas superpuestas van en pistas separadas. Vuelve a leer y compara.
7. Sonido — SFX para superposiciones: primero sfx_search, luego sfx_generate; el usuario evalúa; sfx_mark los veredictos. Premezcla las señales de cada superposición en un WAV con ffmpeg (la API ignora el volumen del clip) y colócalo en una pista de audio vacía, nunca en Audio 1.
8. Renderiza — render prepare_delivery_job (YouTube 1080p/4K a los fps de la línea de tiempo) en <project>/renders/, start, verify_output. Verifica la sonoridad en el resultado.

Hecho = un render aprobado en <project>/renders/, con transcripciones y proyectos de superposición guardados para cambios posteriores.