review-ugc-render은(는) 무엇을 하나요?
모든 UGC 비디오 레시피가 게시 전 반드시 통과해야 하는 QC 게이트. 육안
/watch가 아닌 — 결정론적 전사-대본 차이 검사로, 결함이 있을 경우 비-제로로 종료되어 레시피가set_final_render를 하드 스톱합니다.
왜 필요한가
Seedance는 오디오를 자체 생성합니다. 때때로 단어를 잘못 발음(mis-voice) 합니다 — 승인된 대사 human-vetted가 human witted로 발음되는 식입니다. 또 다른 사례: Hume→Hune, Alitu→al-too. 이 결함은 렌더링의 오디오에 존재하므로, 육안 /watch ("대사가 스크립트와 일치함")로는 놓치기 쉽고, 이후 캡션 생성 단계에서 잘못된 단어가 그대로 박히게 됩니다. 실제로 발화된 오디오와 사용자가 승인한 스크립트를 비교하는 과정이 없었습니다.
이 게이트는 정확히 그 작업을 결정론적으로 수행하며, 불일치 시 게시를 거부합니다.
실행 시점
- 필수: 모든
remix-ugc-*-from-sample및create-ugc-*-video-from-refs레시피의 QC 단계에서, 마스터 렌더가 존재한 후 그리고set_final_render전에 실행합니다. - 통과(PASS)할 때까지 수정/재실행 후 다시 실행합니다.
계약(Contract)
렌더링 전에, 승인된 정확한 구어 대사(비트 노트 제외, 말 그대로의 발화)를 working/approved-script.txt에 저장합니다. 그런 다음 렌더 후:
python3 <pack>/review-ugc-render/scripts/review_render.py \
--video working/final.mp4 \
--script-file working/approved-script.txt \
--json working/review-verdict.json
- exit 0 → PASS — 게시 진행 (
set_final_render). - exit 2 → FAIL — 게시 금지. 보고서를 읽고 수정 후 재실행.
- exit 3 → ERROR — 검사를 실행할 수 없음 (아래 참조). 환경을 수정하고, 맹목적으로 게시하지 마십시오.
전사 백엔드 (우선순위 순): OPENAI_API_KEY (설정된 경우 OPENAI_BASE_URL을 사용하여 gooseworks Whisper 프록시로 라우팅) → 로컬 whisper CLI. ffmpeg가 PATH에 있어야 합니다.
FAIL의 의미와 수정 방법
| 보고서 라인 | 근본 원인 | 수정 방법 |
|---|---|---|
[high] said [witted] where script has [vetted] | Seedance가 생성한 오디오에서 단어를 잘못 발음함 | 새 시드(seed)로 재생성. 브랜드/조어 토큰인 경우 SPOKEN LINE에 음성적으로 철자하세요 (예: Ali-too, 절대 (발음: …)와 같은 괄호 사용 금지 — Seedance는 괄호도 읽습니다). create-video-seedance-2-fal 실패 모드 참조. |
[medium] dropped [...] / 낮은 유사도 | Seedance가 승인된 구문을 누락함 | 재생성; 꼬리 단어만 누락된 경우 stitch_replacement.py 창 수정으로 복구 가능할 수 있습니다. |
⚠ audio is effectively silent | 잘못된 렌더 / 오디오 트랙이 후처리에서 손실됨 | 재렌더링 / 먹싱 재확인; 무음 테이크를 게시하지 마십시오. |
ERROR: no transcription backend | OPENAI_API_KEY도 로컬 whisper도 없음 | 키(프록시 OPENAI_BASE_URL)를 설정하거나 whisper를 설치한 후 재실행. |
--expect-music는 참고용일 뿐입니다 (음악 배경이 없으면 경고). 자체적으로 게이트를 실패시키지 않습니다.
입력
--video PATH(필수) — 렌더링된 마스터 mp4.--script-file PATH또는--script "text"— 승인된 구어 대본. 둘 다 생략하면 진정한 스크립트 없는 클립으로 간주됩니다 (드리프트 검사가 건너뛰어지고 게이트는 참고용이 됩니다).--min-ratio FLOAT(기본값0.90) — 전사↔대본 토큰 유사도 통과 기준.--json PATH— 앱 검토 패널을 위한 기계 판정 결과를 기록합니다.
테스트
python3 tests/test_review_render.py # 순수 판정 로직; 오디오/네트워크 불필요
다음 경우를 다룹니다: 정규 vetted→witted 잘못 발음, 브랜드 이름 잘못 발음, 꼬리 누락, 무해한 필러 단어, 스크립트 없는 참고 경로.
content-goose 검토 엔진과의 관계
이 스킬은 더 포괄적인 coworkers/video/molecules/review/review-loop (18축 평가 기준)의 출시된 단일 파일 게이팅 조각입니다. 여기서는 게시 시점에 오디오-대본 결함을 잡는 하나의 축(review-transcript-integrity / brand_text_accuracy)을 적용합니다. 더 깊은 다축 검토는 content-goose 연구소에 남아 있습니다.