dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/camera/steep-tilt-glide.md

@@ -1,52 +1,52 @@
----
-name: steep-tilt-glide
-一句话: 固定镜头下直立页面以 60° 强透视侧立（右近左远），页面自身沿其 3D 横面方向滑移掠过镜头（物动镜不动），滑移带速度重影、文字组件悬空贴落、由暗揭亮
-适用: 长页面/多区块 UI 的炫技巡览（内容依次滑过固定机位）；暗场霓虹调性；与贴面运镜卡互补的"侧掠"机位
-时长: 4s（120f）单镜；页面越宽越可拉长
-能量: 中高（透视炫技+持续运动，但节奏是匀的）
-标签: ui-entrance
----
-
-## 意图
-把页面立成一堵斜墙：镜头钉死不动，60° 强透视让右缘贴脸、左缘
-消失在灭点，页面自己沿自身平面横向滑移——内容像列车车厢一样
-依次掠过。命门是**物动镜不动**：perspective/origin/rotY 全程常数，
-唯一动的量是页面局部 translateX——镜头一动语义就变成运镜炫技，
-这里的戏是"页面在自我展示"。角度经三轮收敛为精确 60°
-（-45°"不对"→-53°"再大一点"→-60°选中）。
-
-## 动效核心
-- 镜头常数：perspective 1100、origin 30% 58%、rotateY(-60°)+
-  rotateZ(-2°)，transformOrigin left top，全程一个数不变
-- 页面：超宽面板（6200×2400@内容坐标），沿局部 X 轴 +60→-4100
-  滑移，bezier(0.3,0.12,0.72,0.9)——起步柔和后近匀速，尾段斜率
-  不归零（不安定停死）
-- 速度重影：拖尾层=过去时刻（f-1.6/-3.2/-4.8 三层，权重递减）的局部位置重投影，
-  透明度 ∝ 滑移速度（快时重影浓）
-- 悬空贴落：页面元素 FloatWrap 悬浮 230–280px 带同形软影，随
-  滑移进程错峰贴落（巡礼语法）
-- 揭亮：起始面板压暗 0.7，~1.4s 揭到全亮；左缘额外渐变阴影同退
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 倾斜角 | rotateY **-60°**（用户精确定值） | -45° 被裁"角度不对"、-53°"再大一点"；>-70° 内容读不清 |
-| 运动模型 | 镜头全常数、页面自移 | **命门**——镜头横移版被裁"镜头是固定的，页面本身往其3d空间的横面方向移动" |
-| 滑移曲线 | 尾段斜率不归零的 bezier | 中途停死被抓（v4 返工）；全 linear 少了起步呼吸 |
-| 重影 | 透明度∝速度，三层 f-1.6/-3.2/-4.8 | 恒定重影读作重像故障 |
-| 页面宽度 | ≥3 屏内容 | 太窄滑两秒就完，撑不起一镜 |
-| 悬空贴落 | 错峰（巡礼语法）+ 影随高度 | 语义判例见 graze-face-tour/orbit-drop 三卡族 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 角度判例：透视角是本卡身份，实战微调范围建议 55–65°，出这个
-  区间等于换手法
-- 与 graze-face-tour 分工：那张镜头动（贴面游走）、页面静；本卡
-  镜头静、页面动。同段落二选一
-- 超宽页面手绘成本高；实战可用真实长截图代替（滑移逻辑不变）
-
-## 参考实现
-demos/camera/steep-tilt-glide/
-（SteepTiltGlide.tsx）
-原片出处：clickup-30.mp4
+---
+name: steep-tilt-glide
+一句话: 固定镜头下直立页面以 60° 强透视侧立（右近左远），页面自身沿其 3D 横面方向滑移掠过镜头（物动镜不动），滑移带速度重影、文字组件悬空贴落、由暗揭亮
+适用: 长页面/多区块 UI 的炫技巡览（内容依次滑过固定机位）；暗场霓虹调性；与贴面运镜卡互补的"侧掠"机位
+时长: 4s（120f）单镜；页面越宽越可拉长
+能量: 中高（透视炫技+持续运动，但节奏是匀的）
+标签: ui-entrance
+---
+
+## 意图
+把页面立成一堵斜墙：镜头钉死不动，60° 强透视让右缘贴脸、左缘
+消失在灭点，页面自己沿自身平面横向滑移——内容像列车车厢一样
+依次掠过。命门是**物动镜不动**：perspective/origin/rotY 全程常数，
+唯一动的量是页面局部 translateX——镜头一动语义就变成运镜炫技，
+这里的戏是"页面在自我展示"。角度经三轮收敛为精确 60°
+（-45°"不对"→-53°"再大一点"→-60°选中）。
+
+## 动效核心
+- 镜头常数：perspective 1100、origin 30% 58%、rotateY(-60°)+
+  rotateZ(-2°)，transformOrigin left top，全程一个数不变
+- 页面：超宽面板（6200×2400@内容坐标），沿局部 X 轴 +60→-4100
+  滑移，bezier(0.3,0.12,0.72,0.9)——起步柔和后近匀速，尾段斜率
+  不归零（不安定停死）
+- 速度重影：拖尾层=过去时刻（f-1.6/-3.2/-4.8 三层，权重递减）的局部位置重投影，
+  透明度 ∝ 滑移速度（快时重影浓）
+- 悬空贴落：页面元素 FloatWrap 悬浮 230–280px 带同形软影，随
+  滑移进程错峰贴落（巡礼语法）
+- 揭亮：起始面板压暗 0.7，~1.4s 揭到全亮；左缘额外渐变阴影同退
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 倾斜角 | rotateY **-60°**（用户精确定值） | -45° 被裁"角度不对"、-53°"再大一点"；>-70° 内容读不清 |
+| 运动模型 | 镜头全常数、页面自移 | **命门**——镜头横移版被裁"镜头是固定的，页面本身往其3d空间的横面方向移动" |
+| 滑移曲线 | 尾段斜率不归零的 bezier | 中途停死被抓（v4 返工）；全 linear 少了起步呼吸 |
+| 重影 | 透明度∝速度，三层 f-1.6/-3.2/-4.8 | 恒定重影读作重像故障 |
+| 页面宽度 | ≥3 屏内容 | 太窄滑两秒就完，撑不起一镜 |
+| 悬空贴落 | 错峰（巡礼语法）+ 影随高度 | 语义判例见 graze-face-tour/orbit-drop 三卡族 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 角度判例：透视角是本卡身份，实战微调范围建议 55–65°，出这个
+  区间等于换手法
+- 与 graze-face-tour 分工：那张镜头动（贴面游走）、页面静；本卡
+  镜头静、页面动。同段落二选一
+- 超宽页面手绘成本高；实战可用真实长截图代替（滑移逻辑不变）
+
+## 参考实现
+demos/camera/steep-tilt-glide/
+（SteepTiltGlide.tsx）
+原片出处：clickup-30.mp4

