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): make the editor the deliverable for original films

Awek-0152062ce26b0ce
diff --git a/docs/product/architecture.md b/docs/product/architecture.md
index e56dbafe..7a37f8be 100644
--- a/docs/product/architecture.md
+++ b/docs/product/architecture.md
@@ -44,7 +44,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 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 仅留内部兼容。
+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 project open in the editor is the deliverable: exports serve the Agent's checks, and MP4 files are handed over only when the user asks for them (motion-video-to-template still delivers its template ZIP). 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 核对保持项、相邻关系与后续延续。
6. 完成画面、文案、声音检查后,按用户要求导出固定 revision 的快照,等待真实产物并验证。
@@ -135,7 +135,7 @@ flowchart LR
Native <--> Workspace
Workspace --> Snapshot[固定版本快照]
Snapshot --> Render[lint / render]
- Render --> Output[MP4 与工程交付]
+ Render --> Output[MP4:自检,用户要求时交付]
Output --> Review[技术验证与实际视听检查]
```
diff --git a/skills/motion-director/SKILL.md b/skills/motion-director/SKILL.md
index c551379b..15e99ad8 100644
--- a/skills/motion-director/SKILL.md
+++ b/skills/motion-director/SKILL.md
@@ -103,7 +103,7 @@ Once this turn's requested HTML output is saved, complete the [editable preview
对用户点名的质量问题,审片记录必须影响下一步:仍存在就修正相应创作决定并复验,或如实报告未达标及具体限制。技术错误修复与创作修正分开记录,不能因字号/布局检查用完精力而把主要表达问题标为完成。已有规则反复失效时,查实现表示与实际审片证据,优先调整共享状态、时间结构或材料策略,不机械追加同义规则。
-按用户范围交付预览或视频、可编辑工程,以及必要的脚本与已知限制。标清占位素材、概念演示和未验证内容。渲染成功不是内容验收,静态截图不能证明运动流畅。
+编辑器中打开的可编辑工程就是交付物,“做一支片”“make a film/video”这类请求也一样。只有用户明确要 MP4、视频文件、下载或导出时,才复制并给出 MP4 路径;否则导出只用于自检,不复制、链接或附上 MP4 等文件。按用户范围补充必要的脚本与已知限制。标清占位素材、概念演示和未验证内容。渲染成功不是内容验收,静态截图不能证明运动流畅。
## 防止模板塑造所有作品
diff --git a/skills/motion-production/SKILL.md b/skills/motion-production/SKILL.md
index 70606500..0544ea29 100644
--- a/skills/motion-production/SKILL.md
+++ b/skills/motion-production/SKILL.md
@@ -23,7 +23,7 @@ Agent 根据本轮意图选择入口,专业任务可直接进入对应 Skill
2. Existing-project content edits apply the [continuing-edit preview rules](references/native.md#continuing-edits) before writing and after saving, including scoped engineering work. Preserve the current chat by default; queue its latest preview while inactive and inspect it on return. Only an explicit show-now request permits switching back for this turn. 操作工程前读取 [运行规范](references/production.md);编写原生内容前另读 [Native authoring](references/native.md) 及工具返回的固定版本引擎指南。确认 projectId、最新 revision 与 currentVersionId,复用已完成操作。
3. 按共享上下文的依赖清单补齐受影响的质量规范。换现成音乐、调音量也需核对声画锚点与原有 SFX;画面锁定时保持视觉内容。补读结果先返回模型,后续调用再执行依赖操作。
4. 检查受影响区间、接点和保持项。需要新渲染的导出或成片交付读取 [验证](references/verification.md),针对已审查 revision/versionId 导出,已有适用任务先查询并复用;模板出片按专业入口在编辑器中核验,需要导出时检查实际 MP4。技术通过与创作品质、正常播放及试听分别记录。
-5. 停在用户要求的方案、预览、工程或成片阶段。交付实际结果、检查与必要限制。
+5. 停在用户要求的方案、预览、工程或成片阶段。交付实际结果、检查与必要限制。编辑器中打开的工程就是交付物,只有用户明确要 MP4、视频文件、下载或导出时才附 MP4。
## 专业导航与旧调用兼容