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: simplify the installation success reply

罗高b3464a698d3a
diff --git a/docs/install.md b/docs/install.md
index 011603d8..35e69e84 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -9,7 +9,7 @@ If you are reading this file in the source repository and see `{{...}}`, it is a
1. Collect OS/CPU, Node.js/npm versions and the current Agent identity together, using the host's supplied context where available. Node.js 22.18+ with npm and the Agent must already be installed. Supported native targets: {{TARGETS}}. If a macOS target has no declared minimum version, proceed with setup and native executable checks; do not infer a minimum from the build/test machine's OS version. Do not claim support for another target from package-download success.
2. Select the current host explicitly: `codex` (Codex), `claude` (Claude Code), `deepseek` (DeepSeek Harness) or `workbuddy` (WorkBuddy). An explicit user selection takes precedence. Do not infer the current host from which CLIs happen to be installed. Ask only when the current host or required profile cannot be established. Configure only that host; preserve projects, credentials and unrelated MCP/Skills settings.
3. For a test candidate, use a separate host profile, application home, project data and Skills directory. Keep those paths and reuse them for prepare and future reconnects. The [platform installation recipes]({{DETAILS_URL}}) describe the actual supported options. Do not run a test candidate into the user's daily profile by default.
-4. Choose exactly one setup command below, applying the test isolation paths first when required. Setup starts checked video-component downloads in the background. Do not wait for prepare to connect MCP, create/edit projects or open ordinary preview. Studio shows preparation status and retry; media import, automated capture and export require their respective components. Compatible phase-one updates can keep existing connections; reconnect closed or incompatible transports. When the current host can discover the eleven public Tools and five Skills, verify the version/environment and make an actual `motion_get_project` call. If the current chat has not loaded them, report that limitation; registration alone does not prove loading. Do not postpone the installation reply or invitation until a new chat or the first MCP call.
+4. Choose exactly one setup command below, applying the test isolation paths first when required. Setup starts checked video-component downloads in the background. Do not wait for prepare to connect MCP, create/edit projects or open ordinary preview. Studio shows preparation status and retry; media import, automated capture and export require their respective components. Compatible phase-one updates can keep existing connections; reconnect closed or incompatible transports. When the current host can discover the eleven public Tools and five Skills, verify the version/environment and make an actual `motion_get_project` call. Keep verification details internal; registration alone does not prove current-chat loading. Do not postpone the installation reply or invitation until a new chat or the first MCP call. Follow the recovery rule below only when an actual tool call or requested operation is blocked.
5. On successful setup, follow the installation-success reply below in this same conversation, using the returned `onboarding.catalog` summaries. Installation does not authorize creating a project, downloading template assets, rendering or calling a paid model. Report a failed installation honestly; do not issue a success invitation until it is fixed.
For npm network failures, automatically try `https://registry.npmjs.org` then `https://registry.npmmirror.com`, at most once per registry, counting the initial failed attempt. Respect an explicitly selected registry and host policy. Set `npm_config_registry` and `npm_config_fetch_retries=0` only for that attempt, including setup's npm child process. Keep the exact version; verify any mirrored tgz against the matching immutable guide's SHA256 before executing it. If both fail, follow [npm download recovery]({{DETAILS_URL}}#npm-download-failures) for network checks and a terminal handoff. Permission or checksum failures stop immediately. A local tgz still needs npm access for setup's production dependencies.
@@ -29,21 +29,20 @@ Select the invitation mode in this order:
- Fewer than three confirmed candidates: use one. Never randomly select a few-shot or mode.
Reply structure, in the user's language:
-1. Brief actual installation result. Distinguish registered configuration, independent probe and current-chat verification. Never claim the current chat is connected just because setup succeeded.
-2. One concise capability/selling sentence. Chinese: “OpenMotion 开源免费,让你与熟悉的 Agent 协作,从模板、参考视频或一个灵感出发,打造惊艳的动效视频。” Adapt naturally for other languages.
-3. One selected template with its appeal, or three numbered candidates with concise differences and confirmed durations where available. Keep each ID mapped to its displayed number/name in this conversation.
-4. A yes/no question for one template, or a number/name choice for three, with an option to defer. Then stop and wait.
+1. Say only that installation is complete. Chinese: “OpenMotion 已安装完成。” Adapt naturally for other languages. Omit version/environment, configuration paths, MCP/Skill/tool counts, probe or connection results and background video-component preparation. Do not add a separate capability/selling paragraph or claim that the current chat is connected just because setup succeeded.
+2. Directly invite the user to try one selected template with its appeal, or three numbered candidates with concise differences and confirmed durations where available. Keep each ID mapped to its displayed number/name in this conversation.
+3. A yes/no question for one template, or a number/name choice for three, with an option to defer. Then stop and wait.
-After acceptance, use motion-template-to-video with the exact offered template ID and unchanged sample content. A single-template “yes/体验” accepts that template; a three-candidate “yes” is ambiguous, so ask which one. Do not reshuffle, re-query just to change the offer, or silently substitute a failed template. Create one independent project, preserving existing work; reuse the same experience project on continuation. Do not repeat optional material/brand/style questions. Open the actual editable project and check loading/playback when the host supports it; otherwise give its real link and state the limitation. Export only on request. A refusal/deferment stops the experience. If tools are not yet loaded, first deliver this invitation; after consent carry the chosen ID into the host's supported refresh/reconnect/continuation path. No invitation-state service or “invitation sent/seen” telemetry is implied; only the host controls its actual reply.
+Do not ask the user to refresh/reconnect, restart the host or open a new chat by default. Only when an actual tool call or requested operation is blocked, attempt supported recovery within the current chat when available. If user action is still necessary, briefly explain the specific blocker and the minimum supported next step. Mention video-component preparation only when it blocks the requested operation. Preserve the accepted template choice and existing work across recovery.
+
+After acceptance, use motion-template-to-video with the exact offered template ID and unchanged sample content. A single-template “yes/体验” accepts that template; a three-candidate “yes” is ambiguous, so ask which one. Do not reshuffle, re-query just to change the offer, or silently substitute a failed template. Create one independent project, preserving existing work; reuse the same experience project on continuation. Do not repeat optional material/brand/style questions. Open the actual editable project and check loading/playback when the host supports it; otherwise give its real link and state the limitation. Export only on request. A refusal/deferment stops the experience. If creation is blocked by unavailable tools, follow the recovery rule above. No invitation-state service or “invitation sent/seen” telemetry is implied; only the host controls its actual reply.
### Few-shot: single template — preference without comparison
Example context: setup succeeded, current-chat MCP not yet loaded, the user mentioned data/metrics; `nyt-graph` is a confirmed candidate.
```text
-OpenMotion 已安装并完成配置,当前会话还需要刷新工具连接。
-
-OpenMotion 开源免费,让你与熟悉的 Agent 协作,从模板、参考视频或一个灵感出发,打造惊艳的动效视频。
+OpenMotion 已安装完成。
你刚提到数据展示,可以先试试 NYT Graph:15 秒报刊风动态图表,用数据、标注和图形节奏讲清重点,无需准备素材。
@@ -55,9 +54,7 @@ OpenMotion 开源免费,让你与熟悉的 Agent 协作,从模板、参考
Example context: the user explicitly asked to see options; setup and a real current-chat read succeeded; all three named candidates are confirmed.
```text
-OpenMotion 已安装,当前会话已验证连接可用。
-
-OpenMotion 开源免费,让你与熟悉的 Agent 协作,从模板、参考视频或一个灵感出发,打造惊艳的动效视频。
+OpenMotion 已安装完成。
可以从这三个无需准备素材的模板里选一个:
1. Product Promo|20 秒,多场景动效与字幕,适合感受产品宣传片的节奏。
diff --git a/docs/product/architecture.md b/docs/product/architecture.md
index c4bbff59..427d2f7e 100644
--- a/docs/product/architecture.md
+++ b/docs/product/architecture.md
@@ -128,7 +128,7 @@ README 参考 OpenDesign 的产品导览和 HTML Anything 的贡献、来源表
## 核心用户流程
1. The user creates a blank project or opens an existing one from the sidebar, asks an external Agent to create a project, or chooses a template in the editor. Bundled templates create independent project copies; external references require Agent reconstruction.
-2. The Agent uses the existing MCP integration and verifies the selected project, revision and workflow. Integration setup remains available outside the MVP editor. Successful Agent-led installation returns the canonical reply rules from `docs/install.md` plus bounded real catalog summaries in the setup result, without waiting for the first MCP use. The Agent defaults to one eligible template; explicit comparison requests can receive three confirmed candidates. Acceptance preserves that exact choice and creates one independent editable project; refusal stops. Registration does not prove active-chat loading or that an invitation was actually displayed. No invitation telemetry/state service is introduced. Follow the [first-run defaults](../../skills/motion-production/references/templates.md#first-run-experience-defaults) for creation and delivery.
+2. The Agent uses the existing MCP integration and verifies the selected project, revision and workflow. Integration setup remains available outside the MVP editor. Successful Agent-led installation returns the canonical reply rules from `docs/install.md` plus bounded real catalog summaries in the setup result, without waiting for the first MCP use. The user-facing reply only confirms installation and invites an experience; technical verification stays internal, and recovery instructions appear only when an actual operation is blocked and user action is necessary. The Agent defaults to one eligible template; explicit comparison requests can receive three confirmed candidates. Acceptance preserves that exact choice and creates one independent editable project; refusal stops. Registration does not prove active-chat loading or that an invitation was actually displayed. No invitation telemetry/state service is introduced. Follow the [first-run defaults](../../skills/motion-production/references/templates.md#first-run-experience-defaults) for creation and delivery.
3. `motion_open_preview({projectId})` opens the project directly. Project switching waits for pending saves and reloads the document to release the previous edit session. Opening a bookmark warms only its scoped native context without switching other editor tabs. Rendering and write conflicts continue to block unsafe switches. Original creation, reference recreation and template production automatically open the saved project before delivery; the open editor is the deliverable, and video files are handed over only when requested (video-to-template still delivers its template ZIP). Continued edits and restores return a project/revision/version-bound previewHandoff. 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. The shared [editable preview handoff](../../skills/motion-production/references/native.md#editable-preview-handoff) defines readiness, host checks and capability limitations.
4. Agent 根据本轮目标直接选择 Skill:motion-director 负责原创、局部/整体叙事动作声音重新设计和创作审片;motion-template-to-video 负责已有模板出片;motion-recreate 负责参考作品重建(已接入实际流程、独立参考与测量脚本);motion-video-to-template 负责可复用模板生产;motion-production 承接既定决定下的工程操作、预览、技术检查、排错和导出。共享规则同源引用,已有 production/start 保留导航,无需前置总路由。项目来源与画面锁定不固定入口;保持项和已完成操作继续有效。
5. The Agent imports or generates media through the existing backend. In the editor, the user imports assets, edits text/solid color/opacity, previews, and edits clips on the timeline. Element, clip, time-range and official animation-library Ask Agent entry points are hidden in the MVP; users can continue requesting edits through their external Agent. Text controls include headings with explicit line breaks and preserve those breaks when edited. The MVP omits the layer-count heading and Add text field controls. Unselected off-canvas elements have no dashed markers in the MVP preview; selecting an element, including from Layers, retains its selection boundary. Text selections omit the separate Style group and background-fill control; element opacity remains in Text. For opacity-animated elements, the MVP opacity control saves an independent CSS filter multiplier, retaining the authored fade and existing static filters rather than writing over the animated opacity channel. The multiplier is part of project source, so preview and export use the same value. Other element types retain their Style controls. Generation, image replacement, advanced style/animation controls, code and inspector Layout settings are hidden without rewriting existing source content or removing Agent capabilities.
diff --git a/docs/templates/candidate-install.md b/docs/templates/candidate-install.md
index 6ec66377..d59aae9f 100644
--- a/docs/templates/candidate-install.md
+++ b/docs/templates/candidate-install.md
@@ -20,9 +20,9 @@ This is a **local candidate installation guide**. It installs the complete `{{TG
```
Replace `HOST` with `codex`, `claude`, `deepseek` or `workbuddy`. Carry the explicit `--home`, `--data-dir`, `--skills-dir` and host-specific options from the platform recipe. Setup starts checked video-component downloads in the background. Do not run or wait for prepare to connect MCP, create/edit projects or open ordinary preview. Keep using this local package; no sidecar application/manifest download or source build is required.
-4. Follow this host's discovery/reload action. Verify the actual application version, **{{TEMPLATE_ENVIRONMENT}} template environment**, eleven MCP Tools, resources and five Skills, including a `motion_get_project` call against the isolated data directory. Registration or installation success alone is not host loading or creative acceptance.
+4. Internally verify available host discovery, the actual application version, **{{TEMPLATE_ENVIRONMENT}} template environment**, eleven MCP Tools, resources and five Skills, including a `motion_get_project` call against the isolated data directory when available. Registration or installation success alone is not host loading or creative acceptance. Follow the installation-success reply rules returned by setup: say only that installation is complete, then invite an experience. Do not ask for refresh/reconnection, restart or a new chat by default; attempt supported recovery only when an actual tool call or requested operation is blocked, asking for user action only when necessary.
-Report installation/host loading and video-component readiness separately. Installation alone does not authorize creating a video or exporting an MP4.
+Keep installation/host loading and video-component readiness as separate internal evidence; include those details only in an explicitly requested acceptance report or when needed to resolve a blocked operation. Installation alone does not authorize creating a video or exporting an MP4.
## Video preparation and requested acceptance
diff --git a/docs/usage.md b/docs/usage.md
index bfc41ccf..7b65f392 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -75,7 +75,7 @@ openmotion 围绕已有 Agent 用户的产品演示、参考复刻、动态图
### 安装完成后的引导(Codex / Agent)
-所有 Agent 安装入口共用 [安装成功后的回复规则与示例](install.md#installation-success-reply)。安装器当轮输出规则和真实模板摘要,Agent 按上下文选择模板并组织邀请:默认单模板,用户明确要求挑选/比较且有三份合适模板时提供三候选。配置完成不代表当前会话已加载 MCP;如实说明后,仍在本轮邀请,不等首次调用工具。
+All Agent installation entries share the [installation-success reply rules and examples](install.md#installation-success-reply). After successful setup, say only that installation is complete, then invite the user to try a real template: one by default, or three confirmed candidates for an explicit comparison request. Keep technical verification internal. Do not ask for refresh/reconnection, restart or a new chat unless an actual tool call or requested operation is blocked and user action is necessary.
### 首次体验默认规则
diff --git a/tests/bootstrap.test.ts b/tests/bootstrap.test.ts
index dad71cb5..1f7cd37a 100644
--- a/tests/bootstrap.test.ts
+++ b/tests/bootstrap.test.ts
@@ -51,7 +51,7 @@ test('remote entry point builds a fresh checkout before registering and checking
assert.match(result.stdout, /OpenMotion registration and independent MCP preflight succeeded/);
const onboarding = JSON.parse(result.stdout.slice(result.stdout.indexOf('\n{') + 1));
assert.equal(onboarding.hostSessionVerified, false);
- assert.match(onboarding.instructions, /OpenMotion 开源免费/);
+ assert.match(onboarding.instructions, /OpenMotion 已安装完成。/);
assert.equal(onboarding.catalog.source, 'bundled');
});
});
@@ -132,7 +132,7 @@ test('the onboarding entry runs through a symlinked checkout path', async () =>
assert.equal(result.status, 0, result.stderr);
const onboarding = JSON.parse(result.stdout);
assert.equal(onboarding.hostSessionVerified, false);
- assert.match(onboarding.instructions, /OpenMotion 开源免费/);
+ assert.match(onboarding.instructions, /OpenMotion 已安装完成。/);
assert.equal(onboarding.catalog.source, 'bundled');
});
});
diff --git a/tests/npm-installer.test.ts b/tests/npm-installer.test.ts
index 457ca053..ad8d8461 100644
--- a/tests/npm-installer.test.ts
+++ b/tests/npm-installer.test.ts
@@ -54,7 +54,13 @@ test('successful setup hands the current Agent an invitation before any MCP use,
const options = await setupFixture(t);
const installed = await setup(options);
assert.equal(installed.onboarding.hostSessionVerified, false);
- assert.match(installed.onboarding.instructions, /OpenMotion 开源免费/);
+ const examples = [...installed.onboarding.instructions.matchAll(/```text\n([\s\S]*?)```/g)].map(([, text]) => text);
+ assert.equal(examples.length, 2);
+ for (const example of examples) {
+ assert(example.startsWith('OpenMotion 已安装完成。\n\n'));
+ assert.doesNotMatch(example, /MCP|Skills?|prod|DEV|刷新|连接|新聊天|后台|开源免费/);
+ assert.match(example, /暂不体验/);
+ }
assert(Array.isArray(installed.onboarding.catalog.templates));
assert.equal('onboarding' in JSON.parse(await readFile(path.join(options.home, 'install.json'), 'utf8')), false);
});