package/lib/motion/shotcraft/upstream/references/shots/camera/tension-camera-moves.md

@@ -1,43 +1,43 @@
----
-name: tension-camera-moves
-一句话: 情绪运镜两式——bullet-time 冻结环绕、pull-back 拉远孤立，相机替观众"感受"而非"看"
-适用: 情绪节点（震撼/收束）的运镜语言；与 space-camera-moves 的"炫技大动作"互补——这两式动作小、情绪重
-时长: 单式 5–6s（150–170f）；全片合计 ≤2 式（各 ≤1 次）
-能量: A 高 / B 低收
----
-
-## 意图
-space-camera-moves 三式是"把页面当 3D 实体拍"的高光炫技；这两式相反——
-动作本身克制，全部劲道在情绪语义上：A 说"这一刻值得停下时间看"
-（运动中的元素被冻住、相机绕行审视）；B 说"最后只剩这一件事"
-（后拉中周围逐层熄灭，孤悬一点收束全片）。两式各占一个情绪格，
-是分镜阶段"这一段观众该感到什么"的直接词汇。
-
-## 两式选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A bullet-time-freeze-orbit 冻结环绕 | 图表生长到一半连同柱顶喷出的火花一起冻住（火花悬在半空、拖尾保留），相机在真 3D 场景里绕面板 rotateY 扫 52° 再回，时间恢复接着长完 | 核心数据/图表的加冕时刻；"值得停表看"的一格 |
-| B pull-back-isolation 拉远孤立 | 从发光主卡特写后拉，8 张兄弟卡按距离错峰熄灭、背景沉黑，孤卡悬在暗场中央 | 结尾收束；"全片只为这一个数字"的谢幕 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 双时钟 | 内容动画吃 `eff`（速度坡道积分：8f smooth 刹停 → 冻结 52f → 8f 恢复），相机吃真实 f | 命门：冻结期内容必须肉眼可见地完全静止，相机却在动——两个时钟各管各的；硬停硬起没有子弹时间的变速感 |
-| A 环绕 | perspective 1800 的 preserve-3d 场景（面板 / 带 z 深度的火花 / 网格地面 / 远处点阵墙）：rotateY 0→-52°（26f smooth）→ 顶点慢漂 12f → 回 0（22f swift），同步 rotateX 抬 6°、推近 160px | 50–55° 是"绕到侧面看"的下限；>70° 面板变纸片穿帮；没有深度参照物（单面板 + 纯色底）读不出是相机在绕 |
-| A 冻住的运动 | 火花拖尾长度、计数器滚动模糊都按内容时钟的速度算 | 冻结时它们保持"运动中"的形态——冻住的是瞬间，不是静物 |
-| B 后拉 | scale 2.2→0.62 / 110f Easing.out(cubic)，origin 锁主卡中心，按 2.2× CSS zoom 布局再缩小 | 前 20f 主卡仍占满画面，开场即特写不需要另加 hold；transform 放大的特写字会糊（Q2） |
-| B 熄灭 | 兄弟卡按 hypot 距离排序，帧 30 起每 8f 一张，16f 内 opacity→0（EASE.out）+ brightness→0.3 + 失焦 5px + 下沉 0.97；背景 60–110f 从亮柔光底交叉沉入带色相深场 | 由近到远熄灭 = "世界向外塌暗"；乱序熄灭读作故障 |
-| B 光晕 | 主卡两层冷白 box-shadow 60–100f 淡入，受光上沿同步浮现 | 光晕是"只剩它"的视觉证词，与沉黑同步才成立 |
-| 收尾 | 两式动作完毕 hold ≥30f（A 只留光的极缓呼吸；B 110–150f 真静止） | R1；B 式是全片句号，静止给足 40f+，可在屏幕空间加一句结语 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- A 式与 speed-ramp-freeze/impact-feedback 同为时间操纵，同一镜头别叠用
-  （帧 remap 互相打架）；A 的冻结是"停给你看"+相机动，speed-ramp-freeze 的
-  定格是"停下来标注"——选语义不选形似
-- B 式放结尾时后接 outro-group-photo-launch 会打架（一收一放），二选一
-
-## 参考实现
-demos/camera/tension-camera-moves/
-（BulletTimeFreezeOrbit.tsx / PullBackIsolation.tsx）
+---
+name: tension-camera-moves
+一句话: 情绪运镜两式——bullet-time 冻结环绕、pull-back 拉远孤立，相机替观众"感受"而非"看"
+适用: 情绪节点（震撼/收束）的运镜语言；与 space-camera-moves 的"炫技大动作"互补——这两式动作小、情绪重
+时长: 单式 5–6s（150–170f）；全片合计 ≤2 式（各 ≤1 次）
+能量: A 高 / B 低收
+---
+
+## 意图
+space-camera-moves 三式是"把页面当 3D 实体拍"的高光炫技；这两式相反——
+动作本身克制，全部劲道在情绪语义上：A 说"这一刻值得停下时间看"
+（运动中的元素被冻住、相机绕行审视）；B 说"最后只剩这一件事"
+（后拉中周围逐层熄灭，孤悬一点收束全片）。两式各占一个情绪格，
+是分镜阶段"这一段观众该感到什么"的直接词汇。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A bullet-time-freeze-orbit 冻结环绕 | 图表生长到一半连同柱顶喷出的火花一起冻住（火花悬在半空、拖尾保留），相机在真 3D 场景里绕面板 rotateY 扫 52° 再回，时间恢复接着长完 | 核心数据/图表的加冕时刻；"值得停表看"的一格 |
+| B pull-back-isolation 拉远孤立 | 从发光主卡特写后拉，8 张兄弟卡按距离错峰熄灭、背景沉黑，孤卡悬在暗场中央 | 结尾收束；"全片只为这一个数字"的谢幕 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 双时钟 | 内容动画吃 `eff`（速度坡道积分：8f smooth 刹停 → 冻结 52f → 8f 恢复），相机吃真实 f | 命门：冻结期内容必须肉眼可见地完全静止，相机却在动——两个时钟各管各的；硬停硬起没有子弹时间的变速感 |
+| A 环绕 | perspective 1800 的 preserve-3d 场景（面板 / 带 z 深度的火花 / 网格地面 / 远处点阵墙）：rotateY 0→-52°（26f smooth）→ 顶点慢漂 12f → 回 0（22f swift），同步 rotateX 抬 6°、推近 160px | 50–55° 是"绕到侧面看"的下限；>70° 面板变纸片穿帮；没有深度参照物（单面板 + 纯色底）读不出是相机在绕 |
+| A 冻住的运动 | 火花拖尾长度、计数器滚动模糊都按内容时钟的速度算 | 冻结时它们保持"运动中"的形态——冻住的是瞬间，不是静物 |
+| B 后拉 | scale 2.2→0.62 / 110f Easing.out(cubic)，origin 锁主卡中心，按 2.2× CSS zoom 布局再缩小 | 前 20f 主卡仍占满画面，开场即特写不需要另加 hold；transform 放大的特写字会糊（Q2） |
+| B 熄灭 | 兄弟卡按 hypot 距离排序，帧 30 起每 8f 一张，16f 内 opacity→0（EASE.out）+ brightness→0.3 + 失焦 5px + 下沉 0.97；背景 60–110f 从亮柔光底交叉沉入带色相深场 | 由近到远熄灭 = "世界向外塌暗"；乱序熄灭读作故障 |
+| B 光晕 | 主卡两层冷白 box-shadow 60–100f 淡入，受光上沿同步浮现 | 光晕是"只剩它"的视觉证词，与沉黑同步才成立 |
+| 收尾 | 两式动作完毕 hold ≥30f（A 只留光的极缓呼吸；B 110–150f 真静止） | R1；B 式是全片句号，静止给足 40f+，可在屏幕空间加一句结语 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- A 式与 speed-ramp-freeze/impact-feedback 同为时间操纵，同一镜头别叠用
+  （帧 remap 互相打架）；A 的冻结是"停给你看"+相机动，speed-ramp-freeze 的
+  定格是"停下来标注"——选语义不选形似
+- B 式放结尾时后接 outro-group-photo-launch 会打架（一收一放），二选一
+
+## 参考实现
+demos/camera/tension-camera-moves/
+（BulletTimeFreezeOrbit.tsx / PullBackIsolation.tsx）

