Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs: remove Echo Pro product name, add SVS syntax highlighting
rponee56aa3f579f4
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.tsindex d5fa7692..962541a7 100644--- a/docs/.vitepress/config.ts+++ b/docs/.vitepress/config.ts@@ -1,4 +1,122 @@import { defineConfig } from "vitepress";+import type { ShikiTransformer } from "shiki";++function svmlSelectionHighlighter(): ShikiTransformer {+ return {+ name: "svml-selection-highlighter",+ span(node) {+ const text = node.children?.[0];+ if (!text || text.type !== "text") return;+ const v = text.value;+ const re = /(~?@\/?[A-Za-z][\w-]*[!~]?| \| )/g;+ const parts: Array<{ value: string; highlight: boolean }> = [];+ let last = 0;+ let m: RegExpExecArray | null;+ while ((m = re.exec(v)) !== null) {+ if (m[1].startsWith("@")) {+ const after = v[re.lastIndex];+ if (after === "/") continue;+ }+ if (m.index > last) parts.push({ value: v.slice(last, m.index), highlight: false });+ parts.push({ value: m[1], highlight: true });+ last = re.lastIndex;+ }+ if (parts.length === 0) return;+ if (last < v.length) parts.push({ value: v.slice(last), highlight: false });+ node.children = parts.map((p) =>+ p.highlight+ ? { type: "element", tagName: "span", properties: { class: "svml-selection" }, children: [{ type: "text", value: p.value }] }+ : { type: "text", value: p.value },+ );+ },+ };+}++const svsLanguage: Record<string, unknown> = {+ name: "svs",+ scopeName: "source.svs",+ patterns: [+ { include: "#processing-instruction" },+ { include: "#close-tag" },+ { include: "#open-tag" },+ { include: "#comment" },+ { include: "#recipe-block" },+ ],+ repository: {+ "processing-instruction": {+ begin: "<\\?",+ end: "\\?>",+ beginCaptures: { "0": { name: "punctuation.definition.tag.xml" } },+ endCaptures: { "0": { name: "punctuation.definition.tag.xml" } },+ name: "meta.tag.preprocessor.xml",+ patterns: [+ { match: "\\bsvml\\b", name: "entity.name.tag.xml" },+ { include: "#attribute" },+ ],+ },+ "open-tag": {+ begin: "(<)(sheet)\\b",+ beginCaptures: {+ "1": { name: "punctuation.definition.tag.xml" },+ "2": { name: "entity.name.tag.xml" },+ },+ end: ">",+ endCaptures: { "0": { name: "punctuation.definition.tag.xml" } },+ patterns: [{ include: "#attribute" }],+ },+ "close-tag": {+ match: "(</)(sheet)(>)",+ captures: {+ "1": { name: "punctuation.definition.tag.xml" },+ "2": { name: "entity.name.tag.xml" },+ "3": { name: "punctuation.definition.tag.xml" },+ },+ },+ attribute: {+ match: '([\\w-]+)(=)("[^"]*")',+ captures: {+ "1": { name: "entity.other.attribute-name.xml" },+ "2": { name: "punctuation.separator.key-value.xml" },+ "3": { name: "string.quoted.double.xml" },+ },+ },+ comment: {+ name: "comment.block.css",+ begin: "/\\*",+ end: "\\*/",+ },+ "recipe-block": {+ begin: "([a-z][\\w-]*)(\\.)(\\S+)\\s*(\\{)",+ beginCaptures: {+ "1": { name: "entity.name.tag.css" },+ "2": { name: "punctuation.accessor.css" },+ "3": { name: "entity.other.attribute-name.class.css" },+ "4": { name: "punctuation.section.block.begin.css" },+ },+ end: "\\}",+ endCaptures: { "0": { name: "punctuation.section.block.end.css" } },+ patterns: [{ include: "#comment" }, { include: "#property-declaration" }],+ },+ "property-declaration": {+ begin: "([a-z][\\w-]*)\\s*(:)",+ beginCaptures: {+ "1": { name: "support.type.property-name.css" },+ "2": { name: "punctuation.separator.key-value.css" },+ },+ end: ";",+ endCaptures: { "0": { name: "punctuation.terminator.rule.css" } },+ patterns: [{ include: "#property-value" }],+ },+ "property-value": {+ patterns: [+ { match: "#[0-9A-Fa-f]{3,8}\\b", name: "constant.other.color.css" },+ { match: "\\b\\d+(?:\\.\\d+)?\\b", name: "constant.numeric.css" },+ { match: "\\./[^;\\s]+", name: "string.unquoted.css" },+ { match: "[a-zA-Z][\\w:-]+", name: "support.constant.property-value.css" },+ ],+ },+ },+};const sharedTheme = {siteTitle: "NARRATAGE",@@ -122,12 +240,12 @@ export default defineConfig({light: "github-light",dark: "github-dark",},+ languages: [svsLanguage as never],languageAlias: {svml: "xml",svk: "xml",- svs: "xml",- svc: "xml",},+ codeTransformers: [svmlSelectionHighlighter()],},head: [["meta", { name: "theme-color", content: "#2C2126" }],diff --git a/docs/.vitepress/theme/style.css b/docs/.vitepress/theme/style.cssindex c47f1b3a..6bb9e49d 100644--- a/docs/.vitepress/theme/style.css+++ b/docs/.vitepress/theme/style.css@@ -6,6 +6,12 @@* script in config.ts and kept in sync across navigation by theme/Layout.vue.*/+.svml-selection {+ --shiki-light: #8250DF !important;+ --shiki-dark: #D2A8FF !important;+ font-weight: 600;+}+html.home-page {--paper: #2C2126;--paper-light: #3D2A33;diff --git a/docs/README.md b/docs/README.mdindex ba770cf1..e28c9b34 100644--- a/docs/README.md+++ b/docs/README.md@@ -51,7 +51,7 @@ These video contracts are executable candidates, not yet an open-source compatib- [`image-transform.md`](./image-transform.md)- [`caption-gemini-provider-contract.md`](./caption-gemini-provider-contract.md)- [`../services/whisperx/README.md`](../services/whisperx/README.md)-- [`../examples/echo-pro-aroll/README.md`](../examples/echo-pro-aroll/README.md) — current four-take+- [`../examples/talking-head-aroll/README.md`](../examples/talking-head-aroll/README.md) — current four-takelive acceptance and explicit historical-Candidate reuse witness.- [`../examples/talking-film-live/README.md`](../examples/talking-film-live/README.md)diff --git a/docs/guide/testing.md b/docs/guide/testing.mdindex 95809138..3a30ce0c 100644--- a/docs/guide/testing.md+++ b/docs/guide/testing.md@@ -90,4 +90,4 @@ ordinary `.svml`, `.svs` and `.svrun` files that exercise specific compilation pThe `examples/` directory also serves as integration-level fixtures:- `examples/bootstrap/` — smallest source closure check- `examples/talking-film-graph-check/` — complete graph compilation without Providers-- `examples/echo-pro-aroll/` — live acceptance with explicit historical-Candidate reuse+- `examples/talking-head-aroll/` — live acceptance with explicit historical-Candidate reusediff --git a/docs/quickstart.md b/docs/quickstart.mdindex e473bef8..65309d27 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -66,7 +66,3 @@ before spending money.| [Film & Rendering](./quickstart/composition.md) | film:Film, render:Video, full pipeline walkthrough || [Run Source & Builds](./quickstart/run.md) | .svrun syntax, targets, reuse, runtime profile, build workflow |-## Next--- [Development guide](./guide/develop.md) — repository layout, package architecture, extension- patterns.diff --git a/docs/quickstart/generation.md b/docs/quickstart/generation.mdindex 18618ac9..e4faec92 100644--- a/docs/quickstart/generation.md+++ b/docs/quickstart/generation.md@@ -180,7 +180,7 @@ you provide a Recipe with generation settings and a Kit that assembles the promp<speaker:Take id="hook-take"dialogue={story.segment.hook.dialogue}duration={hook-duration.duration}- recipe={studio.speaker.echo-pro}+ recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/>@@ -240,7 +240,7 @@ A four-take setup with estimated durations feeding into `speaker:Take` generatio<import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/>-<media:Image id="presenter-with-echo" src="./assets/presenter-with-echo.png"/>+<media:Image id="presenter-alt" src="./assets/presenter-alt.png"/><media:Audio id="presenter-voice" src="./assets/presenter-voice.mp3"/><estimate:Speech id="hook-duration"@@ -253,28 +253,28 @@ A four-take setup with estimated durations feeding into `speaker:Take` generatiosource={story.segment.payoff.speech} policy={studio.speech.normal}/><speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration} recipe={studio.speaker.echo-pro}+ duration={hook-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take><speaker:Take id="meeting-take" dialogue={story.segment.meeting.dialogue}- duration={meeting-duration.duration} recipe={studio.speaker.echo-pro}+ duration={meeting-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-with-echo} role="character-and-scene"/>+ <speaker:Reference image={presenter-alt} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take><speaker:Take id="evidence-take" dialogue={story.segment.evidence.dialogue}- duration={evidence-duration.duration} recipe={studio.speaker.echo-pro}+ duration={evidence-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-with-echo} role="character-and-scene"/>+ <speaker:Reference image={presenter-alt} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take><speaker:Take id="payoff-take" dialogue={story.segment.payoff.dialogue}- duration={payoff-duration.duration} recipe={studio.speaker.echo-pro}+ duration={payoff-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/>diff --git a/docs/quickstart/run.md b/docs/quickstart/run.mdindex 7538da7c..856ee76c 100644--- a/docs/quickstart/run.md+++ b/docs/quickstart/run.md@@ -95,13 +95,13 @@ historical Records as zero-input Candidates and connect them through Satisfactio</target-set><build-record id="hook-video"- build="echo-pro-film-001" output="hook-take.video"/>+ build="my-film-001" output="hook-take.video"/><build-record id="meeting-video"- build="echo-pro-film-001" output="meeting-take.video"/>+ build="my-film-001" output="meeting-take.video"/><build-record id="evidence-video"- build="echo-pro-film-001" output="evidence-take.video"/>+ build="my-film-001" output="evidence-take.video"/><build-record id="payoff-video"- build="echo-pro-film-001" output="payoff-take.video"/>+ build="my-film-001" output="payoff-take.video"/><satisfy output="hook-take.video"candidate="hook-video" fidelity="substitute"/>@@ -248,7 +248,7 @@ prevent one type of work from starving others.### 1. Diagnose the environment```bash-pnpm narratage doctor examples/echo-pro-aroll/svml.runtime.json+pnpm narratage doctor examples/talking-head-aroll/svml.runtime.json```Doctor checks that every endpoint is reachable, credentials are valid, and required executables@@ -257,8 +257,8 @@ Doctor checks that every endpoint is reachable, credentials are valid, and requi### 2. Inspect the plan```bash-pnpm narratage plan examples/echo-pro-aroll/build.svrun \- --package-lock examples/echo-pro-aroll/svml.packages.lock --root .+pnpm narratage plan examples/talking-head-aroll/build.svrun \+ --package-lock examples/talking-head-aroll/svml.packages.lock --root .```Review the frozen BuildPlan before spending money. The plan shows every Operation and Needs the@@ -267,11 +267,11 @@ Scheduler would issue.### 3. Submit the Build```bash-pnpm narratage build examples/echo-pro-aroll/build.svrun \- --runtime examples/echo-pro-aroll/svml.runtime.json \- --package-lock examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage build examples/talking-head-aroll/build.svrun \+ --runtime examples/talking-head-aroll/svml.runtime.json \+ --package-lock examples/talking-head-aroll/svml.packages.lock \--root . \- --build-id echo-pro-film-001 \+ --build-id my-film-001 \--follow```@@ -286,10 +286,10 @@ pnpm narratage build examples/echo-pro-aroll/build.svrun \### 4. Retrieve results```bash-pnpm narratage get echo-pro-film-001 \- --runtime examples/echo-pro-aroll/svml.runtime.json \+pnpm narratage get my-film-001 \+ --runtime examples/talking-head-aroll/svml.runtime.json \--name final.video \- --to examples/echo-pro-aroll/output/final.mp4+ --to examples/talking-head-aroll/output/final.mp4```Every accepted intermediate Record and Artifact is archived before the Build completes. `get` makes@@ -301,8 +301,8 @@ Create a new `.svrun` file that references the completed Build's Records (see [Rabove), then submit it:```bash-pnpm narratage build examples/echo-pro-aroll/reuse-generated.svrun \- --runtime examples/echo-pro-aroll/svml.runtime.json \- --package-lock examples/echo-pro-aroll/svml.packages.lock \- --root . --build-id echo-pro-film-reuse-001 --follow+pnpm narratage build examples/talking-head-aroll/reuse-generated.svrun \+ --runtime examples/talking-head-aroll/svml.runtime.json \+ --package-lock examples/talking-head-aroll/svml.packages.lock \+ --root . --build-id my-film-reuse-001 --follow```diff --git a/docs/quickstart/script.md b/docs/quickstart/script.mdindex 4ceefaab..1f9e598e 100644--- a/docs/quickstart/script.md+++ b/docs/quickstart/script.md@@ -234,9 +234,9 @@ A complete Script using all constructs together:</hook><meeting>- <HOST> @solution Then I found <Echo Pro | echo pro>: a card-sized recorder- that snaps onto the back of my phone. @ranking! I brought it to one- meeting. @/solution+ <HOST> @solution I started sending <BCC | B C C> recaps after every+ meeting: timestamps, decisions, who said what. @ranking! After+ the first recap, everything changed. @/solution</meeting><evidence>@@ -254,9 +254,9 @@ This Script declares:- Four Segments: `hook`, `meeting`, `evidence`, `payoff`- One Role Cue: `HOST` (consistent across all Segments)-- One Dual Text: `<Echo Pro | echo pro>` (displayed as "Echo Pro", spoken as "echo pro")+- One Dual Text: `<BCC | B C C>` (displayed as "BCC", spoken as "B C C")- Three Selections: `whole` (entire Script), `problem`, `solution`, `emphasis`-- One Moment: `ranking` (marks the instant "I brought it to one meeting")+- One Moment: `ranking` (marks the instant "After the first recap")Downstream components reference these by name: `{story.segment.hook.dialogue}` for generation,`{story.selection.problem}` for B-roll timing, `{story.moment.ranking}` for a visual card reveal.diff --git a/docs/quickstart/styles.md b/docs/quickstart/styles.mdindex 7e18dfdd..cdee23ae 100644--- a/docs/quickstart/styles.md+++ b/docs/quickstart/styles.md@@ -261,7 +261,7 @@ Seedance Speaker generation settings — the Recipe that controls how `speaker:Ttalking-head clip.```svs-speaker.echo-pro {+speaker.host {kind: ugc-talking-head;model: mini;resolution: 720p;@@ -292,7 +292,7 @@ Referenced by `speaker:Take` via the `recipe` attribute:```svml<speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration} recipe={studio.speaker.echo-pro} kit={ugc.official-ugc-v1}>+ duration={hook-duration.duration} recipe={studio.speaker.host} kit={ugc.official-ugc-v1}>```## Font declarations@@ -346,7 +346,7 @@ A complete `studio.svs` file for a four-take talking-head project:rounding: ceil;}- speaker.echo-pro {+ speaker.host {kind: ugc-talking-head;model: mini;resolution: 720p;@@ -392,7 +392,7 @@ This file is imported once in the `.svml` source and its values are referenced t<estimate:Speech id="hook-duration" source={story.segment.hook.speech}policy={studio.speech.normal}/>-<speaker:Take id="hook-take" ... recipe={studio.speaker.echo-pro} .../>+<speaker:Take id="hook-take" ... recipe={studio.speaker.host} .../><caption:Style id="primary-caption" appearance={studio.caption.primary} .../>diff --git a/docs/zh/guide/testing.md b/docs/zh/guide/testing.mdindex 9834e45e..1916a8d9 100644--- a/docs/zh/guide/testing.md+++ b/docs/zh/guide/testing.md@@ -85,4 +85,4 @@ test("generates a video", async (t) => {`examples/` 目录同时充当集成级别的夹具:- `examples/bootstrap/` — 最小源闭包检查- `examples/talking-film-graph-check/` — 不含 Provider 的完整图编译-- `examples/echo-pro-aroll/` — 显式复用历史 Candidate 的实时验收+- `examples/talking-head-aroll/` — 显式复用历史 Candidate 的实时验收diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.mdindex adaf6451..923b3709 100644--- a/docs/zh/quickstart.md+++ b/docs/zh/quickstart.md@@ -63,6 +63,3 @@ pnpm narratage plan examples/talking-film-graph-check/build.svrun \| [Film 与渲染](./quickstart/composition.md) | film:Film、render:Video、完整流水线演练 || [Run Source 与 Build](./quickstart/run.md) | .svrun 语法、targets、复用、runtime profile、build 工作流 |-## 下一步--- [开发指南](./guide/develop.md) —— 仓库结构、包架构、扩展模式。diff --git a/docs/zh/quickstart/generation.md b/docs/zh/quickstart/generation.mdindex a091b3ed..3fd670e1 100644--- a/docs/zh/quickstart/generation.md+++ b/docs/zh/quickstart/generation.md@@ -173,7 +173,7 @@ speech.normal {<speaker:Take id="hook-take"dialogue={story.segment.hook.dialogue}duration={hook-duration.duration}- recipe={studio.speaker.echo-pro}+ recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/>@@ -229,7 +229,7 @@ Prompt Kit 是一种特殊的 SVS 文件,定义了包含有序块、变体选<import as="ugc" source="../../packages/seedance-speaker/kits/official-ugc-v1.svs"/><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/>-<media:Image id="presenter-with-echo" src="./assets/presenter-with-echo.png"/>+<media:Image id="presenter-alt" src="./assets/presenter-alt.png"/><media:Audio id="presenter-voice" src="./assets/presenter-voice.mp3"/><estimate:Speech id="hook-duration"@@ -242,28 +242,28 @@ Prompt Kit 是一种特殊的 SVS 文件,定义了包含有序块、变体选source={story.segment.payoff.speech} policy={studio.speech.normal}/><speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration} recipe={studio.speaker.echo-pro}+ duration={hook-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take><speaker:Take id="meeting-take" dialogue={story.segment.meeting.dialogue}- duration={meeting-duration.duration} recipe={studio.speaker.echo-pro}+ duration={meeting-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-with-echo} role="character-and-scene"/>+ <speaker:Reference image={presenter-alt} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take><speaker:Take id="evidence-take" dialogue={story.segment.evidence.dialogue}- duration={evidence-duration.duration} recipe={studio.speaker.echo-pro}+ duration={evidence-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-with-echo} role="character-and-scene"/>+ <speaker:Reference image={presenter-alt} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take><speaker:Take id="payoff-take" dialogue={story.segment.payoff.dialogue}- duration={payoff-duration.duration} recipe={studio.speaker.echo-pro}+ duration={payoff-duration.duration} recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/>diff --git a/docs/zh/quickstart/run.md b/docs/zh/quickstart/run.mdindex c28b422f..7280e347 100644--- a/docs/zh/quickstart/run.md+++ b/docs/zh/quickstart/run.md@@ -89,13 +89,13 @@ Narratage 没有隐式缓存。复用结果是显式的运行图编写——你</target-set><build-record id="hook-video"- build="echo-pro-film-001" output="hook-take.video"/>+ build="my-film-001" output="hook-take.video"/><build-record id="meeting-video"- build="echo-pro-film-001" output="meeting-take.video"/>+ build="my-film-001" output="meeting-take.video"/><build-record id="evidence-video"- build="echo-pro-film-001" output="evidence-take.video"/>+ build="my-film-001" output="evidence-take.video"/><build-record id="payoff-video"- build="echo-pro-film-001" output="payoff-take.video"/>+ build="my-film-001" output="payoff-take.video"/><satisfy output="hook-take.video"candidate="hook-video" fidelity="substitute"/>@@ -236,7 +236,7 @@ Runtime Profile(`svml.runtime.json`)告诉系统**在哪里**执行每种类### 1. 诊断环境```bash-pnpm narratage doctor examples/echo-pro-aroll/svml.runtime.json+pnpm narratage doctor examples/talking-head-aroll/svml.runtime.json```Doctor 检查每个 endpoint 是否可达、凭证是否有效,以及所需的可执行文件(`ffmpeg`、`ffprobe`、Chrome)是否可用。@@ -244,8 +244,8 @@ Doctor 检查每个 endpoint 是否可达、凭证是否有效,以及所需的### 2. 检查计划```bash-pnpm narratage plan examples/echo-pro-aroll/build.svrun \- --package-lock examples/echo-pro-aroll/svml.packages.lock --root .+pnpm narratage plan examples/talking-head-aroll/build.svrun \+ --package-lock examples/talking-head-aroll/svml.packages.lock --root .```在花费资金之前审查冻结的 BuildPlan。该计划展示调度器将发出的每个 Operation 和 Needs。@@ -253,11 +253,11 @@ pnpm narratage plan examples/echo-pro-aroll/build.svrun \### 3. 提交 Build```bash-pnpm narratage build examples/echo-pro-aroll/build.svrun \- --runtime examples/echo-pro-aroll/svml.runtime.json \- --package-lock examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage build examples/talking-head-aroll/build.svrun \+ --runtime examples/talking-head-aroll/svml.runtime.json \+ --package-lock examples/talking-head-aroll/svml.packages.lock \--root . \- --build-id echo-pro-film-001 \+ --build-id my-film-001 \--follow```@@ -272,10 +272,10 @@ pnpm narratage build examples/echo-pro-aroll/build.svrun \### 4. 获取结果```bash-pnpm narratage get echo-pro-film-001 \- --runtime examples/echo-pro-aroll/svml.runtime.json \+pnpm narratage get my-film-001 \+ --runtime examples/talking-head-aroll/svml.runtime.json \--name final.video \- --to examples/echo-pro-aroll/output/final.mp4+ --to examples/talking-head-aroll/output/final.mp4```每个被接受的中间 Record 和 Artifact 在 Build 完成前都会被归档。`get` 会复制一份已持久化的 Record。@@ -285,8 +285,8 @@ pnpm narratage get echo-pro-film-001 \创建一个引用已完成 Build 的 Record 的新 `.svrun` 文件(参见上文[复用结果](#复用结果)),然后提交:```bash-pnpm narratage build examples/echo-pro-aroll/reuse-generated.svrun \- --runtime examples/echo-pro-aroll/svml.runtime.json \- --package-lock examples/echo-pro-aroll/svml.packages.lock \- --root . --build-id echo-pro-film-reuse-001 --follow+pnpm narratage build examples/talking-head-aroll/reuse-generated.svrun \+ --runtime examples/talking-head-aroll/svml.runtime.json \+ --package-lock examples/talking-head-aroll/svml.packages.lock \+ --root . --build-id my-film-reuse-001 --follow```diff --git a/docs/zh/quickstart/script.md b/docs/zh/quickstart/script.mdindex 11e568e2..4c5ddce6 100644--- a/docs/zh/quickstart/script.md+++ b/docs/zh/quickstart/script.md@@ -218,9 +218,9 @@ Slot id 为 1–64 个字符,以字母或下划线开头。绑定值为纯文</hook><meeting>- <HOST> @solution Then I found <Echo Pro | echo pro>: a card-sized recorder- that snaps onto the back of my phone. @ranking! I brought it to one- meeting. @/solution+ <HOST> @solution I started sending <BCC | B C C> recaps after every+ meeting: timestamps, decisions, who said what. @ranking! After+ the first recap, everything changed. @/solution</meeting><evidence>@@ -238,8 +238,8 @@ Slot id 为 1–64 个字符,以字母或下划线开头。绑定值为纯文- 四个 Segment:`hook`、`meeting`、`evidence`、`payoff`- 一个 Role Cue:`HOST`(在所有 Segment 中保持一致)-- 一个 Dual Text:`<Echo Pro | echo pro>`(显示为 "Echo Pro",说出为 "echo pro")+- 一个 Dual Text:`<BCC | B C C>`(显示为 "BCC",说出为 "B C C")- 三个 Selection:`whole`(整个 Script)、`problem`、`solution`、`emphasis`-- 一个 Moment:`ranking`(标记 "I brought it to one meeting" 这一瞬间)+- 一个 Moment:`ranking`(标记 "After the first recap" 这一瞬间)下游组件通过名称引用这些内容:`{story.segment.hook.dialogue}` 用于生成,`{story.selection.problem}` 用于 B-roll 时间绑定,`{story.moment.ranking}` 用于视觉卡片揭示。diff --git a/docs/zh/quickstart/styles.md b/docs/zh/quickstart/styles.mdindex 771a64f6..fb1933f5 100644--- a/docs/zh/quickstart/styles.md+++ b/docs/zh/quickstart/styles.md@@ -256,7 +256,7 @@ speech.normal {Seedance Speaker 生成设置——控制 `speaker:Take` 如何生成说话人头像片段的 Recipe。```svs-speaker.echo-pro {+speaker.host {kind: ugc-talking-head;model: mini;resolution: 720p;@@ -287,7 +287,7 @@ speaker.echo-pro {```svml<speaker:Take id="hook-take" dialogue={story.segment.hook.dialogue}- duration={hook-duration.duration} recipe={studio.speaker.echo-pro} kit={ugc.official-ugc-v1}>+ duration={hook-duration.duration} recipe={studio.speaker.host} kit={ugc.official-ugc-v1}>```## 字体声明@@ -340,7 +340,7 @@ caption.dialogue {rounding: ceil;}- speaker.echo-pro {+ speaker.host {kind: ugc-talking-head;model: mini;resolution: 720p;@@ -386,7 +386,7 @@ caption.dialogue {<estimate:Speech id="hook-duration" source={story.segment.hook.speech}policy={studio.speech.normal}/>-<speaker:Take id="hook-take" ... recipe={studio.speaker.echo-pro} .../>+<speaker:Take id="hook-take" ... recipe={studio.speaker.host} .../><caption:Style id="primary-caption" appearance={studio.caption.primary} .../>diff --git a/examples/README.md b/examples/README.mdindex 3996745b..d8a2b70e 100644--- a/examples/README.md+++ b/examples/README.md@@ -5,8 +5,8 @@requirements.- [`talking-film-live`](./talking-film-live/README.md) executes the real paid two-take path with KIE,local media processing, local WhisperX, Vertex Caption planning and local HyperFrames rendering.-- [`echo-pro-aroll`](./echo-pro-aroll/README.md) is the current four-take acceptance witness and- demonstrates a second Run that explicitly reuses historical shot Records as zero-input+- [`talking-head-aroll`](./talking-head-aroll/README.md) is the current four-take acceptance witness+ and demonstrates a second Run that explicitly reuses historical shot Records as zero-inputCandidates without another KIE submission.- [`talking-film-golden`](./talking-film-golden/README.md) is the larger authoring and visual designfixture used while video packages remain pre-freeze.diff --git a/examples/echo-pro-aroll/README.md b/examples/talking-head-aroll/README.mdsimilarity index 77%rename from examples/echo-pro-aroll/README.mdrename to examples/talking-head-aroll/README.mdindex e0132514..283aca7d 100644--- a/examples/echo-pro-aroll/README.md+++ b/examples/talking-head-aroll/README.md@@ -1,11 +1,11 @@-# Echo Pro A-roll+# Talking Head A-rollComplete four-take Seedance Mini talking-head film with measured captions.Supply these ignored local assets before checking or building:- `presenter-clean.png`-- `presenter-with-echo.png`+- `presenter-alt.png`- `presenter-voice.mp3`Every take uses the same voice-timbre reference. The visual reference sequence is clean, product,@@ -27,7 +27,7 @@ take at Seedance's 15-second request limit.Create the explicit package lock used by this development-workspace example:```sh-pnpm narratage lock-packages examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage lock-packages examples/talking-head-aroll/svml.packages.lock \--package @narratage/artifact \--package @narratage/narrative \--package @narratage/media \@@ -57,7 +57,7 @@ pnpm narratage lock-packages examples/echo-pro-aroll/svml.packages.lock \--package @narratage/run-text \--root .-pnpm narratage lock-packages examples/echo-pro-aroll/svml.runtime-packages.lock \+pnpm narratage lock-packages examples/talking-head-aroll/svml.runtime-packages.lock \--package @narratage/provider-kie \--package @narratage/provider-media-local \--package @narratage/provider-whisperx-local \@@ -69,16 +69,16 @@ pnpm narratage lock-packages examples/echo-pro-aroll/svml.runtime-packages.lockInspect all authored outputs—including `*.prompt` and `*.program`—without a paid call:```sh-pnpm narratage check examples/echo-pro-aroll/main.svml \- --package-lock examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage check examples/talking-head-aroll/main.svml \+ --package-lock examples/talking-head-aroll/svml.packages.lock \--root .```Inspect the exact paid plan before submitting it:```sh-pnpm narratage plan examples/echo-pro-aroll/build.svrun \- --package-lock examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage plan examples/talking-head-aroll/build.svrun \+ --package-lock examples/talking-head-aroll/svml.packages.lock \--root .```@@ -86,32 +86,32 @@ Build the complete film after starting the local WhisperX sidecar and exposing ``GOOGLE_CLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS_JSON`:```sh-pnpm narratage build examples/echo-pro-aroll/build.svrun \- --runtime examples/echo-pro-aroll/svml.runtime.json \- --package-lock examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage build examples/talking-head-aroll/build.svrun \+ --runtime examples/talking-head-aroll/svml.runtime.json \+ --package-lock examples/talking-head-aroll/svml.packages.lock \--root . \- --build-id echo-pro-film-001 \+ --build-id my-film-001 \--follow-pnpm narratage get echo-pro-film-001 \- --runtime examples/echo-pro-aroll/svml.runtime.json \+pnpm narratage get my-film-001 \+ --runtime examples/talking-head-aroll/svml.runtime.json \--name final.video \- --to examples/echo-pro-aroll/output/final.mp4+ --to examples/talking-head-aroll/output/final.mp4```Run the same downstream film from the four archived generated shots without another Seedancesubmission:```sh-pnpm narratage build examples/echo-pro-aroll/reuse-generated.svrun \- --runtime examples/echo-pro-aroll/svml.runtime.json \- --package-lock examples/echo-pro-aroll/svml.packages.lock \+pnpm narratage build examples/talking-head-aroll/reuse-generated.svrun \+ --runtime examples/talking-head-aroll/svml.runtime.json \+ --package-lock examples/talking-head-aroll/svml.packages.lock \--root . \- --build-id echo-pro-film-reuse-001 \+ --build-id my-film-reuse-001 \--follow```-`reuse-generated.svrun` names the four public shot aliases from `echo-pro-film-001`, exposes each+`reuse-generated.svrun` names the four public shot aliases from `my-film-001`, exposes eachverified historical Record as a zero-input Candidate and explicitly satisfies the correspondinglogical output as `substitute`. Reverse demand therefore removes all four Seedance branches whilekeeping media normalization, WhisperX, Gemini planning, Film and rendering reachable. This is a newdiff --git a/examples/echo-pro-aroll/build.svrun b/examples/talking-head-aroll/build.svrunsimilarity index 100%rename from examples/echo-pro-aroll/build.svrunrename to examples/talking-head-aroll/build.svrundiff --git a/examples/echo-pro-aroll/main.svml b/examples/talking-head-aroll/main.svmlsimilarity index 82%rename from examples/echo-pro-aroll/main.svmlrename to examples/talking-head-aroll/main.svmlindex 220fd127..a0c33ef6 100644--- a/examples/echo-pro-aroll/main.svml+++ b/examples/talking-head-aroll/main.svml@@ -20,21 +20,21 @@</hook><meeting>- <HOST>Then I found Echo Pro: a card-sized recorder that snaps onto the back of my phone, paired with an AI agent. I brought it to one meeting. It captured every word, organized the minutes, and showed exactly where my work had been overlooked. For once, I felt seen.+ <HOST>Then I found a voice memo app that auto-transcribes: just tap record and it captures every word. I brought it to one meeting. It organized the minutes and showed exactly where my work had been overlooked. For once, I felt seen.</meeting><evidence>- <HOST>That gave me the courage I was missing. Before our month-end review, I gave Echo Pro the meeting notes and my actual work files. It connected the dots and turned everything into one clear, evidence-backed report of what I had really delivered.+ <HOST>That gave me the courage I was missing. Before our month-end review, I fed the app my meeting notes and my actual work files. It connected the dots and turned everything into one clear, evidence-backed report of what I had really delivered.</evidence><payoff>- <HOST>And guess what? I’m sitting in my old boss’s chair now. The first thing I did was give every person on my team an Echo Pro—so work gets easier, achievements stay visible, and no one has to fight alone just to get the credit they’ve earned.+ <HOST>And guess what? I’m sitting in my old boss’s chair now. The first thing I did was set up the same tool for every person on my team—so work gets easier, achievements stay visible, and no one has to fight alone just to get the credit they’ve earned.</payoff></script><!-- Author-owned reference material. --><media:Image id="presenter-clean" src="./assets/presenter-clean.png"/>- <media:Image id="presenter-with-echo" src="./assets/presenter-with-echo.png"/>+ <media:Image id="presenter-alt" src="./assets/presenter-alt.png"/><media:Audio id="presenter-voice" src="./assets/presenter-voice.mp3"/><!-- Duration remains an explicit graph fact derived from the pronunciation projection. -->@@ -48,7 +48,7 @@id="hook-take"dialogue={story.segment.hook.dialogue}duration={hook-duration.duration}- recipe={studio.speaker.echo-pro}+ recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/>@@ -59,10 +59,10 @@id="meeting-take"dialogue={story.segment.meeting.dialogue}duration={meeting-duration.duration}- recipe={studio.speaker.echo-pro}+ recipe={studio.speaker.host}kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-with-echo} role="character-and-scene"/>+ <speaker:Reference image={presenter-alt} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take>@@ -70,10 +70,10 @@id="evidence-take"dialogue={story.segment.evidence.dialogue}duration={evidence-duration.duration}- recipe={studio.speaker.echo-pro}+ recipe={studio.speaker.host}kit={ugc.official-ugc-v1}>- <speaker:Reference image={presenter-with-echo} role="character-and-scene"/>+ <speaker:Reference image={presenter-alt} role="character-and-scene"/><speaker:Reference audio={presenter-voice} role="voice-timbre"/></speaker:Take>@@ -81,7 +81,7 @@id="payoff-take"dialogue={story.segment.payoff.dialogue}duration={payoff-duration.duration}- recipe={studio.speaker.echo-pro}+ recipe={studio.speaker.host}kit={ugc.official-ugc-v1}><speaker:Reference image={presenter-clean} role="character-and-scene"/>diff --git a/examples/echo-pro-aroll/reuse-generated.svrun b/examples/talking-head-aroll/reuse-generated.svrunsimilarity index 61%rename from examples/echo-pro-aroll/reuse-generated.svrunrename to examples/talking-head-aroll/reuse-generated.svrunindex 1da4dbdf..b462e5d1 100644--- a/examples/echo-pro-aroll/reuse-generated.svrun+++ b/examples/talking-head-aroll/reuse-generated.svrun@@ -6,10 +6,10 @@<target output="final.video" accepts="substitute"/></target-set>- <build-record id="hook-video" build="echo-pro-film-001" output="hook-take.video"/>- <build-record id="meeting-video" build="echo-pro-film-001" output="meeting-take.video"/>- <build-record id="evidence-video" build="echo-pro-film-001" output="evidence-take.video"/>- <build-record id="payoff-video" build="echo-pro-film-001" output="payoff-take.video"/>+ <build-record id="hook-video" build="my-film-001" output="hook-take.video"/>+ <build-record id="meeting-video" build="my-film-001" output="meeting-take.video"/>+ <build-record id="evidence-video" build="my-film-001" output="evidence-take.video"/>+ <build-record id="payoff-video" build="my-film-001" output="payoff-take.video"/><satisfy output="hook-take.video" candidate="hook-video" fidelity="substitute"/><satisfy output="meeting-take.video" candidate="meeting-video" fidelity="substitute"/>diff --git a/examples/echo-pro-aroll/studio.svs b/examples/talking-head-aroll/studio.svssimilarity index 97%rename from examples/echo-pro-aroll/studio.svsrename to examples/talking-head-aroll/studio.svsindex 00fa817e..f0e0973a 100644--- a/examples/echo-pro-aroll/studio.svs+++ b/examples/talking-head-aroll/studio.svs@@ -10,7 +10,7 @@rounding: ceil;}- speaker.echo-pro {+ speaker.host {kind: ugc-talking-head;model: mini;resolution: 720p;diff --git a/examples/echo-pro-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.locksimilarity index 100%rename from examples/echo-pro-aroll/svml.packages.lockrename to examples/talking-head-aroll/svml.packages.lockdiff --git a/examples/echo-pro-aroll/svml.runtime-packages.lock b/examples/talking-head-aroll/svml.runtime-packages.locksimilarity index 100%rename from examples/echo-pro-aroll/svml.runtime-packages.lockrename to examples/talking-head-aroll/svml.runtime-packages.lockdiff --git a/examples/echo-pro-aroll/svml.runtime.json b/examples/talking-head-aroll/svml.runtime.jsonsimilarity index 86%rename from examples/echo-pro-aroll/svml.runtime.jsonrename to examples/talking-head-aroll/svml.runtime.jsonindex 2e85a771..eaf96911 100644--- a/examples/echo-pro-aroll/svml.runtime.json+++ b/examples/talking-head-aroll/svml.runtime.json@@ -6,7 +6,7 @@"endpoints": [{"use": "@narratage/provider-kie",- "instance": "kie.echo-pro-aroll",+ "instance": "kie.talking-head-aroll","lane": "generation","config": {"apiKeyEnv": "KIE_API_KEY",@@ -15,7 +15,7 @@},{"use": "@narratage/provider-media-local",- "instance": "media.echo-pro-aroll",+ "instance": "media.talking-head-aroll","lane": "media","config": {"defaultConcurrency": 2@@ -23,7 +23,7 @@},{"use": "@narratage/provider-whisperx-local",- "instance": "whisperx.echo-pro-aroll",+ "instance": "whisperx.talking-head-aroll","lane": "alignment","config": {"defaultConcurrency": 1@@ -31,7 +31,7 @@},{"use": "@narratage/provider-google-vertex",- "instance": "vertex.echo-pro-aroll",+ "instance": "vertex.talking-head-aroll","lane": "planning","config": {"projectEnv": "GOOGLE_CLOUD_PROJECT",@@ -42,7 +42,7 @@},{"use": "@narratage/provider-hyperframes-local",- "instance": "hyperframes.echo-pro-aroll",+ "instance": "hyperframes.talking-head-aroll","lane": "render","config": {"workers": 2,