JohanDuran/video-studio

Règles de montage

Suivez ces règles sans redemander. Pour connaître les outils existants et comment les utiliser, lisez video-toolkit.

0. Profil et règles personnelles

• Trouvez le profil de la chaîne comme indiqué dans video-toolkit §0 : le studio.json le plus proche au-dessus du dossier de travail, sinon la chaîne par défaut depuis ~/.video-studio/config.json. Absent → proposez /studio-setup.
• Les house_rules dans le profil sont les décisions personnelles de l'utilisateur (par exemple "ne pas toucher le son du micro"). Elles remplacent les valeurs par défaut ci-dessous. Lorsque l'utilisateur énonce une nouvelle préférence permanente, ajoutez-la à house_rules en une courte ligne avec la raison et la date, et dites-lui que vous l'avez sauvegardée.

1. Tout doit être gratuit

• DaVinci Resolve : édition gratuite, 21.0.x. Ne suggérez jamais de passer à 21.1 ou ultérieur : 21.1 a rendu le scripting Python exclusif à la version Studio, ce qui casse le Resolve MCP sur l'édition gratuite.
  • Ne proposez pas de fonctionnalités de l'API 21.1 (SetSpeed, AddTransition, SetFades, NormalizeAudioLevel, CreateMulticlipClip, AutoAlignClips, output blanking). Proposez une solution de contournement (keyframes, Fusion, ffmpeg, ou une étape manuelle dans l'interface).
  • Ne proposez pas de fonctionnalités exclusives à Studio (Voice Isolation, Dialogue Leveler, réduction de bruit temporelle/spatiale, Super Scale, Magic Mask) sans préciser qu'elles sont exclusives à Studio.
  • Si resolve.edition dans le profil est studio, les fonctionnalités Studio sont autorisées ; la contrainte 21.0.x reste valable uniquement si l'utilisateur dépend du pont intégré à l'application.
• HyperFrames : rendu local uniquement. Utilisez la boîte à outils render_hyperframes ou npx hyperframes render.
  • N'exécutez jamais hyperframes cloud render, lambda, cloudrun, ou hyperframes auth login.
  • N'utilisez jamais les fonctionnalités nécessitant des crédits HeyGen : TTS/voix HeyGen, avatars, media-use resolve --type bgm|sfx (nécessite le CLI heygen), ou génération d'images/musique/vidéo par IA qui coûte des crédits. Utilisez plutôt la boîte à outils : speak pour la voix, sfx_search/sfx_generate pour les sons, transcribe pour les transcriptions.
  • Si une étape du workflow HyperFrames nécessite l'un de ces éléments, ignorez-la ou utilisez l'alternative gratuite et dites-le.
  • Ne poussez pas l'application de bureau HyperFrames ou hyperframes open : le pipeline est Claude + rendu CLI + Resolve MCP. L'aperçu web Studio est acceptable pour les petites modifications de l'utilisateur.
• Autres outils : privilégiez ce qui est installé (ffmpeg, Node, Docker). Ne vous inscrivez pas à des services payants et ne les connectez pas.
• Voix : Kokoro (local, Apache 2.0) via speak, avec la voix et la vitesse du profil. N'utilisez pas de poids TTS non commerciaux pour les vidéos de la chaîne.
• Transcription : WhisperX via la boîte à outils transcribe, pas celle de Resolve ou HeyGen. Pas de diarisation des locuteurs sauf demande explicite.
• Effets sonores/musique générés : Stable Audio Open 1.0 via la boîte à outils sfx_generate (sa licence Hugging Face est acceptée lors de /studio-setup).

2. Structure des dossiers

<studio>/
  sfx_library/       sons générés partagés + index.jsonl (réutilisés entre vidéos et chaînes ; toolbox.sfx_library)
  recordings/        enregistrements bruts de toute source (recordings.folder par défaut) : lecture seule
  _scratch/          sorties de la boîte à outils sans dossier projet
  <channel>/         un dossier par chaîne
    studio.json      profil de cette chaîne
    <ProjectName>/   un dossier par vidéo, nommé exactement comme le projet Resolve
      plan.md, script.json, short.json
      audio/           narration, mixages
      capture/         captures d'écran réalisées pour cette vidéo
      transcripts/     transcriptions par fichier + <timeline>.timeline.* (temps de la timeline)
      timeline/        dispositions des pistes capturées
      animations/      projets et rendus HyperFrames
      builds/, renders/, audio_preview/

Un studio mono-chaîne peut placer studio.json et les dossiers projets directement dans <studio>/ ; cela fonctionne toujours.

• Obtenez le nom du projet depuis Resolve (project_manager get_current) lorsqu'un projet est ouvert ; sinon, accordez-le avec l'utilisateur. Créez le dossier la première fois qu'il est nécessaire.
• N'écrivez jamais de fichiers projet dans la racine du studio, le dossier d'une autre chaîne, ou à côté des enregistrements sources.

3. Les enregistrements bruts sont en lecture seule

• Le dossier d'enregistrement (recordings.folder) n'est jamais modifié : pas d'écrasement, suppression, renommage ou fichiers annexes. Les médias traités vont dans le dossier projet sous forme de copies, puis sont échangés via la médiathèque.
• Utilisez recordings.mic_audio_stream pour la transcription. Si un enregistrement a des pistes audio supplémentaires (audio de bureau, un doublon du micro), signalez-le et ne les supprimez ou ne les coupez pas sans demander.

4. Ne touchez à rien sauf demande

• Audio : n'égalisez pas, ne débruitez pas, ne compressez pas et ne normalisez pas la voix de l'utilisateur sauf s'il le demande.
• Image : n'étalonnez pas et n'accentuez pas sauf demande.

5. Comment travailler

• Aperçu avant validation : pour les modifications audio/visuelles, effectuez un rendu d'un court échantillon avant/après dans <project>/audio_preview/ (ou équivalent) et laissez l'utilisateur décider.
• Proposer, puis appliquer : montrez les coupures proposées, les points de déclenchement et les placements d'incrustations avant de modifier une timeline.
• Incrustations → Resolve : construisez les projets HyperFrames dans <project>/animations/, effectuez le rendu en mov (alpha) à la fréquence d'images de la timeline, importez et placez sur une piste vidéo vide. Si une autre session peut travailler dans animations/, construisez les incrustations ponctuelles comme leur propre projet HyperFrames dans un dossier frère.
• Zones de sécurité du visage : lorsqu'il y a une image de la caméra, mesurez où se trouve le visage (images tuilées avec ffmpeg) avant de placer des cartes ; ne couvrez jamais le visage.
• Confidentialité : n'affichez jamais rien de channel.never_show. Les captures d'écran enregistrent tout ce qui était à l'écran — vérifiez chaque recadrage à sa première et dernière image.
• Bibliothèque sonore : cherchez avant de générer, enregistrez les verdicts de l'utilisateur avec sfx_mark, ne supprimez jamais les fichiers de la bibliothèque (y compris ceux rejetés). Placez les sélections sur une piste audio vide, jamais sur Audio 1.