package/lib/motion/shotcraft/upstream/references/shots/camera/terminal-3d.md

@@ -1,42 +1,42 @@
----
-name: terminal-3d
-一句话: 三个终端窗散布 3D 空间，相机窗间飞行、途中正弦拉远，每到一窗打字机敲命令、结果逐行滑出——命令执行的空间叙事流
-适用: 开发者产品的 CLI/工作流演示：把"三步命令"拍成三站空间旅程
-时长: 约 8.2s（246f@30fps；三站各约 2–3s 停留 + 两段 30f 飞行）
-能量: 中（飞行给动感、打字给节奏，整体是沉稳的技术叙事；收在 ● READY 一记亮点）
----
-
-## 意图
-终端输出天生是"平面滚动"的反电影语言，这张卡把它空间化：每条命令占据空间中一个实体窗口，相机像穿过机房一样逐窗拜访。飞行途中的拉远让观众瞥见"还有更多窗口"——工作流的全貌感。
-
-## 动效核心
-- 三窗各持 pose（x/y/z/ry，世界坐标 px），相机走**逆变换**：`translateZ(-pull) rotateX(tilt) rotateY(view−ry) translate3d(-x,-y,-z)`——写窗口姿态表即得相机路径；每站留 8–10° 侧视角（VIEW 表），落定时窗口不完全正对，读得清且有体积
-- 窗口按真实屏幕尺寸布局（1180×620，命令 52px / 输出 38px 等宽），相机落定时 1:1 栅格化——不靠外层放大，文字不糊（Q2）
-- 两段飞行各 30f（swift 不对称 in-out），途中 `sin(π·u^0.85)×1250px` 拉远鼓包——峰值处画面缩到 ~0.6，三窗同框，"瞥见全貌"；按相机屏速加横向方向性模糊（只在飞行段生效）
-- 景深：每窗按与当前站点的距离算 focus → `blur 0–3px + brightness 0.62–1 + opacity 0.72–1`；拉远时景深整体变深（离焦量随 pull 收窄），全景里三窗都认得出是终端
-- 空间锚点：地面是按与 world 完全同构的投影公式逐线画出的 SVG 透视网格（线宽恒定不闪）；焦点窗背后一团背光、脚下一摊强调色反光（都按窗心投影到屏幕）；每窗后方立一枚 560px 描边步骤号，飞行时与窗口产生视差
-- 打字机三要素：命令逐字符（每字 0.75–1.65f 确定性抖动、空格多停 0.6f）、块光标紧贴字尾（打字中常亮 / 打完 8f 半周期闪）、敲完停 2f 再回车；输出是终端式快速打印（每行 6f snappy 淡入 + 左移 10px 收回，行距 4f），状态位先转 braille 小菊花 ~6f 再落成 ✓
-- 打字起点 TYPE_AT `[8, 94, 184]` 均在到站后——飞行中不打字，注意力不分裂；全片唯一泛光给第三窗的 ● READY 成片名（Q4）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 拉远鼓包 | sin(π·u^0.85)×1250px | 砍掉后飞行是"平移"没有"起降"；<800 时飞行中只看得见两窗，全貌感没了 |
-| 飞行/停留 | 飞 30f，站内 ~60–90f | 停留必须容下打字 ~20f + 输出 ~20f + 读秒 ≥14f |
-| 侧视角 | 8–10°（VIEW 表） | 0° 退化成平面截图；>18° 等宽字被透视压扁读不清（Q6） |
-| 景深 | blur ≤3px，拉远时 ×(1−0.45) | 离焦太狠时飞行全程一片糊，空间关系读不出 |
-| 打字节奏 | 0.75–1.65f/字 + 空格 +0.6f | 匀速逐字读作机器回放；>2.5f/字 观众等得不耐烦 |
-| 输出打印 | 6f snappy、行距 4f | 终端是"吐"出来的，慢滑入（>12f）读作 PPT |
-| 窗口姿态 | x 间距 ~1500px，z −220~+260，ry ±14–28° | 角度差与前后错落是"空间散布感"来源；全部朝正前会退化成平面轮播 |
-
-## 已知坑
-- 相机是逆变换实现，**窗口 transform、world transform、地面/背光的 project() 三处必须同构**——改姿态只改 POSES / VIEW 数据，改相机链就三处一起改，否则地面网格和窗口会"滑"
-- 命令/输出文案是示意的 video-shotcraft 出片流程（shotcraft init / render / export：搭分镜 → 渲染 → 混音导出），换项目真实命令时保持"命令短、输出 3–5 行"的信息结构
-- 光标闪烁按帧取模（8f 半周期），改时长不影响；"打字中常亮、待机慢闪"的对比要保留
-- 第三窗 READY 行在 ~220f 弹出，之后至少留 ~24f hold，否则尾帧没有落定
-- 光标必须紧贴已打出的字符：未打出的字符不要用 opacity 0 占位（会把光标顶到行尾空处悬着）
-- 整摞 SpeedBlur 是全屏 SVG 滤镜，只在飞行段速度 >0 时启用；静止段零开销，别改成常驻
-
-## 参考实现
-demos/camera/terminal-3d/
-（Terminal3D.tsx）
+---
+name: terminal-3d
+一句话: 三个终端窗散布 3D 空间，相机窗间飞行、途中正弦拉远，每到一窗打字机敲命令、结果逐行滑出——命令执行的空间叙事流
+适用: 开发者产品的 CLI/工作流演示：把"三步命令"拍成三站空间旅程
+时长: 约 8.2s（246f@30fps；三站各约 2–3s 停留 + 两段 30f 飞行）
+能量: 中（飞行给动感、打字给节奏，整体是沉稳的技术叙事；收在 ● READY 一记亮点）
+---
+
+## 意图
+终端输出天生是"平面滚动"的反电影语言，这张卡把它空间化：每条命令占据空间中一个实体窗口，相机像穿过机房一样逐窗拜访。飞行途中的拉远让观众瞥见"还有更多窗口"——工作流的全貌感。
+
+## 动效核心
+- 三窗各持 pose（x/y/z/ry，世界坐标 px），相机走**逆变换**：`translateZ(-pull) rotateX(tilt) rotateY(view−ry) translate3d(-x,-y,-z)`——写窗口姿态表即得相机路径；每站留 8–10° 侧视角（VIEW 表），落定时窗口不完全正对，读得清且有体积
+- 窗口按真实屏幕尺寸布局（1180×620，命令 52px / 输出 38px 等宽），相机落定时 1:1 栅格化——不靠外层放大，文字不糊（Q2）
+- 两段飞行各 30f（swift 不对称 in-out），途中 `sin(π·u^0.85)×1250px` 拉远鼓包——峰值处画面缩到 ~0.6，三窗同框，"瞥见全貌"；按相机屏速加横向方向性模糊（只在飞行段生效）
+- 景深：每窗按与当前站点的距离算 focus → `blur 0–3px + brightness 0.62–1 + opacity 0.72–1`；拉远时景深整体变深（离焦量随 pull 收窄），全景里三窗都认得出是终端
+- 空间锚点：地面是按与 world 完全同构的投影公式逐线画出的 SVG 透视网格（线宽恒定不闪）；焦点窗背后一团背光、脚下一摊强调色反光（都按窗心投影到屏幕）；每窗后方立一枚 560px 描边步骤号，飞行时与窗口产生视差
+- 打字机三要素：命令逐字符（每字 0.75–1.65f 确定性抖动、空格多停 0.6f）、块光标紧贴字尾（打字中常亮 / 打完 8f 半周期闪）、敲完停 2f 再回车；输出是终端式快速打印（每行 6f snappy 淡入 + 左移 10px 收回，行距 4f），状态位先转 braille 小菊花 ~6f 再落成 ✓
+- 打字起点 TYPE_AT `[8, 94, 184]` 均在到站后——飞行中不打字，注意力不分裂；全片唯一泛光给第三窗的 ● READY 成片名（Q4）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 拉远鼓包 | sin(π·u^0.85)×1250px | 砍掉后飞行是"平移"没有"起降"；<800 时飞行中只看得见两窗，全貌感没了 |
+| 飞行/停留 | 飞 30f，站内 ~60–90f | 停留必须容下打字 ~20f + 输出 ~20f + 读秒 ≥14f |
+| 侧视角 | 8–10°（VIEW 表） | 0° 退化成平面截图；>18° 等宽字被透视压扁读不清（Q6） |
+| 景深 | blur ≤3px，拉远时 ×(1−0.45) | 离焦太狠时飞行全程一片糊，空间关系读不出 |
+| 打字节奏 | 0.75–1.65f/字 + 空格 +0.6f | 匀速逐字读作机器回放；>2.5f/字 观众等得不耐烦 |
+| 输出打印 | 6f snappy、行距 4f | 终端是"吐"出来的，慢滑入（>12f）读作 PPT |
+| 窗口姿态 | x 间距 ~1500px，z −220~+260，ry ±14–28° | 角度差与前后错落是"空间散布感"来源；全部朝正前会退化成平面轮播 |
+
+## 已知坑
+- 相机是逆变换实现，**窗口 transform、world transform、地面/背光的 project() 三处必须同构**——改姿态只改 POSES / VIEW 数据，改相机链就三处一起改，否则地面网格和窗口会"滑"
+- 命令/输出文案是示意的 video-shotcraft 出片流程（shotcraft init / render / export：搭分镜 → 渲染 → 混音导出），换项目真实命令时保持"命令短、输出 3–5 行"的信息结构
+- 光标闪烁按帧取模（8f 半周期），改时长不影响；"打字中常亮、待机慢闪"的对比要保留
+- 第三窗 READY 行在 ~220f 弹出，之后至少留 ~24f hold，否则尾帧没有落定
+- 光标必须紧贴已打出的字符：未打出的字符不要用 opacity 0 占位（会把光标顶到行尾空处悬着）
+- 整摞 SpeedBlur 是全屏 SVG 滤镜，只在飞行段速度 >0 时启用；静止段零开销，别改成常驻
+
+## 参考实现
+demos/camera/terminal-3d/
+（Terminal3D.tsx）

