字幕与旁白 Cue
每张 slide 的旁白脚本、字幕渲染、分步揭示——用 inline marker 标注让讲解和画面同步。
Cue 是 Storyboard 的"讲解脚本层"。一张 slide 可以挂一段旁白，旁白里用 inline marker 标注何时做何事：触发子步骤、高亮某段文字、展开某个元素。点标记写成 {@cueId}，范围标记写成 {@cueId:start} … {@cueId:end} 一对。在 Cue 编辑器里，这些标记被画成浮在文字上方的彩色圆点，而不是显示成原始文本。
Cue 的三个能力
- 字幕显示：朗读时底部自动滚动字幕（可开关）；
- 分步揭示：在旁白里插入点标记
{@cueId}，朗读到此处触发该 cue 的操作； - 范围效果：范围标记
{@cueId:start}…{@cueId:end}在起点触发该 cue 的操作；其中标记为"临时"的操作（例如高亮、连线、短暂推近镜头等）会在范围结束时自动撤销。
示例脚本
本季度 GMV 同比增长 38%，{@2}主要来自华东市场的爆发。
{@3:start}其中长三角三省一市贡献了 60%{@3:end}，是重点投入的回报。其中 2、3 是该 slide 上 cue 的 id。标记之外的部分是纯文本：会被逐字朗读、并原样显示为字幕，写 Markdown 语法不会被渲染，只会被念出来。
朗读流程：
| 时间 | 事件 |
|---|---|
| 0–2.1s | 朗读第一句字幕 |
2.1s（{@2}） | 触发 cue 2（展示"华东柱状图"） |
2.1–5.4s（{@3:start}…{@3:end}） | 同步高亮长三角区域 |
跟读与跳转
播放时旁白脚本会逐字点亮，随语音推进——它同时就是进度显示。想从某一句重听，直接点那个字即可从该处播放，无需另找进度条。
Cue 从哪来
Cue 由 AI 随故事板文档一并写出——旁白与标记是和 slide 一起产出的，不是另一个「生成」步骤。
自己动手改
旁白文字右侧的 ✏️ 进入编辑态，可以直接改。你改的是干净文本，看不到 {@id} 这类内部记法；标记会跟着文字走——在标记前插字它右移，删掉一整段则落在段内的标记贴到段首。标记就叠在你正在编辑的这行字上，随每一次输入实时挪位——它和不编辑时长得完全一样，点铅笔进出编辑态，文字一个像素都不会动。
标记的位置也可以直接拖，用来调整触发时机（编辑文字时不能拖，两套操作不同时开）。多个标记停在同一处时也能靠拖拽调先后——它们会并排展开，拖到某个圆点的左半边就排在它前面，右半边就排在它后面，插入光标会告诉你会落在哪。拖起来的时候，放不下的位置会变灰——标记的先后顺序同时决定了操作的执行顺序，比如「创建图表」的标记不能排到「高亮图表」之后，否则播放时会去操作一个还没出现的组件。灰掉的区域就是这条约束的样子。
有两件事只能交给 AI（在聊天里说就行）：
- 新增标记：比如「这里也要触发一下」——它需要先挑一个 cue，而 cue 与操作的对应关系不该由你操心；
- 点标记 ↔ 范围标记互转：比如「让这个高亮讲完这三句再撤掉」。
如果某个圆点是空心的，说明它对应的 cue 已经没有任何操作了（通常是删掉组件后留下的）——播放到那里什么都不会发生。点它即可清掉。
编辑时翻页会暂时停用——切页会让编辑框里的内容突然变成另一页的。播放不受限：点播放就退出编辑并开始朗读，改完想听一遍不用先关掉编辑器。反过来播放中不能编辑，逐字点亮的位置会跟正在变的文字对不上。
TTS 与音量
Cue 搭配 TTS（文本转语音）朗读，播放控制栏提供：
- 开关字幕显示
- 静音开关 + 连续音量滑杆
- 播放 / 暂停 / 上一句 / 下一句