字幕与旁白 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}） | 同步高亮长三角区域 |
跟读与跳转
播放时旁白脚本会逐字点亮，随语音推进——它同时就是进度显示。想从某一句重听，直接点那个字即可从该处播放，无需另找进度条。
组件怎样出现
播放时，随这一句旁白出现的组件会淡入。想让某个组件出场更有分量，直接告诉 AI，它会按旁白的意思来选：核心结论放大入场，承接上一步的从下方上浮，趋势图和代码自左向右展开，背景与装饰直接出现。
点字跳转、换页、或一次跨过好几句时，组件直接出现在该在的位置，不重播入场。系统开启「减少动态效果」时，各种入场都只保留淡入。
播放中翻到下一页时，上一页还在画面上、新一页一开头就接着用的组件会留在原地，不会先消失再出现；它在新一页的位置或大小不同，就平滑移过去。讲解途中让组件换位置、改大小，同样是平滑移动。系统开启「减少动态效果」时直接到位。
等画面播完再往下
有些组件自己会动一段时间：物理仿真、随机过程、倒计时。连续播放时，讲稿念完了而它还没播完，就先不翻页，等它播完再翻；控制栏会显示「等待：<在等什么>」，知道剩余时间的还会显示「还剩 0:12」。不想等就点旁边的 跳过，接着往下播。暂停再继续，接着等，不会从头重念这一页。
想在讲某句话之前先等画面——比如「等小球落地，再讲它弹了多高」——告诉 AI 在那里等。播放到那个位置时讲稿停住、画面继续，等完再接着念。
这项行为在组件属性里叫 播完再翻页，默认开着；关掉后讲稿念完就翻页。手动翻页、点字跳转、只播本张都不会等。
组件需要先加载才能入场。网络较慢、一时半会儿还没好时，它的位置上会出现一个转圈；加载完成后照常入场。等了几秒仍未就绪的组件会直接显示出来，不再补播入场。
Cue 从哪来
Cue 由 AI 随故事板文档一并写出——旁白与标记是和 slide 一起产出的，不是另一个「生成」步骤。
自己动手改
旁白文字右侧的 ✏️ 进入编辑态，可以直接改。你改的是干净文本，看不到 {@id} 这类内部记法；标记会跟着文字走——在标记前插字它右移，删掉一整段则落在段内的标记贴到段首。标记就叠在你正在编辑的这行字上，随每一次输入实时挪位——它和不编辑时长得完全一样，点铅笔进出编辑态，文字一个像素都不会动。
标记的位置也可以直接拖，用来调整触发时机（编辑文字时不能拖，两套操作不同时开）。多个标记停在同一处时也能靠拖拽调先后——它们会并排展开，拖到某个圆点的左半边就排在它前面，右半边就排在它后面，插入光标会告诉你会落在哪。拖起来的时候，放不下的位置会变灰——标记的先后顺序同时决定了操作的执行顺序，比如「创建图表」的标记不能排到「高亮图表」之后，否则播放时会去操作一个还没出现的组件。灰掉的区域就是这条约束的样子。
有两件事只能交给 AI（在聊天里说就行）：
- 新增标记：比如「这里也要触发一下」——它需要先挑一个 cue，而 cue 与操作的对应关系不该由你操心；
- 点标记 ↔ 范围标记互转：比如「让这个高亮讲完这三句再撤掉」。
如果某个圆点是空心的，说明它对应的 cue 已经没有任何操作了（通常是删掉组件后留下的）——播放到那里什么都不会发生。点它即可清掉。
编辑时翻页会暂时停用——切页会让编辑框里的内容突然变成另一页的。播放不受限：点播放就退出编辑并开始朗读，改完想听一遍不用先关掉编辑器。反过来播放中不能编辑，逐字点亮的位置会跟正在变的文字对不上。
TTS 与音量
Cue 搭配 TTS（文本转语音）朗读，播放控制栏在页面最下方、横跨整个视图，从左到右是：
- 播放 / 暂停（右侧箭头可选「从当前页起」「仅当前页」「从头播放」）
- 上一页 / 页码 / 下一页
- 本页的「已播 / 总长」（本页语音到了才显示总长）
- 静音开关 + 连续音量滑杆、开关字幕、全屏
逐句跳转用键盘 ← / →，或直接点讲稿里的字从那里念起。
播放时讲稿里的圆点会跟着进度变化：已经触发过的变淡，刚刚触发的那个跳动一下，还没读到的保持原色——看得出刚才画面上的变化是哪里触发的、下一个在哪里。鼠标停在圆点上会显示它触发的操作。