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.
TypeScript agent-skillsagentic-aiai-agentsai-videobyokclaude-codecodexdeepseek-harnessdsh-plugingenerative-ailocal-firstmcpmotionmotion-graphicsmultimodalopenmotionreverse-engineeringvideo-editingvideo-generationworkbuddy
docs(motion): end the first-run experience in the editor without an MP4
Awek-01527c6003ec355
diff --git a/README.md b/README.mdindex 924cbe79..6c023417 100644--- a/README.md+++ b/README.md@@ -69,7 +69,7 @@ Paste this into a Codex conversation:```textFrom this checkout, install openmotion with bash scripts/install-motion.command.Once installation succeeds, ask whether I'd like the 20-second Product Promo demo.-If I accept, open an independent editable project and deliver its MP4.+If I accept, open an independent editable project beside the conversation.```After you accept, the Agent follows the [template-to-video workflow](skills/motion-template-to-video/SKILL.md). If your host cannot open the editor beside the conversation, use the returned local project link. [Installation and first-demo guide (Chinese)](docs/usage.md#使用) · [Other Agent adapters](docs/agent-adapters.md)diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.mdindex 6a249acf..230a635f 100644--- a/docs/README.zh-CN.md+++ b/docs/README.zh-CN.md@@ -67,7 +67,7 @@```text在当前仓库目录运行 bash scripts/install-motion.command 安装 openmotion。安装成功后,问我是否体验 20 秒的 Product Promo 示例。-我确认后,打开一份独立的可编辑工程,并交付导出的 MP4。+我确认后,在对话旁打开一份独立的可编辑工程。```确认体验后,Agent 会按[模板出片流程](../skills/motion-template-to-video/SKILL.md)执行。宿主不支持在对话旁打开编辑器时,可以打开返回的本地工程链接。[安装与首次体验手册](usage.md#使用) · [其他 Agent 接入](agent-adapters.md)diff --git a/docs/product/architecture.md b/docs/product/architecture.mdindex 83e5973d..e56dbafe 100644--- a/docs/product/architecture.md+++ b/docs/product/architecture.md@@ -43,7 +43,7 @@ Model Gateway 是共用的素材生成服务,可由 Motion Viewer 或 MCP 调## 核心用户流程1. 用户在首页切到 Motion 模式,选择 Motion 模板并提交需求创建会话;也可直接新建空白创作,或打开左侧已有会话。内置模板复制为该会话的工程,外部参考由 Agent 制作。-2. 需要 Agent 时选择 Codex、Claude Code、DeepSeek Harness 或通用 stdio 客户端。接入配置绑定当前工作区;Agent 验证工具和数据目录,读取当前工程与制作规范。 安装后先介绍能力、邀请并等待选择;接受首次体验即确认 `product-promo` 示例内容、独立 20 秒工程、MP4 导出及右侧可编辑页面。Agent 不再问素材/模板/导出确认,实际打开宿主面板,等待并验证成片。Successful first-run delivery uses one completion sentence, the playable MP4 and an LLM-generated contextual invitation to the user's next video, following the [first-run defaults](../../skills/motion-production/references/templates.md#first-run-experience-defaults); the editable project stays open on the right. 宿主没有面板能力时明确提供链接作为降级,不能冒称已打开;实际行为按客户端验证。+2. 需要 Agent 时选择 Codex、Claude Code、DeepSeek Harness 或通用 stdio 客户端。接入配置绑定当前工作区;Agent 验证工具和数据目录,读取当前工程与制作规范。 安装后先介绍能力、邀请并等待选择;接受首次体验即确认 `product-promo` 示例内容、独立 20 秒工程及右侧可编辑页面,用户没有要求时不导出 MP4。Agent 不再问素材/模板确认,实际打开宿主面板并检查工程载入与播放。Successful first-run delivery uses one completion sentence and an LLM-generated contextual invitation to the user's next video, following the [first-run defaults](../../skills/motion-production/references/templates.md#first-run-experience-defaults); the editable project stays open on the right. 宿主没有面板能力时明确提供链接作为降级,不能冒称已打开;实际行为按客户端验证。3. 用户在会话补充需求并复制给外部 Agent。一期 Agent 用 `motion_get_project` 读取明确工程及其 sessionId、需求、来源与版本,按本轮意图选择入口或直接继续已选范围;编辑前校验工程归属。For original creation, reference-video recreation and editable-template production, the Agent automatically calls `motion_open_preview({projectId})` after the requested HTML is saved and visibly opens its exact `previewUrl` in the host browser, before export or delivery; no extra user request is required. The shared [editable preview handoff](../../skills/motion-production/references/native.md#editable-preview-handoff) defines readiness, host checks and capability limitations. Continued content edits, including motion-production work, return a project/revision/version-bound previewHandoff after saving or restoring. Reuse the native project tab: present it when the calling chat is active, otherwise queue it without switching chats and resolve the latest version when the user returns. Only this turn's explicit presentation=now request permits switching back; explicit background requests suppress presentation. Codex IAB synchronizes visibility within the calling chat. A queued acknowledgment is separate from observed visibility and live-content freshness; record_display rejects stale content identities, and stored previewDisplay remains historical host-reported evidence rather than a live server measurement. 旧 design_* handler 仅留内部兼容。4. Agent 根据本轮目标直接选择 Skill:motion-director 负责原创、局部/整体叙事动作声音重新设计和创作审片;motion-template-to-video 负责已有模板出片;motion-recreate 负责参考作品重建(已接入实际流程、独立参考与测量脚本);motion-video-to-template 负责可复用模板生产;motion-production 承接既定决定下的工程操作、预览、技术检查、排错和导出。共享规则同源引用,已有 production/start 保留导航,无需前置总路由。项目来源与画面锁定不固定入口;保持项和已完成操作继续有效。5. Agent 导入素材或通过 Model Gateway 生成图片/视频/音频,完成后写入原生工程。用户在右侧浏览器 Tab 的 Motion Artifact Viewer 预览与编辑,可从空时间轴、素材面板或时间轴选区生成并放入指定时段;选中图片可交给 Codex 参考修改,确认后只替换素材引用并保留原生撤销。也可新增同会话的另一个工程,关闭浏览器继续会话、收起会话沉浸浏览。发生 revision 冲突时重新读取并合并。 按共享 context 补齐缺少的正文并先返回模型再执行;修改按共享 edit 核对保持项、相邻关系与后续延续。diff --git a/docs/usage.md b/docs/usage.mdindex 0d215ac9..5e641d9e 100644--- a/docs/usage.md+++ b/docs/usage.md@@ -68,7 +68,7 @@ openmotion 围绕已有 Agent 用户的产品演示、参考复刻、动态图```text请在当前仓库目录运行 bash scripts/install-motion.command 安装 openmotion。-安装成功后,询问我是否体验一个无需准备素材的 20 秒视频。我确认后,请打开独立的可编辑工程并交付 MP4。+安装成功后,询问我是否体验一个无需准备素材的 20 秒视频。我确认后,请在右侧打开独立的可编辑工程。```安装脚本使用当前检出版本,安装依赖、构建编辑器、注册本地插件并预检 MCP 连接。它不会安装系统软件或重启 Codex。请保留仓库目录供插件继续使用。导出 MP4 还需要浏览器和媒体工具,详见下文。@@ -78,7 +78,7 @@ openmotion 围绕已有 Agent 用户的产品演示、参考复刻、动态图由 Codex 或其他 Agent 执行安装时,在插件安装与 MCP 连接预检均成功后,按以下顺序结束安装任务:1. 在当前对话简要介绍 openmotion 支持产品宣传视频、动态图表与流程动画、模板和可编辑预览、MP4 导出。-2. 主动询问用户:**“要现在体验一个无需准备素材的 20 秒视频吗?我会提供 MP4,并打开可编辑工程。”**+2. 主动询问用户:**“要现在体验一个无需准备素材的 20 秒视频吗?我会在右侧打开一个可编辑工程。”**3. 停下来等待用户选择;用户回复“体验”或明确同意后,进入 [motion-template-to-video](../skills/motion-template-to-video/SKILL.md) 并执行下方首次体验默认规则。用户明确只要安装或暂不体验时,尊重该选择。先在当前对话完成介绍与邀请。若新插件工具尚未加载,在用户同意体验后再提供新会话接续方式;安装时的 MCP 预检不代表当前对话已加载新工具。安装失败时先说明失败原因,修复成功后再邀请。@@ -89,12 +89,12 @@ openmotion 围绕已有 Agent 用户的产品演示、参考复刻、动态图- 沿用模板的示例文字、图形和动画,保持原生 20 秒规格,不再询问素材、品牌、风格或模板选择。- 创建独立可编辑工程,保留原有工程;同一次体验已经创建工程时直接续用,避免重复创建。-- 在 Codex 右侧打开 openmotion 可编辑工程,检查正确载入并可播放;让用户可以在等待导出时继续查看工程。-- 接受首次体验同时授权导出该示例的 MP4。读取当前 revision,导出并等待完成,检查实际文件与播放;复用本次已完成的导出,不重复排队。-- On success, the final reply contains **one completion sentence, the playable MP4, then one contextual next-step invitation**, with the editable project kept open on the right. Use plain Markdown; screenshots and verification evidence stay in local records. Editor screenshots, ZIPs, duplicate project links, checklists and HTML wrappers are omitted unless requested.-- The LLM writes the invitation naturally in the user's language: ask what video they want next and introduce existing templates, video-link recreation and creation from their requirements. Wording follows the conversation rather than a fixed script. Continue an already-known next request instead of asking again; otherwise wait for the user's choice. Invite only after the first successful experience delivery, not on follow-up edits, repeated exports or export failure. The [first-run defaults](../skills/motion-production/references/templates.md#first-run-experience-defaults) define delivery exceptions.+- 在 Codex 右侧打开 openmotion 可编辑工程,检查正确载入并可播放。+- 右侧打开的工程就是这次体验的结果,不导出 MP4;用户要视频文件时再导出。+- On success, the final reply contains **one completion sentence, then one contextual next-step invitation**, with the editable project kept open on the right. Use plain Markdown; screenshots and verification evidence stay in local records. MP4s, editor screenshots, ZIPs, duplicate project links, checklists and HTML wrappers are omitted unless requested.+- The LLM writes the invitation naturally in the user's language: ask what video they want next and introduce existing templates, video-link recreation and creation from their requirements. Wording follows the conversation rather than a fixed script. Continue an already-known next request instead of asking again; otherwise wait for the user's choice. Invite only after the first successful experience delivery, not on follow-up edits, exports or a failed experience. The [first-run defaults](../skills/motion-production/references/templates.md#first-run-experience-defaults) define delivery exceptions.-右侧页面打开依赖宿主的浏览器/面板能力。没有该能力时仍交付 MP4 和实际工程链接,明确说明页面未自动打开,不能声称完整的桌面体验已通过。导出失败时保留工程并说明具体原因,不把预览或任务排队当作最终成片。+右侧页面打开依赖宿主的浏览器/面板能力。没有该能力时提供实际工程链接,明确说明页面未自动打开,不能声称完整的桌面体验已通过。工程创建或载入失败时说明具体原因,不发出完成语和邀请。此默认规则只适用于用户接受安装后的首次体验邀请;用户提出自己的视频需求时,按其明确范围执行。diff --git a/scripts/install-motion.command b/scripts/install-motion.commandindex d484e980..733382ff 100644--- a/scripts/install-motion.command+++ b/scripts/install-motion.command@@ -46,12 +46,12 @@ OpenDesign(Motion) 已安装。MCP 连接预检通过。安装后引导(Codex / Agent):请在当前对话简要介绍 OpenDesign(Motion) 支持产品宣传视频、动态图表与流程动画、模板和可编辑预览、MP4 导出。-然后主动询问用户:“要现在体验一个无需准备素材的 20 秒视频吗?我会提供 MP4,并打开可编辑工程。”+然后主动询问用户:“要现在体验一个无需准备素材的 20 秒视频吗?我会在右侧打开一个可编辑工程。”停下来等待用户选择;用户明确只要安装或暂不体验时,尊重该选择。用户回复“体验”或明确接受本次邀请,即确认使用内置 Product Promo(product-promo):沿用示例文字、图形和动画,创建独立的 20 秒可编辑工程,保留原有工程;同一次体验已创建则复用。-不再追问素材、品牌、风格或模板。进入 motion-template-to-video 的首次体验默认路径,在 Codex 右侧打开工作室的可编辑工程,检查载入与播放,并导出 MP4。-Acceptance authorizes exporting the example. After export and file/playback checks succeed, follow the first-run delivery rules in skills/motion-production/references/templates.md: one completion sentence, the playable MP4, then one contextual next-step invitation; keep the editable project open on the right. Use plain Markdown and retain screenshots/check evidence locally, with no extra editor screenshot, ZIP, duplicate project link, checklist or HTML wrapper unless requested.-Generate the next-step sentence naturally in the user's language, asking what video they want next and offering existing templates, video-link recreation and creation from their requirements. Adapt it to the conversation rather than quoting fixed copy. If the next request is already known, continue it instead of asking again; otherwise wait for a choice. Invite only after the first successful experience delivery, not on follow-up edits, repeated exports or export failure.-宿主无浏览器/面板能力时仍提供 MP4 与实际工程链接,并说明页面未自动打开;导出失败时保留工程并说明原因,不以预览或排队状态冒充成片。+不再追问素材、品牌、风格或模板。进入 motion-template-to-video 的首次体验默认路径,在 Codex 右侧打开工作室的可编辑工程,检查载入与播放;右侧打开的工程就是这次的结果,用户没有要求时不导出 MP4。+After the editor check succeeds, follow the first-run delivery rules in skills/motion-production/references/templates.md: one completion sentence, then one contextual next-step invitation; keep the editable project open on the right. Use plain Markdown and retain screenshots/check evidence locally, with no MP4, extra editor screenshot, ZIP, duplicate project link, checklist or HTML wrapper unless requested.+Generate the next-step sentence naturally in the user's language, asking what video they want next and offering existing templates, video-link recreation and creation from their requirements. Adapt it to the conversation rather than quoting fixed copy. If the next request is already known, continue it instead of asking again; otherwise wait for a choice. Invite only after the first successful experience delivery, not on follow-up edits, exports or a failed experience.+宿主无浏览器/面板能力时提供实际工程链接,并说明页面未自动打开;工程创建或载入失败时说明原因,不发出完成语和邀请。先在当前对话完成介绍与邀请。若新插件工具尚未加载,在用户同意体验后再提供新会话接续方式。MOTION_ONBOARDINGdiff --git a/skills/motion-production/SKILL.md b/skills/motion-production/SKILL.mdindex d37ba81b..b8509a6b 100644--- a/skills/motion-production/SKILL.md+++ b/skills/motion-production/SKILL.md@@ -37,7 +37,7 @@ Agent 根据本轮意图选择入口,专业任务可直接进入对应 Skill| 明确要求把参考视频重建为可复用模板文件夹或 ZIP | [motion-video-to-template](../motion-video-to-template/SKILL.md) || 根据实际视频重建本次作品;只有成片文件/链接、没有对应可编辑工程时,即使只改几处字 | [motion-recreate](../motion-recreate/SKILL.md),沿用已有复刻方法与数字测量 || 参考视频只提供风格灵感 | motion-director |-| 接受安装后的首次体验邀请 | motion-template-to-video;沿用已确认的 `product-promo` 示例、20 秒、独立工程、右侧预览及最终 MP4 |+| 接受安装后的首次体验邀请 | motion-template-to-video;沿用已确认的 `product-promo` 示例、20 秒、独立工程及右侧预览 |模糊需求结合用户目标和已有素材判断;只补充影响选路或真实性的关键缺口。链接与文件是输入形式,不自动等于复刻。模板来源与精确 ID 按 [模板能力说明](references/templates.md) 核对;原创新片需要补齐简报时使用 [需求与记录](references/intake.md)。diff --git a/skills/motion-production/references/templates.md b/skills/motion-production/references/templates.mdindex cce5e250..26a06e38 100644--- a/skills/motion-production/references/templates.md+++ b/skills/motion-production/references/templates.md@@ -12,17 +12,17 @@ For a requested starter draft, selected template defaults and graphics are usabl## First-run experience defaults-This contract applies only when the conversation contains the installation experience invitation and the user replies “体验” or explicitly accepts it. Acceptance selects builtin `product-promo`, its unchanged sample text/graphics/animation and native 20-second specification, a separate editable project, the right-side editable preview and a completed MP4. It authorizes exporting this example. Do not ask again for assets, brand, style, template choice or export confirmation; do not start original creative intake or redesign the example. An explicit user request to stop at preview overrides this default.+This contract applies only when the conversation contains the installation experience invitation and the user replies “体验” or explicitly accepts it. Acceptance selects builtin `product-promo`, its unchanged sample text/graphics/animation and native 20-second specification, a separate editable project and the right-side editable preview. The project open in the editor is the result; the experience does not export an MP4 unless the user asks for one. Do not ask again for assets, brand, style or template choice; do not start original creative intake or redesign the example.-Reuse the existing first-run project if already created. Otherwise call `motion_create_project` once with projectType=template, templateId=product-promo, stable requestId, title and the confirmed requirements. Record the returned projectId; creation alone does not open Studio or finish the film. Call `motion_open_preview({projectId})` and use the host browser/panel to open its exact previewUrl on the right; verify the selected editor loaded and the template plays. Read current project/version after GUI saves before export.+Reuse the existing first-run project if already created. Otherwise call `motion_create_project` once with projectType=template, templateId=product-promo, stable requestId, title and the confirmed requirements. Record the returned projectId; creation alone does not open Studio or finish the film. Call `motion_open_preview({projectId})` and use the host browser/panel to open its exact previewUrl on the right; verify the selected editor loaded and the template plays.If the user requested export, read [verification](verification.md), reuse an applicable existing job or call `motion_export_request` once with the current projectId/versionId/revision and stable requestId. Poll `motion_get_project` with exportJobId; technical verification is automatic, actual playback is separate.-For a successful first-run delivery, keep the editable OpenMotion page open on the right. The final reply contains, in order, one concise completion sentence, the actual MP4 presented with the host's supported playable media format, and the contextual next-step invitation below. Use plain Markdown for text and media. Keep screenshots and verification evidence in local records; omit editor screenshots, ZIPs, duplicate project links and checklists from this reply unless the user requested them. HTML wrappers such as `<details>` and `<summary>` are not part of the reply format.+For a successful first-run delivery, keep the editable OpenMotion page open on the right. The final reply contains, in order, one concise completion sentence and the contextual next-step invitation below. Use plain Markdown. Keep screenshots and verification evidence in local records; omit MP4s, editor screenshots, ZIPs, duplicate project links and checklists from this reply unless the user requested them. HTML wrappers such as `<details>` and `<summary>` are not part of the reply format.-After the MP4, generate one brief, natural sentence in the user's language asking what video they want to make next and introducing three ways to start: choose an existing template, send a video link to recreate, or describe their requirements for an original video. Adapt the wording to the conversation; this is a behavior instruction, not a fixed script. If the user already supplied their next request, acknowledge or continue that request instead of asking again. Otherwise wait for their choice before starting another video. This invitation belongs only to the first successful experience delivery, not follow-up edits or repeated exports.+After the completion sentence, generate one brief, natural sentence in the user's language asking what video they want to make next and introducing three ways to start: choose an existing template, send a video link to recreate, or describe their requirements for an original video. Adapt the wording to the conversation; this is a behavior instruction, not a fixed script. If the user already supplied their next request, acknowledge or continue that request instead of asking again. Otherwise wait for their choice before starting another video. This invitation belongs only to the first successful experience delivery, not follow-up edits or exports.-If a host lacks browser/panel capability, provide the real MP4 and project URL and briefly state that the page could not be opened automatically. Report any material delivery limitation before inviting new work. If export fails, preserve the editable project and report the concrete failure without a success statement or next-step invitation. If tools are unavailable, carry this selected template/defaults/MP4-plus-project scope into a continuation without asking the user to choose again.+If a host lacks browser/panel capability, provide the project URL and briefly state that the page could not be opened automatically. Report any material delivery limitation before inviting new work. If the project cannot be created or does not load and play, or a requested export fails, preserve the editable project and report the concrete failure without a success statement or next-step invitation. If tools are unavailable, carry this selected template/defaults/project scope into a continuation without asking the user to choose again.The three recipes below help adapt the story. They do not identify installed presets or impose a fixed scene count. Implement the chosen outline as native compositions with source files or Studio, following the pinned authoring guide.diff --git a/skills/motion-template-to-video/SKILL.md b/skills/motion-template-to-video/SKILL.mdindex 7d7c909c..7b055a64 100644--- a/skills/motion-template-to-video/SKILL.md+++ b/skills/motion-template-to-video/SKILL.md@@ -11,7 +11,7 @@ Turn the selected editable template into the requested draft, editable project oChanges to existing content use the [shared edit workflow](../motion-production/references/edit.md), including required related changes and preserved content. Missing instructions and target sources must finish returning to the model before a later call applies a template, imports, writes or exports. Entering this Skill again does not create another copy, apply the template again or repeat a completed export.-The accepted installation experience follows [first-run defaults](../motion-production/references/templates.md#first-run-experience-defaults): builtin `product-promo`, unchanged sample content, one separate 20-second project, the right-side editable preview and a completed MP4 are already selected. Resume an existing experience project; otherwise create it once. This invitation explicitly includes opening the editor and delivering the MP4, with no new template/assets/export questionnaire.+The accepted installation experience follows [first-run defaults](../motion-production/references/templates.md#first-run-experience-defaults): builtin `product-promo`, unchanged sample content, one separate 20-second project and the right-side editable preview are already selected; it exports no MP4 unless the user asks. Resume an existing experience project; otherwise create it once. This invitation explicitly includes opening the editor, with no new template/assets questionnaire.## Open the supplied project