video-shotcraft: 영화 같은 제품 비디오 제작
자체 포함된 제작 능력 라이브러리: 157장의 쇼트 레시피 카드(demo 구현 소스 코드 및 동적 샘플 갤러리 포함), 검증된 완전한 프로모션 템플릿, 재사용 가능한 컴포넌트 및 오디오 에셋, 6단계 워크플로우. 현재 초점은 웹/데스크톱 제품 프로모션 비디오이지만, 쇼트 카드는 그 자체로 일반적인 모션 효과 어휘입니다. 또한 개별 카드를 뽑아 임의 비디오의 단일 쇼트로 사용할 수 있습니다.
호출 시 먼저 모드 판단
완전한 프로모션 비디오에는 서로 병합되지 않는 세 가지 모드가 있습니다.素材 수집, 스토리보드 또는 구현을 시작하기 전에 사용자가 명시적으로 선택했는지 먼저 판단하십시오. 이미 선택한 경우 직접 실행하고 반복해서 묻지 않으며 다른 모드로 변경하지 마십시오.
- 템플릿 직접 사용: Ink Press의 기존 교체流程을 유지합니다.
template/TEMPLATE.md를 읽고 기존 쇼트 구조에 따라 대상 제품의 스크린샷, 카피 및 브랜드 정보를 교체합니다. - 자유 창작:
references/pipeline.md를 읽습니다. 에이전트는 사용자의 기존 요구 사항과 프로젝트 내용에 따라 시각적 방향, 쇼트 매핑, 스토리보드,素材 및 오디오를 자율적으로 결정하고 연속적으로 완성된 비디오로 진행합니다. 제품 브리핑, 스타일프레임, 쇼트 매핑 또는 스토리보드 단계에서 사용자 확인을 위해 중단하지 않습니다. - 공동 창작:
references/guided-free-creation.md를 읽습니다. 에이전트는 근거 있는 판단과 계획을 먼저 제시하고, 사용자가 제품 브리핑, 요구 사항 결정, 시각적 방향, 쇼트 매핑 및 최종 스토리보드를 순서대로 확인합니다. 스토리보드 승인 후references/pipeline.md의 최종素材 수집 및 제작 단계로 들어갑니다.
사용자가 프로젝트 경로, URL, 화면 녹화 또는 페이지 스크린샷을 제공했지만 아직 모드를 선택하지 않은 경우, 먼저 최소한의 읽기 전용 제품 검사를 수행합니다. 제품 포지셔닝, 주요 기능, 페이지 시각적 요소, 표시 가능한 상태 및素材 위험을 파악합니다. 비즈니스 프로젝트를 수정하지 않고, 민감한 데이터를 수집하지 않으며, 비디오 코드를 작성하지 않습니다. 검사 후 세 가지 모드를 제공하고 다음 사항을 설명합니다.
- Ink Press가 해당 제품에 적합한지, 적합 및 부적합의 구체적인 근거.
- 자유 창작과 공동 창작 각각의 적합 여부, 예상되는 제품 시각적 단서 유지 사항.
- 에이전트가 추천하는 모드와 그 근거 및 장단점.
그런 다음 명확하게 질문합니다. "위 제품 검사에 따라, 저는 ×× 모드를 추천합니다. 이 모드로 계속할까요?" 동시에 사용자에게 다음 사항을 알립니다: https://vincentwei1021.github.io/video-shotcraft/ 에서 동적 샘플을 둘러보고 비디오에서 사용하고 싶은 모션 효과 쇼트를 선택할 수 있습니다.
사용자가 검사 가능한 프로젝트나 페이지를 아직 제공하지 않은 경우, 세 가지 모드를 간략히 소개한 후 질문합니다. Ink Press가 기성 템플릿이라는 이유만으로 기본적으로 추천하지 마십시오.
- 사용자가 템플릿 선택:
template/TEMPLATE.md를 완전히 읽고 원본 템플릿流程대로 실행합니다. - 사용자가 자유 창작 선택:
references/pipeline.md를 완전히 읽고 에이전트가 자율적으로 진행하며, 단계별 확인을 위해 중단하지 않습니다. - 사용자가 공동 창작 선택:
references/guided-free-creation.md를 완전히 읽고 확인 노드에 따라 협업합니다. - 사용자가 아직 결정하지 않음: 여기서 멈추고 선택을 기다립니다. 사용자를 대신하여 기본적으로 선택하지 말고 제작을 시작하지 마십시오.
예외 1: 사용자가 이미 Ink Press 템플릿을 지명한 경우, 템플릿 모드가 선택된 것으로 간주합니다.
예: "Ink Press 템플릿을 사용하여 내 제품 프로모션 비디오를 만들어 주세요." 이 경우 다시 묻지 말고 template/TEMPLATE.md를 완전히 읽고 템플릿 경로로 실행합니다.
예외 2: 사용자가 특정 쇼트 카드를 사용하거나 참조하도록 명시적으로 지정한 경우, 쇼트 제약이 이미 선택된 것으로 간주합니다.
예: "deck-deal-flyin과 row-embed를 사용하여 이 비디오를 만들어 주세요" 또는 "spotlight-hero-card의 효과를 참조해 주세요." 이 경우 템플릿을 소개하지 말고 템플릿 사용 여부를 묻지 마십시오. 갤러리 이름 확인 규칙에 따라 지정된 쇼트를 확인하고 각 카드를 완전히 읽은 후 카드의 "참조 구현"에 따라 정확한 데모 소스 코드를 찾습니다. 단일 쇼트는 대상素材가 명확해진 후 실행할 수 있습니다. 완전한 프로모션 비디오가 아직 자유 창작 또는 공동 창작 중 어떤 방식을 사용할지 명시되지 않은 경우, 이 두 가지 모드에 대해서만 질문하고 지정된 쇼트를 후속 제작 제약 조건으로 사용하며, 자동으로 공동 창작으로 간주하지 않습니다.
네 가지 용법
- 완전한 프로모션 비디오 (템플릿 경로): 템플릿 비디오와 매우 유사한 효과를 원하는 경우 →
template/TEMPLATE.md를 읽고 "제품 교체 재현 가이드"에 따라素材를 교체하고 쇼트별로 적용합니다. - 완전한 프로모션 비디오 (자유 창작): 새로운 스타일을 원하고 에이전트에게 자율적 결정을 위임하는 경우 →
references/pipeline.md를 읽고 제품 이해부터 최종 검사까지 연속적으로 진행하며, 중간 단계별로 확인을 위해 중단하지 않습니다. - 완전한 프로모션 비디오 (공동 창작): 주요 결정에 참여하려는 경우 →
references/guided-free-creation.md를 읽고 제품 브리핑, 요구 사항 결정, 시각적 방향, 쇼트 매핑 및 최종 스토리보드를 확인합니다. 승인 후 파이프라인의 최종素材 수집부터 계속합니다. - 단일 쇼트/단일 모션 효과:
references/shots/에서 카드를 선택하거나(또는 사용자가gallery/갤러리에서 선택), 카드 전체를 읽고 "참조 구현"에 따라 정확한 데모 소스 코드를 찾은 후 대상素材에 적용합니다.
자유 창작과 공동 창작의 경계
자유 창작은 창의적 및 엔지니어링 결정을 에이전트에게 맡깁니다. 에이전트는 프로젝트 내용에서 동적으로 제품 핵심, 시각적 방향, 쇼트 매핑, 스토리보드,素材 처리 및 오디오 계획을 도출하고, 주요 판단을 기록한 후 직접 실행합니다. 안전하게 추론할 수 없는 필수 입력이 부족하지 않은 이상 질문하지 않고, 단계별로 중단하지 않으며, 중간 산출물에 대한 사용자 확인을 요구하지 않습니다. 사용자의 기존 명확한 요청은 항상 제약 조건이며 에이전트의 기본 선택으로 재정의될 수 없습니다.
공동 창작에서만 단계별 확인을 사용합니다. 기본적으로 references/guided-free-creation.md를 읽고, 각 라운드에서 재작업을 가장 줄일 수 있는 1-3개의 질문만 하며, 제품 브리핑, 요구 사항 결정, 시각적 방향, 쇼트 매핑 및 최종 스토리보드에서 중단하고 사용자 확인을 기다립니다. 사용자가 비즈니스 및 창의적 방향을 확인합니다. 에이전트는 선택 방식, 구현 매개변수, SFX 고정 프레임, Remotion 프로젝트, 렌더링 및 기술 QA를 자율적으로 완료합니다.
공동 창작 중 사용자가 명확하게 "전적으로 당신이 결정하세요" 또는 "확인 건너뛰고 바로 진행하세요"라고 말하면 자유 창작으로 전환하고 이 선택을 기록합니다. 자율적으로 진행한다고 주장하면서 계속 단계별 확인을 요구하지 마십시오.
기능-쇼트 매핑은 단지 "어떤 모션 문법을 선택할 것인가"일 뿐, 완전한 스토리보드가 아닙니다. 공동 창작에서 매핑을 확인한 후, 에이전트는 계속해서 쇼트 순서, 길이, 구체적인 화면, 페이지 상태,素材 출처, 자막, 전환 및 SFX를 제공해야 합니다. 완전한 스토리보드가 확인된 후에야 최종素材 수집에 들어갑니다. 사용자가 갤러리에서 쇼트 이름을 복사할 때는 카드 이름 또는 "카드 이름 · 스타일 이름"만 제공하면 되며, 에이전트가 로컬 레시피 카드와 데모 소스 코드를 읽습니다.
핵심 개념
-
기존 페이지를 복제할 때는 반드시 실제 스크린샷을 사용해야 합니다. UI를 직접 만드는 것은 비복제 시나리오로 제한되며, 품질과 표현의 명확성이 엄격한 기준입니다. 제품의 실제 페이지를 표현할 때는 첫 단계로 로컬 dev 서버를 시작하고, 헤드리스 브라우저로 전체 페이지 2x 텍스처 + 요소별 컷아웃 + layout.json 좌표표를 캡처합니다. 비복제 시나리오(추상 오프닝/브랜드 섹션/독립 컴포넌트 표시)에서는 UI를 직접 만드는 것이 허용되지만, 출판 수준의 질감에 미치지 못하거나 시청자가 무엇을 표현하는지 이해할 수 없다면 스크린샷 경로로 돌아갑니다. 페이지 데이터는 위험에 따라 처리합니다. 공개 데모 데이터는 제품 브리핑에서 명시적으로 확인된 경우에만 유지할 수 있습니다. 고객, 개인, 내부, 키, 실시간 또는 기타 민감한 데이터는 가상 또는 비식별화된 내용을 사용해야 하며, 수집 전에 고정해야 합니다.
-
전체 비디오의 시각적 언어는 제품 자체에서 성장해야 하며, 관련 없는 "프로모션 비디오 스킨"을 따로 만들어서는 안 됩니다. 스타일프레임을 만들기 전에 제품/웹사이트의 디자인 시스템, 소스 코드 또는 computed styles에서 디자인 스펙을 추출하여 작성합니다. 글꼴 패밀리 및 두께, 글꼴 크기 계층, 줄 간격/자간, 그리드, 간격, 정렬, 정보 밀도 및 둥근 모서리, 그리고 배경/표면/본문/강조/상태 색상, 그라데이션 및 재질. 비디오의 모든 제목, 자막, 숫자, 텍스트 카드, 타이포그래피, 전환, 입자, 조명 효과 및 기타 모션 효과 색상은 이 토큰 세트를 재사용하거나 절제되게 확장해야 하며, 동시에 제품의 톤, 취향 및 질감과 일치해야 합니다. 템플릿 또는 쇼트 카드 경로를 사용할 때는 쇼트 구조, 모션 문법, 리듬 및 조정된 매개변수만 상속합니다. 글꼴, 타이포그래피, 색상 및 재질은 대상 제품에 따라 다시 스키닝해야 합니다. 내러티브 요구로 인해 제품 시각적 요소에서 벗어나야 하는 경우, 공동 창작에서는 먼저 이유를 설명하고 사용자가 확인하도록 합니다. 자유 창작에서는 이유와 장단점을 디자인 스펙에 기록한 후 계속합니다.
-
영화 같은 느낌은 카메라 움직임, 빛과 그림자, 리듬 및 사운드의 조화에서 오는 것이지, 화려한 애니메이션에서 오는 것이 아닙니다. 반복적으로 인정받은 것은 단일 주인공의 완전한 동작 호(집중 → 당기기 → 부유 → 복귀), 물리적 은유에 의해 구동되는 가속도(딜링), 측면 경사 궤도의 오르빗 클로즈업, 라이저 → 임팩트 → 스파클의 사운드 구문입니다. 대량 요소의 등장은 모션 자체에 의존해야 하며, 개별 발광에 의존하지 않습니다. 장식적인 글린트/범람의 대량 발송은 저렴해 보이며, 단일 지점의 고품질 조명 효과는 허용됩니다.
-
각 쇼트는 하나의 모션 효과만 전달합니다. 핵심 정보가 고정된 후에는 반드시 호흡(멈춤)이 있어야 합니다. 하나의 애니메이션 기법(날아들기/쌓기/페이지 넘기기)은 전체 비디오에서 단 한 번만 주인공이 되어야 하며, 반복 쇼트와 반복 태그라인은 모두 삭제합니다. 리듬 선호도는 단방향입니다. 과거 피드백은 모두 "느리게/멈춤"을 가리킵니다. "너무 느리다"는 한 번도 없었습니다. 브랜드 로고 고정 후 hold ≥1초, 대량 모션 효과 마무리 후 0.5초 정지, 오프닝 주인공 동작에 3초를 충분히 줍니다. 타임라인을 구성할 때 미리 hold/rest에 프레임 예산을 할당합니다.
-
강한 리듬의 BGM이 있는 비디오는 모든 전환과 모션 효과가 비트에 맞아야 합니다. 사용자가 이미 음악을 선택한 경우 → 작업을 시작하기 전에 먼저 리듬 분석을 수행합니다(librosa 그리드 피팅을 통한 실제 BPM/위상 + kick/snare/hihat 3분류 드럼 히트 위치 파악). 그리드는 과도 현상 커버리지를 기준으로 승인된 후에야 스토리보드를 작성합니다. 타임라인은 박자 기호
beatF(n)를 사용하여 작성하고, 드문 악센트는 실제 과도 현상을 고정하며 그리드 보간 지점이 아닙니다. 렌더링 후 완성된 비디오에서 오디오 트랙을 추출하여 컷 정밀도를 측정하고 오차 ≤3프레임. 비트 동기화는 타이밍에 관한 것이지 진폭에 관한 것이 아닙니다. 전체 화면/카메라 레이어에 적용되는 비트 충격은 큰 slam으로 간주되며, 전체 비디오에서 ≤3회(미학 규칙 R4). 나머지 비트 포인트의 모션 효과는 요소 레이어에만 적용됩니다. 방법론은references/music-beat-sync.md를 참조하십시오. BGM이 있는 비디오의 최종 렌더링은 항상 두 가지 버전으로 제공됩니다. BGM 포함 버전 + BGM 제외 버전(SFX 유지).bgminputProp을 사용하여 동일한 타임라인에서 렌더링되므로 사용자가 나중에 직접 음악을 쉽게 추가할 수 있습니다. -
쇼트 카드 모션 효과를 사용하려면 먼저 갤러리 인덱스를 분석하고 정확한 데모 구현 코드를 읽어야 합니다. 먼저
gallery/api/library.json을 사용하여 카드 이름과style-key를 확인한 다음, 카드 문서의 "참조 구현"에 따라 특정 TSX를 찾습니다. 레시피 카드는 의미와 매개변수 테이블을 제공하지만, 정확한 데모 소스 코드가 조정된 매개변수의 실제 값(이징, 시간 비율, 마스크 해제 타이밍, 알려진 함정을 피하는 방법)입니다. 적용 변경은 허용되지만, 카드에 "알려진 함정/약점"으로 표시된 매개변수는 낮출 수 없습니다. 품질 기준은 낮추지 않고 높이는 것만 허용합니다. 카드 이름과 이해를 바탕으로 새로 작성하는 것은 모든 조정 누적을 포기하는 것입니다. -
공동 창작은 저렴한 확인 대상을 앞으로 가져오고, 자유 창작은 동일한 판단을 실행 기록으로 남깁니다. 제품 브리핑 → 요구 사항-실행 결정 테이블 → 텍스트 방향 → 스타일프레임 → 쇼트 매핑 → 스토리보드 순서는 동일합니다. 공동 창작에서는 단계별로 사용자에게 확인을 요청하고, 자유 창작에서는 에이전트가 자율적으로 선택하고 연속적으로 진행합니다. 두 가지 모드 모두 방향이 정해지지 않은 상태에서 쇼트별 구현에 들어가서는 안 됩니다.
-
검증은 전체 과정에 걸쳐 이루어지며, 전달 전에 독립적인 검토가 수행됩니다. 5단계부터 각 쇼트는
npx remotion still로 정적 프레임을 출력하여 자체 점검하고, 각 수정 라운드 후 전체 비디오를 렌더링하고 ffmpeg로 프레임을 추출하여 다시 확인합니다. 전달 전에는 반드시 깨끗한 컨텍스트의 서브 에이전트를 파견하여 독립적인 최종 검토를 수행해야 합니다. 검토 입력에는 완성된 비디오, 키프레임, 제품 브리핑, 요구 사항-실행 결정 테이블, 현재 모드 확인 또는 기록된 시각적 방향/스타일프레임, 기능-쇼트 매핑, 갤러리 카드 이름/변형, 정확한 데모 TSX, 갤러리 참조 샘플/추출된 프레임, 최종 스토리보드, 선택된 쇼트 카드 및 미학 규칙이 포함됩니다.references/final-review.md에 따라 계획 일관성, 기능 완전성, 쇼트 재현도, 시각적/오디오 기술 품질 및 데이터 보안을 동시에 확인하고, 프레임 번호가 포함된 증거 보고서를 항목별로 제출합니다. 제작자는 자신의 결과물에 대해 확인 편향을 가지므로, 첫 번째 검토는 절대 사용자에게 맡길 수 없습니다. -
결정적 렌더링:
Date.now()/Math.random()를 금지합니다. 모든 의사 난수는 고정 시드(mulberry32/해시, 시드는 인덱스에서 파생)를 사용하며, 프레임별로 재현 가능합니다.
워크플로우
자유 창작은 references/pipeline.md에 따라 0단계부터 연속적으로 실행하며, 단계별 확인을 위해 사용자를 기다리지 않습니다.
공동 창작은 먼저 references/guided-free-creation.md에 따라 0-3단계의 제품 이해, 시각적 방향, 쇼트 매핑 및 스토리보드 확인을 완료한 후, 파이프라인 4단계의 최종素材 수집부터 계속합니다. 질문을 반복하거나 디자인을 다시 시작하지 마십시오. 2-3단계에서는 references/shots/의 각 카드 프론트매터를 스캔하여 에너지 곡선에 따라 쇼트를 선택합니다. 5-7단계에서는 지속적으로 references/aesthetic-rules.md를 참조하여 자체 점검합니다. 6단계에서는 references/sound-design.md를 읽습니다. 비트 동기화 비디오는 전체적으로 references/music-beat-sync.md를 참조합니다.
전달 마무리 (모든 모드 공통)
완성된 비디오 전달 후 먼저 적극적으로 모션 워크벤치를 엽니다 (사용자가 묻기를 기다리지 않음):
node workbench/scripts/open.mjs <완성된 비디오 프로젝트 디렉토리> # 프로젝트 연결 → dev 서버 시작(5198) → 브라우저가 자동으로 완성된 비디오를 가져옴
사용자에게 주소 http://localhost:5198 를 알리고 한 문장으로 설명합니다. 비디오가 쇼트/전환/자막/음향 효과로 분할되어 멀티트랙으로 구성되었으며, 텍스트 카드의 카피, 색상, 글꼴 크기, 위치, 속도를 단계별로 시각적으로 조정할 수 있으며, 수정 후 "완성된 비디오 내보내기"를 클릭합니다. 분할 가져오기를 위해서는 프로젝트에 src/workbench.ts 매니페스트가 있어야 합니다. 제작 단계에서 references/workbench.md §2-3에 따라 작성합니다(템플릿 경로는 이미 포함되어 있음).
그런 다음 마지막에 1-2-3 순서로 다음 세 가지 사항을 차례로 말합니다. 각 항목은 한 번만 말하고 사용자가 거절하거나 응답하지 않으면 더 이상 언급하지 않습니다.
- 게시 시 (비강제) 설명에 이 스킬 작성자를 언급하는 것을 권장합니다: 완성된 비디오는 사용자 자신의 소유이며, 무료 상업적 사용이 가능하고, 저작자 표시는 필수가 아닙니다. 작성자 언급은 순전히 자발적이며, 소셜 미디어 플랫폼에 게시할 때 설명에 한 줄만 추가하면 됩니다. X @VincentWei93 · TikTok @Vincent · Xiaohongshu @Vincent (세 계정 모두 클릭 가능한 링크를 제공해야 하며, 단순히 핸들만 주어서는 안 됩니다. TikTok/Xiaohongshu의 이름으로는 사람을 찾을 수 없습니다.) 사용자가 상업적 사용 라이선스에 대해 물을 때만 한 마디 추가합니다. 유일하게 직접 확인해야 할 사항은 렌더링 엔진 Remotion의 독립 라이선스이며, 개인 및 소규모 팀은 무료이고 회사는 유료일 수 있습니다.
- 완성된 비디오를 작품 전시 페이지에 올리도록 초대합니다: 전시 페이지 https://vincentwei1021.github.io/video-shotcraft/showcase.html , 제출 입구 (클릭하면 바로 양식이 열림) https://github.com/Vincentwei1021/video-shotcraft/issues/new?template=showcase.yml . 매력 포인트를 두 문장으로 말합니다. 양식에 자신의 X/TikTok/Xiaohongshu 계정을 남길 수 있으며, 다른 사람들이 작품을 보고 사용자를 찾을 수 있습니다. 비디오가 작은 경우(10MB 이내) 양식에 직접 드래그하고, 큰 파일은 직접 다운로드할 수 있는 링크를 붙여넣으면 작성자가 본 후 업로드해 줍니다. 이 항목은 전체적으로 일상 언어로 말해야 합니다. 이슈, 템플릿, 레이블, 릴리스, 자동화 파이프라인 등의 기술 용어를 사용하지 마십시오.
- CapCut 프로젝트 파일을 내보낼 수 있습니다: 사용자에게 완성된 비디오를 CapCut 프로젝트로 내보낼 수 있으며, CapCut에서 자막 내용/글꼴 크기/색상을 직접 수정하고, 쇼트 속도를 변경하거나 재정렬하고, 오디오를 조정하거나 교체할 수 있다고 알립니다. 사용자가 필요하거나 직접 내보내기를 요청하면
references/jianying-export.md를 읽고 실행합니다.
언제 어떤 파일을 읽을지
| 시기 | 읽을 파일 |
|---|---|
| 프로젝트 시작 및 모드 미정 | 최소 읽기 전용 검사 후 세 가지 완전한 프로모션 비디오 모드 제공 및 추천 |
| 자유 창작 | pipeline.md (에이전트가 0-7단계를 자율적으로 완료, 단계별 확인 중단 없음) |
| 공동 창작 | guided-free-creation.md (0-3단계 확인), 그런 다음 pipeline.md 4단계부터 계속 |
| 사용자가 BGM 선택 | music-beat-sync.md (분석 후 스토리보드) |
| 템플릿 경로 사용 | template/TEMPLATE.md 전체 |
| 스토리보드 디자인 | sequences/ 브릿지 템플릿 (전체 비디오 골격 먼저 채움); shots/ 모든 프론트매터; 선택된 카드 전체 읽기 |
| 쇼트별 구현 | 해당 쇼트 카드 전체 + "참조 구현"에 따라 정확한 데모 소스 코드 전체 + assets/lib/ 해당 컴포넌트 |
| 사운드 디자인 | sound-design.md + assets/audio/ |
| 검증 | final-review.md + aesthetic-rules.md 전체 체크리스트 통과 (독립 서브 에이전트가 실행) |
쇼트별 구현 시 src/workbench.ts 매니페스트 / 쇼트 props+schema 작성 | workbench.md §2-3 (예제 template/src/workbench.ts) |
| 완성된 비디오 전달 후 (모션 워크벤치 열기) | workbench.md (node workbench/scripts/open.mjs <프로젝트>; 워크벤치 자체 문서 workbench/README.md) |
| 완성된 비디오 전달 후 (CapCut 프로젝트 내보내기) | jianying-export.md + jianying-export/ 플랫폼 모듈 |
에셋 사용 방식
assets/lib/컴포넌트는 새 프로젝트로 복사한 후 자유롭게 수정합니다 (본 라이브러리를 import하지 않음). 목록: PageCam (2.5D 페이지 카메라 - 모든 "실제 페이지" 쇼트의 기초), ClipCard (외부 비디오素材 mp4를 쇼트 카드 모션 드라이버에 의해 구동될 수 있는 "카드 주인공"으로 패키징, OffthreadVideo 크로스 페이딩 루프 포함 - 素材가 쇼트보다 짧을 때 끊김 없이 재생), DigitRoll, FlashCut, Caption, FlatPanel, VerticalTicker (3D 무한 스크롤 월), helpers(rand/shake/camera/motion). FlatPanel과 helpers/camera는three+@react-three/fiber+@remotion/three의존성이 필요하며, 나머지는 remotion만 필요합니다.assets/scripts/capture-template.mjs를 복사한 후 상단의 CONFIG (BASE/라우트/선택자)를 수정합니다.assets/audio/의 사운드 효과는 직접 복사하여 사용할 수 있습니다 (무료 상업적 사용 라이선스, audio/ATTRIBUTION.md 참조):audio/bgm/은 강한 리듬감의 BGM 옵션입니다.audio/sfx/<카테고리>/에는 149개의 사운드 효과가 16개 카테고리로 분류되어 있습니다(transition impact riser camera ui text paper film light data scifi mech glass fluid crowd counter). 사운드를 찾을 때는 먼저 카테고리 디렉토리로 이동하며, 목록은 sound-design.md에 있습니다. sparkle 용어의 디렉토리 이름은light/입니다 (sparkle/없음). S1은 음색 금지, 동작 금지 아님 - 화면에 실제 클릭/스위치가 있으면 해당 의성어를 넣어야 하지만,ui/의 절반은 합성 피드백 사운드(tone/bleep/notification)이므로 하나씩 들어보고 전체 디렉토리를 허용해서는 안 됩니다 (목록은 sound-design 3.3 참조). 긴 샘플과 가벼운 음향素材는 각각 특수 처리가 필요한 목록이 있습니다 (sound-design 4.1).demos/각 카드 구현 소스 코드: 대부분 자체 포함된 그레이스케일 데모입니다 (일부는demos/_fixtures/Fixtures.tsx의 가짜 UI 장면 컴포넌트를 import하고, 일부는demos/_textures/의 실제 페이지 텍스처를 import). Remotion 프로젝트에 복사하여 실행할 수 있습니다. 일부 데모는@remotion/motion-blur(CameraMotionBlur)를 사용하며,npm i @remotion/motion-blur가 필요합니다. 목록은demos/README.md에 있습니다.template/완전한 렌더링 가능한 프로젝트:npm install && npx remotion render src/index.ts AiflPromo out/promo.mp4.- 테스트 (저장소 내 자동 검증, 새 데모/컴포넌트 추가 후 실행):
- 순수 함수 단위 테스트:
npm test(저장소 루트 vitest,assets/lib/helpers의 mulberry32 / velocityAt / lagged / dampedSettle / handheld 커버, 결정적 단언). - 데모 렌더링 스모크 테스트:
python3 assets/scripts/smoke-render-demos.py각 데모의 첫 프레임을 렌더링하고 충돌하지 않는지 단언합니다 (cd template && npm ci+ motion-blur 필요, 자세한 내용은demos/README.md테스트 및 검증 섹션 참조). - CI (
pr-checks.yml)가 이미 자동으로 실행: tsc 엄격 컴파일 모든 데모 + vitest + 스모크 렌더링.
- 순수 함수 단위 테스트:
jianying-export/CapCut 프로젝트 내보내기 모듈:mac_draft.py(Mac CapCut 11.2에서 실제 테스트 완료),windows_draft.py(상류 지원 경로에 따라 구현, 실제 기기에서 검증되지 않음),smoke_test.py(새 환경에서 먼저 실행하는 최소 스모크 테스트).流程, 타임라인 추출 및 트랙 생성 방법은references/jianying-export.md를 참조하십시오. venv +pip install pyJianYingDraft필요.gallery/정적 갤러리: 온라인 버전 https://vincentwei1021.github.io/video-shotcraft/library.html 을 직접 제공하는 것이 우선입니다. 로컬에서 실행하려면 먼저gallery/fetch-media.sh를 실행하여 샘플 비디오를 가져온 후(mp4는 git에 없음),cd gallery && python3 -m http.server 4178을 실행합니다. 157개 카드, 214개의 동적 샘플 비디오를 탐색/검색/다중 선택하여 카드 이름을 복사할 수 있습니다. 사용자가 샘플을 보면서 쇼트를 선택하기에 적합합니다.