package/lib/motion/shotcraft/upstream/references/shots/data/before-after-slider-scrub.md

@@ -1,48 +1,48 @@
----
-name: before-after-slider-scrub
-一句话: 前后对比拉杆——"处理前/后"两版叠放，分割杆先猛甩后慢扫，杆过处新版"显影"揭出
-适用: AI 增强/优化/重构类功能的效果对比段落（"用前 vs 用后"一镜讲清）
-时长: 4–5s
-能量: 中（快甩是打击点，慢扫是阅读期）
-标签: interaction
----
-
-## 意图
-AI 图像产品发布片的标准对比语法：同一画面"处理前"（低对比灰蒙）
-与"处理后"（清晰版）叠放，带圆手柄的竖分割杆先从左端猛甩到 70%
-（overshoot 回弹）、停一拍，再以约 1/5 的速度慢扫回来让观众看清
-差异——**快甩慢扫的速度对比就是节奏**：快甩宣告"变了"，
-慢扫证明"变在哪"。
-
-## 动作阶段
-| 阶段 | 帧段参考 | 内容 |
-|------|------|------|
-| 1 静置 | f0–14 | 杆停 8%，画面几乎全是"处理前"；f10–14 先向左预备回拉到 6.5% |
-| 2 快甩 | 12f | 8%→76%（out cubic）过冲 |
-| 3 回弹 | 12f | 76%→70% |
-| 4 停顿 | ~18f | 让观众看清 after |
-| 5 慢扫 | ~48f | 70%→40% 二次展示差异 |
-| 6 定格 | 末 ≥40f | 真静止 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 速度比 | 快甩 12f vs 慢扫 48f，约 5:1 | 比例 <3:1 节奏对比不可感 |
-| 揭示 | after 层 clip-path inset 右边界跟随杆 x | 杆和揭示边界错位即穿帮 |
-| 手柄 | 圆形手柄 + 速度差分驱动 scaleX 微拉伸（峰值 1.18），静止自动归 1 | 拉伸给手柄"被甩"的重量感 |
-| before 处理 | 低对比灰蒙版 | before 太难看是自黑，"差"要可信（真实旧版/未优化态） |
-| 角标 | BEFORE/AFTER 角标放内容区 | demo 判例：初版压住侧栏/头像穿帮 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 两版必须同布局同机位——布局不同读作两个页面，对比失效
-  （theme-switch-moves 同款约束）
-- 实战 before/after 都用真实截图（Q1）：before 是注入旧数据/关闭
-  功能的真实态，不手搓"故意丑"的假 before
-- 慢扫终点停 40% 而非 0%——留一段 after 在画面上定格（结论可见）
-- 声音：快甩一声 whoosh + 回弹轻 tick，慢扫无声或极轻摩擦音（S4）
-
-## 参考实现
-demos/data/before-after-slider-scrub/
-（BeforeAfterSliderScrub.tsx）
+---
+name: before-after-slider-scrub
+一句话: 前后对比拉杆——"处理前/后"两版叠放，分割杆先猛甩后慢扫，杆过处新版"显影"揭出
+适用: AI 增强/优化/重构类功能的效果对比段落（"用前 vs 用后"一镜讲清）
+时长: 4–5s
+能量: 中（快甩是打击点，慢扫是阅读期）
+标签: interaction
+---
+
+## 意图
+AI 图像产品发布片的标准对比语法：同一画面"处理前"（低对比灰蒙）
+与"处理后"（清晰版）叠放，带圆手柄的竖分割杆先从左端猛甩到 70%
+（overshoot 回弹）、停一拍，再以约 1/5 的速度慢扫回来让观众看清
+差异——**快甩慢扫的速度对比就是节奏**：快甩宣告"变了"，
+慢扫证明"变在哪"。
+
+## 动作阶段
+| 阶段 | 帧段参考 | 内容 |
+|------|------|------|
+| 1 静置 | f0–14 | 杆停 8%，画面几乎全是"处理前"；f10–14 先向左预备回拉到 6.5% |
+| 2 快甩 | 12f | 8%→76%（out cubic）过冲 |
+| 3 回弹 | 12f | 76%→70% |
+| 4 停顿 | ~18f | 让观众看清 after |
+| 5 慢扫 | ~48f | 70%→40% 二次展示差异 |
+| 6 定格 | 末 ≥40f | 真静止 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 速度比 | 快甩 12f vs 慢扫 48f，约 5:1 | 比例 <3:1 节奏对比不可感 |
+| 揭示 | after 层 clip-path inset 右边界跟随杆 x | 杆和揭示边界错位即穿帮 |
+| 手柄 | 圆形手柄 + 速度差分驱动 scaleX 微拉伸（峰值 1.18），静止自动归 1 | 拉伸给手柄"被甩"的重量感 |
+| before 处理 | 低对比灰蒙版 | before 太难看是自黑，"差"要可信（真实旧版/未优化态） |
+| 角标 | BEFORE/AFTER 角标放内容区 | demo 判例：初版压住侧栏/头像穿帮 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 两版必须同布局同机位——布局不同读作两个页面，对比失效
+  （theme-switch-moves 同款约束）
+- 实战 before/after 都用真实截图（Q1）：before 是注入旧数据/关闭
+  功能的真实态，不手搓"故意丑"的假 before
+- 慢扫终点停 40% 而非 0%——留一段 after 在画面上定格（结论可见）
+- 声音：快甩一声 whoosh + 回弹轻 tick，慢扫无声或极轻摩擦音（S4）
+
+## 参考实现
+demos/data/before-after-slider-scrub/
+（BeforeAfterSliderScrub.tsx）

