企业官网建设流程全解析

SCRIPT — storyboard-sample

【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes

Voice:Rachel (ElevenLabs)Voice settings:stability 0.35 · similarity 0.75 · style 0.20Voice direction:Confident, warm, a little playful. Sounds like a person, never a reader.

头部固定四类元信息，含义与取值建议如下： | 字段 | 本例取值 | 作用 | |---|---|---| | `Voice` | `Rachel (ElevenLabs)` | 指定 TTS 音色及其来源引擎，供生成配音时选用 | | `Voice settings: stability` | `0.35` | 稳定性，越低越有情绪起伏、越高越平稳一致 | | `Voice settings: similarity` | `0.75` | 与目标音色的相似度 | | `Voice settings: style` | `0.20` | 风格化程度 | | `Voice direction` | `Confident, warm, a little playful. ...` | 给朗读者的总体表演指令，属于风格化的 prompt 文本，强调"像人、不像播音腔"（Sounds like a person, never a reader） | 从写法上可以推断，`stability / similarity / style` 这类带点的键是 ElevenLabs 系引擎的典型参数，取值被限定在 0~1 区间；而 `Voice direction` 则是面向 Agent/语音合成模型的自然语言约束。 ### 逐句台词：Line 块的时序契约 文件的正文按叙事顺序排列，每一句台词对应一个 `## Line N` 块，块内固定三要素——**配音事件时间（Time）**、**情绪/表演指示（Delivery）**、**逐字台词**（代码块内、即后续 TTS 的朗读原文）： ```markdown ## Line 1 — Hook (Frame 1) **Time:** 0.0 – 3.0s **Delivery:** Land the promise on the beat. Slight smile. Ship a launch video in an afternoon.

时间区间用半开区间起始 – 结束s表示（0.0–3.0s 与 3.0–7.0s 精确衔接，无重叠、无缝隙），恰好与对应帧的时长一一咬合。标题中的(Frame N)后缀则给出了台词与分镜的显式关联。这正呼应 STORYBOARD.md frontmatter 里那一行自述：voice: Rachel — 5 lines from SCRIPT.md。

台词 ↔ 帧 ↔ 时间轴：一段 5 帧的完整叙事弧

把 SCRIPT.md 的 5 句台词与 STORYBOARD.md 的 5 帧对齐，可以整理出整支 19 秒广告片（CTA 帧在 16s 后）的完整结构：

在 STORYBOARD.md 侧，每个帧以同样的序号组织，frontmatter 记录了整支片子的全局方向：

--- format: 1920x1080 message: "Ship a launch video in an afternoon" arc: Hook → Problem → Solution → Proof → CTA audience: indie devs on X voice: Rachel — 5 lines from SCRIPT.md ---

随后每一帧都是一个元数据列表 + 一段叙述文字，例如 Frame 1：

## Frame 1 — Hook - scene: Big type punches in on the beat - duration: 3s - poster: 2s - transition_in: cut - status: animated - voiceover: "Ship a launch video in an afternoon." - src: compositions/frames/01-hook.html Open cold on the promise. ...

逐字段含义由 StoryboardFrame 类型给出权威解释：

• scene—— 关键瞬间的一句话视觉描述（即接触网格图块下的 caption）；
• duration—— 帧时长，按"6s"这样的字符串解析成durationSeconds，解析失败不抛错只记 warning；
• poster—— 接触网格上代表该帧的"定格展示点"（跳过开场动画后的代表时间，如2s），缺省时回退到启发式推断；
• transition_in—— 进入本帧的转场，样例里四种切换都用到了：cut、crossfade、wipe；
• status—— 生命周期状态，见下文；
• voiceover—— 该帧的旁白行（注意：当 SCRIPT.md 存在时它只是导览副本）；
• src—— 指向帧 HTML 子合成的项目相对路径；
• 元数据下方的正文段落narrative—— 给 Agent/创作者看的创作意图说明。

三种 status：outline → built → animated

状态机由核心包定义，types.ts 中FrameStatus = "outline" | "built" | "animated"，缺省即outline。UI 展示层对每个状态的语义做了精确收口（frameStatus.ts）：

frameStatus.ts注释还点明了阶段推进规则："The lifecycle order an agent advances each frame through"，即 Agent 逐帧执行outline → built → animated，Studio 据此渲染进度。docs 同样提醒：status 只是进度信息（progress information），不代表帧已获准通过。

从文字到可播放时间轴：index.html 如何缝合帧

SCRIPT.md 只负责"念什么、什么时候念"，真正把帧"播起来"的是 index.html。它以一个主合成容器（data-composition-id="main"，data-duration="16"）包住 4 个帧节点，每个节点用三个关键属性把 SCRIPT/STORYBOARD 里的时间契约翻译成运行时：

<div id="frame-2" class="scene"><script> (function () { const tl = gsap.timeline({ paused: true }); const h = '[data-composition-id="frame-01-hook"] .headline'; tl.fromTo(h, { opacity: 0, scale: 0.86 }, { opacity: 1, scale: 1, duration: 0.6, ease: "back.out(1.4)" }, 0.1); tl.to(h, { scale: 1.04, duration: 2, ease: "none" }, 0.7); window.__timelines = window.__timelines || {}; window.__timelines["frame-01-hook"] = tl; })(); </script>

主合成在页脚同样初始化了一个空的main时间线（paused: true），由播放器负责按data-start /># SCRIPT — <project> **Voice:** <voice name> (<engine>) **Voice settings:** stability 0.35 · similarity 0.75 · style 0.20 **Voice direction:** <一句话表演指令，明确语气与"不要念稿"> ## Line 1 — Hook (Frame 1) **Time:** 0.0 – 3.0s **Delivery:** <这一句的情绪与落点> <逐字台词，与 STORYBOARD.md Frame 1 的 voiceover 一致> ## Line 2 — … (Frame N) **Time:** 3.0 – 7.0s ← 与上一句结束时间无缝衔接 **Delivery:** … <逐字台词>

【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes