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: show the full Script authoring language

kashorinb35d2c7fbe31
diff --git a/README.md b/README.md
index dcc59177..52bdc64b 100644
--- a/README.md
+++ b/README.md
@@ -19,18 +19,41 @@ yet.
## What it feels like
-The Script remains readable prose. Semantic anchors live beside the words they describe; generation,
-timing, captions and composition refer back to that meaning.
+The Script remains readable prose. Segments organize the story; Role Cues say who speaks; Dual Text
+separates what viewers read from what the speaker says; Selections and Moments name semantic ranges
+and points without introducing timecodes.
```svml
<script id="story">
- <opening>
- <HOST>Meaning @demo becomes the source @/demo.</opening>
+ @whole
+
+ <hook>
+ <ALICE> @problem @beat Never let anyone take credit for your work. @/beat @/problem
+ </hook>
+
+ <answer>
+ <!-- Selections may cross; the markers do not have to nest like XML. -->
+ @claim
+ <BOB> Before ~@proof the report appears @reveal! on screen @/claim,
+ I call it <SVML | semantic video markup language> @/proof~.
+ <ALICE> @beat I < | honestly> wish I'd had it sooner @/beat ~@cut!
+ — and yes, I said \@proof aloud.
+ </answer>
+
+ @silence
+ <pause/>
+ @/silence
+
+ <tagline>
+ Meaning becomes the source.
+ </tagline>
+
+ @/whole~
</script>
<seedance:TextVideo id="take"
model="mini"
- prompt={direction}
+ prompt={story.segment.hook.dialogue}
duration="5"
generate-audio="true"/>
@@ -40,20 +63,38 @@ timing, captions and composition refer back to that meaning.
<media-track:Item
video={motion.video}
- during={story.selection.demo}
+ during={story.selection.proof}
frame={card-frame}/>
-
-<film:Film id="main" canvas={vertical} space={speech.space}>
- <film:Track source={speech.visual}/>
- <film:Track source={cards.visual}/>
- <film:Track source={captions.track}/>
-</film:Film>
```
-This is an excerpt from the complete, checkable
-[`talking-film-graph-check`](./examples/talking-film-graph-check/main.svml) example. Namespaced
-elements are supplied by imported packages; the language does not hard-code Seedance, WhisperX,
-Caption or Film into its Core.
+The Script excerpt shows the complete marker vocabulary:
+
+| Form | Meaning |
+|---|---|
+| `<hook>...</hook>` / `<pause/>` | spoken and empty Segments |
+| `<ALICE>` | a Role Cue; it continues until the next cue or Segment end |
+| `<SVML \| semantic video markup language>` | display text on the left, spoken text on the right |
+| `< \| honestly>` | spoken filler deliberately absent from captions |
+| `@problem ... @/problem` | Selection whose boundaries absorb inward |
+| `~@proof ... @/proof~` | Selection whose boundaries absorb outward |
+| repeated `@beat ... @/beat` | one non-contiguous Selection with multiple occurrences |
+| `@reveal!` / `~@cut!` | Moments attached to the next word start / previous word end |
+| `\@proof` | a literal `@proof`, not a marker |
+| `<!-- ... -->` | a source comment; it enters no text projection |
+
+`@whole` crosses Segment boundaries; `@claim` and `proof` demonstrate that Selections may cross
+instead of nesting. `tagline` shows that a Segment may be roleless. Repeating the same Selection id
+creates multiple non-contiguous occurrences.
+Marker names carry no built-in behavior: `@silence` does not mute audio; an Audio, Caption or Track
+component must explicitly consume that Selection. The complete escape set and Slot parser contract
+are documented in [Script](./docs/quickstart/script.md); Slot binding is not yet exposed by the
+author-facing `<script>` Surface, so the README does not pretend it is usable source syntax today.
+
+The outer component lines are deliberately an excerpt: they show how generated media, alignment and
+Tracks consume Script projections. See the complete, checkable
+[`talking-film-graph-check`](./examples/talking-film-graph-check/main.svml) source for imports,
+layout, captions, Film and rendering. Namespaced components come from packages; Core does not
+hard-code Seedance, WhisperX, Caption or Film.
## Try it without API keys
diff --git a/docs/quickstart/script.md b/docs/quickstart/script.md
index 79cfa4b8..e67d7ffd 100644
--- a/docs/quickstart/script.md
+++ b/docs/quickstart/script.md
@@ -190,6 +190,9 @@ Other components reference Moments via `{story.moment.ranking}`.
## Slots
+> The Script parser defines Slot syntax, but the current author-facing `<script>` Surface does not
+> yet expose a binding input. Do not put an unbound Slot in `main.svml`; it will fail `check`.
+
Variable interpolation for templated Scripts:
```svml
diff --git a/spec/script-surface.md b/spec/script-surface.md
index e4e1074c..602c86d5 100644
--- a/spec/script-surface.md
+++ b/spec/script-surface.md
@@ -460,6 +460,10 @@ at="phrase.end" <!-- SelectionSet 的各 range 终点投影 -->
## 6. Slot
+当前实现状态:`parseScript` 已实现下述 parse-first、literal-only 绑定合同,但官方
+`<script>` Author Surface 尚未暴露 bindings 输入。未绑定 Slot 在当前 `main.svml` 中会按
+`SCRIPT_SLOT_UNBOUND` 失败;公开使用示例在 Surface 补齐绑定边之前不得宣称 Slot 可直接使用。
+
Slot 是解析器识别的一等 AST atom:
```svml