package/lib/motion/shotcraft/upstream/references/shots/data/chart-live-moves.md

@@ -1,52 +1,52 @@
----
-name: chart-live-moves
-一句话: 活体图表三式——oscilloscope-stream 示波流线（曲线右端实时写入+突发尖峰）、unit-dot-swarm-regroup 点阵重组（点群三幕迁徙聚成数字）、axis-rescale-shock 轴爆表重标（新值冲出画框逼 y 轴重标）
-适用: 数据叙事段落；分别讲"实时性"、"每个数字是一个人"、"增长装不下"
-时长: 各 165–192f（5.5–6.4s）
-能量: 中高（数据即剧情）
----
-
-## 意图
-图表不是插图是剧情。三式共同前提（实测判例）：**必须真图表语境**
-——真轴标/真数据/真文案，灰阶占位条测不出数据叙事的表达力。
-A 示波流线：曲线写入点钉在右端上下起伏，旧数据左流出画，中途一次
-突发尖峰（振幅 2.2×、读数跳大变强调色）——"实时"不用说出口，还有事件；
-B 点阵重组：320 个点（每点≈40 renders）散布→聚三簇（浮 Promo/Launch film/
-Explainer 真标签）→列队成柱（真轴标）→聚成点阵大数字 "12,847"——
-同一批点，观众能跟着某一颗看它归队；
-C 轴爆表：折线正常爬升，新值顶破图表天花板规线冲出 226px（强调色粗线
-插进标题区、撞进右上 KPI 数字），停半拍，y 轴"哗"地重标（旧刻度飞出/新刻度滑入/网格
-加密/旧线压扁成地平线），新值落回+弹真值标签——用"坐标轴装不下"演增长。
-
-## 三式选型
-| 式 | 核心动作 | 适用 |
-|----|----------|------|
-| A oscilloscope-stream | 采样窗平移 8px/f + 高斯脉冲尖峰（带前兆/余震）+ 刹停真静止 + 刹停后缓推向尖峰 | 监控/实时类产品："活着"的系统 |
-| B unit-dot-swarm-regroup | 三幕 spring 错峰迁徙（stiffness 150、damping 13、错峰 8f），簇用向日葵螺旋紧排，终幕点阵拼数字 | 用户量/构成叙事："每个点是一个人" |
-| C axis-rescale-shock | 冲出天花板 226px（规线裂口 + 碎屑）+ 重标三联动（刻度换/网格密/旧线压扁）+ 震 10px | 增长曲线高光："off the charts" 字面化 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 真语境 | 真标题/真轴标/真单位/真读数 | **入库前提**：灰阶版三条全数被裁，换真语境后全过 |
-| 主角色 | 强调色标事件/主角（demo：A 珊瑚红尖峰、B 钴蓝 Launch film 簇、C 赤陶爆表段） | 全灰读不出"哪里是重点" |
-| A 流速 | 8px/f | 5.5 已可感，8 更明确；波形纯函数禁随机 |
-| B 点数/点径 | 320 / 直径 20px（迁徙中按速度拉成胶囊，封顶 +20px） | 点太少拼不出数字，太小看不见个体；拉伸过长会糊成一片 |
-| C 冲出幅度 | 天花板规线外 226px | 80px 版不够"爆"；真的插进标题区才是事故感 |
-| 收尾 | 三式都要 ≥36f 真静止 | 数据图表尾漂读作还没播完 |
-
-## 已知坑
-- demo 以 video-shotcraft 的示意渲染数据调校（A 深蓝示波屏·渲染农场 fps、B 瓷白信息图·按片型分的渲染量、
-  C 沙色瑞士海报·月度渲染量），数值是示意——参数是调校起点非实战定稿，首次实战须以真实素材回验
-- 三式的读数 / 刻度 / 标签都按成片字号做（≥32px，主读数 120–176px）；图表撑满画面而不是缩在卡片里
-- 三式是三种独立手法不是套餐——同片用两式以上时各 ≤1 次且错开段落
-- A 的尖峰事件、C 的重标只能发生一次；重复即廉价
-- B 终幕数字字形要预先手算（点数=位点数用满才整齐；参考实现用单线骨架等弧长采样、法向双排，恰好 320 颗无重叠）
-- 与 dataviz-landscape-open（抽象数据地景开场）分工：那是开场氛围，
-  这三式是段落内的具体数据论证
-- 声音：A 尖峰一声警示 tick；B 每幕迁徙一声 whoosh；C 冲出框
-  一声 riser、重标一声"哗啦"
-
-## 参考实现
-demos/data/chart-live-moves/
-（AxisRescaleShockV2.tsx / OscilloscopeStreamV2.tsx / UnitDotSwarmRegroupV2.tsx）
+---
+name: chart-live-moves
+一句话: 活体图表三式——oscilloscope-stream 示波流线（曲线右端实时写入+突发尖峰）、unit-dot-swarm-regroup 点阵重组（点群三幕迁徙聚成数字）、axis-rescale-shock 轴爆表重标（新值冲出画框逼 y 轴重标）
+适用: 数据叙事段落；分别讲"实时性"、"每个数字是一个人"、"增长装不下"
+时长: 各 165–192f（5.5–6.4s）
+能量: 中高（数据即剧情）
+---
+
+## 意图
+图表不是插图是剧情。三式共同前提（实测判例）：**必须真图表语境**
+——真轴标/真数据/真文案，灰阶占位条测不出数据叙事的表达力。
+A 示波流线：曲线写入点钉在右端上下起伏，旧数据左流出画，中途一次
+突发尖峰（振幅 2.2×、读数跳大变强调色）——"实时"不用说出口，还有事件；
+B 点阵重组：320 个点（每点≈40 renders）散布→聚三簇（浮 Promo/Launch film/
+Explainer 真标签）→列队成柱（真轴标）→聚成点阵大数字 "12,847"——
+同一批点，观众能跟着某一颗看它归队；
+C 轴爆表：折线正常爬升，新值顶破图表天花板规线冲出 226px（强调色粗线
+插进标题区、撞进右上 KPI 数字），停半拍，y 轴"哗"地重标（旧刻度飞出/新刻度滑入/网格
+加密/旧线压扁成地平线），新值落回+弹真值标签——用"坐标轴装不下"演增长。
+
+## 三式选型
+| 式 | 核心动作 | 适用 |
+|----|----------|------|
+| A oscilloscope-stream | 采样窗平移 8px/f + 高斯脉冲尖峰（带前兆/余震）+ 刹停真静止 + 刹停后缓推向尖峰 | 监控/实时类产品："活着"的系统 |
+| B unit-dot-swarm-regroup | 三幕 spring 错峰迁徙（stiffness 150、damping 13、错峰 8f），簇用向日葵螺旋紧排，终幕点阵拼数字 | 用户量/构成叙事："每个点是一个人" |
+| C axis-rescale-shock | 冲出天花板 226px（规线裂口 + 碎屑）+ 重标三联动（刻度换/网格密/旧线压扁）+ 震 10px | 增长曲线高光："off the charts" 字面化 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 真语境 | 真标题/真轴标/真单位/真读数 | **入库前提**：灰阶版三条全数被裁，换真语境后全过 |
+| 主角色 | 强调色标事件/主角（demo：A 珊瑚红尖峰、B 钴蓝 Launch film 簇、C 赤陶爆表段） | 全灰读不出"哪里是重点" |
+| A 流速 | 8px/f | 5.5 已可感，8 更明确；波形纯函数禁随机 |
+| B 点数/点径 | 320 / 直径 20px（迁徙中按速度拉成胶囊，封顶 +20px） | 点太少拼不出数字，太小看不见个体；拉伸过长会糊成一片 |
+| C 冲出幅度 | 天花板规线外 226px | 80px 版不够"爆"；真的插进标题区才是事故感 |
+| 收尾 | 三式都要 ≥36f 真静止 | 数据图表尾漂读作还没播完 |
+
+## 已知坑
+- demo 以 video-shotcraft 的示意渲染数据调校（A 深蓝示波屏·渲染农场 fps、B 瓷白信息图·按片型分的渲染量、
+  C 沙色瑞士海报·月度渲染量），数值是示意——参数是调校起点非实战定稿，首次实战须以真实素材回验
+- 三式的读数 / 刻度 / 标签都按成片字号做（≥32px，主读数 120–176px）；图表撑满画面而不是缩在卡片里
+- 三式是三种独立手法不是套餐——同片用两式以上时各 ≤1 次且错开段落
+- A 的尖峰事件、C 的重标只能发生一次；重复即廉价
+- B 终幕数字字形要预先手算（点数=位点数用满才整齐；参考实现用单线骨架等弧长采样、法向双排，恰好 320 颗无重叠）
+- 与 dataviz-landscape-open（抽象数据地景开场）分工：那是开场氛围，
+  这三式是段落内的具体数据论证
+- 声音：A 尖峰一声警示 tick；B 每幕迁徙一声 whoosh；C 冲出框
+  一声 riser、重标一声"哗啦"
+
+## 参考实现
+demos/data/chart-live-moves/
+（AxisRescaleShockV2.tsx / OscilloscopeStreamV2.tsx / UnitDotSwarmRegroupV2.tsx）

