scroll-world｜滚动驱动镜头飞行的3D世界落地页生成Skill

scroll-world 是一个 Agent Skill（面向 Claude Code、Codex 及其他兼容 SKILL.md 的智能体），不是独立工具或独立应用。它的作用是：把一段「滚动即飞行」的连续镜头串成落地页——访客滚动页面时，镜头从场景外飞入内部，再无缝飞向下一幕，全程不剪切。

做法是把预渲染的视频当作「时间轴」，滚动只负责拖动播放进度，因此镜头确实在移动，而不是图片淡入淡出。

一次构建会产出：N 张场景图 → N 段「飞入」镜头 → N−1 段「连接」镜头（衔接相邻场景）→ 一套与框架无关的前端滚动引擎。

以上为项目 README / SKILL.md 的说明，未在本站环境实测。

• Claude Code：以插件形式安装（官方推荐路径）。
• Codex 及其他 20 多个智能体：通过 Vercel 的 skills CLI 安装，README 列出 Codex、Claude Code、Cursor 等。
• 也可以手动把技能目录复制进智能体的 skills 目录。

skills/scroll-world/
├── SKILL.md                 流程说明、无缝衔接规则、常见问题
└── references/
    ├── prompts.md           需求清单与各环节提示词模板
    ├── pipeline.md          批量脚本（生成 → 抽帧 → 连接 → 编码）
    ├── scrub-engine.js      可移植的滚动引擎（按配置驱动）
    ├── index-template.html  最小可运行的示例页面
    └── knockout.py          背景抠图（让场景悬浮）

运行所需的本地环境（按 SKILL.md 列出的清单）：

• Monid CLI 及其 API Key 与余额（README 称其为默认的视频链后端）。
• Higgsfield CLI 并完成登录、有可用额度（负责生成场景图，也是视频链的备用计费方与 kling3_0 回退模型）。
• ffmpeg / ffprobe（抽帧与编码）。
• Python 3 + Pillow（可选，用于竖屏画布与透明抠图）。
• Codex CLI（可选）：若已登录 ChatGPT，可用内置 image_gen 出图，改由订阅计费。

在支持的客户端里直接说「做一个滚动穿越世界的落地页」，或调用 /scroll-world（Codex 中用 $scroll-world）。技能会依次：

1. 访谈：主题与一句话定位、品牌色板、美术方向、镜头风格、分镜顺序、是否需要手机竖屏版本、预算。
2. 生成素材：每个分区一张场景图、一段飞入镜头，以及基于相邻片段实际渲染帧生成的连接镜头（这是无缝的关键）。
3. 组装：把滚动引擎接入用户项目，串起整条镜头链，手机端自动降级或切换竖屏素材。

镜头结构按访谈结果分为两种：连续向前推进的单镜头（适合写实/第一人称）；飞入 + 空中转场（适合微缩立体模型风格，但每次接缝会反向拉出）。也可以选固定等距视角的平移版本。

• Monid / Higgsfield 的实际计费与额度，以及账号在国内的注册、支付、访问可行性。
• Codex CLI 版本要求（SKILL.md 写 ≥0.125）与订阅计费规则。
• 不同视频模型对接缝的支持情况会随服务商目录变化，构建前需按文档重新核对。

来源：https://github.com/oso95/scroll-world

许可证：MIT

依据 GitHub 原始资料由 AI 整理的中文待审核草稿，未经本站实测。原始版权与许可归原作者；未声明许可不代表允许转载或再分发。

来源类型：GitHub；授权范围待核验

README 给出的三种方式（命令照录，未在本站执行验证）：

Claude Code 插件（官方推荐）

/plugin marketplace add oso95/scroll-world
/plugin install scroll-world@scroll-world

Codex 及其他智能体（Vercel skills CLI）

npx skills add oso95/scroll-world            # 提示时选择目标智能体
npx skills add oso95/scroll-world -a codex   # 或直接指定 Codex

手动放入技能目录

git clone https://github.com/oso95/scroll-world
cp -R scroll-world/skills/scroll-world ~/.claude/skills/   # Claude Code
cp -R scroll-world/skills/scroll-world ~/.codex/skills/    # Codex

• 账号与授权：higgsfield auth login 为交互式 OAuth，需用户自行执行；monid keys list / monid balance 用于确认可用密钥与余额。
• 页面参数：使用 mountScrollWorld(container, config) 传入品牌名、分区列表与连接片段数组；每个分区可设置 still、clip、eyebrow、title、body、tags，以及控制节奏的 scroll（滚动距离即停留时长）与 linger（镜头在文案峰值处放缓）。
• 移动端：若做出竖屏版本，另设 clipMobile / connectorsMobile / stillMobile；引擎在手机上自动切换。
• 主题：通过 CSS 变量 --sw-bg、--sw-ink、--sw-accent 等覆盖默认样式。

• 费用：README 说明出图与出视频都按次计费，且默认视频后端为 Monid（按条计费，示例称 6 个场景的 1080p 链约 27 美元）；Higgsfield 侧按额度计费，CLI 不公开价格。实际价格、额度、是否需要科学上网与国内支付可用性均待核查，请以官方页面与实时余额为准。
• 生成物不入库：README 明确生成的 .mp4 / .webp 素材按项目单独产出，不随仓库发布。
• 许可证：MIT License，见仓库 LICENSE 文件；版权声明为 Copyright (c) 2026 cyw，与仓库 owner 名称不同，转载或再分发时请保留原始版权与许可声明。
• 未验证项：本站未实际运行该技能，未验证安装命令、模型可用性、衔接效果与移动端表现；插件市场名称、CLI 版本要求等请以仓库最新说明为准。