숏츠 파이프라인 (주제 중립적)
하나의 편집 목록(<short>/edl.json)과 보이스오버로 완성된 비디오가 만들어집니다: 테마 사진 "창" 안에서 움직이는 클립, 단어 캡션, 훅 플레이트, 히어로 서클 하나, 커버, SFX 큐 리스트, -14 LUFS 사운드 믹스.
채널 특화된 모든 것(주제, 언어, 시청자, 콘텐츠 규칙, 외관, 음성, 크레딧, 일정)은 프로젝트의 CHANNEL.md에 있습니다. 먼저 읽고 아래 기본값보다 우선 적용하세요. 파일이 없거나 섹션이 비어 있으면, 아무것도 제작하기 전에 소유자에게 문의하거나(또는 engine/templates/CHANNEL.md를 복사하여 함께 작성) 하세요.
관련 스킬: shorts-script-voice(주제, 스크립트, 음성) 및 shorts-packaging(완성된 파일, 업로드 텍스트).
시작 전에
- 킷 스크립트(
setup.sh,shorts-init.sh,doctor.sh,install-codex.sh)는 킷의scripts/폴더에 있습니다: 플러그인 폴더 또는$SHORTS_HOME/kit/scripts/(setup.sh와install-codex.sh는 사본을 유지). _pipeline/,_tools/,_fonts/,CHANNEL.md를 포함하는 프로젝트 폴더에서 작업합니다(scripts/shorts-init.sh <dir>로 생성). 아래 모든 명령은 해당 폴더의 루트에서 실행됩니다.scripts/doctor.sh <project-dir>를 각 머신에서 한 번 실행합니다. 모든 종속성(시스템 프로그램, Python 패키지, 모델, 여유 디스크)을 확인하고 "All good."으로 끝나야 합니다. 그렇지 않으면: ffmpeg/Python/curl용scripts/install-system-deps.sh, 나머지용scripts/setup.sh. 전체 목록은 킷의DEPENDENCIES.md에 있습니다.SHORTS_HOME(기본값~/.shorts-studio)은 Python 가상 환경과 음성 모델을 보관합니다. 다른 곳에 둔다면 내보내세요.- 편집 목록을 작성하기 전에
_pipeline/README.md(엔진 참조)와references/edl-notes.md를 읽으세요.
워크플로 (각 단계마다 자체 검사가 있습니다)
| # | 단계 | 명령 / 출력 | 확인 |
|---|---|---|---|
| 1 | 주제 + 스크립트 | 스킬 shorts-script-voice | 하나의 주장, 출처 명시, 프로필이 요청하면 소유자 승인 |
| 2 | 음성 | $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, 그런 다음 _tools/words.py <short>/vo | vo/words.json 읽기: 모든 단어가 정확한지 |
| 3 | 푸티지 | _tools/grab.py <topic> '<url>' <start> <end> --tag NAME (_footage/SOURCES.md에 기록), 또는 직접 녹화 | 모든 클립의 콘택트 시트; CHANNEL.md의 정책 |
| 4 | 편집 목록 | references/edl-template.json 복사, 내용 변경 | build.py <edl> --words가 캡션 토큰 표시 |
| 5 | 렌더링 | python3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10분; 4K60은 느림) | 오류 없음; 파일이 edl보다 최신 |
| 6 | 커버 | ... build.py <edl> --cover | "안전 영역 위반: 없음", 180px 너비에서 읽기 가능 |
| 7 | 검사 | python3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.json | ALL CHECKS PASS 출력; 모든 콘택트 시트 확인 |
| 8 | 사운드 | $SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict | -14.0 +/-0.5 LUFS, 트루 피크 <= -1.0 dBTP, 단어 오류 0에 가까움 |
| 9 | 패키징 | 스킬 shorts-packaging | ready/에 파일 + 커버 + 업로드 블록 |
소스 클립의 콘택트 시트: ffmpeg -ss <t> -i <file> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png
(PNG 작성: 일부 소스의 JPEG 출력이 "non full-range YUV"로 실패). 샷 경계:
ffmpeg -i <file> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*".
테마: case-file(서류 용지), panel-heist(만화 페이지), vice-dusk(네온 황혼), classic; 프로필이 하나를 선택합니다.
좋은 숏츠의 모습 (기본값; 프로필이 재정의)
- 18-45초, 훅에서 결말까지 하나의 주장, 1.5-3초마다 컷, 모든 샷이 움직임, 훅 플레이트는 프레임 0부터 켜짐
(
hook.y1170은 전시 레이블과 겹치지 않도록 유지), 프레임이 실제로 보여주는 것에 빨간 원이 있는 히어로 순간 하나. - 그림이 단어를 따릅니다. 캡션은 2-3단어 구(
break_before); 이름은 하나의 그룹으로 유지. - 마지막 샷이 첫 번째 프레임으로 다시 컷 (비디오가 반복됨).
- 모든 읽을 수 있는 텍스트는 전화 안전 영역 내에 유지: y 300-1580, x 130-950 (y 1000-1600의 경우 x <= 860). check.py가 강제.
- 1080p 이상 클립에 "aspect": "3:4"(900x1200)의 높은 사진 창. 720p 또는 레터박스 소스는 채울 수 없음.
힘들게 얻은 교훈 (자세한 내용은 references/lessons.md)
- edl이 렌더링보다 최신? 렌더링이 오래된 것입니다. check.py를 판단하기 전에 다시 빌드하세요.
- 정지된 스틸(연속 프레임이 0.3초 이상 거의 차이 없음)은 check.py를 실패시킵니다. 정적 화면, 평평한 색상, 움직임이 없는 피사체는 일정한 속도의 움직임이 필요:
"move_ease": "linear", 0.15-0.4의 줌 범위 및 150+ 소스 픽셀의 팬.float만으로는 충분하지 않음 (사인파가 방향 전환에서 0으로 느려짐). - 줌 제한: 4K 소스 <= 1.00, 1080p <= 1.25, 720p <= 1.0 (check.py가 클립당 제한 출력).
- 크리에이터 오버레이(워터마크, 페이스캠, 하단 1/3, 자막, 스타일 배너)는 그림에 닿지 않음: 최상위
sources그림 오버라이드로 자르기, 자르기 이동, 또는 다른 프레임 선택. 모든 컷 프레임을 확인. - 정직성: 라벨, 원, 캡션은 프레임이 보여주는 것만 말함; 음성에서 사실을 출처에 귀속.
- 커버: 하나의 소스 프레임을 전체 면적으로 자름; 플레이트는
tab_y(330)에 위치하여 그림 상단을 가림. 상단에 가까운 피사체의 경우tab_y를 약 1090,stamp_y를 약 410으로 설정. - 한 번에 하나의 렌더링 (4K60 렌더링은 모든 코어 사용); 같은 폴더의 두 번째 렌더링을 시작하지 마세요.
서브 에이전트에게 편집 위임
에이전트에게 BRIEF.md(shorts-init이 references/editor-brief.md에서 생성)와 스크립트, 음성 파일, 클립 목록을 제공하세요. 메인 세션은 스크립트와 음성을 작성하고, 모든 프레임을 직접 검토하며 사운드 믹스를 수행합니다: 에이전트의 보고는 주장일 뿐 증거가 아닙니다. 수락하기 전에 파일 시간(무음 mp4가 edl보다 최신, 검사 로그가 mp4보다 최신)을 확인하세요.