package/lib/motion/shotcraft/upstream/references/shots/data/gauge-readout-moves.md

@@ -1,45 +1,45 @@
----
-name: gauge-readout-moves
-一句话: 仪表读数两式——needle-sweep-selftest 满弧扫针（点火自检指针甩满全弧再回落真值）与 tape-scroll-fixed-pointer 滚带定针（针不动刻度带滚过+冲刺刹车）
-适用: dashboard 开场仪式/性能指标揭晓；A 多表盘开机感，B 单指标大跳变
-时长: A 140f（4.7s）/ B 150f（5s）
-能量: 中高（机械仪式型）
----
-
-## 意图
-把"报数值"做成仪表的身体动作：A 是汽车点火自检——卡片里三个并排表盘
-指针先"唰"地甩满全弧（270°）、扫过的刻度依次点亮，再弹簧回落定格真实值，
-多表错峰成波浪，落定同帧盘下数值弹出，先亮量程再报数，开场宣誓感；
-B 是飞机空速带语法——读数窗 + 指针钉死画面中线，贯穿全画高的刻度带整体从窗后滚过，先顶着旧上限慢爬、升级后冲刺
-（峰值 ~100px/f）、末尾 spring 刹车带回摆过冲，"世界动、针不动"，
-数值大小变成看得见的位移距离。
-
-## 两式选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A needle-sweep-selftest | 表面与外环点亮 → 指针去程 12f ease-out 甩满弧（扫过的刻度依次点亮、24f 内回落）→ 弹簧回程 ~8° 过冲回摆落真值；三表错峰 4f；落定同帧盘下数值 overshoot 弹出、指标名淡入，全部落定后自检胶囊 Running self-test… → Ready to render | dashboard 开场/系统就绪仪式 |
-| B tape-scroll-fixed-pointer | 全画高刻度带 translate：慢爬顶住旧上限线→上限线断开→预备回拉 5→冲刺 22f（峰值 ~100px/f，纵向运动模糊）→spring 刹车过冲回摆停位，新上限 bug 停进指针；窗内读数同步刷新 | 单指标大跳变（性能翻倍/配额提升） |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 甩弧幅度 | 满量程 270°，到顶即回程 | 只甩到真值=没有自检仪式感；满弧再回落才是"先亮量程"；去程扫过的刻度（含红区）依次点亮 |
-| A 过冲 | 回落带 ~8° 回摆（按行程反算弹簧阻尼） | 无过冲读作电子表；过冲=机械指针的质量 |
-| A 错峰 | 4f/表（左→中→右） | 齐甩读作复制粘贴；错峰成波浪 |
-| B 冲刺速度 | 5px/单位、峰值 ~100px/f（大跳变段） | 慢了读作匀速爬升，"世界动"不成立；带子越长越大，越要配纵向运动模糊 |
-| B 刹车 | spring 过冲（冲过头再弹回停位） | 词汇原案的回摆是"哐"的来源，直停可惜 |
-| 真静止 | 停位后 ≥30f 全锁死（A 末表落定 ~66f、B 110f 锁常数） | 指针类最忌尾漂 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 同批 ring-close-overfill（合环过盈）改改再看无附言——环形进度类
-  待重做，别急着当第三式并入
-- A 的表盘是自绘 SVG（弧刻度+指针），实战贴真 dashboard 时优先找
-  页面里现成的 gauge 组件特写，没有再造
-- 声音：A 甩针一声"唰"+落定"嗒"（多表错峰各一声）；B 冲刺段
-  低频滚动声、刹车一声闷"哐"
-
-## 参考实现
-demos/data/gauge-readout-moves/
-（NeedleSweepSelftest.tsx / TapeScrollFixedPointer.tsx）
+---
+name: gauge-readout-moves
+一句话: 仪表读数两式——needle-sweep-selftest 满弧扫针（点火自检指针甩满全弧再回落真值）与 tape-scroll-fixed-pointer 滚带定针（针不动刻度带滚过+冲刺刹车）
+适用: dashboard 开场仪式/性能指标揭晓；A 多表盘开机感，B 单指标大跳变
+时长: A 140f（4.7s）/ B 150f（5s）
+能量: 中高（机械仪式型）
+---
+
+## 意图
+把"报数值"做成仪表的身体动作：A 是汽车点火自检——卡片里三个并排表盘
+指针先"唰"地甩满全弧（270°）、扫过的刻度依次点亮，再弹簧回落定格真实值，
+多表错峰成波浪，落定同帧盘下数值弹出，先亮量程再报数，开场宣誓感；
+B 是飞机空速带语法——读数窗 + 指针钉死画面中线，贯穿全画高的刻度带整体从窗后滚过，先顶着旧上限慢爬、升级后冲刺
+（峰值 ~100px/f）、末尾 spring 刹车带回摆过冲，"世界动、针不动"，
+数值大小变成看得见的位移距离。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A needle-sweep-selftest | 表面与外环点亮 → 指针去程 12f ease-out 甩满弧（扫过的刻度依次点亮、24f 内回落）→ 弹簧回程 ~8° 过冲回摆落真值；三表错峰 4f；落定同帧盘下数值 overshoot 弹出、指标名淡入，全部落定后自检胶囊 Running self-test… → Ready to render | dashboard 开场/系统就绪仪式 |
+| B tape-scroll-fixed-pointer | 全画高刻度带 translate：慢爬顶住旧上限线→上限线断开→预备回拉 5→冲刺 22f（峰值 ~100px/f，纵向运动模糊）→spring 刹车过冲回摆停位，新上限 bug 停进指针；窗内读数同步刷新 | 单指标大跳变（性能翻倍/配额提升） |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 甩弧幅度 | 满量程 270°，到顶即回程 | 只甩到真值=没有自检仪式感；满弧再回落才是"先亮量程"；去程扫过的刻度（含红区）依次点亮 |
+| A 过冲 | 回落带 ~8° 回摆（按行程反算弹簧阻尼） | 无过冲读作电子表；过冲=机械指针的质量 |
+| A 错峰 | 4f/表（左→中→右） | 齐甩读作复制粘贴；错峰成波浪 |
+| B 冲刺速度 | 5px/单位、峰值 ~100px/f（大跳变段） | 慢了读作匀速爬升，"世界动"不成立；带子越长越大，越要配纵向运动模糊 |
+| B 刹车 | spring 过冲（冲过头再弹回停位） | 词汇原案的回摆是"哐"的来源，直停可惜 |
+| 真静止 | 停位后 ≥30f 全锁死（A 末表落定 ~66f、B 110f 锁常数） | 指针类最忌尾漂 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 同批 ring-close-overfill（合环过盈）改改再看无附言——环形进度类
+  待重做，别急着当第三式并入
+- A 的表盘是自绘 SVG（弧刻度+指针），实战贴真 dashboard 时优先找
+  页面里现成的 gauge 组件特写，没有再造
+- 声音：A 甩针一声"唰"+落定"嗒"（多表错峰各一声）；B 冲刺段
+  低频滚动声、刹车一声闷"哐"
+
+## 参考实现
+demos/data/gauge-readout-moves/
+（NeedleSweepSelftest.tsx / TapeScrollFixedPointer.tsx）