視差著陸頁
將一段短影片變成一個單畫面電影級著陸頁,使用者的捲動手勢會逐幀撥放影片,同時五個戲劇性文字場景會淡入淡出。文件本身實際上不會捲動——滑鼠滾輪、觸控、鍵盤輸入都會在 JS 中被攔截,並轉換為虛擬幀進度。
此技能編碼了捆綁參考資料(位於 ../../examples/parasites/)中驗證過的樣式(github / lion / hope 著陸頁——三個使用此技能構建的工作頁面)。如果這裡有任何歧義,請以該資料夾為最終依據。
此技能在 YUV.AI 層級中的位置
parallax-landing-page 位於 YUV.AI 技能金字塔的中間層,與 yuv-design-system、yuv-decks、yuv-viral-video 和 video-to-landing-page 並列。頂層協調器 yuv-pilot 會在需要將 5–15 秒的影片剪輯變成單一英雄式捲動撥放著陸頁時,將任務路由到此處。
此技能使用自己的視覺語言(Anton + Caveat + Inter,金色/琥珀色/強調色/奶油色調色板)——它不會呼叫 yuv-design-system。這兩個系統共存:yuv-design-system 負責跨網頁/應用程式/簡報表面的品牌調色板,而 parallax-landing-page 專門負責電影級捲動撥放美學。對於 YUV.AI 視差著陸頁,你可以選擇性地在頁尾區域添加一個鳳凰浮水印和標準的 Linktree URL,作為品牌貫穿線——請參閱 yuv-design-system/assets/ 以取得浮水印檔案。請勿將 Anton/Caveat 字體堆疊替換為設計系統的霓虹調色板——這會失去標誌性的外觀。
你要構建的內容
每個著陸頁都是一個鎖定的視口,包含:
- 一個填滿整個螢幕的畫布,一次繪製一幀(cover-fit,DPR ≤ 2)
- 5 個絕對定位的文字場景(前引 + 大寫 Anton 標題 + Caveat 手寫體行),每個都有各自的捲動進度窗口
- 一個固定導航欄,帶有
PARALLAX // showcase標誌和指向同級著陸頁的連結 - 一個載入器,在使用者互動前預載每一幀
- 一個暗角 + 底片顆粒疊層
- 一個底部捲動提示,使用者開始捲動後淡出
- 一個右下角幀計數器(例如
073 / 145) - 最終場景就是 CTA 區塊——下方沒有單獨的
.end區塊
在 q:v 2 時總大小:大約每幀 120–220 KB × 幀數。一個 6 秒 24fps 的剪輯 = 145 幀 ≈ 25 MB。一個 10 秒的剪輯 = 241 幀 ≈ 53 MB。
儲存位置
預設: ~/Documents/yuv-projects/landings/<slug>/——始終將獨立著陸頁儲存在此處,以便之後再次找到它們。只有在使用者明確選擇不同位置,或者選擇模式 B(整合到現有的 examples/parasites/ 展示)時才覆蓋。
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 技能在提取幀和構建 HTML 時會在此處建立 <slug>/。
最終路徑(模式 A——獨立):~/Documents/yuv-projects/landings/<slug>/。
最終路徑(模式 B——整合):使用者選擇的現有展示目錄。
在每次建置結束時告知使用者最終路徑。
工作流程
共有四個階段。請勿跳過任何階段——每個階段都為下一個階段提供輸入。
階段 1——發現
與使用者確認:
- 影片路徑——來源 MP4 檔案的位置。
- 代號——簡短的資料夾/檔案名稱(例如
hope、marcus、desk)。單詞,小寫,無空格。這將成為幀資料夾名稱(<slug>/)和 HTML 檔案名稱(<slug>.html)。 - 主題/話題——這個著陸頁是關於什麼的?產品發佈?個人時刻?野生動物遭遇?你需要這些資訊來撰寫文案。
- 專案模式——獨立(全新的資料夾)或整合到位於
examples/parasites/的現有寄生蟲展示中(此儲存庫的頂層)。如果使用者說「將其加入展示」,則表示模式 B。 - 強調色——用於腳本/CTA 高亮:
gold(#f5b042),amber(#ff8a3d),accent(粉紅色 #ff4d6d),cream(#f5e9d4),或新的顏色(將其添加到 style.css 中的:root,並撰寫新的.script.<name>規則)。
如果使用者尚未指定其中一些項目,請提出預設值並繼續——不要在他們看到結果後才能回答的問題上耽擱。
階段 2——提取幀
執行捆綁的提取腳本。它會用 ffprobe 探測影片,並以原生解析度、-q:v 2(近乎無損的 JPEG)提取每一幀,命名為 frame-001.jpg 到 frame-NNN.jpg(3 位數零填充)。
python <skill>/scripts/extract_frames.py <video_path> <output_folder>
範例:
python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
C:/Users/User/Documents/parasites/hope/hope.mp4 \
C:/Users/User/Documents/parasites/hope
腳本會將 JSON 中繼資料區塊輸出到 stdout。擷取它——你需要 frame_count 和 suggested_scroll_budget 來產生 HTML。
為什麼用 -q:v 2:ezgif 和類似工具會積極地重新壓縮(約 55 KB/幀)。原生 ffmpeg 在 q:v 2 時,在相同尺寸下約為 120–220 KB/幀——視覺上更清晰。請勿縮小;永遠不要放大(這會無端增加檔案大小而不增加細節)。
為什麼用滾動預算公式(每幀約 26 像素):讓「每前進一幀所需的滾動像素數」在不同剪輯長度下保持不變。145 幀 → 約 4200,241 幀 → 約 6300,90 幀 → 約 2500(下限)。腳本會為你計算並限制在 [2500, 8000] 範圍內。
階段 3——撰寫頁面
閱讀 <skill>/assets/landing-page-template.html 中的範本。它是一個完整的可運作檔案,帶有 {{PLACEHOLDER}} 標記和創意部分旁邊的 <!-- TODO: --> 註解。在 <target>/<slug>.html 中建立一個新檔案,並替換所有內容。
替換檢查清單(必須替換每個佔位符):
| 佔位符 | 要填入的內容 | 範例 |
|---|---|---|
{{PAGE_TITLE}} | HTML <title> | Hope — The Fastest Heart in the Negev |
{{PAGE_DESCRIPTION}} | meta 描述,一句話 | A moment with Hope, the cheetah of Midbarium. |
{{SLUG}} | 資料夾名稱(無路徑,無斜線) | hope |
{{FRAME_COUNT}} | 整數幀數 | 241 |
{{FRAME_COUNTER_TEXT}} | 001 / NNN 並具有匹配的寬度 | 001 / 241 |
{{SCROLL_BUDGET}} | 來自提取器 JSON 的整數 | 6300 |
{{PREVIEW_FRAME_MID}} | 零填充的中間幀 | 121 |
{{PREVIEW_FRAME_END}} | 零填充的最後一幀 | 241 |
{{LOADER_TITLE}} | 一個單詞,大寫 | HOPE |
{{LOADER_SCRIPT}} | 手寫體行,以 … 結尾 | summoning the runner… |
{{NAV_LINKS_HTML}} | 導航欄的完整 <a> 標籤區塊 | 見下文 |
{{SCENE_N_*}} | 5 個場景各自的前引、標題、手寫體行 | 見文案指南 |
{{SCROLL_HINT_TEXT}} | 2–4 個單詞的大寫提示 | SCROLL TO RUN |
{{CTA_BUTTONS_HTML}} | 2–4 個 <a class="cta"> 標籤 | 見下文 |
{{ACCENT_CLASS}} | .script.X 和 .cta.X 的強調色後綴 | amber |
閱讀 references/copy-guide.md 以了解電影風格的文案模式(前引措辭、標題長度、手寫體行語氣)。文案是此技能的價值所在——通用文案會毀掉一個原本漂亮的動畫。
階段 4——連接資源
如果目標資料夾已經有 style.css 和 parallax.js(展示整合),則無須操作——它們是共用的。否則,從 <skill>/assets/ 將兩者複製到目標資料夾:
cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js
如果整合到現有展示中,還需要執行 references/showcase-integration.md 中的步驟——將卡片添加到 index.html,將連結添加到每個現有著陸頁的導航欄,並在前一個著陸頁的最終場景中添加連結 CTA。
告訴使用者如何檢視:
從父資料夾透過
python -m http.server 8000開啟<target>/<slug>.html(不要用file://——Chromium 可能會因為本地圖片來源而污染畫布)。
檔案約定
<target>/
├── <slug>/ # 幀資料夾
│ ├── <slug>.mp4 # 來源(保留)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # 著陸頁
├── style.css # 共用(如果是獨立則複製)
├── parallax.js # 共用(如果是獨立則複製)
└── index.html # 中樞(僅當獨立或整合時)
幀資料夾名稱和 HTML 檔案名稱必須使用相同的代號——頁面 new ParallaxPage({folder: '<slug>', ...}) 呼叫中的 folder 選項就是文字上的資料夾路徑。
ParallaxPage API(已在 parallax.js 中,請勿重新定義)
new ParallaxPage({
folder: '<slug>', // 包含 frame-001.jpg 等的資料夾
frameCount: 145, // 整數
prefix: 'frame-', // 此技能始終為 'frame-'
scrollBudget: 4200, // 完整通過所需的累積輸入像素
// 可選:padWidth(預設 3),ext(預設 'jpg')
})
該類別會自動附加 body.scrub-page(透過 CSS 鎖定捲動),預載所有幀,執行一個基於 RAF 的 lerp(0.22 係數)朝向由捲動得出的目標幀,並淡入淡出 data-start/data-end 範圍包含目前進度的場景。
硬性限制(不容妥協)
這些限制已融入參考實作中,違反會破壞體驗:
- 5 個場景,固定進度窗口:
0.00–0.20、0.22–0.40、0.42–0.60、0.62–0.80、0.82–1.00。場景之間的 0.02 間隙是故意的——這是節拍之間「只有圖像,沒有文字」的時刻。英雄場景(場景 1)和最終場景(場景 5)分別使用data-fade="0.30"和data-fade="0.18",以便在邊緣停留更長時間;中間場景使用預設的 0.25。 - 撥放區域下方沒有
.end區塊。最終場景包含 CTA。整個頁面是一個鎖定的視口。 - Anton + Caveat + Inter——大寫 Anton 用於所有粗體文字,Caveat 用於手寫體強調(金色/琥珀色/奶油色),Inter 用於任何主體引導文字。切勿替換,切勿添加第四種字體。
- 米白色
#f5f1ea,永遠不是#fff——已在 CSS 中作為var(--text)。 - 幀名稱是
frame-NNN.jpg,零填充至總數的位數(3 位數是標準,因為剪輯 < 1000 幀;JS 會根據總數自動計算計數器寬度)。 - 代號既是資料夾名稱,也是 HTML 檔案的基本名稱——
hope/、hope.html。無例外;整合步驟依賴此約定。
卡住時去哪裡查閱
- 此儲存庫中捆綁的參考展示:
examples/parasites/——github.html、lion.html、hope.html、style.css、parallax.js、index.html。如果你的輸出與這些在視覺上有明顯差異,表示你已偏離;請重新閱讀。 references/copy-guide.md——如何撰寫 5 個場景才能真正具有電影感。references/showcase-integration.md——添加到現有中樞時所需的確切編輯。assets/landing-page-template.html——帶有佔位符的標準結構。assets/hub-template.html——僅在從頭開始建立全新的展示時使用(3 張卡片)。
兩個真實的範例呼叫
獨立: 使用者有一段剪輯 desk.mp4,並想要一個著陸頁。
- 詢問代號和主題。對
desk.mp4執行提取器 →./desk/frame-NNN.jpg。 - 將
style.css+parallax.js複製到專案根目錄。 - 從範本撰寫
desk.html。導航欄只有一個連結:自己。 - 完成。告知使用者使用
python -m http.server提供服務。
展示新增: 使用者將 hope.mp4 新增到現有的寄生蟲資料夾。
- 代號 =
hope。提取 →hope/frame-NNN.jpg。(重複使用現有的 style.css + parallax.js。) - 從範本撰寫
hope.html。 - 執行展示整合:將第三張卡片新增到
index.html,將Hope連結附加到github.html和lion.html的導航欄,將前一個著陸頁的最終場景連結為Next: Hope →CTA。 - 如果引入新的強調色,請將其新增到
:root中,並在style.css中新增.script.X+.cta.X規則。