/drama-forge — 续集短视频一键流水线
당신은 짧은 비디오 시리즈 제작 파이프라인 운영자입니다. 사용자가 시리즈 이름을 입력하면 오케스트레이터를 실행하여 "대본→비디오→더빙→합성→품질 검사→상태 업데이트"를 모두 자동화하고, 출시 가능한 세로형 짧은 비디오를 생성하며 자동으로 다음 에피소드로 이어집니다(캐릭터 일관성 + 스토리 연속성은 상태 파일로 보장).
트리거
사용자가 /drama-forge를 호출하거나 자연어로 언급:
/drama-forge 生成 苏晚的重生 下一集
/drama-forge 重跑第 1-2 集（上次画面有重复问题）
/drama-forge 批量生成 3 集，古风重生爽文
/drama-forge 先跑一下自检
단일 명령(항상 먼저 시도)
cd <skill directory>
python -X utf8 scripts/run_pipeline.py --series "시리즈 이름" [옵션]
모든 단계 순서는 오케스트레이터 코드에 정의되어 있으며, 수동으로 각 단계를 실행하지 마세요.
| 옵션 | 설명 |
|---|---|
--series NAME | 시리즈 이름 (필수) |
--to-episode N | N번 에피소드까지 연속 생성 |
--force-episode N | N번 에피소드 강제 재생성 (원자적 상태 롤백 + 산출물 정리) |
--with-bgm | AI 배경 음악 자동 생성 (music-2.6) |
--genre / --directive | 장르 / 추가 스토리 지시사항 |
--dry-run | 비용 없음 사전 점검, 유료 API 호출 안 함 |
--workdir PATH | 작업 디렉토리 (series/ 위치) |
--model ID | LLM 모델 덮어쓰기 (기본값: abab6.5s-chat) |
Windows에서는 python에 반드시 -X utf8을 추가해야 합니다 (GBK 콘솔에서 한글 출력 시 깨짐 방지).
표준 워크플로우
- 사전 점검(코드 수정 후 반드시 실행, 비용 없음):
python -X utf8 scripts/run_pipeline.py --dry-run - 잔액 확인:
--dry-run은 잔액을 확인하지 않습니다. 생성 전에 최소 chat 호출을 먼저 수행하여 확인합니다 (InsufficientBalanceError발생 시 즉시 중단, 사용자에게 충전 요청 — MiniMax 비디오는 "오픈 플랫폼 잔액"만 인식하며, Token 패키지 금액은 비디오에 사용 불가) - 생성:
python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm] - 검수: 품질 게이트(내장) 통과 후
series/<시리즈 이름>/episodes/epXXX.mp4완성본 +series/<시리즈 이름>/.usage.json(비용 내역) 확인
품질 게이트(내장, 통과 실패 시 자동 중단)
각 에피소드 생성 후 자동으로 verify 실행:
- 모든 조각의 MD5가 서로 다름 (중복 조각 사고를 직접 방어)
- 완성본에 비디오 스트림 + 오디오 스트림 존재, 길이 ≥10초
- 스크립트에 hook_line(첫 프레임 오버레이 텍스트 훅) 포함 + 씬 길이가 균일하지 않음 (박자기 없음)
게이트 실패 = 상태 업데이트 안 함, 다음 에피소드 실행 안 함, 다음 에피소드 비용 소모 안 함. 수정 후 --force-episode N으로 재생성.
시리즈 지속 메커니즘(상태 파일을 수동으로 수정하지 마세요)
- 캐릭터/세계관/복선/요약은
series/<시리즈 이름>/state.json에 저장 - 각 에피소드: LLM이 상태를 읽음 → 대본 생성 → 완료 후 상태 업데이트 (요약/복선 추가/제거/캐릭터 상태)
- 특정 에피소드를 재생성하려면 반드시
--force-episode N사용 (상태 자동 롤백 + 산출물 정리), 수동 파일 삭제 금지 - 새 캐릭터:
assets/characters/에 정면/반신/단색 배경 사진 저장, state.json에 등록
전체 세부 정보
references/api-reference.md— 실제 테스트된 모든 API 파라미터 ("최적화"하지 마세요)references/pitfall-log.md— 사고 → 원인 → 방어 (매번 문제 발생 시 먼저 확인)references/quality-gates.md— 품질 게이트와 사전 점검 항목 설명references/content-quality.md— 다섯 단계 극작/훅 문법/유지 원칙assets/state.schema.json— state.json의 JSON 스키마assets/series-template.json— 새 시리즈 초기화 템플릿