Skip to content

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.

docs(motion): streamline first-run delivery and contextual follow-up

金梅洪9731aa37f8e8
diff --git a/docs/product/architecture.md b/docs/product/architecture.md
index 5f219e54..d769235e 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 不再问素材/模板/导出确认,实际打开宿主面板,等待并验证成片,最终回复交付 MP4 与简短说明。宿主没有面板能力时明确提供链接作为降级,不能冒称已打开;实际行为按客户端验证。
+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. 宿主没有面板能力时明确提供链接作为降级,不能冒称已打开;实际行为按客户端验证。
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, confirm the same project is visible before writing, reopen a closed tab as needed, reuse an existing tab and inspect the latest visible content after saving; explicit background requests suppress opening/focusing the editor. 旧 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.md
index 5d412d53..5db4cbf7 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -91,7 +91,8 @@ openmotion 围绕已有 Agent 用户的产品演示、参考复刻、动态图
- 创建独立可编辑工程,保留原有工程;同一次体验已经创建工程时直接续用,避免重复创建。
- 在 Codex 右侧打开 openmotion 可编辑工程,检查正确载入并可播放;让用户可以在等待导出时继续查看工程。
- 接受首次体验同时授权导出该示例的 MP4。读取当前 revision,导出并等待完成,检查实际文件与播放;复用本次已完成的导出,不重复排队。
-- 最终回复包含**简短说明与可直接播放/下载的 MP4**,同时保持右侧工程页面可用。工程 ZIP 和截图只作补充,不能代替 MP4。
+- 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.
右侧页面打开依赖宿主的浏览器/面板能力。没有该能力时仍交付 MP4 和实际工程链接,明确说明页面未自动打开,不能声称完整的桌面体验已通过。导出失败时保留工程并说明具体原因,不把预览或任务排队当作最终成片。
diff --git a/scripts/install-motion.command b/scripts/install-motion.command
index 4a786c56..d484e980 100644
--- a/scripts/install-motion.command
+++ b/scripts/install-motion.command
@@ -50,7 +50,8 @@ OpenDesign(Motion) 已安装。MCP 连接预检通过。
停下来等待用户选择;用户明确只要安装或暂不体验时,尊重该选择。
用户回复“体验”或明确接受本次邀请,即确认使用内置 Product Promo(product-promo):沿用示例文字、图形和动画,创建独立的 20 秒可编辑工程,保留原有工程;同一次体验已创建则复用。
不再追问素材、品牌、风格或模板。进入 motion-template-to-video 的首次体验默认路径,在 Codex 右侧打开工作室的可编辑工程,检查载入与播放,并导出 MP4。
-接受本次邀请即授权示例导出。等待导出完成并检查实际文件后,最终回复给出简短说明与可播放/下载的 MP4,同时保持右侧工程可用;ZIP/截图仅作补充。
+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_ONBOARDING
diff --git a/skills/motion-production/references/templates.md b/skills/motion-production/references/templates.md
index 7ecc48e0..cce5e250 100644
--- a/skills/motion-production/references/templates.md
+++ b/skills/motion-production/references/templates.md
@@ -18,7 +18,11 @@ Reuse the existing first-run project if already created. Otherwise call `motion_
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.
-The final assistant reply contains a short result statement and a playable/downloadable MP4, with the editable OpenMotion page already open on the right. ZIPs and screenshots are supplementary. If a host lacks browser/panel capability, provide the real MP4 and project URL and explicitly state that the page could not be opened automatically. If export fails, preserve the editable project and report the concrete failure; do not claim final delivery. If tools are unavailable, carry this selected template/defaults/MP4-plus-project scope into a continuation without asking the user to choose again.
+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.
+
+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.
+
+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.
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.md
index a7d4f20a..7d7c909c 100644
--- a/skills/motion-template-to-video/SKILL.md
+++ b/skills/motion-template-to-video/SKILL.md
@@ -47,7 +47,7 @@ Once this turn's requested HTML is ready, complete the [editable preview handoff
For an unchanged request delivered from `preview.mp4`, only probe that the copied file exists and decodes; do not compare it with anything. If you had to render because there was no preview, decode/probe the output and inspect representative frames. For an edited request, decode/probe the actual exported MP4 and inspect representative frames.
-For an edited request, inspect the requested content, its related layout/timing and unchanged sections against the template's `preview.mp4`. Verify that supplied replacement assets are actually used and old brand content does not remain at another relevant appearance. Record passed, failed and unrun checks separately in the copy's `TEMPLATE.md`. Save output files in the current workspace and link them by absolute local path, with only the plain path in each link target. For the editable Studio page, use the exact previewUrl from the handoff. Keep the reply short and in the user's words: the MP4, the edited project when applicable, one or two sentences on what changed, and only the limitations the user would notice. For an unchanged request, the MP4 and one sentence are enough. Humans decide visual acceptance; do not give a subjective pass/fail verdict. Do not claim independent-agent verification unless a separate session actually performed it.
+For an edited request, inspect the requested content, its related layout/timing and unchanged sections against the template's `preview.mp4`. Verify that supplied replacement assets are actually used and old brand content does not remain at another relevant appearance. Record passed, failed and unrun checks separately in the copy's `TEMPLATE.md`. Save output files in the current workspace and link them by absolute local path, with only the plain path in each link target. For the editable Studio page, use the exact previewUrl from the handoff. Keep the reply short and in the user's words: the MP4, the edited project when applicable, one or two sentences on what changed, and only the limitations the user would notice. For an unchanged request, use one completion sentence and the playable MP4; the editable page remains open in the host. An accepted first-run experience follows the [first-run delivery and contextual invitation](../motion-production/references/templates.md#first-run-experience-defaults), including its limited exceptions, instead of adding project screenshots or technical evidence. Humans decide visual acceptance; do not give a subjective pass/fail verdict. Do not claim independent-agent verification unless a separate session actually performed it.
For edited or freshly rendered requests, apply the relevant [review standards](../motion-director/references/motion-review.md); changed multi-scene relationships use [production decisions](../motion-director/references/production-decisions.md), and sound changes load the shared context's sound references. These standards do not restart original creative intake or impose a new style on the template. For a fresh managed export, follow [verification](../motion-production/references/verification.md) using the completed job/revision; reuse a matching existing job. Copied unchanged previews use only the existence/decode branch above and create no export job. Stop at the user's requested delivery stage; a draft or review-only request does not automatically render.