dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/interaction/voice-waveform-live.md

@@ -1,54 +1,54 @@
----
-name: voice-waveform-live
-一句话: 录音胶囊实时声纹——64 根细竖条随"说话"起伏，说话时中部高耸、停顿缩成点线，波形从右往左滚动；说→停→说→提交塌缩的完整表演
-适用: 语音输入/AI 助手"正在听你说"的功能镜头；无 UI 内容可展示但需要持续活性撑画面的段落
-时长: 172f（~5.7s：入场 14f + 说 1.4s + 停 0.8s + 说 1.4s + 提交塌缩 / 收进气泡 0.8s + hold 0.7s）
-能量: 中（功能性活性，不是炫技）
----
-
-## 意图
-本卡是**功能性**声纹："正在听你说"的实时回执。命门在因果：
-波形跟"用户说话"跳、是产品功能本身，不是跟 BGM 跳的装饰包装。
-说话时波形高耸、停顿时缩成一排点线、历史向左滚出——观众从波形的起伏读出"它真的在听"，一段 6s+ 的画面全靠这份
-活性撑住，不需要任何别的内容。与 gauge-readout-moves 分工：仪表是
-"报一个数值"的机械仪式，本卡是"持续监听"的生命体征，没有终值。
-
-## 动效核心
-- **帧确定的伪随机是命门**：mulberry32 按整数采样点取值 + smoothstep
-  相邻插值（值噪声），无 Math.random——渲染可复现且相邻帧连续
-- 滚动感：第 i 条采样时刻 = f - (N-1-i)·1.6，最右条是"现在"，
-  历史向左流；不是条在平移，是每条在读不同时刻的信号
-- 条高 = 说话包络（梯形 seg 说/停两档 + 音节噪声 0.55+0.45·noise）
-  × 中部空间权重 sin^0.8 × 逐条 jitter（0.35+0.65·noise）；
-  静默钳到 6px 点线
-- 提交：按钮 3f 压缩 scale 1→0.82→1 回弹，波形 12f ease-in 塌缩
-  到 0.06，麦克风呼吸环随包络外扩
-- demo 加了一层实时转写（92px 粗体）：每个词在它那一拍的音节起点由虚到实升起，刚说出的词是强调色、
-  几帧后沉成墨色，停顿时尾光标闪烁；提交时整段转写上移缩小收进强调色消息气泡——
-  "停"从字和波形两处同时读得到，结尾帧是一张完整的对话海报
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 条数/间隙 | 64 条，gap 5px（1240px 宽胶囊，声纹区 ≈820px） | 少于 40 条读作均衡器；密过 90 条单条读不出起伏 |
-| 滚动速率 | 1.6 帧/采样点 | 快了历史刷太快像故障；慢了"滚动感"消失变成原地抖 |
-| 说停包络 | seg 梯形 rise 5f / fall 7f；demo 说 15–57f、停 80–124f | 停顿段必须真的塌成点线——没有"停"的对比，"说"就不成立 |
-| 音节噪声 | 0.55+0.45·noiseAt(t/4.5) | 去掉音节层波形是平滑山丘，读不出"一句话的顿挫" |
-| 中部权重 | sin^0.8 空间包络 | 无权重全场等高像均衡器；指数 >1.5 中间独秀像单根跳 |
-| 静默钳位 | max 6px 点线（点线用中性弱色，说话条用强调色渐变） | 钳 0 波形消失读作断线；点线是"在听但你没说" |
-| 提交塌缩 | 12f ease-in 到 0.06 + 按钮压缩回弹 3f | 塌缩是"这段话被收走了"；淡出读不出提交语义 |
-| 转写节奏 | 词出现帧 = 该词音节起点（包络 rise 段内），8f 由虚到实 | 词比波形早出读作字幕先于声音；晚 10f 以上读作延迟识别 |
-| 收进气泡 | 22f EASE.swift 上移 + 缩到 0.72，气泡底 / 白字 10f 跟进 | 只淡出转写读不出"发出去了" |
-
-## 已知坑
-- demo 在 video-shotcraft 语音口述分镜（"Shotcraft is listening"）的暖色亮场上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **有音轨时波形必须跟人声走**：片子若配了真旁白/人声，包络的说停段要对齐音轨的说停，错位一秒就穿帮；无人声配乐片才可用纯合成包络
-- demo 是亮场暖白实底胶囊（顶部 1.5px 内高光 + 两层落地影）；暗场片子换成 1.5px 渐变边玻璃胶囊即可，声纹参数不变
-- 麦克风已是 SVG 线性图标（早期 emoji + grayscale 占位已换掉），实战按品牌图标库替换即可
-- 声音：本卡画面就是"声音的形状"，配人声最顺；提交钮一声轻 pop + 塌缩配短促下滑音
-
-## 参考实现
-demos/interaction/voice-waveform-live/
-（VoiceWaveformLive.tsx）
-原片出处：raycast-teams 19.5–26.0s
+---
+name: voice-waveform-live
+一句话: 录音胶囊实时声纹——64 根细竖条随"说话"起伏，说话时中部高耸、停顿缩成点线，波形从右往左滚动；说→停→说→提交塌缩的完整表演
+适用: 语音输入/AI 助手"正在听你说"的功能镜头；无 UI 内容可展示但需要持续活性撑画面的段落
+时长: 172f（~5.7s：入场 14f + 说 1.4s + 停 0.8s + 说 1.4s + 提交塌缩 / 收进气泡 0.8s + hold 0.7s）
+能量: 中（功能性活性，不是炫技）
+---
+
+## 意图
+本卡是**功能性**声纹："正在听你说"的实时回执。命门在因果：
+波形跟"用户说话"跳、是产品功能本身，不是跟 BGM 跳的装饰包装。
+说话时波形高耸、停顿时缩成一排点线、历史向左滚出——观众从波形的起伏读出"它真的在听"，一段 6s+ 的画面全靠这份
+活性撑住，不需要任何别的内容。与 gauge-readout-moves 分工：仪表是
+"报一个数值"的机械仪式，本卡是"持续监听"的生命体征，没有终值。
+
+## 动效核心
+- **帧确定的伪随机是命门**：mulberry32 按整数采样点取值 + smoothstep
+  相邻插值（值噪声），无 Math.random——渲染可复现且相邻帧连续
+- 滚动感：第 i 条采样时刻 = f - (N-1-i)·1.6，最右条是"现在"，
+  历史向左流；不是条在平移，是每条在读不同时刻的信号
+- 条高 = 说话包络（梯形 seg 说/停两档 + 音节噪声 0.55+0.45·noise）
+  × 中部空间权重 sin^0.8 × 逐条 jitter（0.35+0.65·noise）；
+  静默钳到 6px 点线
+- 提交：按钮 3f 压缩 scale 1→0.82→1 回弹，波形 12f ease-in 塌缩
+  到 0.06，麦克风呼吸环随包络外扩
+- demo 加了一层实时转写（92px 粗体）：每个词在它那一拍的音节起点由虚到实升起，刚说出的词是强调色、
+  几帧后沉成墨色，停顿时尾光标闪烁；提交时整段转写上移缩小收进强调色消息气泡——
+  "停"从字和波形两处同时读得到，结尾帧是一张完整的对话海报
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 条数/间隙 | 64 条，gap 5px（1240px 宽胶囊，声纹区 ≈820px） | 少于 40 条读作均衡器；密过 90 条单条读不出起伏 |
+| 滚动速率 | 1.6 帧/采样点 | 快了历史刷太快像故障；慢了"滚动感"消失变成原地抖 |
+| 说停包络 | seg 梯形 rise 5f / fall 7f；demo 说 15–57f、停 80–124f | 停顿段必须真的塌成点线——没有"停"的对比，"说"就不成立 |
+| 音节噪声 | 0.55+0.45·noiseAt(t/4.5) | 去掉音节层波形是平滑山丘，读不出"一句话的顿挫" |
+| 中部权重 | sin^0.8 空间包络 | 无权重全场等高像均衡器；指数 >1.5 中间独秀像单根跳 |
+| 静默钳位 | max 6px 点线（点线用中性弱色，说话条用强调色渐变） | 钳 0 波形消失读作断线；点线是"在听但你没说" |
+| 提交塌缩 | 12f ease-in 到 0.06 + 按钮压缩回弹 3f | 塌缩是"这段话被收走了"；淡出读不出提交语义 |
+| 转写节奏 | 词出现帧 = 该词音节起点（包络 rise 段内），8f 由虚到实 | 词比波形早出读作字幕先于声音；晚 10f 以上读作延迟识别 |
+| 收进气泡 | 22f EASE.swift 上移 + 缩到 0.72，气泡底 / 白字 10f 跟进 | 只淡出转写读不出"发出去了" |
+
+## 已知坑
+- demo 在 video-shotcraft 语音口述分镜（"Shotcraft is listening"）的暖色亮场上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **有音轨时波形必须跟人声走**：片子若配了真旁白/人声，包络的说停段要对齐音轨的说停，错位一秒就穿帮；无人声配乐片才可用纯合成包络
+- demo 是亮场暖白实底胶囊（顶部 1.5px 内高光 + 两层落地影）；暗场片子换成 1.5px 渐变边玻璃胶囊即可，声纹参数不变
+- 麦克风已是 SVG 线性图标（早期 emoji + grayscale 占位已换掉），实战按品牌图标库替换即可
+- 声音：本卡画面就是"声音的形状"，配人声最顺；提交钮一声轻 pop + 塌缩配短促下滑音
+
+## 参考实现
+demos/interaction/voice-waveform-live/
+（VoiceWaveformLive.tsx）
+原片出处：raycast-teams 19.5–26.0s

