SuperAPI AI 工具集

scroll-film-landing

前端与建站

查看项目

更新于 10-17 14:18

技能介绍

Scroll film landing 是一个技能(skill),用于制作以「滚动拖动电影」为核心体验的落地页。页面首屏是一段影片,访客用滚动条控制播放:N 张静帧变成 N-1 段片段,第 k 段片段从第 k 个停靠点运行到第 k+1 个停靠点,滚动位置决定视频的 currentTime——向下滚动向前播放,向上滚动倒放。该方法参考 midudev 的 Arko 落地页(github.com/midudev/mcp-higgsfield-landing),但引擎为自身独立实现。

主要能力与约定:

  1. 影片负责氛围,HTML 负责事实。AI 视频在镜头移动时会让文字和数字模糊变形,因此静帧中不放置可读文字、标志或界面;每一条主张、数字和 UI 都放在对应停靠点左下角的 HTML 字幕中。

  2. 一个连续世界。所有静帧展示同一地点、同一风格,每站都有通往下一站的门或路径,使模型执行的是镜头运动而非形态渐变。

  3. 花费闸门。每次付费调用先估算并报告,由人批准预算(第 2 步)和静帧(第 3 步)之后,才会为片段花钱。

  4. 接缝不可见。每段片段下的海报图从编码后的片段本身提取,并校验色彩标签,使海报与视频匹配(第 7 步进行测量)。

  5. 默认本地。上传到 Higgsfield 会得到公开 CDN URL,只上传所有者可以分享的素材;仅在明确要求时部署。

使用流程分为七个步骤:

第 0 步环境检查:检查 node、pnpm、ffmpeg、ffprobe、cwebp、jq、curl 是否存在,以及 Chrome 和 Higgsfield API 密钥是否就绪;缺失项可用 brew install ffmpeg webp jq 安装。QA 需要 Chrome,因为 Playwright 自带的 Chromium 无法解码 H.264。

第 1 步简述停靠点:阅读产品的设计规范,写出 5 到 7 个停靠点的表格,每站包含 id、在世界中的位置、字幕一句话主张以及证明它的 HTML 卡片(表格行、状态、数字),并选择每个地点作为该站物理隐喻的世界(如用档案室隐喻库存、检查室隐喻审核),外加一个开场到达镜头。

第 2 步密钥与预算:若密钥缺失,由人在自己终端运行 scripts/hf-key-setup.sh 隐藏输入;然后用免费估算为整次运行定价。注意 Higgsfield CLI 与 API 有各自独立的余额。

第 3 步静帧:按 art-direction 参考为每站写请求体(共享风格块、重复出现的物体、门洞连续性),每站生成 4 张一批,制作联络表并每站挑选一张,由人并排确认。这是最后一个免费退出点。

第 4 步片段:上传所选静帧,编写片段请求体,先生成一个测试片段并查看帧条,再并行生成其余片段;逐条检查剪辑、淡入淡出、扭曲、可读文字以及最后一帧是否稳定落在下一张静帧上,只重做失败项。

第 5 步编码:运行 scripts/encode.sh,输出 public/film/clip-k.mp4(1080p)、clip-k-720.mp4(移动端)和海报图,每 6 帧一个关键帧,并带 BT.709 / sRGB 标签。

第 6 步构建:用 Astro 搭建(pnpm create astro@latest、pnpm add lenis、pnpm add -D playwright),复制模板,按设计规范样式化字幕,处理移动端裁切(focus)与注意事项。

第 7 步 QA:运行 node qa/verify.mjs,在 1440x900 与 390x844 两种尺寸下双向滚动,检查片段时间是否跟随滚动、在两个站点测量海报与视频的 PSNR、确认减少动态效果时不加载视频,并在控制台报错时失败。

适用场景:需要电影感叙事的产品落地页、品牌故事页、需要滚动交互演示的营销页面。限制:依赖 Higgsfield API 完成静帧与视频生成,需要人工审批预算;QA 依赖 Chrome;H.264、关键帧间隔与色彩标签有明确技术要求;密钥不以聊天方式输入。