视差滚动着陆页 (Parallax Landing Page)
将一段短视频转化为全屏电影感着陆页——用户滚动鼠标即可逐帧播放视频,同时五段戏剧性文字场景交叉淡入淡出。文档本身永远不会实际滚动——滚轮/触控/键盘输入由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 字体栈替换为设计系统的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
# 此技能在提取帧并构建HTML时会在此处创建 <slug>/ 目录
最终路径(模式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),或新的颜色(将其添加到 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 元数据块打印到标准输出。捕获它——你需要 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个场景各自的 kicker、标题、手写行 | 参考文案指南 |
{{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 以了解电影感文案模式(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文件名必须使用相同的别名——页面中 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的线性插值(系数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 添加到现有的 parasites 文件夹。
- 别名 =
hope。提取 →hope/frame-NNN.jpg。(复用现有的 style.css + parallax.js。) - 从模板创作
hope.html。 - 运行展示集成:向
index.html添加第三张卡片,在github.html和lion.html的导航栏追加Hope链接,将前一个着陆页的最后场景链接为Next: Hope →CTA。 - 如果引入新的强调色,将其添加到
:root,并在style.css中添加.script.X+.cta.X规则。