The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.
English · 简体中文 · OpenMotion
Motion.md
复用动效,讲你的故事,把创作方法变成社区资产。
一支好的 reference video,包含的不只是配色,还有开场钩子、镜头顺序、运动路径、阅读节奏,以及声音推动叙事的时刻。MOTION_DESIGN.md 把这些创作决定记录下来,让 Agent 保留动效语言,换成用户自己的主题、内容和品牌。 再把方法、可编辑源码、替换输入和真实成片一起打包,就形成可以复用、传播和继续改进的 Motion Design Skill 包。
Motion.md 是完整的创作设计规范,Brand Kit 是它内部的品牌章节,与叙事、动效、声音和审阅规则一起构成同一份设计上下文。Logo、配色、字体、语气、产品事实和已确认素材都归入该章节;已有品牌文件可以作为引用材料,不要求另写一份与 Motion.md 并列的 BRANDKIT.md。
六组 reference / remix 动态对比 · 可运行的 Skill 包 · Ink & Water 设计体系 · Brandkit
当前状态: Motion.md 是 v0.1 写作提案,由用户显式交给 Agent 阅读;尚无自动导入、解析、注册或跨引擎执行保证。示例 Skill 的脚本只复制六种指定源码并执行已记录的内容替换,不会解释 Markdown,也不会自动重建任意视频。
1. 从一支参考视频,到可复用的 Motion Design Skill 包
核心目标是:保留好的创意结构,换主题、换文案、换品牌。 一次经过检查的复刻,可以变成下一位创作者的起点。
REFERENCE VIDEO 你的需求与素材
开场 · 镜头 · 运动 · 节奏 · 声音 文案 · 产品 · 品牌 · 配音
| |
v v
MOTION DESIGN SKILL PACKAGE
+------------------------------------------------+
| SKILL.md 如何改编与检查 |
| MOTION_DESIGN.md 保留什么,以及为什么 |
| 可编辑源码 动效怎样实现 |
| 替换配置与素材 本次故事改什么 |
| 预览与验证记录 实际做出了什么 |
+------------------------------------------------+
|
v
AGENT + 可编辑工程
修改 → 预览 → 比较 → 迭代
|
v
新的视频 + 可复用源码
|
分享 / Fork / 改进 / 评审
这里的 clone 是保留约定的镜头、节奏与动效语言,同时改写内容。有可用源码时复用实现;只有参考视频时,先逐镜头分析和重建,比较差距,再把确认后的结果沉淀为包。Markdown 本身不能保证效果完全一致;还原程度取决于源码、素材、字体、镜头、时间关系与实际渲染。
2. 架构:创作意图、执行方法、工程实现与证据分层
| 层次 | 文件 / 产物 | 职责 | 具体例子 |
|---|---|---|---|
| 创作设计规范 | MOTION_DESIGN.md |
Brand Kit、叙事、构图、节奏、运动、声音与审阅规则 | 同一份设计上下文指导品牌与动效。 |
| 规范内的 Brand Kit | MOTION_DESIGN.md → Brand Kit 章节 |
名称、事实、Logo、字体、配色、语气与已确认素材,可内联或引用 | 换成用户的产品,保留真实事实。 |
| Agent 方法 | SKILL.md |
选择输入、改编、检查、交付 | 读取所选 profile,更换标题,在主要停留点检查。 |
| 替换契约 | Preset / 参数 Schema | 可改字段、长度、素材角色与缺失处理 | 标题最多 18 字符;保持时间轴。 |
| 可执行工程 | HTML/CSS/JS 与素材 | 几何、动画、渲染与编辑实现 | 原有 portal 实现和原生时间轴。 |
| 验证证据 | 对照预览、版本与哈希 | 哪份源码、哪些修改、哪个区间被检查过 | 原版和改编版按相同时间点渲染。 |
| 分发与协作 | 文件夹、Git revision、可选压缩包 | 稳定身份、完整文件、来源和许可 | 一个确认过的源码版本,加上具名内容配置。 |
现有 openmotion-video-to-template 仍以 TEMPLATE.md 作为单份模板交接文档。可按需链接 Motion Design 说明,不要求所有现有模板增加第二份 manifest。便携工程、Agent Skill 和 .motion 压缩包有联系,也有各自不同的契约。
3. 可以直接检查的包结构
Motion Design Remix Skill 提供六种 profile,源码来自 OpenMotion 资源目录已有的 registry 条目:
openmotion-design-remix/
├── SKILL.md Agent 入口:选择 → 改编 → 对比
├── references/<profile>/
│ └── MOTION_DESIGN.md 这一类动效的创作规则
├── assets/<profile>/index.html 固定上游版本的实现
│ └── assets/ 或 lib/ 字体、纹理和必要依赖
├── presets/<profile>.json 源码哈希与明确替换项
├── scripts/materialize.mjs 复制为独立工程
├── previews/ 实际 GIF / MP4 对照片段
├── sources.json 来源版本与原始 Demo
├── evidence.json 改编与渲染证据
├── NOTICE.md 署名及运行要求
└── LICENSE
这是示例包的组织方式,不是新增的强制运行时格式。六种 profile 不会自动成为六个核心 Skill 或六个 Studio 内置模板;原有三个内置模板的 ID 和行为保持不变。
在 Skill 文件夹中运行:
node scripts/materialize.mjs wireframe-portal-title reference /tmp/portal-reference
node scripts/materialize.mjs wireframe-portal-title remix /tmp/portal-remix
脚本核对源码哈希与替换出现次数,拒绝覆盖已有目录,生成独立可编辑工程和 remix-record.json。使用自己的内容时,先把 preset 复制到包外,修改替换值,再将文件作为第四个参数传入。生成的工程包含本地脚本、字体、纹理与参考视频,无需 CDN / 在线字体;执行工具另行安装,许可与要求见包内 NOTICE.md。这套脚本实现的是指定源码的替换,不是通用模板参数导入器。
4. MOTION_DESIGN.md 具体写什么
| 章节 | 记录什么 | 如何让 Agent 能执行 |
|---|---|---|
| 身份与来源 | 名称、版本、原作者/链接、源码版本、权限与验证状态 | 指向准确原作,保留署名。 |
| Brand Kit | 品牌身份、产品事实、Logo、配色、字体、语气与已确认素材 | 将品牌规则写在创作设计规范内,按需引用已有资料。 |
| 叙事语法 | 受众、钩子、揭示顺序、证据与收尾 | 说明每个场景承担的信息。 |
| 视觉层级 | 构图、字级、景深、对比、留白与品牌来源 | 明确每个主要停留点的视觉焦点。 |
| 时间与运动 | 镜头边界、停留、缓动、镜头路径、遮罩、转场和连续性 | 写清动作关系或源码标签,不只写“高级、电影感”。 |
| 素材与声音 | 视频、截图、字体、配音、音乐、同步点与替代方案 | 区分必须提供和可以生成的素材。 |
| 保持项 | 内容变化后仍应保留的创作决定 | 保持 portal 时间与镜头,保留结尾阅读停留。 |
| 可替换项 | 文案、人物、数据、品牌、画幅与实际容量 | 约定长文案、长配音、素材缺失和布局变化怎么处理。 |
| 检查与证据 | 同时刻对比、源文件/输出身份、技术与视听检查 | 写实际差距;有检查章节不等于检查通过。 |
使用普通 Markdown。区分从参考中观察到的内容、推断出的创作决定与主动改动。长文案应拆分或重排受影响场景,不靠无限缩字解决;改时长时要一起调整相关转场和声画锚点。
完整例子的核心:保留 portal,换一段故事
# Portal launch — MOTION_DESIGN.md
Version: 0.1.0
来源:填写真实源码版本和参考视频。
## 保持
平面卡片 → 打开 portal → 立体文字 → 白场退出。
保留镜头路径、揭示时间、随机种子与缓动。
## 替换
标题:OPENMOTION(此 profile 最多 18 字符)。
立体短句:TELL YOUR STORY。
副标题:YOUR STORY. IN MOTION.
## 时间
0–0.45 秒:卡片进入;0.45–2.5 秒:打开 portal。
2.5–6 秒:立体短句;6–8 秒:镜头穿过,白场退出。
## 素材与声音
使用包内 Geist 字体与源码。本例无声。
增加配音或音乐时,另外明确输入与时间关系。
## 检查
在卡片、portal 交接和短句停留处同步比较。
检查整句话是否完整、镜头是否连续、文字是否碰撞。
保存源码/preset 哈希和真实产物,记录剩余问题。
完整 portal profile 适合复用局部动效。需要整支影片的叙事简报时,可参考既有的产品发布 Motion.md。
5. 复刻怎样沉淀为社区资产
发现参考
→ 分析镜头、运动、内容槽位与素材要求
→ 缺少可用源码时,重建可编辑工程
→ 参考与重建结果按相同时刻比较
→ 用 MOTION_DESIGN.md 固化创作规则
→ 换一个真正不同的主题,再做一版
→ 渲染 reference / remix 对照并记录证据
→ 分享 Skill、工程、输入约定、来源与许可证
→ Fork、改进、评审下一个版本
当前 openmotion-recreate 负责参考作品重建,openmotion-template-to-video 负责已有模板改编,openmotion-video-to-template 在用户需要可复用模板时负责模板交付。Library Skill 可以携带特定风格和改编方法。这些都是用户 Agent 读取的指导,不是另起一个后台编排 Agent。
可发布案例应回答:保留了什么、修改了什么、实际渲染出了什么。 优先使用同一时钟的左右对比,记录截取区间、裁切和速度变化。用户工程和凭据放在源码包外。Git 分支保存 preset 或实现修改,PR 同时审阅源码差异和成片差异。文件分享、社区评审和人工沉淀方法现在即可进行;自动 marketplace 入库、传播数据学习和 RAG 检索仍是产品方向。
真人剪辑:同一个故事,两套时钟
Motion Design 也要描述人物、语言与辅助画面之间的关系。Presenter Story Skill 提供三份设计配方与有出处的上游对比。这些媒体说明设计模式,不是新配方已完成成片的证明。
你的口播录制 + 屏幕录制 + 实际语音时间码
│
▼
源素材选段 ── 剪辑映射 ──► 输出时间轴
├─ 保留的语音 + 人物画面
├─ 随剪切重新映射的字幕
├─ 屏幕 / 空镜 / 证据卡片
└─ 关键词、标注与动效
│
带声音预览 + 改稿
│
可编辑工程 + 成片
源素材时间与输出时间不同。 例如,把源片 12–18 秒保留到输出 0–6 秒,源片第 15 秒的事件就映射到输出第 3 秒。这只是算术示例,不是测得的字幕。逐片段保存映射,按实际语音证据安排字幕和叠层,剪切后重建映射;只看抽帧无法得到逐词时间码。
| 层次 | Motion.md 记录什么 |
|---|---|
| 叙事 | 想表达的意思、保留的语义、开场、证据与结尾。 |
| 人物 | 素材身份、构图、面部与手势安全区、何时回到人物。 |
| 剪辑映射 | 源片选段、输出起点、转场与插入画面的理由。 |
| 字幕 | 转写来源、真实时间码、重构图后的可读位置。 |
| 动效 | 哪句表达触发关键词、截图、标注或画中画变化。 |
| 审片 | 语音衔接、屏幕可读性、人物无遮挡、正常速度带声音播放。 |
换主题时,录制与证据素材也要对应替换。保留创作者的口吻和意图,不能仅把新标题盖在无关口播上。配方是显式交给 Agent 的上下文,不是自动转写、静音检测或新的时间轴格式。可复用成品包仍需自己的剪辑源码、可分发素材与真实导出对比。
6. 从 MotionGit、Hypit 与 rea-video 借鉴什么
| 参考 | 借鉴的思路 | 在 OpenMotion 中的应用 |
|---|---|---|
| MotionGit 规范 / motion-spec | 区分内容、运行时和分发,明确素材、参数、依赖与许可 | 把创作规则、工程源码、内容输入、证据分别组织;不声称已支持 .motion 导入导出。 |
| MotionGit 模板合集 | Demo、素材要求和真正可用的工程入口一起呈现 | 每个对比都能找到 Skill、Motion.md 和替换配置。 |
| MotionGit Git | 用可编辑源码和版本协作延长视频的生命周期 | Fork 风格、改 preset、比较渲染结果,再评审改进。 |
| Hypit | 同一种创意结构,展示多种内容变体 | 每个案例都说明保持项与可替换内容。 |
| rea-video | 解释逐镜头制作方式,并同步展示原作与改编 | 明确区分参考重建证据与已有源码改编证据。 |
MotionGit 的内容层和分发层分别版本化。MOTION_DESIGN.md 是可读的创作说明,不是 MotionGit .motion 容器或 Schema 的实现。字段映射只是未来适配器的候选设计,兼容性需要单独实现和验证。引用某个项目不意味着已经集成它的视频、API 或包格式。
7. 贡献与验证等级
| 状态 | 需要什么证据 |
|---|---|
| Reference | 原片及可追溯来源。 |
| Described style | Motion.md、观察/推断标记和替换意图。 |
| Editable example | 真实源码、素材要求和已知限制。 |
| Rendered remix | 实质变化的输入、实际输出及源码/preset/渲染身份。 |
| Reviewed recreation | 与原作的对比、明确差距以及人工接受的范围。 |
本次六个实例展示已有源码的内容替换,不证明任意参考视频的复刻成功率、完整声轨匹配或传播效果。Motion Benchmark / Arena 仍待设计,不从这些案例推导相似度百分比或公开排名。
欢迎通过 Library 贡献清单 提交第二个真实需求与对应结果。好的社区资产,应让下一位创作者知道怎样复用,也知道在哪些边界上需要重新设计。