scroll-world:把任意品牌变成一个可滚动的 3D 世界
痛点切入
做一个”苹果风”的滚动叙事落地页,过去只有两条路:要么花几万块找动效工作室,要么自己用 Three.js 调相机、写 scroll listener,调三个月还不一定顺。
问题不在”能不能做”,而在”值不值得做”。相机从场景外飞进内部、再无缝接到下一个场景、全程零剪辑——这套活儿的技术含量全在接缝处。人眼对画面跳帧极其敏感,差一帧就显得廉价。
scroll-world 想替你把这整条流水线包了:从生成场景图,到生成每段相机飞行,再到把相邻场景用”连接片段”对帧缝合,最后给你一个可直接挂载的滚动引擎。
项目简介
scroll-world 是 oso95 开源的一个 agent skill,支持 Claude Code、Codex 以及任何兼容 SKILL.md 的 agent。当前 GitHub 是三千星量级项目,MIT 协议,主语言是 JavaScript。
它本质上是一套”流程 + 提示词模板 + 滚动引擎”的组合包,而不是一个开箱即用的网站生成器。仓库结构很克制:
- SKILL.md:完整流程、接缝规则、常见坑
- references/prompts.md:问卷清单 + 每个 Higgsfield 提示词模板
- references/pipeline.md:可复制的批处理脚本(生成 → 抽帧 → 连接 → 编码)
- references/scrub-engine.js:可配置的滚动引擎(blob-seek、懒加载、接缝交叉淡入)
- references/index-template.html:最小独立页面
- references/knockout.py:漂浮场景的背景抠图
它的卖点很明确:框架无关。你拿到的是 Higgsfield 管线、提示词模板和一段 vanilla JS 滚动引擎,能直接塞进纯 HTML、Next.js、Vue,或者 Python 服务的页面里。不绑定任何技术栈。
为什么是它
scroll-world 真正稀有的地方,是它对”接缝”的处理方式。
多数 AI 视频拼接方案的死穴,是相邻片段不是同一帧起步,于是滚动到连接处会闪一下。scroll-world 的做法是:连接器片段直接由相邻两个场景的真实渲染帧生成,所以每一处接缝都是帧对齐的。它明确写进了 SKILL.md 的”seam rule”,把这件最容易被忽略、也最毁观感的事当成了硬约束。
另一个差异点是相机真的在动。它用 Seedance 或 Kling 的图生视频,只选能”frame-lock”的模型——滚动只是驱动时间轴,相机运动是真实生成的。这和苹果官网页面的技术同源。
它还做了两件降低决策门槛的事:
- 生成前先访谈你(行业、品牌色、场景顺序、是否要移动端竖屏版、预算),并用实时余额估算总成本,批准后才花钱
- 移动端不是把横屏视频裁一刀,而是独立渲染一条 9:16 的竖屏链,按手机构图重做
快速上手
前提是你要先装好依赖,注意它对外部服务的依赖很重:
- Higgsfield CLI,已登录且有额度(higgsfield auth login)
- ffmpeg / ffprobe,用于抽帧和编码
- Python 3 + Pillow,用于竖屏画布和抠图
- Codex CLI(可选):若已安装,场景静帧可用 Codex 的 image_gen 走 ChatGPT 订阅额度,不必花 Higgsfield 额度
以 Claude Code 插件方式安装最省事:
/plugin marketplace add oso95/scroll-world
/plugin install scroll-world@scroll-world
然后直接说”我要一个滚动穿越世界的落地页”,或调用 /scroll-world。
Codex 及其他 agent 用 Vercel 的 skills CLI:
npx skills add oso95/scroll-world
手动安装则把 skill 文件夹拷进 agent 的 skills 目录:
git clone https://github.com/oso95/scroll-world
cp -R scroll-world/skills/scroll-world ~/.claude/skills/
亮点代码
滚动引擎是纯前端、配置驱动的。你不需要懂视频管线,只要喂一个场景清单:
// scrub-engine.js 的配置结构(节选)
const world = new ScrollWorld({
scenes: [
{ still: "scene1.webp", dive: "scene1-dive.mp4", poster: "scene1-poster.webp" },
{ still: "scene2.webp", dive: "scene2-dive.mp4", poster: "scene2-poster.webp" },
],
connectors: ["conn-1-2.mp4"],
mobilePortrait: true, // 自动在手机上换竖屏链
});
world.mount(document.getElementById("stage"));
它做的事很朴素但很关键:blob-seek 让滚动直接定位到视频帧、懒加载按需拉取片段、接缝处做交叉淡入。index-template.html 已经把这段引擎挂上了一个最小页面,你复制改场景路径就能跑。
社区与生态
项目还很新,main 分支只有 13 次提交,Issue 和 PR 都在个位数。但三千星和三五百 fork 的量级说明需求真实存在——“苹果式滚动叙事”一直是很多人想做但下不了手的东西。
风险和所有”依赖外部付费 API 的 skill”一样:核心资产是 Higgsfield 实时生成的,CLI 不公开单次价格,成本会随你的余额波动。skill 自己会先校准再报价,这点比很多同类工具诚实。
适用场景与局限
该用它的场景:
- 你想给品牌、产品、行业做一个记忆点强的发布页或官网 hero
- 你愿意为视觉冲击付费,且能接受数小时的生成等待
- 你有 Higgsfield 额度,或愿意用 Codex CLI 走 ChatGPT 订阅
别用它的场景:
- 预算紧、想要免费或纯本地方案——它强依赖 Higgsfield 付费额度
- 需要高频改文案/换场景——每次改动都意味着重新生成视频资产,迭代成本不低
- 想要一个”输入文案就出网站”的零干预工具——它本质是 expert-in-a-box,关键决策(场景顺序、品牌、预算)仍要你拍板
一句话:它把”苹果式滚动叙事”从工作室项目降级成了 agent 任务,但没把它降级成免费午餐。