one-prompt-reel
이 필름이 전하는 메시지: "어디에 입력하든 동일하게 작동합니다." 증명은 반복입니다. 하나의 문자열, 서로 다른 네 개의 표면, 그리고 그 결과물의 연속, 마지막으로 다시 한 번 문자열을 보여줍니다.
입력
| 입력 | 필수 | 참고 |
|---|---|---|
prompt | 예 | 정확한 명령어 또는 문장. 약 50자 이내가 가장 잘 읽힙니다. 네 번 입력되고 마지막에 한 번 더 표시됩니다. |
reel 이미지 | 예 | 16-24개의 실제 출력물: 스크린샷, 제품 화면, 이전 렌더링에서 추출한 스틸 이미지. 사용자의 자체 자료만 사용 가능합니다. |
| 브랜드 이름, 태그라인, URL | 예 | 클로징 카드에 사용됩니다. |
| 로고 | 아니오 | 알파 채널이 있는 정사각형 PNG. 생략하면 텍스트 전용 클로징이 생성됩니다. |
| 음악 | 아니오 | 상업적으로 사용할 수 있는 라이선스가 있는 트랙. 라이선스가 확실하지 않으면 음악 없이 제작합니다. |
워크플로우
- 스캐폴드. 프로젝트 폴더를 만들고
template/(index.html및assets/gsap.min.js)을 복사한 다음 리일 이미지를assets/reel/에 넣습니다. 그런 다음:npx --yes hyperframes check index.html의<script>상단에 있는 CONFIG 블록을 채웁니다. 모든 프로젝트별 설정이 여기에 있습니다:prompt,bpm,reel파일 목록,brand,tagline,url,logo. 아래 규칙에서 강제로 요구하지 않는 한 나머지 구조는 변경하지 마십시오.- 컷 그리드를 선택합니다.
- 음악 없음:
cuts: null을 유지합니다. 컷은bpm과reelPattern에서 생성됩니다 (기본값: 1비트 컷 8개, 그 다음 0.5비트 컷 16개, 120 BPM에서 = 4초 + 4초). 표면은 각각surfaceBeats비트 동안 지속되므로 전체 필름이 그리드를 유지합니다. - 음악 있음: 트랙을
<audio id="music" data-timeline-role="music" src="assets/music.mp3" data-start="0" data-duration="24" data-track-index="5">로 추가하고,npx hyperframes beats를 실행하고,beats/assets/music.mp3.json을 열고, 리일 시작 시간 이후에 해당하는 비트 시간(초)을CONFIG.cuts에 복사합니다 (마지막 컷의 끝을 표시하는 추가 항목 하나, 즉 클로징이 시작되는 시점).bpm을 트랙의 템포로 설정하여 타이핑 섹션도 일치시킵니다. 비트 간격이 0.2초보다 좁으면 두 번째 비트마다 사용합니다. 마지막 1초 동안 음악을 페이드 아웃합니다 (/hyperframes-audio).
- 음악 없음:
- 렌더링 전에 확인합니다.
npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23을 실행하고 PNG를 엽니다. 각 표면의 타이핑 중간, 리일 컷 한 개, 클로징을 확인합니다. - 렌더링합니다.
npx --yes hyperframes render --workers 2 -o final.mp4. - MP4에서 4-6프레임을 추출하여 (표면당 하나, 리일 컷 하나, 클로징 하나) 확인합니다. 잘리거나, 읽을 수 없거나, 빈 프레임이 있으면 수정하고 다시 렌더링합니다.
필름 구조 (기본값 24초)
| 시간 | 비트 |
|---|---|
| 0-10 초 | 네 개의 표면, 각 2.5초. 오른쪽에서 슬라이드 인, 약 1.5초 동안 타이핑, ENTER 누름, 왼쪽으로 슬라이드 아웃. 작은 레이블이 표면 이름과 위치(1/4)를 표시합니다. |
| 10-18 초 | 흰색 플래시와 함께 하드 컷. 24개의 전체 화면 출력 이미지, 각각 느린 푸시인 효과. 명령어는 리일 전체 동안 왼쪽 하단의 필(pill) 안에 위치하고, 오른쪽 하단에 카운터가 있습니다. |
| 18-24 초 | 어두운 클로징: 로고, 이름, 태그라인, 명령어가 테두리가 있는 필 안에 한 번 더 입력되고, URL, 한 번의 글로우 펄스. |
성공을 위한 규칙
- 네 개의 표면은 색상뿐만 아니라 실루엣이 달라야 합니다. 넓고 낮음, 높고 좁음, 그라데이션 위에 떠 있음, 측면 트리가 있는 어두운 배경. 두 표면을 구분하기 어렵다면 하나를 다시 디자인하십시오. 순수 HTML과 CSS로만 제작하고, 실제 제품의 크롬, 로고 또는 색상 팔레트를 절대 모방하지 마십시오.
- 동일한 문자열, 동일한 타이핑 속도. 모든 표면이 동일한 시간 동안 동일한
prompt를 입력합니다. 이 동일성이 핵심입니다. - 타이머 대신 타임라인 트윈(tween)을 사용하여 입력합니다.
{n}카운터에 대한 트윈으로,onUpdate가 문자열을 슬라이싱하는 방식은 seek에 안전합니다.setInterval은 그렇지 않습니다. tl.set을 사용하여 하프 비트 루프로 커서를 깜박입니다. CSS 애니메이션이나repeat: -1을 사용하지 마십시오.- 그리드에 맞춰 컷합니다. 모든 표면 경계, 컷 및 클로징 진입은 음악 그리드든 일반 템포든 비트에 맞춰 떨어집니다. 그리드에서 벗어난 편집은 가장 먼저 조잡하게 보입니다.
- 한 번만 속도를 높입니다. 처음에는 느린 컷, 그 다음에는 절반 길이의 컷. 반복적으로 가속하지 마십시오.
- 리일 이미지는 증거입니다. 장식이 아닌 실제 출력물입니다. 1920x1080 스틸 이미지를 선호하며, 크기가 다른 경우
object-fit: cover로 조정합니다. 어두운 이미지와 밝은 이미지를 번갈아 배치하여 각 컷이 구분되도록 합니다. - 타사 미디어를 사용하지 마십시오. 다른 제품의 로고, UI 스크린샷, 스톡 푸티지 또는 배포할 수 없는 글꼴은 사용할 수 없습니다. 글꼴: 하나의 패밀리를 명시적으로 지정합니다 (고정폭에는 CLI가 자체적으로 해결하는
"JetBrains Mono"사용). 테스트에서 범용ui-monospace스택은 비례적으로 렌더링되었습니다. - 캡션을 읽기 쉽게 유지합니다. 대비를 확인하십시오.
hyperframes check는 텍스트에 WCAG AA를 적용하므로 크림색 배경에 중간 정도의 어두운 잉크가 필요합니다. - 무음은 허용됩니다. 라이선스가 불분명한 음악을 추가하지 마십시오. 비상업적 조건의 AI 생성 트랙은 허용되지 않습니다.
- 플래시 트윈은
immediateRender: false로 유지하십시오. 그렇지 않으면 레이아웃 감사에서 t=0에 흰색 오버레이가 있는 것으로 간주합니다.
검증
npx --yes hyperframes check는 "Check passed"로 끝나야 합니다 (린트, 레이아웃, 대비).- 스냅샷 프레임에는 네 개의 표면이 모두 나가기 전에 완전히 입력된 상태, 표면과 겹치는 레이블이 없음, 빈 리일 이미지 또는 절반만 로드된 리일 이미지가 없음이 표시되어야 합니다.
ffprobe는 1920x1080, h264, 길이가 20-30초 범위 내에 있음을 보고해야 합니다.
전달
final.mp4를 프로젝트 (index.html, assets/) 옆에 둡니다. 저장소 규칙에 따라 짧은 노트를 요청하는 경우 다음을 나열하십시오: 프롬프트, 템포 또는 비트 소스, 리일 이미지 소스, 음악 라이선스 (또는 "무음"), 렌더링 명령어. Studio (npx hyperframes preview)를 사용하여 타이밍을 다시 조정할 수 있음을 언급하십시오.
네 가지 표면 사양은 references/surfaces.md를, 타이밍 계산은 references/grid.md를 참조하십시오.