
如何用Oil Motion快速做出第一个响应滚动的网页动画新手安装与上手教程【免费下载链接】oil-motion设计并实现随滚动、拖动、指针或状态变化响应的网页动画覆盖素材、时间轴和运行时。项目地址: https://gitcode.com/gh_mirrors/oi/oil-motion想做一个产品随页面滚动逐步展开、镜头跟随鼠标转动的网页动画却不知道怎么从素材到上线Oil Motion 是一个 Agent 通用的交互动画 Skill负责设计动作、生成连续画面、整理动画素材并把最终效果接入页面滚动、鼠标、拖动、触摸等交互。这篇新手安装与上手教程会带你完成 Oil Motion 的环境准备、安装和首次配置再用一段自然语言需求做出第一个响应滚动的网页动画——全程不需要手写动画代码。一、Oil Motion 是什么让网页动画跟着滚动和鼠标走简单来说你只需要说清楚三件事想表达什么、提供哪些素材、动画跟随什么操作剩下的生成、检查、压缩和前端接入都交给 Agent。它专门处理主体本身需要变化的交互动画页面滚动时产品逐步展开成爆炸图镜头推进内部结构或在几种状态之间切换️鼠标移动时角色的脸始终朝向光标硬件产品跟着拖动做 360° 展台旋转️拖动或触摸时动画跟随手势前进、后退或停在指定位置⚠️ 边界提醒只靠 CSS、JS、SVG、Lottie 就能完成的按钮反馈、界面过渡和布局动效直接交给普通前端实现即可不需要这套素材流程。二、准备工作一次装好 3 类环境依赖依赖用途版本要求Python帧处理、时间轴编译3.10ffmpeg / ffprobe视频解码、抽帧、压缩较新版本即可Node.js首次填写 API Key 的本机配置页22.18在仓库根目录安装 Python 依赖含 Pillow、numpy、PyYAMLpython3 -m pip install -r scripts/requirements.txt依赖清单见 scripts/requirements.txt。 如果你只是整理已有的视频或序列帧纯本地处理只需要 Python FFmpeg不需要 API Key只有调用 AI 生成关键帧或视频时才需要。三、安装 Skill把仓库地址交给 Agent最简单的安装方式是直接对 Agent 说一句话帮我安装 https://gitcode.com/gh_mirrors/oi/oil-motion 这个 Skill。或者先克隆到本地再交给 Agentgit clone https://gitcode.com/gh_mirrors/oi/oil-motion安装完成后让 Agent 重新加载 Skill 即可。Skill 的完整主流程入口是 SKILL.md之后你只需用自然语言描述需求不需要记忆任何命令。四、首次配置 ZenMux API Key本机页面填写Key 不进聊天第一次调用生成服务前Agent 会先检查凭据状态node scripts/credential-ui/src/profile.ts status default node scripts/credential-ui/src/profile.ts setup default退出码0Key 已就绪直接继续退出码2还没配置Agent 会打开一个本机配置页并把链接交给你由你亲自填写Key 会存进系统凭据库macOS 钥匙串、Windows 凭据管理器、Linux Secret Service之后自动复用它不会被贴进聊天也不会存成明文。图片与视频生成共用这一个 Key。 每次 AI 生成都会计费所以 Agent 会先做一段小的Pilot确认效果后再批量生成避免白花额度。配置页细节、退出码含义和安全边界见 references/api-key-setup.md。五、上手教程一句话需求做出第一个滚动动画配置完成后假设你手上已有两张产品图对 Agent 这样说使用 oil-motion把这两张产品图制作成随页面滚动逐步展开的动画。桌面端展示区域较大需要保持清晰移动端使用较轻的资源。之后 Agent 会自主完成 4 步锁定意图—— 逐项确认主体、风格、动作、交互输入滚动/指针/拖动和时间控制写入 Concept Contract不擅自扩写。想法还很模糊时Agent 会先给出最多三个真正不同的方向供你选择方法参考 references/concepts.md。生成关键帧与视频—— 先生成产品完整 → 零件展开等关键画面并验收确认身份和结构不跑偏再用 AI 视频生成画面之间的连续动作位移、缩放、跟随阻尼这类参数由程序接管。Pilot 验收—— 只完成第一对关键帧和第一段视频挂载到真实页面验收通过后才进入量产。编译时间轴、接入运行时—— 逐帧检查视频裁掉停顿和重复帧编译出时间轴再把滚动输入映射到动画进度上。项目自带一段成品演示视频 assets/demo/oil-motion-demo.mp4动手前先看一遍能帮你建立对最终效果的预期。六、运行时接入从现成控制器开始不手写动画逻辑页面侧交互不需要从零写起。运行时控制器模板在 assets/interactive-motion.ts管理逐帧随动与分段播放分步手势控制器在 assets/step-gesture.ts。输入映射、反向撤回、预加载和降级规则统一以 references/runtime.md 的时间轴规范为准。七、交付前验收快速检查 5 件事✅ 主体外观、结构和光线在连续画面中保持一致没有闪帧和异常停顿✅ 快速滚动、快速反向时不粘滞、不抽动、不越界✅ 初次加载有清晰首帧资源加载失败时回退到静态画面✅ 移动端不会因资源过大而明显卡顿✅ 用户开启减少动态效果时页面显示静态替代内容完整验收标准见 references/qa.md。常见问题Q需要自己写动画代码吗不需要。你只负责描述效果和素材Agent 生成素材并接入现成的运行时控制器。Q我已经有视频素材还需要 API Key 吗不需要。本地处理已有视频和序列帧只需 Python FFmpeg全程不调用生成服务。Q用 CSS 挪一下图片就能实现的动画适合用它吗不适合。主体本身不需要变化按钮、布局过渡直接用 CSS/JS 实现Oil Motion 专门处理画面本身连续变化的动画。延伸阅读文档内容SKILL.md主流程与四个唯一事实源references/concepts.md交互动画创意方法references/prompting.md关键帧提示词与生成命令references/runtime.md时间轴规范与运行时行为references/optimization.md帧率、插帧与压缩策略scripts/各类处理脚本与凭据配置页【免费下载链接】oil-motion设计并实现随滚动、拖动、指针或状态变化响应的网页动画覆盖素材、时间轴和运行时。项目地址: https://gitcode.com/gh_mirrors/oi/oil-motion创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考