视频 → 滚动驱动型着陆页
构建一个电影感的着陆页,其Hero区域是随滚动播放而非按时间播放的视频——就像Apple产品页面或GitHub Copilot着陆页。从源视频中提取帧,当用户滚动时切换显示;在粘性Hero下方,正常滚动的区块承载文案和CTA按钮。
何时调用
- 用户提供视频并要求制作着陆页、滚动网站、滚动帧Hero或来自视频的网站
- 提及“Apple风格滚动”、“GitHub Copilot着陆页”、“随滚动逐帧”、“滚动帧”
- 希伯来语对应词:“דף נחיתה מסרטון”、“אתר עם גלילה”、“סרטון בגלילה”
保存位置
默认路径: ~/Documents/yuv-projects/landings/<slug>/ —— 始终将着陆页保存于此,以便日后查找。若父目录不存在则创建。
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 在此构建 <slug>/。
最终路径:~/Documents/yuv-projects/landings/<slug>/。每次构建完成后告知用户着陆页所在位置。
工作流程(8步)
- 探查源文件 —— 使用
ffprobe获取时长、帧率、尺寸、音频信息。 - 选择帧数 —— 默认
80。下限40(过低会卡顿),上限160(页面过重)。按时长选择:≤10秒 → 50,10–30秒 → 80,30–60秒 → 120,>60秒 → 160。 - 确定输出目录 —— 默认
~/Documents/yuv-projects/landings/<slug>/。<slug>应简短,源自视频文件名或主题。仅当用户明确要求时才覆盖。 - 提取帧 —— 运行
references/extract-frames.py <source-video> <output-dir> [count]。输出到output-dir/frames/f_0001.jpg……,统一JPG质量82,最大宽度1920(若源文件更大则缩小)。 - 复制并定制
references/landing-template.html到output-dir/index.html:- 将
__FRAMES__占位符替换为每帧的<img>标签(构建脚本在传入--build-html时会自动完成)。 - 填写
__HEADLINE__、__TAGLINE__、__CTA_TEXT__、__CTA_HREF__及各部分内容。 - 对于希伯来语内容:设置
<html lang="he" dir="rtl">并将字体换为 Rubik/Assistant(参见references/design-notes.md)。
- 将
- 优化帧 —— 构建脚本已自动缩放至1920px最大宽度。若页面总大小超过12 MB,则将质量降至75或减少帧数。
- 预览 —— 在输出目录内运行
python -m http.server,打开http://localhost:8000。在中端机器上滚动体验应流畅顺滑。 - 部署 —— 将文件夹拖放至 Vercel/Netlify/Cloudflare Pages。无需构建步骤。
滚动机制
- 外部滚动容器
.scroll-stage高度以视口单位设置(默认600vh= 滚动5屏遍历所有帧)。 - 粘性Hero
position: sticky; top: 0; height: 100vh,包含所有帧,绝对定位并默认隐藏,仅显示当前激活帧。 - 滚动监听器计算
progress = scrolledIntoStage / scrollableHeight,范围限制为0–1。 idx = floor(progress * (N - 1))—— 将.active类切换到该帧。- 监听器包装在
requestAnimationFrame中以保持60fps。
设计规则
- 如果项目是 YUV.AI品牌(Yuval本人、他的作品集、他的品牌):调用
yuv-design-system并按媒介锁定模式:- Neon模式(YUV.AI网页的默认模式):热粉色(
#FF1464)+ 霓虹青色(#00E5FF)+ 白色或深黑色画布。英文使用 Anton + Inter,希伯来文使用 Rubik + Assistant。圆角为0px或999px。 - 温暖编辑模式:仅用于 Hope、Marcus、bigcats.ai、practical.yuv.ai —— 粉色 + 黄色 + 骨白色,非纯白色(不用
#fff)。 - 绝不在着陆页中使用Decks模式(Fly High紫/黄)——该调色板仅保留给幻灯片。
- Neon模式(YUV.AI网页的默认模式):热粉色(
- 如果项目非 YUV.AI 品牌:不应用 yuv-design-system。选择与源视频情绪相符的调色板。Anton + Inter 作为合理默认值但非强制。
- Hero覆盖层应微妙——使用渐晕效果和单个大标题;不要淹没帧画面。
- Hero下方区块:浅色画布(Neon模式下白色,温暖编辑模式下米白色,通用温暖风格则用骨色),大号 Anton 标题,正文使用 Inter 字体18–22px,CTA采用尖锐药丸形状(
border-radius: 999px)——Neon模式下粉色填充,其他情况使用品牌色。 - 对于希伯来语:遵循RTL,标题使用 Rubik 900,正文使用 Assistant 400/500。
文件参考
| 文件 | 用途 |
|---|---|
references/extract-frames.py | 基于ffmpeg的帧提取器;可选一步构建完整HTML |
references/landing-template.html | 包含滚动机制的独立着陆页骨架 |
references/design-notes.md | 字体、调色板和动效默认值 |