package/lib/motion/shotcraft/upstream/references/shots/opening/brand-ink-open.md

@@ -1,36 +1,36 @@
----
-name: brand-ink-open
-一句话: 墨线十字准星描画→字标逐字压印→打字机副标→满一秒静止再上浮消散
-适用: 品牌开场；任何"先立名号再进产品"的片头
-时长: 约 2.8s（83f）
-能量: 低（起步位，为后续镜头留爬升空间）
-标签: typography
----
-
-## 意图
-第一拍先给品牌记忆点：观众在任何产品画面出现之前，先看清并记住名字。安静、纸墨质感、有一个完整的静止时刻。
-
-## 动效核心
-- SVG 十字准星笔画描画（pathLength dashoffset），先竖后横，画完淡出
-- 字标逐字 letterpress：scale 从大压到 1 + blur→0，字底强调色（模板片为琥珀）glint 短划闪过
-- kicker 副标打字机逐字符出现，强调色块光标周期闪烁
-- lockup 完整静止满 1 秒，然后整体上浮 + 缩小 + 淡出，交棒 dashboard
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 准星描画 | 竖线 0→9f、横线 8→18f，24→34f 淡出 | 描画完必须淡出，残留准星会和字标抢焦点 |
-| 字标逐字 | 第 i 字 delay=10+i·3、12f；scale 1.6→1（origin center bottom）+ blur 6px→0 | "opacity+位移/scale+blur→0"是全片入场三件套定式，缺 blur 会显得硬 |
-| kicker 打字机 | 0.7f/字符（28 起 ~43.4 完），光标 2f 周期闪、74f 停闪 | 0.7f/字符只适用于装饰性小字；正文交互打字要 3f/字符（对照 type-and-filter，用户嫌快返工过） |
-| 品牌 hold | 46→76 帧整整 1 秒 | 硬底线：用户两轮点名"出现后延长停留1秒"（R1）；短于 1s 必返工 |
-| 退场 | 7f 上浮 40px + 缩 12% + 淡出 | 退场快于入场——观众已读完，拖长反而泄气 |
-
-## 声音
-品牌落定钉 transition-soft（模板片钉在 f12），brand→dashboard 运镜钉 whoosh-fast（f78）。SFX 逐拍钉帧、声明式表管理（S2）；音色走电影系词汇，不用游戏 UI tap（S1）。
-
-## 已知坑
-- hold 要给的是 wordmark 落定时刻，不是普通字卡/内容卡（R1）——曾把 hold 错加给普通内容卡后很快回滚；指代含糊的"停留"反馈先确认对象再动手（P3）
-- 开场能量必须低起步：全片能量曲线低开→中段推进→outro 峰值，开场炫技会压死后面的爬升（对照 Q8 的能量曲线要求）
-
-## 参考实现
-demos/typography/brand-ink-open/BrandInkOpen.tsx（原 template/src/aifl/live/SceneOpen.tsx 帧 0–83 段）
+---
+name: brand-ink-open
+一句话: 墨线十字准星描画→字标逐字压印→打字机副标→满一秒静止再上浮消散
+适用: 品牌开场；任何"先立名号再进产品"的片头
+时长: 约 2.8s（83f）
+能量: 低（起步位，为后续镜头留爬升空间）
+标签: typography
+---
+
+## 意图
+第一拍先给品牌记忆点：观众在任何产品画面出现之前，先看清并记住名字。安静、纸墨质感、有一个完整的静止时刻。
+
+## 动效核心
+- SVG 十字准星笔画描画（pathLength dashoffset），先竖后横，画完淡出
+- 字标逐字 letterpress：scale 从大压到 1 + blur→0，字底强调色（模板片为琥珀）glint 短划闪过
+- kicker 副标打字机逐字符出现，强调色块光标周期闪烁
+- lockup 完整静止满 1 秒，然后整体上浮 + 缩小 + 淡出，交棒 dashboard
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 准星描画 | 竖线 0→9f、横线 8→18f，24→34f 淡出 | 描画完必须淡出，残留准星会和字标抢焦点 |
+| 字标逐字 | 第 i 字 delay=10+i·3、12f；scale 1.6→1（origin center bottom）+ blur 6px→0 | "opacity+位移/scale+blur→0"是全片入场三件套定式，缺 blur 会显得硬 |
+| kicker 打字机 | 0.7f/字符（28 起 ~43.4 完），光标 2f 周期闪、74f 停闪 | 0.7f/字符只适用于装饰性小字；正文交互打字要 3f/字符（对照 type-and-filter，用户嫌快返工过） |
+| 品牌 hold | 46→76 帧整整 1 秒 | 硬底线：用户两轮点名"出现后延长停留1秒"（R1）；短于 1s 必返工 |
+| 退场 | 7f 上浮 40px + 缩 12% + 淡出 | 退场快于入场——观众已读完，拖长反而泄气 |
+
+## 声音
+品牌落定钉 transition-soft（模板片钉在 f12），brand→dashboard 运镜钉 whoosh-fast（f78）。SFX 逐拍钉帧、声明式表管理（S2）；音色走电影系词汇，不用游戏 UI tap（S1）。
+
+## 已知坑
+- hold 要给的是 wordmark 落定时刻，不是普通字卡/内容卡（R1）——曾把 hold 错加给普通内容卡后很快回滚；指代含糊的"停留"反馈先确认对象再动手（P3）
+- 开场能量必须低起步：全片能量曲线低开→中段推进→outro 峰值，开场炫技会压死后面的爬升（对照 Q8 的能量曲线要求）
+
+## 参考实现
+demos/typography/brand-ink-open/BrandInkOpen.tsx（原 template/src/aifl/live/SceneOpen.tsx 帧 0–83 段）

