몽타주 릴 편집은(는) 무엇을 하나요?
{{REPO}}에서 편집 시스템을 제공합니다. 모든 명령은 {{REPO}}\scripts 디렉토리에서 Python 환경({{REPO}}\.venv\Scripts\python.exe)을 사용하여 실행합니다. 경로(작업 디렉토리, CapCut 소스, 폰트, 색상)는 {{REPO}}\config.json에서 가져오므로 스크립트에 직접 경로를 작성하지 마십시오.
편집 전 필수 확인
{{REPO}}\mi-estilo\estilo.md(사용자가 원하는 스타일)와, 존재하는 경우mi-estilo\aprendido.md(사용자 릴에서 학습한 내용) 및mi-estilo\referencias.md(유령 계정에서 학습한 내용)를 읽으십시오. 이 파일들은 아래 기본 규칙보다 우선합니다. 파일 간 충돌 시estilo.md가 최우선입니다.estilo.md가 비어 있고 첫 번째 사용인 경우, 5-6개의 짧은 질문(주제, 길이, 자막, 색상, 음악)으로 작성하도록 제안하십시오. 사용자가 원하지 않으면 기본값을 사용합니다.
작업 방식 (협의 불가)
- 하나씩 처리하고 승인받기. 한 조각을 제시하고, 사용자의 내보내기 완료 또는 '다음' 명령을 기다린 후 수정하고 다음 조각으로 넘어갑니다. 한꺼번에 여러 조각을 처리하지 마십시오.
- 각 조각은 자체 자원을 요청합니다. 언어는 공통적(색상, 타이포그래피, 자막)이나, 자원(자막 바, B-roll, 확대, 단어 강조)은 각 문장에 따라 결정됩니다. 연속된 두 조각에서 동일한 트릭을 반복하지 마십시오.
- 이미 마음에 든 부분은 재사용합니다. 조각이 괜찮으면 그대로 두고 반복되거나 깨진 부분만 수정합니다.
- 디자인 결함 발견 시 알립니다. 내보내기 결과를 확인하지 않고 무조건 통과시키지 마십시오.
프로세스 (단일 촬영본 기준)
| 단계 | 명령어 | 결과물 |
|---|---|---|
| 1. 정리 | python limpiar.py <촬영본.mp4> | <촬영본>-limpia.mp4 |
| 2. 전사 | python transcribir.py <촬영본>-limpia.mp4 | trabajo/transcripciones/tx (medium) 및 tx2 (turbo) |
| 3. 컷 | python cortes.py <촬영본>-limpia.mp4 | trabajo/<촬영본>-limpia/CORTE.mp4, CORTE.txt, tramos.json |
| 4. 컷 검토 | 사용자가 CORTE.mp4 확인 (모서리에 원본 시간 표시) | |
| 5. 수정 | python cortes.py <촬영본>-limpia.mp4 --fuera "17-45.5,53-58.6" | 새 컷 |
| 6a. CapCut 없이 최종 | python subtitular.py <촬영본>-limpia.mp4 --clave "단어1,단어2" | FINAL.mp4 |
| 6b. CapCut 프로젝트 | python montar_reel.py spec.json | CapCut에서 편집 가능한 프로젝트 |
| 7. 음악 | python anadir_musica.py <프로젝트> <음악.mp3> <볼륨> <시작_초> | 음성 아래 음악 트랙 추가 |
| 8. 내보내기 | 사용자가 CapCut에서 직접 수행 (자동화 불가) | |
| 9. 검토 | python revisar_volumen.py <최종.mp4> | 볼륨 및 안전 영역이 표시된 <최종>-hoja.jpg |
| 10. 썸네일 | 실제 프레임 기반 (아래 참고) |
- 3단계에서
CORTE.txt를 읽으십시오. 여기에는 가능한 반복(두 번 말한 구문)이 나열됩니다. 사용자가 동영상을 보고 결정할 수 있도록--fuera옵션으로 첫 번째 버전을 제거하도록 제안하십시오. - 대본이 있으면 훨씬 더 좋습니다. 컷 전에 대본이 있는지 물어보십시오. 촬영본 옆에
<촬영본>.guion.txt파일이 존재하는 경우(한 줄에 한 구문, 콘텐츠 패널에서 다운로드 가능),CORTE.txt에는 "대본 대비" 항목이 포함됩니다: 여러 번 말한 구문(마지막 테이크를 유지하도록 제안), 대본에서 벗어난 구문(잠재적 잉여 구문 또는 실패한 시작), 그리고 말하지 않은 줄. 이를 제안만 하고 자동으로 적용하지 마십시오. - 또한 직접 읽으십시오.
cortes.py의 목록은 거의 문자 그대로의 반복만 감지합니다(실제 4개 촬영본 기준: 사용자가 수동으로 제거한 항목의 27%만 찾음). 실행 후, medium 전사의 단어별 타임스탬프(<transcripciones>/tx/<촬영본>.json)와 대본(있는 경우)을 직접 읽고 각 아이디어의 깔끔한 패스 하나(보통 마지막으로 완전히 말한 버전)를 남기기 위해 남은 범위를 표시하십시오: 실패한 시작, 다른 단어로 반복된 문장, "헷갈렸어" 등. 한 번만 말한 것은 절대 제거하지 마십시오. 동일한 4개 촬영본 기준, 이렇게 직접 읽으면 수동 제거 항목의 83%를 찾았지만, 좋은 내용을 제거하자고 제안한 경우도 있었습니다(135초 중 21초가 유지됨). 따라서 항상 검토용 동영상에서--fuera로 제안으로 제시하고 사용자가 결정해야 합니다. - "X에서 Y까지 제거"는 항상 원본 시간(컷 동영상 모서리에 표시된 시간)을 사용합니다. 잘린 동영상 시간이 아닙니다.
- 사진 프레임 시트 (
.jpg의Read)를 직접 확인하여 괜찮다고 말하기 전에 확인하십시오: 위쪽 빨간 선(y 288) 위, 아래쪽 빨간 선(y 1267) 아래, 노란 선(x 930) 오른쪽에 중요한 내용이 없어야 합니다. montar_reel.py의 spec 템플릿은{{REPO}}\ejemplos\spec_ejemplo.py(실제 릴에 모든 리소스와 ORGANICO / ANUNCIO 스타일 포함)입니다. 최소 키:nombre,video,fin,palabras,palabras_subt,tramos(또는fuera),piezas_dir.- 이미 구성된 CapCut 프로젝트를 다시 만들지 않고 수정하려면:
anadir_musica.py,anadir_sonido.py,cambiar_clip.py,podar_sonido.py.
기본 규칙 (실제 10개 릴 배치 기준 측정)
- 컷: 첫 번째 단어 0.10초 전부터 마지막 단어 0.18초 후까지 유지; 두 구간 사이의 간격이 0.55초 미만이면 병합합니다.
mi-estilo/aprendido.json이 있으면cortes.py가 해당 값을 사용합니다. - 오디오: highpass 80Hz + 3.2kHz 부드러운 EQ + two-pass loudnorm(-15 LUFS, 피크 -2). 압축기나 노이즈 감소는 사용하지 않음: 배경 잡음이 증가합니다.
- 자막: 대문자, 흰색에 검은색 테두리, 키워드는 config의
color_clave색상, 1~3단어 블록, 최대 14자. - 자막 바: PNG 1080x1920, 흰색 + 키워드는 키 색상, 단단한 그림자, 88%(숨 쉴 공간 확보).
- 자막 바와 자막은 절대 겹치지 않습니다. 오가닉 스타일에서는 자막이 아래로 내려감(
subt_y_bajo-0.37); 광고 스타일에서는 자막 바가 올라가고 자막이 -0.255로 내려감(y 1267을 초과하지 않음). 레이어가 하단을 차지하면 자막이 숨겨집니다. - 계층 구조(작은 줄 + 큰 키워드) 는 두 개의 분리된 텍스트로: 하나에 크기를 혼합하면 CapCut이 정렬을 잘못함.
- 가짜 멀티캠: 교대 구간 130%, 강력한 구문에서 확대 138%.
- Instagram 광고 안전 영역: 유용한 y 288-1267, 오른쪽 버튼 x 930부터. 오가닉: 250 / 420. 작은 B-roll 카드는 왼쪽, 눈높이(크기 0.22, x -0.60, y 0.30)에 배치: 오른쪽에 두면 얼굴을 가리거나 버튼 아래로 떨어짐.
- 적은 사운드 이펙트, 이유가 있을 때만(자막 바에 충돌, 목록에 틱). 릴 하나에 12개 이상은 과함. 어떤 이펙트도 동영상 끝을 넘을 수 없음.
- 프로모션용 무료 음악: Pixabay 또는 Mixkit. 볼륨 Pixabay 0.06
0.07, Mixkit 0.130.14(Pixabay가 약 7dB 더 큼). 국가나 유명 노래 금지: Meta가 광고를 차단합니다. - B-roll은 Pexels만 사용(
herramientas/pexels_buscar.mjs,{{REPO}}\.env에PEXELS_API_KEY필요). Mixkit 또는 Pixabay의 음악 및 효과. 최종 동영상에 다른 계정의 자료를 절대 사용하지 마십시오.
알려진 함정
- CapCut이 열려 있으면 변경 사항을 덮어씁니다: 자동 저장이
montar_reel.py가 작성한 내용을 덮어씁니다. 사용자에게 CapCut을 닫고 프로젝트를 새로 볼 수 있도록 다시 시작하도록 요청하십시오(새 프로젝트를 실시간으로 감지하지 못함). - CapCut에서 내보내기는 수동입니다: 자동화할 수 없습니다. 사용자가 CapCut을 원하지 않으면
subtitular.py를 사용하십시오. - 머리 뒤에 중요한 것 두지 마십시오: 가려집니다. 가슴 높이에 크게 배치하십시오.
- 대상 프로젝트 폴더가 이미 존재하면 VectCutAPI가 삭제합니다: 항상 새 이름(
-v2,-v3)을 사용하십시오. - CapCut 프로젝트를 정리하려면: 이동하고, 삭제하지 마십시오. CapCut이 닫혀 있을 때만 수행하십시오.
- CapCut 버튼은 자동화로 접근할 수 없습니다. 맹목적으로 클릭하지 마십시오: 사용자에게 직접 프로젝트를 열도록 요청하십시오.
- 내보내기 검토 시 텍스트가 어디에 떨어지는지 픽셀 단위로 측정하십시오: 애니메이션 중간의 캡처는 속일 수 있습니다.
- 촬영본 끝부분, 손이 휴대폰이나 텔레프롬프터로 갈 때는 잘 감지되지 않습니다: 직접 확인하고
--fin으로 잘라내십시오. - 간투사는 자동으로 제거되지 않습니다. 자막에 전사 오류가 있을 수 있습니다: 전달하기 전에 읽으십시오.
- 첫 번째 전사는 Whisper 모델(수 GB)을 다운로드합니다: 시간이 걸린다고 알리십시오.
썸네일
- 실제 프레임 전체, 밝고 배경이 있는 것. 절대 사람을 잘라내어 다른 배경에 붙이거나 어두운 배경 사용 금지.
- 키워드는 브랜드 색상의 상자에 흰색 줄 위에, 작은 레이블이 있을 수 있음.
- 텍스트 블록은 턱 아래에, 프로필 그리드 3:4 자르기(y 240-1680) 안에 완전히 들어와야 함.
- Pillow와
rotulos_lib.py사용(폰트와 색상은config.json에서). 표정 개선에 AI를 사용하는 경우 두 버전을 모두 제공하고 AI 버전에는 Meta의 "AI로 제작" 레이블을 붙입니다.
개인화
A. 작성된 스타일: mi-estilo/estilo.md
사용자가 원하는 릴 스타일을 작성하는 템플릿. 사용자가 수정 사항을 제시할 때마다("너무 촘촘하게 자르지 마", "키워드는 항상 빨간색", "더 빠르게") estilo.md의 "학습된 수정" 섹션에 날짜와 함께 추가하고 즉시 적용합니다. 수정 사항이 숫자(공기, 간격, 크기, 색상)인 경우 aprendido.json 또는 config.json에서도 변경합니다.
B. 사용자 릴에서 학습
사용자가 "내 릴에서 배워" 또는 "내 편집 스타일을 배워"라고 말할 때:
- 사용자에게
mi-estilo/mis-reels/에 자신의 게시된 릴 3~10개(내보낸.mp4파일)를 복사하도록 요청합니다. python analizar_reels.py mis-reels->mi-estilo/mis-reels.json(길이, 컷당 초, 초당 단어 수, 볼륨, 처음 3초 후크, 마무리) 및 각 동영상의 프레임 시트.- 프레임 시트 확인(각
*-hoja.jpg의Read): 자막 크기, 위치, 색상; 자막 바, B-roll, 확대, 구도 사용 여부. - 사용자가 자동 컷을 수동으로 수정한 CapCut 프로젝트가 있으면 비교합니다:
python aprender_corte.py <깨끗한-촬영본.mp4> <capcut_프로젝트> [...]->mi-estilo/aprendido.json(각 컷 전후의 공기 및 자르지 않는 간격).cortes.py가 자동으로 사용합니다. mi-estilo/aprendido.md작성: 측정된 내용(숫자 포함)과 프레임 시트에서 본 내용을 구체적인 규칙으로("자막 중간 높이, 2단어, 노란색"). 확인되지 않은 것은 작성하지 마십시오.- 요약을 보여주고 사용자가 자신의 스타일인지 확인하도록 합니다. 사용자가 아니라면 제거합니다.
C. 유령 계정 (참조 릴)
사용자가 "이 계정 분석해 줘", "유령 계정", "이 릴처럼 편집하고 싶어"라고 말할 때:
- 사용자에게 릴 링크를
mi-estilo/referencias.txt에 붙여넣도록 요청합니다(한 줄에 하나씩). python referencias.py: yt-dlp로mi-estilo/referencias/에 다운로드하고 분석 실행(mi-estilo/referencias.json+ 프레임 시트).- 프레임 시트를 확인하고
mi-estilo/referencias.md작성: 해당 계정의 스타일(리듬, 후크, 자막, 자막 바, 마무리) 및 그 중estilo.md와 충돌하는 항목을 사용자가 선택할 수 있도록 표시. - 참조는 지도일 뿐 템플릿이 아닙니다: 구조(리듬, 후크 유형)는 복사하지만 텍스트, 음악, 다른 계정의 이미지는 절대 복사하지 않습니다.
유령 계정 규칙:
- 다운로드한 동영상은 이 컴퓨터에서 분석 용도로만 사용됩니다. 업로드, 재게시,
mi-estilo/referencias/(git 외부) 밖으로 반출되지 않습니다. - Instagram에 로그인하거나 사용자의 비밀번호를 요청하지 마십시오. 링크가 로그인을 요구하면 건너뜁니다.