JohanDuran/video-studio

Bearbeitungsregeln

Befolge diese ohne Rückfrage. Welche Tools es gibt und wie man sie verwendet, steht in video-toolkit.

0. Profil und Hausregeln

• Finde das Profil des Kanals wie in video-toolkit §0 beschrieben: die nächstgelegene studio.json oberhalb des Arbeitsordners, ansonsten den Standard-Kanal aus ~/.video-studio/config.json. Fehlt → /studio-setup anbieten.
• house_rules im Profil sind die eigenen Entscheidungen des Benutzers (z. B. „Fass den Mikrofon-Sound nicht an“). Sie überschreiben die nachfolgenden Standardeinstellungen. Wenn der Benutzer eine neue dauerhafte Präferenz angibt, hänge sie als eine kurze Zeile mit Grund und Datum an house_rules an und teile ihm mit, dass du sie gespeichert hast.

1. Alles muss kostenlos sein

• DaVinci Resolve: kostenlose Edition, 21.0.x. Nie vorschlagen, auf 21.1 oder höher zu aktualisieren: 21.1 hat Python-Scripting auf Studio beschränkt, was das Resolve MCP in der kostenlosen Edition unbrauchbar macht.
  • Keine 21.1-API-Funktionen vorschlagen (SetSpeed, AddTransition, SetFades, NormalizeAudioLevel, CreateMulticamClip, AutoAlignClips, Ausgangs-Blanking). Biete eine Workaround-Lösung an (Keyframes, Fusion, ffmpeg oder einen manuellen UI-Schritt).
  • Keine Studio-exklusiven Funktionen vorschlagen (Voice Isolation, Dialogue Leveler, temporale/räumliche Rauschunterdrückung, Super Scale, Magic Mask), ohne zu erwähnen, dass sie Studio-exklusiv sind.
  • Wenn resolve.edition im Profil studio ist, sind die Studio-Funktionen in Ordnung; die Bindung an 21.0.x gilt trotzdem nur, wenn der Benutzer auf das In-App-Bridge angewiesen ist.
• HyperFrames: nur lokales Rendering. Verwende die Toolbox render_hyperframes oder npx hyperframes render.
  • Niemals hyperframes cloud render, lambda, cloudrun oder hyperframes auth login ausführen.
  • Niemals HeyGen-Credit-Funktionen nutzen: HeyGen TTS/Stimmen, Avatare, media-use resolve --type bgm|sfx (erfordert die heygen CLI) oder KI-Bild-/Musik-/Videogenerierung, die Credits kostet. Verwende stattdessen die Toolbox: speak für Sprache, sfx_search/sfx_generate für Sound, transcribe für Transkripte.
  • Wenn ein HyperFrames-Workflow-Schritt eines dieser Mittel benötigt, überspringe ihn oder verwende die kostenlose Alternative und teile dies mit.
  • Nicht die HyperFrames-Desktop-App oder hyperframes open empfehlen: Die Pipeline ist Claude + CLI-Render + Resolve MCP. Die Web-Studio-Vorschau ist für kleine Anpassungen des Benutzers in Ordnung.
• Andere Tools: Bevorzuge installierte Programme (ffmpeg, Node, Docker). Keine kostenpflichtigen Dienste abonnieren oder verbinden.
• Sprache: Kokoro (lokal, Apache 2.0) über speak, mit der Stimme und Geschwindigkeit des Profils. Keine nicht-kommerziellen TTS-Gewichte für Kanalvideos verwenden.
• Transkription: WhisperX über die Toolbox transcribe, nicht über Resolve oder HeyGen. Keine Sprecherdiarisierung, außer wenn danach gefragt wird.
• Generierte SFX/Musik: Stable Audio Open 1.0 über die Toolbox sfx_generate (die Hugging-Face-Lizenz wird während /studio-setup akzeptiert).

2. Ordnerstruktur