package/lib/motion/shotcraft/upstream/references/shots/opening/crane-rise-reveal.md

@@ -1,56 +1,56 @@
----
-name: crane-rise-reveal
-一句话: 升降臂拉升揭示——开场怼在一行数据特写，相机沿 Y 轴减速升起后拉，行行涌入直到整面 dashboard 铺满全幅
-适用: "从细节到全局"的开场定场；与 drone-dive-landing（全局→单点俯冲）互为反向
-时长: 5.5s（165f：特写 hold 24f + 拉升 102f + 落定/余波/静止 39f）
-能量: 中高（持续单向运动，无冲击拍）
-标签: camera、data
----
-
-## 意图
-开场定场库内已有 drone-dive-landing——从上帝视角砸进 hero 特写，
-"全局→焦点"。本卡是它的镜像："焦点→全局"——先怼在一行真实数据上
-让观众看清"这是什么"，再升降臂式拉升后退，一排排内容涌入画面，
-最后整面产品铺满——"你看到的这一行，只是这一面墙的一格"。
-适合以产品体量/内容丰富度为卖点的开场；两卡同片只用一个方向。
-
-## 动效核心
-- transform-origin 固定左上，联动公式 `translate = 屏幕中心 − 对准点×scale`；
-  对准点沿 (追踪行左段)→(页面中心) 与 scale 3.0→1.0 **共用同一条
-  不对称缓动 bezier(0.2,0,0.25,1) 进度**——一条 p = 一台相机一次机动（同 C 式判例）
-- 减速曲线（先快后慢）是"升降臂"的手感：起步有劲、临顶缓停；零速起步、19% 处达峰
-  （≈2.3× 平均速），不从 hold 瞬间跳到最高速；hold 内相机先"吸一口气"推近 1.5% 作预备
-- 对焦：特写 hold 时只有被追踪的那一行是实的（钴蓝底 + 行首呼吸追踪点），其余行压到 38%，
-  起吊后 ~26f 回满——先让观众看清"这一个镜头"，再看全部
-- 逐行洗光：相机可见区上缘 `visTop = fy − 540/s` 首次越过某行顶边时，
-  该行一道强调色洗光从行首掠到行尾（3f 起、6f 后 18f 落，带 1px 强调色描边）——
-  "涌入"的可读性来源；触发帧逐帧解出，与运镜严格同步
-- 体量感：页头 KPI（今日渲染帧数）与拉升同期从 0 数到 48,210（expo-out，与运镜同帧收），窗口阴影随拉开
-  从贴近升到悬浮高度，舞台点阵按 0.35 视差慢移——窗口最后读作舞台上的一件实物
-- 余波：落定后追踪行的状态胶囊由「Rendering」翻成「Rendered」（弹簧 damping 16 + 对勾描画 + 进度条补满），
-  hold 段里唯一的小事件
-- 白底上"提亮"不可见，**加深/上色才可感**（判例：brightness 提亮在白卡上等于没做）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 起点特写 | scale 3.0，对准追踪行左段（镜头号 / 转场 63px 大字；取景下缘停在窗口底边上方，不露窗外） | hold ≥20f 让"这是一行数据"可读再起飞 |
-| 拉升 | 102f bezier(0.2,0,0.25,1)，scale 3.0→1.0 | 快于 80f 行洗光追不上；慢于 130f 中段拖 |
-| 对焦 | 非追踪行 38% → 100%，起吊后 26f | 不压暗时特写里每行同权，观众不知道看哪一行 |
-| 行洗光 | 越线触发，强调色从行首掠过 + 细描边，~24f | 洗光跟不上相机（固定间隔触发）立刻穿帮 |
-| 收尾 | 满幅后不再补推，靠状态翻转让 hold 活着，静止 ≥30f | R1；满幅帧即标准构图 |
-
-## 已知坑
-- demo 在虚构数据的手搓产品窗口（video-shotcraft 渲染队列）上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 起点特写 = 一行内容被放大 3.2 倍盯着看，真实素材先过
-  审美准则 Q2 的高分辨率栅格化技法，低倍截图开场即糊
-- 快速拉升段可包 CameraMotionBlur（参数见 deck-deal-flyin 运动模糊行），
-  但只包前半程快速段——临顶慢速段包了会抹软文字（轮 #8 判例）；
-  半透明洗光叠层别放进 CameraMotionBlur（多重采样叠加出竖条伪影），单独一层同相机
-- 与 drone-dive-landing 同片不并用（一升一降互为镜像，观众读作同一招）；
-  与 crane 语义最近的 tilt-reveal 未入库，别混称
-
-## 参考实现
-demos/opening/crane-rise-reveal/
-（CraneRiseReveal.tsx）
+---
+name: crane-rise-reveal
+一句话: 升降臂拉升揭示——开场怼在一行数据特写，相机沿 Y 轴减速升起后拉，行行涌入直到整面 dashboard 铺满全幅
+适用: "从细节到全局"的开场定场；与 drone-dive-landing（全局→单点俯冲）互为反向
+时长: 5.5s（165f：特写 hold 24f + 拉升 102f + 落定/余波/静止 39f）
+能量: 中高（持续单向运动，无冲击拍）
+标签: camera、data
+---
+
+## 意图
+开场定场库内已有 drone-dive-landing——从上帝视角砸进 hero 特写，
+"全局→焦点"。本卡是它的镜像："焦点→全局"——先怼在一行真实数据上
+让观众看清"这是什么"，再升降臂式拉升后退，一排排内容涌入画面，
+最后整面产品铺满——"你看到的这一行，只是这一面墙的一格"。
+适合以产品体量/内容丰富度为卖点的开场；两卡同片只用一个方向。
+
+## 动效核心
+- transform-origin 固定左上，联动公式 `translate = 屏幕中心 − 对准点×scale`；
+  对准点沿 (追踪行左段)→(页面中心) 与 scale 3.0→1.0 **共用同一条
+  不对称缓动 bezier(0.2,0,0.25,1) 进度**——一条 p = 一台相机一次机动（同 C 式判例）
+- 减速曲线（先快后慢）是"升降臂"的手感：起步有劲、临顶缓停；零速起步、19% 处达峰
+  （≈2.3× 平均速），不从 hold 瞬间跳到最高速；hold 内相机先"吸一口气"推近 1.5% 作预备
+- 对焦：特写 hold 时只有被追踪的那一行是实的（钴蓝底 + 行首呼吸追踪点），其余行压到 38%，
+  起吊后 ~26f 回满——先让观众看清"这一个镜头"，再看全部
+- 逐行洗光：相机可见区上缘 `visTop = fy − 540/s` 首次越过某行顶边时，
+  该行一道强调色洗光从行首掠到行尾（3f 起、6f 后 18f 落，带 1px 强调色描边）——
+  "涌入"的可读性来源；触发帧逐帧解出，与运镜严格同步
+- 体量感：页头 KPI（今日渲染帧数）与拉升同期从 0 数到 48,210（expo-out，与运镜同帧收），窗口阴影随拉开
+  从贴近升到悬浮高度，舞台点阵按 0.35 视差慢移——窗口最后读作舞台上的一件实物
+- 余波：落定后追踪行的状态胶囊由「Rendering」翻成「Rendered」（弹簧 damping 16 + 对勾描画 + 进度条补满），
+  hold 段里唯一的小事件
+- 白底上"提亮"不可见，**加深/上色才可感**（判例：brightness 提亮在白卡上等于没做）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 起点特写 | scale 3.0，对准追踪行左段（镜头号 / 转场 63px 大字；取景下缘停在窗口底边上方，不露窗外） | hold ≥20f 让"这是一行数据"可读再起飞 |
+| 拉升 | 102f bezier(0.2,0,0.25,1)，scale 3.0→1.0 | 快于 80f 行洗光追不上；慢于 130f 中段拖 |
+| 对焦 | 非追踪行 38% → 100%，起吊后 26f | 不压暗时特写里每行同权，观众不知道看哪一行 |
+| 行洗光 | 越线触发，强调色从行首掠过 + 细描边，~24f | 洗光跟不上相机（固定间隔触发）立刻穿帮 |
+| 收尾 | 满幅后不再补推，靠状态翻转让 hold 活着，静止 ≥30f | R1；满幅帧即标准构图 |
+
+## 已知坑
+- demo 在虚构数据的手搓产品窗口（video-shotcraft 渲染队列）上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 起点特写 = 一行内容被放大 3.2 倍盯着看，真实素材先过
+  审美准则 Q2 的高分辨率栅格化技法，低倍截图开场即糊
+- 快速拉升段可包 CameraMotionBlur（参数见 deck-deal-flyin 运动模糊行），
+  但只包前半程快速段——临顶慢速段包了会抹软文字（轮 #8 判例）；
+  半透明洗光叠层别放进 CameraMotionBlur（多重采样叠加出竖条伪影），单独一层同相机
+- 与 drone-dive-landing 同片不并用（一升一降互为镜像，观众读作同一招）；
+  与 crane 语义最近的 tilt-reveal 未入库，别混称
+
+## 参考实现
+demos/opening/crane-rise-reveal/
+（CraneRiseReveal.tsx）

