자동 비디오 편집기
목표
원본을 보존하면서 실제 로컬 편집 결과물을 생성합니다. Codex는 의미적 결정을 수행하고, 워크스페이스 CLI는 결정론적 미디어 분석, 검증, FFmpeg 렌더링, 기술 QA를 수행합니다.
워크스페이스 루트: D:\workspace\codex-auto-video-lab.
워크플로우
요청사항에 reference 비디오 학습, 精剪, 계층/목록 오버레이 구축, 음성에 맞춘 제품 컷아웃 타임라인, 또는 계층화된 캡션 모션 등이 포함된 경우, 타임라인 작성 전에 $tiktok-fine-cut-director를 로드하십시오. 해당 정밀 편집 사양이 이 결정론적 렌더링 워크플로우의 의미적 입력이 됩니다.
-
사용자의 요구사항을 읽고 제공된 모든 로컬 에셋 경로를 확인합니다. 안전하고 간결한 작업 ID를 만듭니다. 원본 파일을 직접 편집하지 마십시오.
-
이 작업에서 첫 번째 편집인 경우 워크스페이스 닥터를 실행합니다:
powershell -ExecutionPolicy Bypass -File .\scripts\doctor.ps1 -
격리된 작업을 생성합니다. 소스당 한 번씩
--asset을 전달하고 사용자의 정확한 요청사항을 포함합니다:.\studio.ps1 create --job <job-id> --asset <경로> --brief <요구사항> -
작업을 분석합니다. 음성 의미, 캡션, 필러 제거, 또는 인용문 선택이 편집에 영향을 미치는 경우
--transcribe를 추가합니다:.\studio.ps1 analyze --job <job-id> --transcribe -
jobs\<job-id>\brief.txt,manifest.json,reports\analysis.json및 관련 트랜스크립트 JSON을 읽습니다. 씬 후보와 무음 구간은 증거로 사용하되, 자동 편집적 진실로 취급하지 마십시오. -
보수적인 초안을 생성합니다:
.\studio.ps1 draft-plan --job <job-id> -
jobs\<job-id>\edit-plan.json을 요청사항에 맞게 편집합니다. 계획을 변경하기 전에 edit-plan.md를 읽으십시오. 선택, 순서, 속도감, 텍스트, 화면 비율, 오디오 결정을 설명하는intent_summary를 유지하십시오. 사용할 수 없는 B-roll이나 사실에 근거하지 않은 주장을 절대 만들어내지 마십시오. -
검증, 렌더링, QA를 실행합니다:
.\studio.ps1 validate --job <job-id>.\studio.ps1 render --job <job-id>.\studio.ps1 qa --job <job-id> -
reports\qa.json의sample_frames및critical_overlay_frames아래 모든 경로를 로컬 이미지 뷰어로 검사합니다. 캡션, 크롭, 타이틀 안전 영역, 글꼴 글리프, 중요 오버레이, 또는 검은 프레임이 잘못된 경우 계획을 수정하고 다시 렌더링하십시오. -
MP4, 편집 계획, 분석, QA 경로를 전달합니다. 실제로 실행된 항목(소스 검사, 트랜스크립션, 로컬 렌더링, 전체 디코드, 샘플링된 프레임 시각 검사, 플랫폼 재생)을 별도로 명시하십시오. 기술 QA를 의미적 또는 게시 검증이라고 부르지 마십시오.
결정 규칙
- 요청사항이 작은 세부 사항을 열어둔 경우 합리적인 편집 가정을 하고
intent_summary에 기록합니다. - 누락된 선택이 스토리, 제품 주장, 정체성, 또는 라이선스 에셋 사용을 실질적으로 변경하는 경우에만 사용자에게 질문합니다.
- 액션, 음성, 증명, 일반 몽타주에는 하드 컷을 선호합니다. 논컷 전환은 실제 시간/장소/장 변경, 부드러운 연결, 또는 시각적으로 일치하는 방향 이동에만 사용하고, 텍스트 스케일은 지원되는 훅, 대비, 숫자, 증명, 페이오프, 또는 CTA에만 사용하십시오. 효과보다 속도감과 샷 선택을 우선시하십시오.
- 대화가 명확하게 들리도록 유지합니다. 배경 음악은 기본적으로 덕킹이 활성화된 상태에서
-18 dB근처로 설정합니다. - 세로 숏폼 출력의 경우 기본적으로 1080x1920, 30fps를 사용합니다. 중요한 콘텐츠가 프레임을 벗어날 때는 파괴적인 크롭 대신
contain을 사용합니다. - 사용자가 스타일 변경을 요청하지 않는 한, 이미 읽을 수 있는 캡션이 포함된 소스 푸티지 위에 새 캡션을 덧입히지 마십시오.
- 씬 감지, 무음 감지, 음성 인식을 오류 가능성이 있는 증거로 취급합니다. 의미적 컷 전에 트랜스크립트 경계를 확인하십시오.
빠른 기준
의미적 삭제 없이 순서 연결, 리프레임, 선택적 제목, 캡션만 필요한 요청의 경우 baseline-auto가 전체 기계적 파이프라인을 실행할 수 있습니다. 이를 사용자 정의 편집 판단이 아닌 기준선 어셈블리로 표시하십시오:
.\studio.ps1 baseline-auto --job <job-id> [--transcribe] [--title <텍스트>] [--burn-captions]
현재 경계
지원됨: 로컬 비디오/이미지 수집, 프로빙, 씬 후보, 무음 구간, 선택적 오프라인 트랜스크립션, 세그먼트 트림, 0.25x-4x 속도, fill/contain 리프레임, 정확한 소스 음소거 또는 소스 게인, 제어된 push/pull 모션, 증거 기반 dissolve/dip/directional-slide 전환, 스타일링된 애니메이션 제목/캡션/레이블, 캡션/제목/레이블 내 하나의 정확한 의미적 컬러 실행(해당 단어의 실제 말하기 창 내에서 선택적 제한된 pulse 또는 shake 포함), 쌍을 이루는 번호 단계 레이블, 생성된 음성 해설, 나레이션 덕킹이 포함된 배경 음악, 시간이 맞춰진 음향 효과, 상업용 컬러 피니싱, H.264/AAC MP4, 전체 디코드 QA, 검은 프레임 스캔, 오디오 레벨 스캔 및 샘플링된 프레임.
이 FFmpeg 렌더러에서 직접 지원되지 않음: 에셋 지식 베이스, 생성형 B-roll, 계층화된 Remotion 모션 그래픽, 객체 추적, 멀티캠 동기화, 편집 가능한 Premiere/DaVinci 프로젝트 내보내기, 또는 플랫폼 게시. 계층화된 Remotion 작업은 $tiktok-fine-cut-director에서 지정한 대로 $openchatcut을 통해 라우팅하십시오.