<studio>/
  sfx_library/       geteilte generierte Sounds + index.jsonl (wiederverwendet in Videos und Kanälen; toolbox.sfx_library)
  recordings/        Rohaufnahmen aus beliebigen Quellen (Standard recordings.folder): schreibgeschützt
  _scratch/          Toolbox-Ausgaben ohne Projektordner
  <channel>/         ein Ordner pro Kanal
    studio.json      Profil dieses Kanals
    <ProjectName>/   ein Ordner pro Video, genau wie das Resolve-Projekt benannt
      plan.md, script.json, short.json
      audio/           Erzählung, Mischungen
      capture/         für dieses Video erstellte Bildschirmaufnahmen
      transcripts/     dateibasierte Transkripte + <timeline>.timeline.* (Timeline-Zeit)
      timeline/        erfasste Track-Layouts
      animations/      HyperFrames-Projekte und Renderings
      builds/, renders/, audio_preview/

Ein Ein-Kanal-Studio kann studio.json und die Projektordner direkt in <studio>/ behalten; das funktioniert trotzdem.

• Hole den Projektnamen aus Resolve (project_manager get_current), wenn eines geöffnet ist; ansonsten stimme ihn mit dem Benutzer ab. Erstelle den Ordner beim ersten Bedarf.
• Schreibe niemals Projektdateien in das Studio-Stammverzeichnis, in einen anderen Kanalordner oder neben Quellaufnahmen.

3. Rohaufnahmen sind schreibgeschützt

• Der Aufnahmeordner (recordings.folder) wird niemals beschrieben: keine Überschreibungen, Löschungen, Umbenennungen oder Sidecar-Dateien. Verarbeitetes Material geht als Kopien in den Projektordner und wird dann über die Medienbibliothek eingefügt.
• Verwende recordings.mic_audio_stream für die Transkription. Wenn eine Aufnahme zusätzliche Audiospuren hat (Desktop-Audio, eine Kopie des Mikrofons), weise darauf hin und entferne oder stummschalte sie nicht ohne Nachfrage.

4. In Ruhe lassen, außer wenn darum gebeten

• Audio: Die Stimme des Benutzers nicht entzerren, entrauschen, komprimieren oder normalisieren, außer er bittet darum.
• Bild: Nicht graduieren oder schärfen, außer er bittet darum.

5. Wie zu arbeiten ist

• Vorschau vor dem Anwenden: Für Audio-/Bildänderungen ein kurzes Vorher-/Nachher-Beispiel in <project>/audio_preview/ (oder ähnlich) rendern und den Benutzer entscheiden lassen.
• Vorschlagen, dann anwenden: Vorgeschlagene Schnitte, Triggerpunkte und Overlay-Positionen zeigen, bevor eine Timeline geändert wird.
• Overlays → Resolve: HyperFrames-Projekte in <project>/animations/ erstellen, als mov (Alpha) in der Timeline-Bildrate rendern, importieren und auf einen leeren Videotrack legen. Wenn möglicherweise eine andere Sitzung in animations/ arbeitet, einzelne Overlays als eigenes HyperFrames-Projekt in einem Geschwisterordner erstellen.
• Gesichtssicherheitszonen: Wenn ein Kamerabild vorhanden ist, mit ffmpeg Kacheln messen, wo das Gesicht sitzt, bevor Karten platziert werden; das Gesicht niemals verdecken.
• Privatsphäre: Niemals etwas aus channel.never_show anzeigen. Bildschirmaufnahmen erfassen, was auf dem Bildschirm war – jeden Ausschnitt im ersten und letzten Bild überprüfen.
• Soundbibliothek: Vor der Generierung suchen, die Bewertungen des Benutzers mit sfx_mark aufzeichnen, niemals Bibliotheksdateien löschen (auch abgelehnte nicht). Ausgewählte Sounds auf einen leeren Audiospur legen, niemals auf Audio 1.