caption-writer
세 가지 별개 항목: 화면 자막(video/captions/, props.captions, speech.srt); 게시글 텍스트(captions/<platform>.md, 스킬 eda-marketing:content-repurposer); 편집 텍스트(spoken: false인 accents, editorialCta) — 절대 SRT에 포함되지 않음.
자막 텍스트는 브랜드 언어(brand.json → language)를 따릅니다. 그룹화, 타이포그래피 및 음절 규칙은 언어 팩(packages/core/src/lang/<en|ru>.ts)에서 가져옵니다.
녹음 전 (드래프트)
npm run mos -- captions build <pkg> — 스크립트에서 예상 시간 산출(brand.json → speech.syllablesPerSec), "예상 시간" 배지 표시, 최종 렌더링은 차단됨.
녹음 후
npm run mos -- footage <pkg>(소스가input/에 있는 경우).npm run mos -- captions transcribe <pkg> <음성 파일>— 로컬 faster-whisper 사용, 다운로드 불필요. 모델 없음 → 설치 전에 권한 요청 (docs/VIDEO_PIPELINE.md참조).- ASR(자동 음성 인식)은 드래프트입니다. 이름, 숫자, 부정어, 어미, 조용한 단어, 구문 경계를 확인합니다. 수정 사항은
transcript/corrected.<파일>.json과transcript/CORRECTIONS.md의 한 줄에 기록됩니다.transcript/raw-asr.*은 변경 불가입니다. 불확실한 경우 →[inaudible]표시 후 사용자에게 질문합니다. 절대 추측하지 마세요. 실제로 듣지 않았다면 들었다고 주장하지 마세요. - 실제 음성이 스크립트와 다른 경우, 차이점을 보여주고 사용자와 결정합니다(원래 음성 유지 / 재편집 / 재녹음). 자막은 실제 음성을 따릅니다. 오디오에 없는 단어를 절대 추가하지 마세요.
npm run mos -- captions map <pkg>→npm run mos -- captions build <pkg> --source transcribed.- 선택 사항:
npm run mos -- captions calibrate <pkg> raw-asr.<파일>.json --write— 제작자의 실제 속도를brand.json에 기록합니다.
모드 및 그룹화
기본 모드: brand.json → defaults.captionMode; 동영상별: props.captions.mode. replace — 짧은 그룹이 서로 교체됨; accumulate — 단어가 작은 계단 블록을 만듦; highlight — 요청 시 사용. 강조: 스크립트 음성에서 *word* (전사된 음성의 경우 corrected에 emphasis 표시).
의미별로 그룹화합니다. 부정어와 동사를 분리하지 마세요("don't / know"), 전치사와 단어를 분리하지 마세요("in / the app"), 숫자와 단위를 분리하지 마세요("30 / seconds"), 이름도 분리하지 마세요. 한 줄에 단어 하나가 매달리지 않도록 합니다. brand.json → captions.protectedPhrases를 유지합니다. 러시아어 규칙은 ru 언어 팩에 정의되어 있습니다.
확인
스튜디오: 각 페이지의 시작/끝, 자막-억양 전환 시 중복 없음, 휴대폰에서 가독성, 눈 위에 텍스트 없음. mos qa는 실제 글꼴 측정값으로 줄 넘침을 검사합니다.