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 任务,但没把它降级成免费午餐。

仓库:https://github.com/oso95/scroll-world

相关文章

AntV Infographic:让 AI 生成真正可编辑的信息图

AntV Infographic:让 AI 生成真正可编辑的信息图

痛点切入 AI 生成信息图最尴尬的地方,不是它不会画,而是它画完以后很难改。 让模型直接生成一张图片,第一眼可能还行。可一旦你想改文案、换颜色、删掉一个模块、把第二步挪到第三步,马上就进入“ ...

Colima:29k star 的 Docker Desktop 替代品,macOS 容器运行时该选它

痛点切入 你在 Mac 上用 Docker Desktop,每次开机它都偷偷吃掉 2-3GB 内存,风扇呼呼转。你打开活动监视器看了一眼,Docker Desktop 占了 15% CPU,你 ...

Cell Architecture Studio:用 3D 探索细胞,开源

生物课本有一个问题。 里面的图是平的。细胞器用箭头标注,三四个箭头指向同一个位置。内质网怎么包裹细胞核、线粒体怎么在细胞质里漂浮——这些空间关系,你得盯着静态插图读一段文字来理解。 Cell Ar ...

Cowart:为 Codex 打造的本地无限画布,让 AI 编程看见你的想法

此项目建立的初衷 AI 编程工具发展到今天,已经能读懂代码、修改文件、运行命令。但有一个问题一直没被很好解决:AI 怎么理解你的视觉意图? 你做了一个 UI 设计,想让 AI 帮你实 ...

Claw Code:193K 星的开源 Agent Harness,AI 编程的下一个战场

Claw Code:193K 星的开源 Agent Harness,AI 编程的下一个战场

此项目建立的初衷 过去一年,AI 编程工具的变化非常快。 最早,开发者用 AI 主要是为了补全代码。后来,AI 开始进入聊天窗口,帮我们解释代码、生成函数、排查报错、写测试用例。再后来,Cu ...

LongCat-Video:美团开源 13.6B 视频生成模型,长视频才是真正的战场

长视频生成为什么难 你可能已经体验过不少视频生成工具——Kling、Runway、Pika、Wan2.1……5 秒的片段看起来都不错。但当你尝试生成 30 秒甚至分钟级视频时,问题就来了。 ...