package/lib/motion/shotcraft/upstream/references/shots/opening/dataviz-landscape-open.md

@@ -1,56 +1,56 @@
----
-name: dataviz-landscape-open
-一句话: 暗场支流线束地景开场——多条流线汇入主干、虚构 ID 标签浮在线上、相机重景深低速飞越
-适用: 品牌级抽象开场（"数据宇宙"隐喻），接亮场产品段或字标；与 glow-flyline-moves 分工：那卡是段落内卡片之间的连线叙事，本卡是开场专用的全画幅地景
-时长: 5–8s（开场氛围段，一支片 ≤1 次；demo 180f）
-能量: 低开缓升（起步位，为后续爬升留空间）
-标签: data、camera
----
-
-## 意图
-Linear Releases 发布片开场实证的品牌级开场品类：把产品背后的数据世界
-拍成一片**暗场地景**——支流线束从画面深处汇入一条主干（"无数工作流
-汇成一个产品"的隐喻），真实感来自三样东西：①虚构 issue/任务 ID 标签
-浮在线上（demo 用 video-shotcraft 的镜头号 + 运镜名：每条支流是一个镜头，汇成一支成片）（观众认出"这是我每天看到的那种东西"）；②重景深——近景大虚焦
-流过、中景标签清晰可读、远景渐隐，三层纵深让平面 SVG 读作空间；
-③相机低速匀稳飞越——这是氛围段不是炫技段，速度感交给后面的镜头。
-手搓 UI 合规依据：非复刻场景（页面上不存在此画面），按核心理念 1
-修订版走质量+表达明确性门槛。
-
-## 动作阶段
-| 阶段 | 帧段（@30fps 参考，demo 180f） | 内容 |
-|------|------|------|
-| 1 生长 | f0–70 | 主干由近及远 draw-on 奔向消失点（36f out-cubic，笔尖光点），支流从两侧画外错峰 4–6f 生长、切向汇入 |
-| 2 飞越 | f0–180 | 相机低空沿河道前飞 + 横向缓移（与生长期跨骑），标签 f44–96 非均匀错峰立起，生长完的线上亮脉冲流向汇点 |
-| 3 交棒 | f104–180 | 标签停止新增；消失点亮起一团强调色光，天空落一行大标题；相机 bezier 减速缓停，hold ≥30f |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 线束规模 | 支流 8–14 条汇入 1 条主干（demo 11 条，含 1 条贴镜头掠过的近景支流） | 超过 ~16 条读作屏保/科技模板；主干必须唯一（单主角原则的地景版） |
-| 地景投影 | 线画在真透视地平面上：针孔投影 `sx = 960 + F·(X−camX)/Z'`、`sy = 地平线 + F·camH/Z'`，F 1100、相机高 220、地平线 0.39 帧高 | 平面 SVG 横移要手工凑三层视差；真投影的近大远小、视差、汇聚全部白给 |
-| 汇流拓扑 | 支流以 bezier 切向汇入主干（汇入点切线 = 主干切线），主干走向让消失点落在画面右 1/3 | 垂直相交读作电路图不是水系；消失点居中构图死板 |
-| 景深 | 按投影深度逐段分层：Z' <~1000 进模糊层（blur 11px、线宽 ×1.3）、中景锐利、Z' >2600 起雾化变淡；线宽 = 世界线宽·F/Z' | 近景不虚焦则读作线框图；远景不雾化会在地平线挤成一团亮 |
-| 相机飞越 | 前飞 950 世界单位 / 180f，bezier(0.3,0.3,0.55,1)：开场即在飞、尾段减速缓停；叠横向缓移 −140→110 | 快了变追逐镜头（那是 crash-zoom 的活）；只前推不横移时远近错动弱 |
-| 线段绘制 | 每条线按弧长等距采样后逐段画（逐段线宽/透明度），**butt 端帽** | round 端帽在半透明线上每个接缝叠一圈，整条线读成串珠 |
-| 流动感 | 生长完成后沿线窄峰亮脉冲低速漂向汇点，只在中远景显形（近处一段在屏上很长，逐段明暗读成台阶） | 生长期结束后无流动元素，后半段退化成"路线图飞越"不是"数据流" |
-| 标签 | 中景 5–9 枚（demo 6）：强调色方块图钉落在线上 + 短立杆 + 等宽 ID 胶囊，按 1500/Z' 透视缩放（钳 0.7–1.7）；远的先画近的后画 | **立杆世界高度要远低于相机高度**——杆高≈相机高时所有标签都投影到地平线上挤成一排；位置要逐帧投影核过起止两端都不叠 |
-| 生长节奏 | 主干 30–40f out-cubic 先行，支流每条错峰 3–6f | 全部同帧生长读作 loading 动画 |
-| 收尾 | 交棒帧前 ≥15f 标签停止新增、相机减速不急刹；标题（眉题 + 两行 108px）逐词升起 | 氛围段急刹是一次可见的顿挫（glow-orb 收敛判例同源） |
-
-## 已知坑
-- 借鉴来源：Linear Releases 开场（进化轮 #3 breakdown #7），单例样本
-  ——参数给区间不给教条，首次实战以真实素材回验
-- 与 glow-flyline-moves 别混用在相邻段落：两卡都是"暗场发光线"，
-  背靠背出现读作全片只会一招；同片都要用时中间隔 ≥2 个亮场镜头
-- 暗场进出成本同 glow 卡：接亮场产品段用 shot-transitions 藏切族垫，
-  别生切明暗
-- 线条纯白全亮会糊成蛛网——亮度按层拉开（见参数表），中景才是主角层；
-  主干/支流给 1–2px 微辉光（soft glow）压出"发光线"氛围，全无辉光读作线框图（Q4 单点光效许可内）
-- 标签字号在目标画幅下 ≥18px 等效，否则"可读"沦为装饰噪点（Q6 同源）
-- 声音：铺 riser/低频 pad 底噪，标签浮现不逐枚打点（批量不逐个发声，
-  S2 同源）；交棒帧一次 whoosh/impact 交给下一镜头
-
-## 参考实现
-demos/opening/dataviz-landscape-open/
-（DatavizLandscapeOpen.tsx）
+---
+name: dataviz-landscape-open
+一句话: 暗场支流线束地景开场——多条流线汇入主干、虚构 ID 标签浮在线上、相机重景深低速飞越
+适用: 品牌级抽象开场（"数据宇宙"隐喻），接亮场产品段或字标；与 glow-flyline-moves 分工：那卡是段落内卡片之间的连线叙事，本卡是开场专用的全画幅地景
+时长: 5–8s（开场氛围段，一支片 ≤1 次；demo 180f）
+能量: 低开缓升（起步位，为后续爬升留空间）
+标签: data、camera
+---
+
+## 意图
+Linear Releases 发布片开场实证的品牌级开场品类：把产品背后的数据世界
+拍成一片**暗场地景**——支流线束从画面深处汇入一条主干（"无数工作流
+汇成一个产品"的隐喻），真实感来自三样东西：①虚构 issue/任务 ID 标签
+浮在线上（demo 用 video-shotcraft 的镜头号 + 运镜名：每条支流是一个镜头，汇成一支成片）（观众认出"这是我每天看到的那种东西"）；②重景深——近景大虚焦
+流过、中景标签清晰可读、远景渐隐，三层纵深让平面 SVG 读作空间；
+③相机低速匀稳飞越——这是氛围段不是炫技段，速度感交给后面的镜头。
+手搓 UI 合规依据：非复刻场景（页面上不存在此画面），按核心理念 1
+修订版走质量+表达明确性门槛。
+
+## 动作阶段
+| 阶段 | 帧段（@30fps 参考，demo 180f） | 内容 |
+|------|------|------|
+| 1 生长 | f0–70 | 主干由近及远 draw-on 奔向消失点（36f out-cubic，笔尖光点），支流从两侧画外错峰 4–6f 生长、切向汇入 |
+| 2 飞越 | f0–180 | 相机低空沿河道前飞 + 横向缓移（与生长期跨骑），标签 f44–96 非均匀错峰立起，生长完的线上亮脉冲流向汇点 |
+| 3 交棒 | f104–180 | 标签停止新增；消失点亮起一团强调色光，天空落一行大标题；相机 bezier 减速缓停，hold ≥30f |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 线束规模 | 支流 8–14 条汇入 1 条主干（demo 11 条，含 1 条贴镜头掠过的近景支流） | 超过 ~16 条读作屏保/科技模板；主干必须唯一（单主角原则的地景版） |
+| 地景投影 | 线画在真透视地平面上：针孔投影 `sx = 960 + F·(X−camX)/Z'`、`sy = 地平线 + F·camH/Z'`，F 1100、相机高 220、地平线 0.39 帧高 | 平面 SVG 横移要手工凑三层视差；真投影的近大远小、视差、汇聚全部白给 |
+| 汇流拓扑 | 支流以 bezier 切向汇入主干（汇入点切线 = 主干切线），主干走向让消失点落在画面右 1/3 | 垂直相交读作电路图不是水系；消失点居中构图死板 |
+| 景深 | 按投影深度逐段分层：Z' <~1000 进模糊层（blur 11px、线宽 ×1.3）、中景锐利、Z' >2600 起雾化变淡；线宽 = 世界线宽·F/Z' | 近景不虚焦则读作线框图；远景不雾化会在地平线挤成一团亮 |
+| 相机飞越 | 前飞 950 世界单位 / 180f，bezier(0.3,0.3,0.55,1)：开场即在飞、尾段减速缓停；叠横向缓移 −140→110 | 快了变追逐镜头（那是 crash-zoom 的活）；只前推不横移时远近错动弱 |
+| 线段绘制 | 每条线按弧长等距采样后逐段画（逐段线宽/透明度），**butt 端帽** | round 端帽在半透明线上每个接缝叠一圈，整条线读成串珠 |
+| 流动感 | 生长完成后沿线窄峰亮脉冲低速漂向汇点，只在中远景显形（近处一段在屏上很长，逐段明暗读成台阶） | 生长期结束后无流动元素，后半段退化成"路线图飞越"不是"数据流" |
+| 标签 | 中景 5–9 枚（demo 6）：强调色方块图钉落在线上 + 短立杆 + 等宽 ID 胶囊，按 1500/Z' 透视缩放（钳 0.7–1.7）；远的先画近的后画 | **立杆世界高度要远低于相机高度**——杆高≈相机高时所有标签都投影到地平线上挤成一排；位置要逐帧投影核过起止两端都不叠 |
+| 生长节奏 | 主干 30–40f out-cubic 先行，支流每条错峰 3–6f | 全部同帧生长读作 loading 动画 |
+| 收尾 | 交棒帧前 ≥15f 标签停止新增、相机减速不急刹；标题（眉题 + 两行 108px）逐词升起 | 氛围段急刹是一次可见的顿挫（glow-orb 收敛判例同源） |
+
+## 已知坑
+- 借鉴来源：Linear Releases 开场（进化轮 #3 breakdown #7），单例样本
+  ——参数给区间不给教条，首次实战以真实素材回验
+- 与 glow-flyline-moves 别混用在相邻段落：两卡都是"暗场发光线"，
+  背靠背出现读作全片只会一招；同片都要用时中间隔 ≥2 个亮场镜头
+- 暗场进出成本同 glow 卡：接亮场产品段用 shot-transitions 藏切族垫，
+  别生切明暗
+- 线条纯白全亮会糊成蛛网——亮度按层拉开（见参数表），中景才是主角层；
+  主干/支流给 1–2px 微辉光（soft glow）压出"发光线"氛围，全无辉光读作线框图（Q4 单点光效许可内）
+- 标签字号在目标画幅下 ≥18px 等效，否则"可读"沦为装饰噪点（Q6 同源）
+- 声音：铺 riser/低频 pad 底噪，标签浮现不逐枚打点（批量不逐个发声，
+  S2 同源）；交棒帧一次 whoosh/impact 交给下一镜头
+
+## 参考实现
+demos/opening/dataviz-landscape-open/
+（DatavizLandscapeOpen.tsx）

