JohanDuran/video-studio

편집 규칙

다시 묻지 말고 다음 규칙을 따르세요. 어떤 도구가 있고 어떻게 사용하는지는 video-toolkit을 읽으세요.

0. 프로필 및 개인 규칙

• 채널의 프로필은 video-toolkit §0에 따라 찾습니다: 작업 폴더 위에서 가장 가까운 studio.json, 없으면 ~/.video-studio/config.json의 기본 채널. 없으면 → /studio-setup을 제안하세요.
• 프로필의 house_rules는 사용자의 개인 결정입니다 (예: "마이크 소리 건드리지 마"). 이는 아래 기본값을 재정의합니다. 사용자가 새로운 고정 선호도를 말하면, 한 줄로 house_rules에 이유와 날짜를 추가하고 저장했음을 알리세요.

1. 모든 것은 무료여야 함

• DaVinci Resolve: 무료 에디션, 21.0.x. 21.1 이상으로 업그레이드 절대 제안 금지: 21.1에서 Python 스크립팅이 Studio 전용이 되어 무료 에디션의 Resolve MCP가 작동하지 않습니다.
  • 21.1 전용 API 기능(SetSpeed, AddTransition, SetFades, NormalizeAudioLevel, CreateMulticlipClip, AutoAlignClips, output blanking)을 제안하지 마세요. 대안(키프레임, Fusion, ffmpeg 또는 수동 UI 단계)을 제시하세요.
  • Studio 전용 기능(Voice Isolation, Dialogue Leveler, temporal/spatial noise reduction, Super Scale, Magic Mask)을 "Studio 전용입니다"라고 말하지 않고 제안하지 마세요.
  • 프로필의 resolve.edition이 studio이면 Studio 기능은 괜찮습니다. 21.0.x 고정은 사용자가 인앱 브리지에 의존하는 경우에만 여전히 적용됩니다.
• HyperFrames: 로컬 렌더링만. 툴박스 render_hyperframes 또는 npx hyperframes render를 사용하세요.
  • 절대 hyperframes cloud render, lambda, cloudrun 또는 hyperframes auth login을 실행하지 마세요.
  • HeyGen 크레딧 기능: HeyGen TTS/음성, 아바타, media-use resolve --type bgm|sfx(heygen CLI 필요) 또는 크레딧이 드는 AI 이미지/음악/비디오 생성을 사용하지 마세요. 대신 툴박스를 사용하세요: 음성은 speak, 사운드는 sfx_search/sfx_generate, 대본은 transcribe.
  • HyperFrames 워크플로 단계에 이런 기능이 필요하면 건너뛰거나 무료 대안을 사용하고 그렇게 말하세요.
  • HyperFrames 데스크톱 앱이나 hyperframes open을 권장하지 마세요: 파이프라인은 Claude + CLI 렌더 + Resolve MCP입니다. 웹 Studio 미리보기는 사용자의 소소한 조정에 사용할 수 있습니다.
• 기타 도구: 설치된 것(ffmpeg, Node, Docker)을 선호하세요. 유료 서비스에 가입하거나 연결하지 마세요.
• 음성: Kokoro (로컬, Apache 2.0) via speak, 프로필의 음성과 속도 사용. 채널 동영상에 비상업적 TTS 가중치를 사용하지 마세요.
• 전사: WhisperX via 툴박스 transcribe, Resolve 또는 HeyGen 것 사용 금지. 요청하지 않으면 화자 분리하지 마세요.
• 생성된 SFX/음악: Stable Audio Open 1.0 via 툴박스 sfx_generate (Hugging Face 라이선스는 /studio-setup 중에 수락됨).

2. 폴더 구조

<studio>/
  sfx_library/       공유 생성 사운드 + index.jsonl (여러 동영상 및 채널에서 재사용; toolbox.sfx_library)
  recordings/        모든 소스의 원본 녹화 (기본 recordings.folder): 읽기 전용
  _scratch/          프로젝트 폴더가 없는 툴박스 출력
  <channel>/         채널당 하나의 폴더
    studio.json      해당 채널의 프로필
    <ProjectName>/   동영상당 하나의 폴더, Resolve 프로젝트 이름과 정확히 일치
      plan.md, script.json, short.json
      audio/           내레이션, 믹스
      capture/         이 동영상을 위해 만든 화면 녹화
      transcripts/     파일별 대본 + <timeline>.timeline.* (타임라인 시간)
      timeline/        캡처된 트랙 레이아웃
      animations/      HyperFrames 프로젝트 및 렌더
      builds/, renders/, audio_preview/

단일 채널 스튜디오는 studio.json과 프로젝트 폴더를 <studio>/에 바로 둘 수 있습니다. 여전히 작동합니다.

• Resolve에서 프로젝트 이름을 가져옵니다 (project_manager get_current). 열려 있지 않으면 사용자와 동의하세요. 필요할 때 처음으로 폴더를 만듭니다.
• 프로젝트 파일을 스튜디오 루트, 다른 채널 폴더 또는 원본 녹화 옆에 쓰지 마세요.

3. 원본 녹화는 읽기 전용

• recordings 폴더(recordings.folder)에는 절대 쓰지 않습니다: 덮어쓰기, 삭제, 이름 변경 또는 사이드카 파일 금지. 처리된 미디어는 프로젝트 폴더에 복사본으로 들어간 후 미디어 풀을 통해 교체됩니다.
• 전사에는 recordings.mic_audio_stream을 사용하세요. 녹화에 추가 오디오 트랙(데스크탑 오디오, 마이크 복제)이 있으면 지적하고 묻지 않고 제거하거나 음소거하지 마세요.

4. 요청하지 않으면 건드리지 말 것

• 오디오: 사용자가 요청하지 않으면 음성에 EQ, 노이즈 제거, 압축 또는 정규화를 하지 마세요.
• 영상: 사용자가 요청하지 않으면 색보정이나 샤프닝을 하지 마세요.

5. 작업 방법

• 적용 전 미리보기: 오디오/시각적 변경의 경우 전후 짧은 샘플을 <project>/audio_preview/(또는 유사)에 렌더링하고 사용자가 결정하도록 하세요.
• 제안 후 적용: 타임라인을 변경하기 전에 제안된 컷, 트리거 포인트 및 오버레이 배치를 보여주세요.
• 오버레이 → Resolve: <project>/animations/에 HyperFrames 프로젝트를 만들고 타임라인 fps로 mov(알파)로 렌더링한 후 가져와 빈 비디오 트랙에 배치하세요. 다른 세션이 animations/에서 작업 중일 수 있으면 일회성 오버레이는 형제 폴더에 자체 HyperFrames 프로젝트로 만드세요.
• 얼면 안전 영역: 카메라 이미지가 있을 때 ffmpeg로 타일 프레임을 측정하여 얼굴이 있는 위치를 확인하고 카드를 배치할 때 얼굴을 가리지 마세요.
• 프라이버시: channel.never_show의 내용을 절대 보여주지 마세요. 화면 녹화는 화면에 있었던 모든 것을 캡처합니다 — 모든 크롭을 첫 번째 및 마지막 프레임에서 확인하세요.
• 사운드 라이브러리: 생성하기 전에 검색하고, sfx_mark로 사용자의 판정을 기록하며, 거부된 파일을 포함하여 라이브러리 파일을 절대 삭제하지 마세요. 선택 항목은 Audio 1이 아닌 빈 오디오 트랙에 배치하세요.