vibecut-add-subtitles

vibecut-add-subtitles 스킬

모드 선택

상황	모드
원본 영상에서 처음 자막 생성 (새 CapCut 프로젝트)	모드 A
이미 편집된 CapCut 프로젝트에 자막 추가, 원본 {stem}_words.json 있음	모드 B (컷 매핑) — 기본
이미 편집된 프로젝트인데 원본 전사가 없음 (외부에서 편집)	모드 B 폴백 (재전사)

전제 조건 (모든 모드 공통)

VIBECUT_CONFIG="${HOME}/.vibecut/config.json"
SCRIPTS=""
if [ -f "${VIBECUT_CONFIG}" ]; then
  SCRIPTS=$(python3 -c "import json; print(json.load(open('${VIBECUT_CONFIG}')).get('scripts_dir',''))" 2>/dev/null)
fi
if [ -z "${SCRIPTS}" ]; then
  SCRIPTS=$(find "${HOME}/.claude/plugins/cache/vibecut" -name "capcut_editor.py" -maxdepth 8 2>/dev/null | head -1 | xargs dirname 2>/dev/null)
fi
if [ -z "${SCRIPTS}" ]; then
  APP_DIR="${HOME}/.vibecut/app"
  if [ -d "${APP_DIR}/.git" ]; then
    git -C "${APP_DIR}" pull --ff-only >/dev/null 2>&1
  else
    git clone --depth 1 https://github.com/AX-Surfers/Vibecut.git "${APP_DIR}" >/dev/null 2>&1
  fi
  [ -f "${APP_DIR}/scripts/capcut_editor.py" ] && SCRIPTS="${APP_DIR}/scripts"
fi
[ -z "${SCRIPTS}" ] && echo "❌ vibecut-setup 먼저 실행" && exit 1

uv run "${SCRIPTS}/_platform.py" quit-capcut
WHISPER_MODEL="large-v3-turbo"   # 질문 없이 고정. 사용자가 이번만 다른 모델을 말하면 그 값

⚠ 커뮤니티 한국어 fine-tune 모델은 기본으로 쓰지 않습니다 — 긴 오디오 대부분을 누락한 사례가 있습니다. 배경과 안전 절차는 vibecut-auto-edit 단계 1 참고.

---

모드 B: 기존 CapCut 프로젝트에 자막 추가 (컷 매핑, 기본)

{stem}_words.json + CapCut 컷 정보
  ├─ [1] 프로젝트·타임라인 확인 (find_project.py)
  ├─ [2] subtitles_from_cuts.py  → {stem}_subtitle_input.json  (자막 경계 == 컷 경계, 오인식 사전 적용)
  ├─ [3] subtitle-splitter 에이전트 → {stem}_subtitle_splits.json
  └─ [4] apply_subtitles.py       → 자막 트랙 추가, 다른 트랙 보존, 4개 JSON 갱신 + 백업

왜 재전사하지 않는가: 편집 오디오를 이어붙여 다시 전사하면 Whisper가 하드컷을 무시해 자막이 컷을 가로지르고 같은 문장이 두 번 나왔습니다. 컷은 원본 words.json의 경계로 만들어졌으므로 같은 단어 시각을 컷 매핑으로 옮기면 경계가 구조적으로 일치합니다.

단계 1: 프로젝트·타임라인

VIDEO="<원본 영상 경로>"; STEM="${VIDEO%.*}"
uv run "${SCRIPTS}/find_project.py" "${VIDEO}"     # <프로젝트>\t<타임라인 이름>\t<id>
PROJECT="<CapCut 프로젝트 경로>"
TIMELINE="<타임라인 이름 또는 빈 문자열>"
TL_OPT=(); [ -n "${TIMELINE}" ] && TL_OPT=(--timeline "${TIMELINE}")