视差着陆页
将一段短视频转化为单屏电影式着陆页,用户通过滚动手势逐帧浏览视频,同时5段戏剧性文字场景淡入淡出。文档本身不会实际滚动——所有滚轮/触摸/键盘输入在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视差着陆页,你可以选择性地在页脚区域添加Phoenix水印和规范Linktree URL作为品牌贯穿线——水印文件见 yuv-design-system/assets/。不要将Anton/Caveat字体栈替换为设计系统的Neon调色板——这会丢失标志性外观。
你将要构建的内容
每个着陆页都是一个锁定视口,包含:
- 一个全屏画布,每次绘制一帧(cover-fit,DPR ≤ 2)
- 5个绝对定位的文字场景(kicker + 大写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
# 技能在此创建 <slug>/ 文件夹,并在其中提取帧和构建HTML
最终路径(模式A —— 独立):~/Documents/yuv-projects/landings/<slug>/。
最终路径(模式B —— 整合):用户选择的现有展示目录。
每次构建完成后告诉用户最终路径。
工作流程
共有四个阶段。不要跳过任何阶段——每个阶段都是下一阶段的输入。
阶段1 —— 发现
向用户确认:
- 视频路径 —— 源MP4文件位置。
- Slug —— 简短的文件夹/文件名(例如
hope、marcus、desk)。单个单词,小写,无空格。它既是帧文件夹名称(<slug>/),也是HTML文件名(<slug>.html)。 - 主题/话题 —— 这个着陆页是关于什么的?产品发布?个人时刻?野生动物邂逅?你需要这些信息来撰写文案。
- 项目模式 —— 独立(全新文件夹)还是整合到
examples/parasites/(此仓库顶层)的现有展示画廊中。如果用户说“把它添加到展示画廊”,他们指的是模式B。 - 强调色 —— 用于脚本/CTA高亮:
gold(#f5b042)、amber(#ff8a3d)、accent(粉色 #ff4d6d)、cream(#f5e9d4),或者其他新颜色(将其添加到:root的style.css中,并编写新的.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
脚本向stdout输出一个JSON元数据块。捕获它——你需要 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 — 内盖夫最快的猎手 |
{{PAGE_DESCRIPTION}} | meta描述,一句话 | 与Midbarium的猎豹Hope共度的时刻。 |
{{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}} | 以 … 结尾的手写行 | 召唤奔跑者… |
{{NAV_LINKS_HTML}} | 导航的完整 <a> 标签块 | 见下文 |
{{SCENE_N_*}} | 每个场景的kicker、标题、手写行(共5个场景) | 见文案指南 |
{{SCROLL_HINT_TEXT}} | 2–4个大写单词提示 | 滚动奔跑 |
{{CTA_BUTTONS_HTML}} | 2–4个 <a class="cta"> 标签 | 见下文 |
{{ACCENT_CLASS}} | 用于 .script.X 和 .cta.X 的强调色后缀 | amber |
阅读 references/copy-guide.md 了解电影式文案模式(kicker措辞、标题长度、手写行语气)。文案是本技能的价值所在——通用文案会毁掉一个精美的动画。
阶段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文件名必须使用相同的slug——页面中 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会根据总数自动计算计数器宽度)。 - slug既是文件夹名称,也是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,想要一个着陆页。
- 询问slug和主题。对
desk.mp4运行提取器 →./desk/frame-NNN.jpg。 - 将
style.css+parallax.js复制到项目根目录。 - 根据模板编写
desk.html。导航栏只有一个链接:自身。 - 完成。告知用户使用
python -m http.server提供服务。
展示画廊添加: 用户将 hope.mp4 添加到现有的 parasites 文件夹。
- Slug =
hope。提取 →hope/frame-NNN.jpg。(重用现有 style.css + parallax.js。) - 根据模板编写
hope.html。 - 执行展示画廊整合:向
index.html添加第三个卡片,在github.html和lion.html的导航栏中添加Hope链接,在前一个着陆页的最终场景中链式添加下一步:Hope →CTA。 - 如果引入新的强调色,将其添加到
:root中,并在style.css中添加.script.X+.cta.X规则。