one-prompt-reel
這部影片所宣稱的:「無論你在哪裡輸入,它都運作相同。」證明來自於重複。一個字串,四個看似無關的表面,然後是一連串它所產出的結果,最後再次顯示這個字串。
輸入
| 輸入項目 | 必填 | 說明 |
|---|---|---|
prompt | 是 | 確切的指令或句子。約 50 字元以內效果最佳;它會被輸入四次,再加上結尾一次。 |
reel 圖片 | 是 | 16-24 個實際輸出:螢幕截圖、產品畫面、從先前渲染中擷取的靜態圖。僅限您自己的素材。 |
| 品牌名稱、標語、網址 | 是 | 用於結尾卡片。 |
| 標誌 | 否 | 方形 PNG 含透明度。省略則結尾僅顯示文字。 |
| 音樂 | 否 | 您擁有商業授權的曲目。如果不確定授權,請保持無聲。 |
工作流程
- 建立專案架構。 建立一個專案資料夾,將
template/複製進去(包含index.html和assets/gsap.min.js),並將 reel 圖片放入assets/reel/。然後執行:npx --yes hyperframes check - 填入 CONFIG 區塊,位於
index.html的<script>頂部。所有專案相關設定都在那裡:prompt、bpm、reel檔案清單、brand、tagline、url、logo。除非下方規則強制要求,否則請勿重新調整其他結構。 - 選擇剪輯網格。
- 無音樂: 保留
cuts: null。剪輯來自bpm和reelPattern(預設:8 個一拍剪輯,接著 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,將落在 reel 開始時間之後的節拍時間(以秒為單位)複製到CONFIG.cuts中(多一個條目標記最後一個剪輯的結束,也就是結尾開始的時間)。將bpm設為曲目的節奏,以便打字區段也能對齊。如果節拍密度超過 0.2 秒,則每隔一個取一個。在最後一秒淡出音樂(/hyperframes-audio)。
- 無音樂: 保留
- 渲染前檢查。
npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23並開啟 PNG 檔案。檢查每個表面打字中、一個 reel 剪輯以及結尾。 - 渲染。
npx --yes hyperframes render --workers 2 -o final.mp4。 - 從 MP4 中提取 4-6 幀(使用 ffmpeg,每個表面一幀、一個 reel 剪輯、結尾)並檢查。如果有任何部分被裁切、無法閱讀或空白,修正後重新渲染。
影片結構(預設值 24 秒)
| 時間 | 節拍 |
|---|---|
| 0-10 秒 | 四個表面,每個 2.5 秒。從右側滑入,打字約 1.5 秒,按下 ENTER,向左滑出。一個小標籤標示表面名稱及其位置(1/4)。 |
| 10-18 秒 | 硬切並伴隨白色閃光。24 張全出血輸出圖片,每張帶有緩慢推入效果。指令以膠囊按鈕形式位於左下方整個 reel 期間;計數器位於右下方。 |
| 18-24 秒 | 黑暗結尾:標誌、名稱、標語,指令在帶有餘燼邊緣的膠囊按鈕中再次輸入,網址,單次發光脈衝。 |
讓它有效的規則
- 四個表面必須在輪廓上有所不同,而不僅僅是顏色。 寬而低、高而窄、浮動在漸層上、帶有側邊樹的深色。如果你瞇著眼會混淆其中兩個,重新繪製一個。用純 HTML 和 CSS 構建;切勿模仿任何真實產品的介面、標誌或色板。
- 相同字串,相同打字速度。 每個表面在相同時間內輸入相同的
prompt。這種一致性是重點。 - 使用時間軸補間(tween)來打字,而不是計時器。一個基於
{n}計數器的補間(其onUpdate會擷取字串)是 seek 安全的;setInterval則不是。 - 使用
tl.set以半拍循環閃爍游標,絕對不要用 CSS 動畫或repeat: -1。 - 對齊網格進行剪輯。 每個表面邊界、剪輯和結尾的進入點都必須落在節拍上,無論網格是音樂性的還是單純的節奏。脫離網格的剪輯是第一個讓人感覺草率的問題。
- 加速一次。 先慢速剪輯,然後半長度剪輯。不要重複加速。
- Reel 圖片是證據。 實際輸出,而非裝飾。偏好 1920x1080 的靜態圖;使用
object-fit: cover縮放不常見的尺寸。交替深色和淺色相鄰圖片,使每個剪輯都能被感知。 - 沒有第三方媒體。 沒有標誌、其他產品的 UI 螢幕截圖、庫存素材或您無法隨附的字型。字型:明確指定一個字體家族(等寬字型使用
"JetBrains Mono",CLI 會自動解析);通用ui-monospace堆疊在測試中會按比例渲染。 - 保持標題可讀。 檢查對比度;
hyperframes check會對文字強制執行 WCAG AA 標準,因此標籤在奶油色舞台背景上需要使用中暗色調的墨水。 - 無聲是可以接受的。 不要添加未知授權的音樂;具有非商業條款的 AI 生成曲目不可使用。
- 保持閃光補間的
immediateRender: false,否則佈局審核會在 t=0 時看到白色疊加層。
驗證
npx --yes hyperframes check必須以「Check passed」結束(語法檢查、佈局、對比度)。- 快照幀應顯示所有四個表面在退出前完全輸入完成,沒有標籤重疊表面,沒有空白或半載入的 reel 圖片。
ffprobe應回報為 1920x1080、h264、時長在 20-30 秒範圍內。
交付
將 final.mp4 放在專案(index.html、assets/)旁邊。如果儲存庫慣例要求簡短備註,請列出:提示詞、節奏或節拍來源、reel 圖片來源、音樂授權(或「無聲」)以及渲染指令。提及 Studio(npx hyperframes preview)可以重新調整任何時序。
詳見 references/surfaces.md 以了解四個表面規格,以及 references/grid.md 以了解時序計算。