JohanDuran/video-studio

Reglas de edición

Siga estas sin volver a preguntar. Para saber qué herramientas existen y cómo usarlas, lea video-toolkit.

0. Perfil y reglas de la casa

• Encuentre el perfil del canal como dice video-toolkit §0: el studio.json más cercano por encima de la carpeta de trabajo, o, en su defecto, el canal predeterminado de ~/.video-studio/config.json. Si falta → ofrezca /studio-setup.
• house_rules en el perfil son las decisiones propias del usuario (por ejemplo, "no tocar el sonido del micrófono"). Anulan los valores predeterminados a continuación. Cuando el usuario exprese una nueva preferencia permanente, agréguela a house_rules como una línea corta con el motivo y la fecha, e informe al usuario que la ha guardado.

1. Todo debe ser gratuito

• DaVinci Resolve: edición gratuita, 21.0.x. Nunca sugiera actualizar a 21.1 o posterior: 21.1 hizo que los scripts de Python fueran solo para Studio, lo que rompe el Resolve MCP en la edición gratuita.
  • No proponga funciones de la API de 21.1 (SetSpeed, AddTransition, SetFades, NormalizeAudioLevel, CreateMulticamClip, AutoAlignClips, output blanking). Ofrezca una solución alternativa (fotogramas clave, Fusion, ffmpeg o un paso manual en la interfaz de usuario).
  • No proponga funciones solo de Studio (Voice Isolation, Dialogue Leveler, reducción de ruido temporal/espacial, Super Scale, Magic Mask) sin indicar que son solo de Studio.
  • Si resolve.edition en el perfil es studio, las funciones de Studio están bien; el bloqueo en 21.0.x sigue vigente solo si el usuario depende del puente en la aplicación.
• HyperFrames: solo renderizado local. Use la caja de herramientas render_hyperframes o npx hyperframes render.
  • Nunca ejecute hyperframes cloud render, lambda, cloudrun o hyperframes auth login.
  • Nunca use funciones que consuman créditos de HeyGen: TTS/voces de HeyGen, avatares, media-use resolve --type bgm|sfx (necesita la CLI de heygen) o generación de imágenes/música/vídeo con IA que cueste créditos. Use la caja de herramientas en su lugar: speak para voz, sfx_search/sfx_generate para sonido, transcribe para transcripciones.
  • Si un paso del flujo de trabajo de HyperFrames necesita una de estas, omítalo o use la alternativa gratuita e indíquelo.
  • No recomiende la aplicación de escritorio de HyperFrames ni hyperframes open: el pipeline es Claude + CLI render + Resolve MCP. La vista previa web de Studio está bien para pequeños ajustes del propio usuario.
• Otras herramientas: prefiera las instaladas (ffmpeg, Node, Docker). No se registre ni conecte servicios de pago.
• Voz: Kokoro (local, Apache 2.0) a través de speak, con la voz y velocidad del perfil. No use pesos TTS no comerciales para vídeos del canal.
• Transcripción: WhisperX a través de la caja de herramientas transcribe, no la de Resolve ni HeyGen. Sin diarización de hablantes a menos que se solicite.
• SFX/música generados: Stable Audio Open 1.0 a través de la caja de herramientas sfx_generate (su licencia de Hugging Face se acepta durante /studio-setup).

2. Estructura de carpetas

<studio>/
  sfx_library/       sonidos generados compartidos + index.jsonl (reutilizados entre vídeos y canales; toolbox.sfx_library)
  recordings/        grabaciones originales de cualquier fuente (recordings.folder predeterminado): solo lectura
  _scratch/          salidas de la caja de herramientas sin carpeta de proyecto
  <channel>/         una carpeta por canal
    studio.json      perfil de ese canal
    <ProjectName>/   una carpeta por vídeo, con el nombre exacto del proyecto de Resolve
      plan.md, script.json, short.json
      audio/           narración, mezclas
      capture/         grabaciones de pantalla realizadas para este vídeo
      transcripts/     transcripciones por archivo + <timeline>.timeline.* (tiempo de línea de tiempo)
      timeline/        diseños de pistas capturados
      animations/      proyectos y renderizados de HyperFrames
      builds/, renders/, audio_preview/

Un estudio de un solo canal puede mantener studio.json y las carpetas de proyecto directamente en <studio>/; eso sigue funcionando.

• Obtenga el nombre del proyecto de Resolve (project_manager get_current) cuando haya uno abierto; de lo contrario, acuérdelo con el usuario. Cree la carpeta la primera vez que sea necesaria.
• Nunca escriba archivos de proyecto en la raíz del estudio, en la carpeta de otro canal o junto a las grabaciones originales.

3. Las grabaciones originales son de solo lectura

• La carpeta de grabaciones (recordings.folder) nunca se escribe: sin sobrescrituras, eliminaciones, cambios de nombre ni archivos secundarios. Los medios procesados van a la carpeta del proyecto como copias y luego se intercambian a través del pool de medios.
• Use recordings.mic_audio_stream para la transcripción. Si una grabación tiene pistas de audio adicionales (audio de escritorio, un duplicado del micrófono), indíquelo y no las elimine ni silencie sin preguntar.

4. No modificar a menos que se solicite

• Audio: no equalice, reduzca ruido, comprima ni normalice la voz del usuario a menos que lo solicite.
• Imagen: no gradúe ni enfoque a menos que lo solicite.

5. Cómo trabajar

• Previsualizar antes de confirmar: para cambios de audio/visuales, renderice una muestra breve de antes/después en <project>/audio_preview/ (o similar) y deje que el usuario decida.
• Proponer, luego aplicar: muestre los cortes propuestos, los puntos de activación y la colocación de superposiciones antes de modificar la línea de tiempo.
• Superposiciones → Resolve: cree proyectos de HyperFrames en <project>/animations/, renderícelos como mov (con alfa) a la velocidad de fotogramas de la línea de tiempo, impórtelos y colóquelos en una pista de vídeo vacía. Si otra sesión podría estar trabajando en animations/, cree superposiciones únicas como su propio proyecto de HyperFrames en una carpeta hermana.
• Zonas seguras para el rostro: cuando haya una imagen de cámara, mida dónde está el rostro (divida los fotogramas con ffmpeg) antes de colocar tarjetas; nunca cubra el rostro.
• Privacidad: nunca muestre nada de channel.never_show. Las grabaciones de pantalla capturan lo que sea que esté en la pantalla — verifique cada recorte en su primer y último fotograma.
• Biblioteca de sonidos: busque antes de generar, registre los veredictos del usuario con sfx_mark, nunca elimine archivos de la biblioteca (incluidos los rechazados). Coloque las selecciones en una pista de audio vacía, nunca en Audio 1.