package/lib/motion/shotcraft/upstream/references/shots/opening/fracture.md

@@ -1,40 +1,40 @@
----
-name: fracture
-一句话: 5×5 瓦片从 3D 碎片态按中心波纹逐圈聚合成整面海报，停一拍亮字，随后全部碎片背离中心加速旋转飞出画面
-适用: 开场第一镜"从混沌到成形"的品牌/海报揭示；倒放或只取后半可作硬转场
-时长: 约 5.2s（156f@30fps；聚合 0–2.6s · hold 1s · 飞散 1.5s）
-能量: 高（两头高能、中段静止，适合压 BGM 重音起收）
----
-
-## 意图
-把"产品成形"拍成物理事件：碎片从三维空间各自带着旋转飞回原位，观众看着一面完整画面从无序中长出来；hold 读字后再整体炸出画面，把注意力干净地交给下一镜。进出对称，一支素材可正反两用。
-
-## 动效核心
-- 25 块瓦片各自持有确定性伪随机的初始姿态：位移 ±450/±300/±490px（x/y/z）+ 三轴 ±180° 旋转，由 `rand(seed)` 生成，渲染可复现
-- 入场按曼哈顿距离波纹 stagger：`delay = (|r-2|+|c-2|) * 0.045`，中心先就位、四角最后，每块 0.34 时长走 `bezier(0.42,0,0.3,1)`（落位前长减速）；落位后 ~10f 一次 ≤2.5° 的 rotateX 阻尼小摆 = 入槽"咔哒"
-- 25 块切的是**同一张海报**（每块按格位偏移取自己那一格），拼齐才看见完整画面；瓦片按朝向做明暗（越侧对镜头越暗）
-- opacity 以 `tin * 2.5` 快速升到 1——碎片远处即近乎实体，避免"淡入感"稀释物理感
-- 海报上印眉题 INTRODUCING + video-shotcraft 字标（标志 + 小写字标），随瓦片切片，t=0.42–0.52 亮起占住 hold 段视线；退场不单独淡出，字和标志跟着碎片一起被撕走；hold 段整面极缓推近 3%
-- 退场不淡出：每块沿背离画面中心的方向（`atan2` 计算 + ±0.8 抖动）飞出 620–880px 并加旋 ±150°，`inCubic` 加速，实体出画
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 网格 | 5×5，380×230px，perspective 900px | 瓦片更多波纹更细腻但单块存在感下降；persp <700 透视夸张易穿帮 |
-| 初始散布 | dx±450 / dy±300 / dz −210~+490 | 放大散布开场更混沌，但聚合路径变长需同步加 delay 窗口 |
-| 波纹间隔 | 0.045/环（曼哈顿距离） | >0.07 波纹感变"逐圈点名"；<0.03 全体近同时到位失去波纹 |
-| 入场时长 | 每块 0.34（inOutCubic） | 缩短更"啪"地成形；配合波纹间隔保证末块 ≤0.6 就位 |
-| 退场窗口 | 0.70 + delay×0.5 起飞，0.18 时长（inCubic） | **窗口必须收在 t≈0.97 前**：曾因 0.72+delay×0.7/0.26 导致角瓦片出画不完、卡在画框边一秒（判例 2026-08-05） |
-| 退场距离 | 620–880px（背离中心 + 随机抖动） | 距离不足会残留在画框边；中心瓦片方向随机（无"背离"可言） |
-| 海报配色 | `ACCENT_HUE=218` 派生整张海报（冷色深场 + 左上柔光 + 底部发光地平线弧） | 改一个色相常量整面换色；拼缝 0.5 设计 px，再宽会把字切缺笔 |
-
-## 已知坑
-- 退场用位移出画而非 opacity 淡出——淡出会读作"消失"而非"飞走"，物理感尽失；改参数时保持 `opacity = min(1, tin*2.5)` 不挂退场项
-- 所有随机量必须走确定性 `rand(seed)`（等价 Remotion `random()`），真随机会渲染间抖动
-- hold 段（t≈0.6–0.7）是唯一读字窗口，加长文案要同步拉开 label 淡出与首块起飞的间隔，否则字还没读完瓦片已散
-- 标志别跨拼缝：拼缝会把标志切出一条细缝/残边，读作坏图。demo 把字标中心对准第 3 行瓦片中心、字号定 22 让标志整个落在第 2 列瓦片里，碎片飞散时标志随一块瓦片完整飞走；换标志尺寸或网格时同步重算
-- 用作转场时建议只取 t=0.7–1 的飞散段倒放/正放各半，两侧素材分别贴在瓦片面上需另做纹理映射
-
-## 参考实现
-demos/opening/fracture/
-（Fracture.tsx）
+---
+name: fracture
+一句话: 5×5 瓦片从 3D 碎片态按中心波纹逐圈聚合成整面海报，停一拍亮字，随后全部碎片背离中心加速旋转飞出画面
+适用: 开场第一镜"从混沌到成形"的品牌/海报揭示；倒放或只取后半可作硬转场
+时长: 约 5.2s（156f@30fps；聚合 0–2.6s · hold 1s · 飞散 1.5s）
+能量: 高（两头高能、中段静止，适合压 BGM 重音起收）
+---
+
+## 意图
+把"产品成形"拍成物理事件：碎片从三维空间各自带着旋转飞回原位，观众看着一面完整画面从无序中长出来；hold 读字后再整体炸出画面，把注意力干净地交给下一镜。进出对称，一支素材可正反两用。
+
+## 动效核心
+- 25 块瓦片各自持有确定性伪随机的初始姿态：位移 ±450/±300/±490px（x/y/z）+ 三轴 ±180° 旋转，由 `rand(seed)` 生成，渲染可复现
+- 入场按曼哈顿距离波纹 stagger：`delay = (|r-2|+|c-2|) * 0.045`，中心先就位、四角最后，每块 0.34 时长走 `bezier(0.42,0,0.3,1)`（落位前长减速）；落位后 ~10f 一次 ≤2.5° 的 rotateX 阻尼小摆 = 入槽"咔哒"
+- 25 块切的是**同一张海报**（每块按格位偏移取自己那一格），拼齐才看见完整画面；瓦片按朝向做明暗（越侧对镜头越暗）
+- opacity 以 `tin * 2.5` 快速升到 1——碎片远处即近乎实体，避免"淡入感"稀释物理感
+- 海报上印眉题 INTRODUCING + video-shotcraft 字标（标志 + 小写字标），随瓦片切片，t=0.42–0.52 亮起占住 hold 段视线；退场不单独淡出，字和标志跟着碎片一起被撕走；hold 段整面极缓推近 3%
+- 退场不淡出：每块沿背离画面中心的方向（`atan2` 计算 + ±0.8 抖动）飞出 620–880px 并加旋 ±150°，`inCubic` 加速，实体出画
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 网格 | 5×5，380×230px，perspective 900px | 瓦片更多波纹更细腻但单块存在感下降；persp <700 透视夸张易穿帮 |
+| 初始散布 | dx±450 / dy±300 / dz −210~+490 | 放大散布开场更混沌，但聚合路径变长需同步加 delay 窗口 |
+| 波纹间隔 | 0.045/环（曼哈顿距离） | >0.07 波纹感变"逐圈点名"；<0.03 全体近同时到位失去波纹 |
+| 入场时长 | 每块 0.34（inOutCubic） | 缩短更"啪"地成形；配合波纹间隔保证末块 ≤0.6 就位 |
+| 退场窗口 | 0.70 + delay×0.5 起飞，0.18 时长（inCubic） | **窗口必须收在 t≈0.97 前**：曾因 0.72+delay×0.7/0.26 导致角瓦片出画不完、卡在画框边一秒（判例 2026-08-05） |
+| 退场距离 | 620–880px（背离中心 + 随机抖动） | 距离不足会残留在画框边；中心瓦片方向随机（无"背离"可言） |
+| 海报配色 | `ACCENT_HUE=218` 派生整张海报（冷色深场 + 左上柔光 + 底部发光地平线弧） | 改一个色相常量整面换色；拼缝 0.5 设计 px，再宽会把字切缺笔 |
+
+## 已知坑
+- 退场用位移出画而非 opacity 淡出——淡出会读作"消失"而非"飞走"，物理感尽失；改参数时保持 `opacity = min(1, tin*2.5)` 不挂退场项
+- 所有随机量必须走确定性 `rand(seed)`（等价 Remotion `random()`），真随机会渲染间抖动
+- hold 段（t≈0.6–0.7）是唯一读字窗口，加长文案要同步拉开 label 淡出与首块起飞的间隔，否则字还没读完瓦片已散
+- 标志别跨拼缝：拼缝会把标志切出一条细缝/残边，读作坏图。demo 把字标中心对准第 3 行瓦片中心、字号定 22 让标志整个落在第 2 列瓦片里，碎片飞散时标志随一块瓦片完整飞走；换标志尺寸或网格时同步重算
+- 用作转场时建议只取 t=0.7–1 的飞散段倒放/正放各半，两侧素材分别贴在瓦片面上需另做纹理映射
+
+## 参考实现
+demos/opening/fracture/
+（Fracture.tsx）