Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

docs: remove Echo Pro product name, add SVS syntax highlighting

rponee56aa3f579f4
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 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.css
index 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.md
index 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-take
live 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.md
index 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 p
The `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 reuse
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 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.md
index 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` generatio
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/quickstart/run.md b/docs/quickstart/run.md
index 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 [R
above), 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.md
index 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.md
index 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:T
talking-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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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-input
Candidates without another KIE submission.
- [`talking-film-golden`](./talking-film-golden/README.md) is the larger authoring and visual design
fixture used while video packages remain pre-freeze.
diff --git a/examples/echo-pro-aroll/README.md b/examples/talking-head-aroll/README.md
similarity index 77%
rename from examples/echo-pro-aroll/README.md
rename to examples/talking-head-aroll/README.md
index 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-roll
Complete 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.lock
Inspect 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 Seedance
submission:
```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 each
verified historical Record as a zero-input Candidate and explicitly satisfies the corresponding
logical output as `substitute`. Reverse demand therefore removes all four Seedance branches while
keeping media normalization, WhisperX, Gemini planning, Film and rendering reachable. This is a new
diff --git a/examples/echo-pro-aroll/build.svrun b/examples/talking-head-aroll/build.svrun
similarity index 100%
rename from examples/echo-pro-aroll/build.svrun
rename to examples/talking-head-aroll/build.svrun
diff --git a/examples/echo-pro-aroll/main.svml b/examples/talking-head-aroll/main.svml
similarity index 82%
rename from examples/echo-pro-aroll/main.svml
rename to examples/talking-head-aroll/main.svml
index 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.svrun
similarity index 61%
rename from examples/echo-pro-aroll/reuse-generated.svrun
rename to examples/talking-head-aroll/reuse-generated.svrun
index 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.svs
similarity index 97%
rename from examples/echo-pro-aroll/studio.svs
rename to examples/talking-head-aroll/studio.svs
index 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.lock
similarity index 100%
rename from examples/echo-pro-aroll/svml.packages.lock
rename to examples/talking-head-aroll/svml.packages.lock
diff --git a/examples/echo-pro-aroll/svml.runtime-packages.lock b/examples/talking-head-aroll/svml.runtime-packages.lock
similarity index 100%
rename from examples/echo-pro-aroll/svml.runtime-packages.lock
rename to examples/talking-head-aroll/svml.runtime-packages.lock
diff --git a/examples/echo-pro-aroll/svml.runtime.json b/examples/talking-head-aroll/svml.runtime.json
similarity index 86%
rename from examples/echo-pro-aroll/svml.runtime.json
rename to examples/talking-head-aroll/svml.runtime.json
index 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,