視差登陸頁面
將一段短影片轉換為單螢幕的電影感登陸頁面,使用者滾動時會逐格播放影片,同時五段戲劇性的文字場景會淡入淡出。文件本身不會實際滾動——滑鼠滾輪、觸控或鍵盤輸入會透過 JavaScript 攔截,並轉換為虛擬的影格進度。
此技能編碼了本儲存庫中 ../../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) - 最終場景就是行動呼籲區塊——之後沒有單獨的
.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 檔案的位置。
- 代號 (Slug) — 簡短的資料夾/檔案名稱(例如
hope、marcus、desk)。一個單字,小寫,無空格。這會同時成為影格資料夾名稱(<slug>/)和 HTML 檔案名稱(<slug>.html)。 - 主題 / 話題 — 這個登陸頁面是關於什麼的?產品發布?個人時刻?野生動物邂逅?你需要這些資訊來撰寫文案。
- 專案模式 — 獨立(全新資料夾)或整合到現有的 parasites 展示館(位於此儲存庫頂層的
examples/parasites/)。如果使用者說「加到展示館」,他們指的是下方的模式 B。 - 強調色 — 用於腳本/行動呼籲反白:
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。請擷取它——你的 HTML 需要 frame_count 和 suggested_scroll_budget。
為什麼用 -q:v 2:ezgif 和類似工具會進行積極的重新壓縮(約 55 KB/影格)。原生 ffmpeg 搭配 q:v 2 在相同尺寸下可達到約 120–220 KB/影格——視覺上更銳利。不要縮小解析度;絕對不要放大(它會增加檔案大小而不增加細節)。
為什麼用捲動預算公式(約 26 px/影格):保持「每次影格前進所需的滾動像素數」在不同片段長度下一致。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 中新增卡片,在每個現有登陸頁面的導覽列中新增連結,並在前一個登陸頁面的最終場景中新增連鎖行動呼籲。
告知使用者如何檢視:
從父資料夾透過
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區段。最終場景包含行動呼籲。整個頁面是一個鎖定的視窗。 - Anton + Caveat + Inter——大寫 Anton 用於所有粗體文字,Caveat 用於手寫強調(金/琥珀/奶油色),Inter 用於任何主體引導文字。絕不替換,也絕不新增第四種字型。
- 近白色
#f5f1ea,絕不使用#fff——已存在於 CSS 中作為var(--text)。 - 影格命名為
frame-NNN.jpg,補零至總影格數的位數(由於片段通常少於 1000 個影格,3 位數是標準;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 新增到現有的 parasites 資料夾。
- 代號 =
hope。提取 →hope/frame-NNN.jpg。(重複使用現有的 style.css + parallax.js。) - 從範本撰寫
hope.html。 - 執行展示館整合:在
index.html中新增第三張卡片,在github.html和lion.html的導覽列中附加一個Hope連結,將前一個登陸頁面的最終場景連結到Next: Hope →行動呼籲。 - 如果引入新的強調色,請將其新增到
:root,並在style.css中新增.script.X+.cta.X規則。