dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/opening/spotlight-hero-card.md

@@ -1,55 +1,55 @@
----
-name: spotlight-hero-card
-一句话: 关灯的剧场里一束钨丝聚光（带体积光柱）扫过页面锁定一张卡，斜侧推进后卡片弹起悬浮、香槟色光束沿轮廓两圈、连同 3D 注记一起贴回原位
-适用: "单一主角"式产品开场；把一个核心对象（卡片/条目/模块）立成全片主角
-时长: 172f（约 5.7s；锁定 f34 → 触地 f142 → 30f 真静止 hold）
-能量: 中（质感最高的一镜，节奏慢而稳）
-标签: effects、camera
----
-
-## 意图
-开场只讲一件事：这一张卡就是产品的原子单位。聚光灯替观众做视线引导，弹起悬浮给它体积和重量，轮廓光束是"扫描/检视"的隐喻，最后贴回原位表示它属于这个页面。
-
-## 动效核心
-- **关灯**：真实页面截图（Q1）整页 multiply 压到 ~6–14% 亮度（暖黑 rgba(14,12,10)，保色相），只有光池里是页面本色；
-  开灯是"推闸"：f1–6 亮 → 回闪到 62% → 稳住
-- **光池**：近高斯衰减的多段 stop（中心透明 → 边缘全暗，不是一圈硬边）+ 低强度钨丝暖白 soft-light；
-  游走 3 个中间站（站间 2–3f 停顿，smooth in-out）后锁定卡心，光池收拢 + 锁定瞬间 6% 脉冲，光池外再压暗一档；
-  锁定后（f38–58，随推进）屏幕空间的圆光池交叉过渡成**页面空间的卡形光**：同一台相机下一层整页暗场
-  （translateZ 1px，0.94 暖黑）在卡位挖一个卡形软孔（紧孔 σ22 + 一圈 15% 的宽溢光 σ60），卡在 z 上高于
-  这层暗场，所以从边到边全亮、保持原生文字对比，衰减只发生在卡外；soft-light 暖光同步退掉（卡上不叠泛光）；
-  卡边一圈暖白发丝轮廓光 + 极淡外溢让轮廓在暗页上读清；hold 段暗场 ±1.2% 极缓呼吸
-- **体积光柱**：光源在画面上方偏右远处，梯形光柱打到光池（外层 blur 28px、内层 clip-path，边缘软），
-  柱内一层确定性浮尘；推进后光柱减淡 45%
-- 相机从全页正视推进到斜侧特写（左侧机位主导），焦点左移让卡落在画面偏右、左侧留给注记；推进后完全锁死
-- 卡片 rise（带过冲）→ 悬停 sin bob → reseat（落地微压 + 一圈香槟色落地光）；悬浮投影落向左下（光从右上来）
-- SVG rounded-rect 轮廓光束跑两圈：第一圈快而亮、第二圈慢而弱（香槟金 + 白芯）
-- 卡起飞后原位铺页面底色补丁 + 香槟色描边，落地瞬间增亮消失
-- 3D 悬空注记（hover-3d-annotation 手法，C3）：卡左侧白色粗黑体两行 video-shotcraft 宣传语「Your product, / in motion.」（34px 页面空间，
-  推进后 ≈100px），关键词背后 12f 长出香槟色马克条（字翻成墨色），注记下垫暗色衬底压住邻卡文字；
-  注记层用与页面同一套相机数学（camAt）单独画在灯光层之上——它是自发光的字，不被关灯压暗。
-  reseat 时注记同步落回页面平面（translateZ 92→4），不提前退场，结尾是一张完整海报
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 选卡 | cards[3]，中心 x 恰为 960（页面中心） | 主角卡先按"推进后构图"选，不是随便挑一张 |
-| 相机 | 静止全页 zoom 0.8（0–40f）→ 18f 推进 zoom 2.6；rotY 34° 主导 + rotX 仅 8°，persp 1200；焦点取卡心左移 105px、上移 10px；推进后锁死到尾 | 侧向水平机位读感优于俯拍（"从左侧拍摄而不是从下方"，Q6）；收尾禁用 zoom 2.6→2.58 一类尾漂，呼吸交给光而不是相机（R1） |
-| 关灯 | 光池外 multiply 0.90→0.94（≈6–10% 亮度） | <0.8 读作"调暗的页面"不是剧场；>0.96 邻卡完全消失、失去"在页面里"的上下文 |
-| 聚光灯 | 3 个中间站（4→28f），光池半径 400→300，锁定 +6% 脉冲；soft-light 暖白 0.24；锁定后换成卡形光 | 圆光池罩卡会两头落暗、中间打爆（"手电筒照页面"）——主角卡要用卡形软孔从边到边打亮；中间站让"随机照射"可信 |
-| 体积光柱 | 光源 (pool.x+420, −720)，柱宽 0.6×光池；screen 0.34→0.06 纵向渐变 | 光源太近读作手电筒；柱太宽会和光池糊成一团 |
-| 动作弧 | rise 10f（bezier(0.2,1.25,0.3,1) 过冲）→ 悬停 58f（sin bob 振幅 4px 周期 40f，z=110px·lift）→ reseat 18f，落地 press 0.997 | 锁定→落地 ≈108f≈3.6s——质感镜头要"放慢到 3 秒"（R3），初版几乎总是偏快 |
-| 轮廓光束 | lap1 68→82f（strokeWidth 5+2.5 双层）、lap2 88→108f（3.5+1.75、整体 opacity 0.62）；strokeDasharray "0.16 1" 走 dashoffset | 两圈快慢有别才读作"持续扫描"，一圈是眨眼；光束只给主角一次（Q4） |
-| 双层影 | 偏左下 `-10·lift, 10·lift …, -36·lift 48·lift 90·lift` 随高度生长 | 影子不随高度长，悬浮就不成立；方向要和光源一致 |
-## 声音
-开灯推闸钉一记低沉的 light-clunk（f2），弹起钉 whoosh-big（本 demo f56；模板片钉在 f127），光束扫描钉 sparkle（f68），reseat 钉 transition-snap（f142）——弹起/光效/落定各有专属音（S2、S4）。
-
-## 已知坑
-- 开场多卡群舞撑不起第一印象（Q5）——开场曾反复推倒多次才收敛到单卡；直接从单主角+完整动作弧起稿
-- 推进特写下卡上文字会糊，根因是纹理栅格化分辨率不是 DoF——配套技法展开见审美准则 Q2
-- 逐卡 glint 闪烁被两次否决（"不需要每个卡片都闪烁一下"，Q4），光效严格只给主角
-- 卡形光的暗场必须在页面空间（PageCam 内、translateZ 介于页面与卡之间），屏幕空间的遮罩跟不上透视与卡的抬升；卡 translateZ 至少 +2px，reseat 后才不会和暗场共面闪烁
-- 注记的暗色衬底右缘要止于卡左缘之前，否则会在卡面左侧压出一道暗楔
-- 注记若画在 PageCam 内、灯光层之下，会被关灯的 multiply 一起压暗成灰字——注记层要单独套同一台相机画在灯光之上
-
-## 参考实现
-demos/opening/spotlight-hero-card/SpotlightHeroCard.tsx（源自 template/src/aifl/live/SceneOpen.tsx 82–220 段，第二轮改为暗场剧场版）
+---
+name: spotlight-hero-card
+一句话: 关灯的剧场里一束钨丝聚光（带体积光柱）扫过页面锁定一张卡，斜侧推进后卡片弹起悬浮、香槟色光束沿轮廓两圈、连同 3D 注记一起贴回原位
+适用: "单一主角"式产品开场；把一个核心对象（卡片/条目/模块）立成全片主角
+时长: 172f（约 5.7s；锁定 f34 → 触地 f142 → 30f 真静止 hold）
+能量: 中（质感最高的一镜，节奏慢而稳）
+标签: effects、camera
+---
+
+## 意图
+开场只讲一件事：这一张卡就是产品的原子单位。聚光灯替观众做视线引导，弹起悬浮给它体积和重量，轮廓光束是"扫描/检视"的隐喻，最后贴回原位表示它属于这个页面。
+
+## 动效核心
+- **关灯**：真实页面截图（Q1）整页 multiply 压到 ~6–14% 亮度（暖黑 rgba(14,12,10)，保色相），只有光池里是页面本色；
+  开灯是"推闸"：f1–6 亮 → 回闪到 62% → 稳住
+- **光池**：近高斯衰减的多段 stop（中心透明 → 边缘全暗，不是一圈硬边）+ 低强度钨丝暖白 soft-light；
+  游走 3 个中间站（站间 2–3f 停顿，smooth in-out）后锁定卡心，光池收拢 + 锁定瞬间 6% 脉冲，光池外再压暗一档；
+  锁定后（f38–58，随推进）屏幕空间的圆光池交叉过渡成**页面空间的卡形光**：同一台相机下一层整页暗场
+  （translateZ 1px，0.94 暖黑）在卡位挖一个卡形软孔（紧孔 σ22 + 一圈 15% 的宽溢光 σ60），卡在 z 上高于
+  这层暗场，所以从边到边全亮、保持原生文字对比，衰减只发生在卡外；soft-light 暖光同步退掉（卡上不叠泛光）；
+  卡边一圈暖白发丝轮廓光 + 极淡外溢让轮廓在暗页上读清；hold 段暗场 ±1.2% 极缓呼吸
+- **体积光柱**：光源在画面上方偏右远处，梯形光柱打到光池（外层 blur 28px、内层 clip-path，边缘软），
+  柱内一层确定性浮尘；推进后光柱减淡 45%
+- 相机从全页正视推进到斜侧特写（左侧机位主导），焦点左移让卡落在画面偏右、左侧留给注记；推进后完全锁死
+- 卡片 rise（带过冲）→ 悬停 sin bob → reseat（落地微压 + 一圈香槟色落地光）；悬浮投影落向左下（光从右上来）
+- SVG rounded-rect 轮廓光束跑两圈：第一圈快而亮、第二圈慢而弱（香槟金 + 白芯）
+- 卡起飞后原位铺页面底色补丁 + 香槟色描边，落地瞬间增亮消失
+- 3D 悬空注记（hover-3d-annotation 手法，C3）：卡左侧白色粗黑体两行 video-shotcraft 宣传语「Your product, / in motion.」（34px 页面空间，
+  推进后 ≈100px），关键词背后 12f 长出香槟色马克条（字翻成墨色），注记下垫暗色衬底压住邻卡文字；
+  注记层用与页面同一套相机数学（camAt）单独画在灯光层之上——它是自发光的字，不被关灯压暗。
+  reseat 时注记同步落回页面平面（translateZ 92→4），不提前退场，结尾是一张完整海报
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 选卡 | cards[3]，中心 x 恰为 960（页面中心） | 主角卡先按"推进后构图"选，不是随便挑一张 |
+| 相机 | 静止全页 zoom 0.8（0–40f）→ 18f 推进 zoom 2.6；rotY 34° 主导 + rotX 仅 8°，persp 1200；焦点取卡心左移 105px、上移 10px；推进后锁死到尾 | 侧向水平机位读感优于俯拍（"从左侧拍摄而不是从下方"，Q6）；收尾禁用 zoom 2.6→2.58 一类尾漂，呼吸交给光而不是相机（R1） |
+| 关灯 | 光池外 multiply 0.90→0.94（≈6–10% 亮度） | <0.8 读作"调暗的页面"不是剧场；>0.96 邻卡完全消失、失去"在页面里"的上下文 |
+| 聚光灯 | 3 个中间站（4→28f），光池半径 400→300，锁定 +6% 脉冲；soft-light 暖白 0.24；锁定后换成卡形光 | 圆光池罩卡会两头落暗、中间打爆（"手电筒照页面"）——主角卡要用卡形软孔从边到边打亮；中间站让"随机照射"可信 |
+| 体积光柱 | 光源 (pool.x+420, −720)，柱宽 0.6×光池；screen 0.34→0.06 纵向渐变 | 光源太近读作手电筒；柱太宽会和光池糊成一团 |
+| 动作弧 | rise 10f（bezier(0.2,1.25,0.3,1) 过冲）→ 悬停 58f（sin bob 振幅 4px 周期 40f，z=110px·lift）→ reseat 18f，落地 press 0.997 | 锁定→落地 ≈108f≈3.6s——质感镜头要"放慢到 3 秒"（R3），初版几乎总是偏快 |
+| 轮廓光束 | lap1 68→82f（strokeWidth 5+2.5 双层）、lap2 88→108f（3.5+1.75、整体 opacity 0.62）；strokeDasharray "0.16 1" 走 dashoffset | 两圈快慢有别才读作"持续扫描"，一圈是眨眼；光束只给主角一次（Q4） |
+| 双层影 | 偏左下 `-10·lift, 10·lift …, -36·lift 48·lift 90·lift` 随高度生长 | 影子不随高度长，悬浮就不成立；方向要和光源一致 |
+## 声音
+开灯推闸钉一记低沉的 light-clunk（f2），弹起钉 whoosh-big（本 demo f56；模板片钉在 f127），光束扫描钉 sparkle（f68），reseat 钉 transition-snap（f142）——弹起/光效/落定各有专属音（S2、S4）。
+
+## 已知坑
+- 开场多卡群舞撑不起第一印象（Q5）——开场曾反复推倒多次才收敛到单卡；直接从单主角+完整动作弧起稿
+- 推进特写下卡上文字会糊，根因是纹理栅格化分辨率不是 DoF——配套技法展开见审美准则 Q2
+- 逐卡 glint 闪烁被两次否决（"不需要每个卡片都闪烁一下"，Q4），光效严格只给主角
+- 卡形光的暗场必须在页面空间（PageCam 内、translateZ 介于页面与卡之间），屏幕空间的遮罩跟不上透视与卡的抬升；卡 translateZ 至少 +2px，reseat 后才不会和暗场共面闪烁
+- 注记的暗色衬底右缘要止于卡左缘之前，否则会在卡面左侧压出一道暗楔
+- 注记若画在 PageCam 内、灯光层之下，会被关灯的 multiply 一起压暗成灰字——注记层要单独套同一台相机画在灯光之上
+
+## 参考实现
+demos/opening/spotlight-hero-card/SpotlightHeroCard.tsx（源自 template/src/aifl/live/SceneOpen.tsx 82–220 段，第二轮改为暗场剧场版）

package/lib/motion/shotcraft/upstream/references/shots/opening/stroke-segment-build.md

@@ -1,50 +1,50 @@
----
-name: stroke-segment-build
-一句话: 断笔成字——标题拆成十几段互不相连的笔画乱序逐段点亮，前 70% 不可读，末段落位瞬间语义"啪"地成立
-适用: 开场吊悬念的产品名/大数字揭晓；一支片 ≤1 次；与 type-assembly/draw-svg-trace 分工：那些是"看着字被组装/描画"，本卡是"意义延迟揭晓"
-时长: 165f（5.5s；揭晓 f105 后 hold 2s）
-能量: 低起中收（悬念型，落位帧是能量点）
-标签: typography
----
-
-## 意图
-《异形》片头判例：标题不是被画出来的，是"显影"出来的——拆成离散
-笔画段乱序点亮，观众前 70% 时间只看到神秘碎段，最后几段落位的瞬间
-突然读出是什么字。"认出的那一刻"就是钩子，钩子的强度取决于
-不可读期撑多久、钥匙段压多晚。
-
-## 动作阶段
-| 阶段 | 帧段参考 | 内容 |
-|------|------|------|
-| 1 暗场 | f0–12 | 深紫墙 + 极淡墙面光静置（不是死黑） |
-| 2 乱序点亮 | f12–72 | 前 13 段起点按 ease-out 分布（间隔 9f 越来越密到 3f）；每段是 7f 霓虹起辉抖闪（亮—灭—亮—半亮—亮），之后以 0.58 亮度稳住 |
-| 3 屏息 | f72–86 | 14f 不新增任何段，只有灯管电流的微弱嗡动——悬念最紧的一拍 |
-| 4 钥匙段 | f86 / f93 / f99 | S 下脊 → H 中横 → P 碗底，三拍落下 |
-| 5 揭晓 | f105 | 全部灯管 0.58→1、电流涌起冲到 1.25 再回落（灯牌自身宽泛光涌一次）、整字 scale 1→1.02、墙与地面被照亮 |
-| 6 定格 | f113–165 | 副题升起后 hold，镜头全程 1→1.035 极缓推近 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 拆段粒度 | 4 字母 16 段（单线几何字 260×400/字，灯管线宽 30，圆端帽，两端各留 4% 电极缝） | 段太少悬念期短；太碎读作噪点。S 拆成两段反向弧各 3 段 |
-| 乱序表 | 手工排：跨字母乱跳，"可读性钥匙段"（S 下脊 / H 中横 / P 碗底）压到最后 3 段 | 顺序点亮 = 没有悬念；钥匙段早出 = 提前泄底 |
-| 点亮节奏 | 疏→密（9f→3f，`stagger(.., EASE.out)`）→ 屏息 14f → 三拍 7f/6f | 匀速等间隔没有张力；屏息 <8f 感觉不到，>20f 读作卡住 |
-| 不可读期 | 前 13 段（约 60% 时长）读不出字 | QA 抽中段帧自问"能猜出来吗"，能猜出就重排 |
-| 半亮 → 满亮 | 悬念期 0.58，揭晓 1.0 + 涌起 1.25 | 悬念期太亮（>0.8）揭晓就没有"通电"的对比 |
-| 落位脉冲 | scale 1.02 + 光的涌起 | 霓虹是挂在墙上的物件，大幅缩放会假；冲击交给光 |
-| 墙面受光 | 环境光 = 0.12 + 0.5×已亮段占比 + 揭晓/涌起 | 灯越多墙越亮，物理上可信；常量墙光会让点亮失去分量 |
-| 地面倒影 | 沿地面交线镜像、blur 5px、opacity 0.42、离地越远越淡 | 遮罩写在镜像前的本地坐标里，交线以上必须全透明 |
-| 未亮段 | 条件不渲染（非 opacity 0） | 收尾真静止与"不泄底"的前提 |
-## 已知坑
-- demo 是霓虹灯牌版（aurora 暗场）；换别的材质（LED 段码、发光描边）时起辉曲线与半亮值要重调
-- 暗底上的辅助文字用亮灰——demo 首版顶部标题深灰压深底不可见（P1 自检抓到）
-- 揭晓泛光别另画一团径向光斑——会在字中间形成一个脏亮点；让灯牌自己的宽泛光（形状就是字）涌起一次
-- 倒影是整块灯牌渲染两遍（每遍两层 SVG 高斯模糊），单镜头渲染成本翻倍；性能吃紧时先砍倒影
-- 字数上限：4–6 字母词最佳；长词不可读期难控制，段数爆炸
-- 本卡吃"识别瞬间"，标题必须是观众认识的词（产品名/SHIP/LIVE 类），
-  生造词没有"认出"可言
-- 声音：逐段点亮配霓虹起辉的短促电流 tick（稀疏、音量阶梯递减），屏息段只留低频嗡声，落位帧一声 impact + 可接 riser 铺底
-
-## 参考实现
-demos/opening/stroke-segment-build/
-（StrokeSegmentBuild.tsx）
+---
+name: stroke-segment-build
+一句话: 断笔成字——标题拆成十几段互不相连的笔画乱序逐段点亮，前 70% 不可读，末段落位瞬间语义"啪"地成立
+适用: 开场吊悬念的产品名/大数字揭晓；一支片 ≤1 次；与 type-assembly/draw-svg-trace 分工：那些是"看着字被组装/描画"，本卡是"意义延迟揭晓"
+时长: 165f（5.5s；揭晓 f105 后 hold 2s）
+能量: 低起中收（悬念型，落位帧是能量点）
+标签: typography
+---
+
+## 意图
+《异形》片头判例：标题不是被画出来的，是"显影"出来的——拆成离散
+笔画段乱序点亮，观众前 70% 时间只看到神秘碎段，最后几段落位的瞬间
+突然读出是什么字。"认出的那一刻"就是钩子，钩子的强度取决于
+不可读期撑多久、钥匙段压多晚。
+
+## 动作阶段
+| 阶段 | 帧段参考 | 内容 |
+|------|------|------|
+| 1 暗场 | f0–12 | 深紫墙 + 极淡墙面光静置（不是死黑） |
+| 2 乱序点亮 | f12–72 | 前 13 段起点按 ease-out 分布（间隔 9f 越来越密到 3f）；每段是 7f 霓虹起辉抖闪（亮—灭—亮—半亮—亮），之后以 0.58 亮度稳住 |
+| 3 屏息 | f72–86 | 14f 不新增任何段，只有灯管电流的微弱嗡动——悬念最紧的一拍 |
+| 4 钥匙段 | f86 / f93 / f99 | S 下脊 → H 中横 → P 碗底，三拍落下 |
+| 5 揭晓 | f105 | 全部灯管 0.58→1、电流涌起冲到 1.25 再回落（灯牌自身宽泛光涌一次）、整字 scale 1→1.02、墙与地面被照亮 |
+| 6 定格 | f113–165 | 副题升起后 hold，镜头全程 1→1.035 极缓推近 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 拆段粒度 | 4 字母 16 段（单线几何字 260×400/字，灯管线宽 30，圆端帽，两端各留 4% 电极缝） | 段太少悬念期短；太碎读作噪点。S 拆成两段反向弧各 3 段 |
+| 乱序表 | 手工排：跨字母乱跳，"可读性钥匙段"（S 下脊 / H 中横 / P 碗底）压到最后 3 段 | 顺序点亮 = 没有悬念；钥匙段早出 = 提前泄底 |
+| 点亮节奏 | 疏→密（9f→3f，`stagger(.., EASE.out)`）→ 屏息 14f → 三拍 7f/6f | 匀速等间隔没有张力；屏息 <8f 感觉不到，>20f 读作卡住 |
+| 不可读期 | 前 13 段（约 60% 时长）读不出字 | QA 抽中段帧自问"能猜出来吗"，能猜出就重排 |
+| 半亮 → 满亮 | 悬念期 0.58，揭晓 1.0 + 涌起 1.25 | 悬念期太亮（>0.8）揭晓就没有"通电"的对比 |
+| 落位脉冲 | scale 1.02 + 光的涌起 | 霓虹是挂在墙上的物件，大幅缩放会假；冲击交给光 |
+| 墙面受光 | 环境光 = 0.12 + 0.5×已亮段占比 + 揭晓/涌起 | 灯越多墙越亮，物理上可信；常量墙光会让点亮失去分量 |
+| 地面倒影 | 沿地面交线镜像、blur 5px、opacity 0.42、离地越远越淡 | 遮罩写在镜像前的本地坐标里，交线以上必须全透明 |
+| 未亮段 | 条件不渲染（非 opacity 0） | 收尾真静止与"不泄底"的前提 |
+## 已知坑
+- demo 是霓虹灯牌版（aurora 暗场）；换别的材质（LED 段码、发光描边）时起辉曲线与半亮值要重调
+- 暗底上的辅助文字用亮灰——demo 首版顶部标题深灰压深底不可见（P1 自检抓到）
+- 揭晓泛光别另画一团径向光斑——会在字中间形成一个脏亮点；让灯牌自己的宽泛光（形状就是字）涌起一次
+- 倒影是整块灯牌渲染两遍（每遍两层 SVG 高斯模糊），单镜头渲染成本翻倍；性能吃紧时先砍倒影
+- 字数上限：4–6 字母词最佳；长词不可读期难控制，段数爆炸
+- 本卡吃"识别瞬间"，标题必须是观众认识的词（产品名/SHIP/LIVE 类），
+  生造词没有"认出"可言
+- 声音：逐段点亮配霓虹起辉的短促电流 tick（稀疏、音量阶梯递减），屏息段只留低频嗡声，落位帧一声 impact + 可接 riser 铺底
+
+## 参考实现
+demos/opening/stroke-segment-build/
+（StrokeSegmentBuild.tsx）

package/lib/motion/shotcraft/upstream/references/shots/opening/text-as-mask.md

@@ -1,59 +1,59 @@
----
-name: text-as-mask
-一句话: 文字视频遮罩——瓷白舞台上切出超粗大标题字，字内部透出缓慢平移的暗色实时产品面板，结尾吸一口气后字形指数冲入放大 46 倍溢出、内部画面接管全屏
-适用: 品牌词/口号与产品画面二合一的开场或章节卡；字是门、产品在门里
-时长: 165f（入场 18f + 字内漂移 78f + 吸气 8f + 冲入接管 24f + 落定/hold 37f）
-能量: 中高（漂移段沉稳，接管段一次爆发）
-标签: typography
----
-
-## 意图
-标题和产品画面抢屏幕是老问题——先字后画慢，画上压字挤。这一式让
-两者同体：字形就是遮罩，产品只透过笔画显形，观众同时读到词和画面
-质感；结尾字形胀开溢出画幅，产品自然接管全屏——"从品牌词走进产品"
-一条镜头说完，兼任章节转场（与 transition-travel A 字腔穿越同族：
-那边是镜头钻进字腔，这边是字形自己胀开，前者相机动、后者门动）。
-
-## 动效核心
-- 亮场舞台（porcelain 冷白 + 主光 + 暗角）+ SVG 白字黑底 data-URI 交给 CSS `mask-image`，遮罩层套住产品画面；
-  字形下垫一层同字形、带色相的模糊投影（同样走 data-URI 图片），字像被"挖"进舞台的窗
-- 窗里的内容要有大块饱和色与亮线：demo 是 video-shotcraft 的暗色渲染看板（钴蓝→青流式面积图持续向左流、渲染帧数计数、渲染队列柱状图呼吸；眉题是 video-shotcraft 字标，副题 From one prompt to a finished launch film.），
-  漂移期面板上移 110px 让亮线正好穿过字的腰线、面积渐变铺满字的下半截——白卡/浅色 UI 透进白底字里会读成普通字
-- 入场：遮罩从基线向上擦出（clip-path 底边收起，16f）+ 1.04→1 落定；眉题字距收拢、副题升起
-- 字内漂移：产品层 scale 1.32 + translateX +150→-150（f18–96，bezier(0.3,0,0.7,1) 两端轻缓）——
-  字形静止、内容流动，"窗外有世界"的错觉即手法本体
-- 吸气：f96–104 字 1→0.965（swift），眉题/副题 ease-in 退场——大动作前的预备
-- 冲入 24f（f104–128）：mask wrapper `scale(0.965→46)`，对数空间里按 t^1.8 插值
-  （`S = s0·(46/s0)^(t^1.8)`，每帧放大比例越来越大 = 越冲越快）；
-  **transform-origin 必须钉在实心笔画内**（demo 取 L 竖笔中线 1236,546）——钉在字腔空洞里则放大后透出的是底色；
-  冲入同时 wrapper 平移 `(960−Ox, 540−Oy)·t`，把竖笔拉回画面中线（否则偏右的竖笔要到 30× 才盖住左缘）
-- 内容层反向补偿：套一层 `scale(1/S) translate(−d)`（同一 origin）抵消 wrapper 的放大与平移，产品画面
-  不随遮罩几何畸变；面板同时 1.32→1、漂移归零（expo-out，f104–132，比冲入晚 4f 收敛 = 跟随）
-- 接管保险：另叠一个共享同一 translate/scale 变换的无遮罩全屏层，只在竖笔已撑满全屏（t^1.8 ∈ [0.86, 0.95]，S≈24×）
-  之后淡入——更早淡入会在亮底上叠出一层半透明灰纱
-- 收尾：f132–165 全屏面板 hold，流式图仍缓慢流动（产品活着，不是死帧）
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 字号/字重 | 470px / 900（system-ui Black，字距 −22） | 笔画就是视口——细字重等于把产品塞进门缝；字宽占画幅 ~72% |
-| 漂移速度 | ~3.8px/f（300px/78f） | 快了字内画面读不清；漂移方向选画面信息密的轴 |
-| 吸气 | 8f，1→0.965 | 没有吸气的冲入读作"突然胀开"；>0.94 读作字在缩小退场 |
-| 放大倍率 | 46×（按竖笔宽/画幅比配：88px 竖笔需 ≥24× 才撑满） | 不足则接管帧还看得到字边残影 |
-| 冲入曲线 | 对数空间 t^1.8，24f | 线性对数 = 匀速冲入；指数 >2.5 前半段几乎不动、最后 3f 猛胀 |
-| 收尾 | 接管后 hold ≥30f | R1；接管完成帧产品应落在标准构图 |
-## 已知坑
-- demo 用的是为镜头设计的 video-shotcraft 渲染看板（Render throughput，侧栏是品牌标志）——实战换真实截图时先看笔画里透出的是不是大块色与亮线，
-  浅色页面要先调暗或换暗色主题，否则字读不出"窗"
-- 别给字形做描边高光：system-ui 等可变字体的字形由重叠轮廓拼成，描边会画出 A 的横杠/顶角等内部轮廓线
-- 字内透出的产品画面全程被特写盯着看——真实素材先过
-  审美准则 Q2 的高分辨率栅格化技法，低倍截图在笔画里糊成一片
-- 换词/换字体后 origin 手推值必失效——渲后看放大方向，洞不对中就微调
-  origin（同 transition-travel A 字腔穿越的腔心漂移坑）
-- 与 transition-travel A 字腔穿越同片不并用——同为"字里长出世界"，
-  观众读作同一招使两次（P4）
-- mask 层与内容层的 transform 必须分离驱动（wrapper 放大/内容反向补偿），
-  合在一层则产品跟着字形一起胀成 26 倍废片
-
-## 参考实现
-demos/opening/text-as-mask/
-（TextAsMask.tsx）
+---
+name: text-as-mask
+一句话: 文字视频遮罩——瓷白舞台上切出超粗大标题字，字内部透出缓慢平移的暗色实时产品面板，结尾吸一口气后字形指数冲入放大 46 倍溢出、内部画面接管全屏
+适用: 品牌词/口号与产品画面二合一的开场或章节卡；字是门、产品在门里
+时长: 165f（入场 18f + 字内漂移 78f + 吸气 8f + 冲入接管 24f + 落定/hold 37f）
+能量: 中高（漂移段沉稳，接管段一次爆发）
+标签: typography
+---
+
+## 意图
+标题和产品画面抢屏幕是老问题——先字后画慢，画上压字挤。这一式让
+两者同体：字形就是遮罩，产品只透过笔画显形，观众同时读到词和画面
+质感；结尾字形胀开溢出画幅，产品自然接管全屏——"从品牌词走进产品"
+一条镜头说完，兼任章节转场（与 transition-travel A 字腔穿越同族：
+那边是镜头钻进字腔，这边是字形自己胀开，前者相机动、后者门动）。
+
+## 动效核心
+- 亮场舞台（porcelain 冷白 + 主光 + 暗角）+ SVG 白字黑底 data-URI 交给 CSS `mask-image`，遮罩层套住产品画面；
+  字形下垫一层同字形、带色相的模糊投影（同样走 data-URI 图片），字像被"挖"进舞台的窗
+- 窗里的内容要有大块饱和色与亮线：demo 是 video-shotcraft 的暗色渲染看板（钴蓝→青流式面积图持续向左流、渲染帧数计数、渲染队列柱状图呼吸；眉题是 video-shotcraft 字标，副题 From one prompt to a finished launch film.），
+  漂移期面板上移 110px 让亮线正好穿过字的腰线、面积渐变铺满字的下半截——白卡/浅色 UI 透进白底字里会读成普通字
+- 入场：遮罩从基线向上擦出（clip-path 底边收起，16f）+ 1.04→1 落定；眉题字距收拢、副题升起
+- 字内漂移：产品层 scale 1.32 + translateX +150→-150（f18–96，bezier(0.3,0,0.7,1) 两端轻缓）——
+  字形静止、内容流动，"窗外有世界"的错觉即手法本体
+- 吸气：f96–104 字 1→0.965（swift），眉题/副题 ease-in 退场——大动作前的预备
+- 冲入 24f（f104–128）：mask wrapper `scale(0.965→46)`，对数空间里按 t^1.8 插值
+  （`S = s0·(46/s0)^(t^1.8)`，每帧放大比例越来越大 = 越冲越快）；
+  **transform-origin 必须钉在实心笔画内**（demo 取 L 竖笔中线 1236,546）——钉在字腔空洞里则放大后透出的是底色；
+  冲入同时 wrapper 平移 `(960−Ox, 540−Oy)·t`，把竖笔拉回画面中线（否则偏右的竖笔要到 30× 才盖住左缘）
+- 内容层反向补偿：套一层 `scale(1/S) translate(−d)`（同一 origin）抵消 wrapper 的放大与平移，产品画面
+  不随遮罩几何畸变；面板同时 1.32→1、漂移归零（expo-out，f104–132，比冲入晚 4f 收敛 = 跟随）
+- 接管保险：另叠一个共享同一 translate/scale 变换的无遮罩全屏层，只在竖笔已撑满全屏（t^1.8 ∈ [0.86, 0.95]，S≈24×）
+  之后淡入——更早淡入会在亮底上叠出一层半透明灰纱
+- 收尾：f132–165 全屏面板 hold，流式图仍缓慢流动（产品活着，不是死帧）
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 字号/字重 | 470px / 900（system-ui Black，字距 −22） | 笔画就是视口——细字重等于把产品塞进门缝；字宽占画幅 ~72% |
+| 漂移速度 | ~3.8px/f（300px/78f） | 快了字内画面读不清；漂移方向选画面信息密的轴 |
+| 吸气 | 8f，1→0.965 | 没有吸气的冲入读作"突然胀开"；>0.94 读作字在缩小退场 |
+| 放大倍率 | 46×（按竖笔宽/画幅比配：88px 竖笔需 ≥24× 才撑满） | 不足则接管帧还看得到字边残影 |
+| 冲入曲线 | 对数空间 t^1.8，24f | 线性对数 = 匀速冲入；指数 >2.5 前半段几乎不动、最后 3f 猛胀 |
+| 收尾 | 接管后 hold ≥30f | R1；接管完成帧产品应落在标准构图 |
+## 已知坑
+- demo 用的是为镜头设计的 video-shotcraft 渲染看板（Render throughput，侧栏是品牌标志）——实战换真实截图时先看笔画里透出的是不是大块色与亮线，
+  浅色页面要先调暗或换暗色主题，否则字读不出"窗"
+- 别给字形做描边高光：system-ui 等可变字体的字形由重叠轮廓拼成，描边会画出 A 的横杠/顶角等内部轮廓线
+- 字内透出的产品画面全程被特写盯着看——真实素材先过
+  审美准则 Q2 的高分辨率栅格化技法，低倍截图在笔画里糊成一片
+- 换词/换字体后 origin 手推值必失效——渲后看放大方向，洞不对中就微调
+  origin（同 transition-travel A 字腔穿越的腔心漂移坑）
+- 与 transition-travel A 字腔穿越同片不并用——同为"字里长出世界"，
+  观众读作同一招使两次（P4）
+- mask 层与内容层的 transform 必须分离驱动（wrapper 放大/内容反向补偿），
+  合在一层则产品跟着字形一起胀成 26 倍废片
+
+## 参考实现
+demos/opening/text-as-mask/
+（TextAsMask.tsx）

package/lib/motion/shotcraft/upstream/references/shots/outro/grain-dissolve.md

@@ -1,38 +1,38 @@
----
-name: grain-dissolve
-一句话: 整行字爆裂成沸腾颗粒噪点并浮现斜纹选区框，噪点云急速凝聚成更大号发光短字标，位移衰减归零定格
-适用: 收尾"XX. Now Live"式上线宣告；长句信息压缩成品牌短标的能量聚合拍
-时长: 约 2.0s（60f@30fps；砂化 0.26–0.56s · 凝聚 1.2–1.42s · 凝固回落收尾）
-能量: 中高（短促、一次性的能量脉冲，天然的 outro 卡点）
----
-
-## 意图
-把"一句话浓缩成一个词"拍成物理事件：句子先失稳沸腾成颗粒（信息解体），选区框暗示"正在选中提取"，然后所有颗粒能量向中心坍缩成更大更亮的短字标——观众读到的是"这一切归结为它"。
-
-## 动效核心
-- 滤镜链是唯一引擎：`feTurbulence`（fractalNoise，baseFrequency 0.9→1.3）+ `feDisplacementMap`（scale 0→52）+ `feGaussianBlur`（0→1.1px），三者由同一条 `burst` 曲线（t=0.13–0.28，outCubic）驱动
-- 噪点"沸腾"靠 `seed = floor(t*46)` 逐帧换种子——每帧一幅新噪声图，颗粒永不静止
-- t=0.60–0.71 交叉淡化：整行字（26px）淡出、短字标（44px 粗体）淡入，两者共用同一滤镜——切换发生在最沸腾时，观众看不到换字
-- t=0.68–0.90 `lock` 曲线把 displacement scale 和 blur 拉回 0，颗粒"凝固"成清晰字形
-- 白辉光三段式：砂化期 0.3 弱光 → 凝聚冲高 0.7 → t=0.88 后回落 0.45，滤镜链内"紧光 + 宽光"两层冷白 bloom（feGaussianBlur → feColorMatrix → feMerge，半径约 4–33px）同步呼吸；SVG 按原生 1920×1080 栅格化，颗粒才细
-- 斜纹选区框（45° 线阵 + 四角像素棋盘手柄）随 burst 浮现、t=0.55–0.64 撤掉——在凝聚前退场，不抢主体
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| displacement scale | 峰值 52 | <30 只是"轻微毛边"；>80 颗粒散到认不出轮廓，"隐约可辨"是砂化质感的底线 |
-| baseFrequency | 0.9 → +0.4 | 越高颗粒越细；低于 0.5 变成大块扭曲不是"砂" |
-| seed 换帧率 | floor(t*46)，2s 内 46 次 | 降低会看出噪声图重复；保持 ≥20 次/秒的换图率 |
-| 砂化窗口 | 0.13–0.28（outCubic） | 前 0.13 的干净字停留是"失稳前的常态"，砍掉则没有对比 |
-| 凝聚交叉 | 0.60–0.71（inOutCubic） | 必须落在最沸腾段内完成换字；提前会穿帮看到两行字叠影 |
-| 辉光包络 | burst·0.3 + cond·0.7 − settle·0.45 | 凝聚冲高是卡点位，压 BGM 重音；回落别到 0，留柔光"余温" |
-
-## 已知坑
-- demo 的文案是 `{ video-shotcraft. Now Live }` → 凝聚成 `video-shotcraft` 字标（全小写）；换项目短标时两行 `<text>` 都要改：整行句式 `{ XX. Now Live }` 与短标 XX 必须指同一对象，否则叙事断裂
-- 短标变长（>6 字符）需同步缩字号或加宽选区框 bw，否则凝聚后超出框位视觉重心偏移——demo 的 15 字符品牌名把整行字从 33px 缩到 26px、短标从 54px 缩到 44px，游离砂粒的落点范围同步放宽到字标字面
-- `feDisplacementMap` 在 Safari 上性能较差，这张卡是 2s 短拍可接受；拉长时长需实测帧率
-- 选区框撤场（0.55–0.64）必须早于凝聚完成（0.71）——框留到凝固后会读作"还没选完"，语义反了
-
-## 参考实现
-demos/outro/grain-dissolve/
-（GrainDissolve.tsx）
+---
+name: grain-dissolve
+一句话: 整行字爆裂成沸腾颗粒噪点并浮现斜纹选区框，噪点云急速凝聚成更大号发光短字标，位移衰减归零定格
+适用: 收尾"XX. Now Live"式上线宣告；长句信息压缩成品牌短标的能量聚合拍
+时长: 约 2.0s（60f@30fps；砂化 0.26–0.56s · 凝聚 1.2–1.42s · 凝固回落收尾）
+能量: 中高（短促、一次性的能量脉冲，天然的 outro 卡点）
+---
+
+## 意图
+把"一句话浓缩成一个词"拍成物理事件：句子先失稳沸腾成颗粒（信息解体），选区框暗示"正在选中提取"，然后所有颗粒能量向中心坍缩成更大更亮的短字标——观众读到的是"这一切归结为它"。
+
+## 动效核心
+- 滤镜链是唯一引擎：`feTurbulence`（fractalNoise，baseFrequency 0.9→1.3）+ `feDisplacementMap`（scale 0→52）+ `feGaussianBlur`（0→1.1px），三者由同一条 `burst` 曲线（t=0.13–0.28，outCubic）驱动
+- 噪点"沸腾"靠 `seed = floor(t*46)` 逐帧换种子——每帧一幅新噪声图，颗粒永不静止
+- t=0.60–0.71 交叉淡化：整行字（26px）淡出、短字标（44px 粗体）淡入，两者共用同一滤镜——切换发生在最沸腾时，观众看不到换字
+- t=0.68–0.90 `lock` 曲线把 displacement scale 和 blur 拉回 0，颗粒"凝固"成清晰字形
+- 白辉光三段式：砂化期 0.3 弱光 → 凝聚冲高 0.7 → t=0.88 后回落 0.45，滤镜链内"紧光 + 宽光"两层冷白 bloom（feGaussianBlur → feColorMatrix → feMerge，半径约 4–33px）同步呼吸；SVG 按原生 1920×1080 栅格化，颗粒才细
+- 斜纹选区框（45° 线阵 + 四角像素棋盘手柄）随 burst 浮现、t=0.55–0.64 撤掉——在凝聚前退场，不抢主体
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| displacement scale | 峰值 52 | <30 只是"轻微毛边"；>80 颗粒散到认不出轮廓，"隐约可辨"是砂化质感的底线 |
+| baseFrequency | 0.9 → +0.4 | 越高颗粒越细；低于 0.5 变成大块扭曲不是"砂" |
+| seed 换帧率 | floor(t*46)，2s 内 46 次 | 降低会看出噪声图重复；保持 ≥20 次/秒的换图率 |
+| 砂化窗口 | 0.13–0.28（outCubic） | 前 0.13 的干净字停留是"失稳前的常态"，砍掉则没有对比 |
+| 凝聚交叉 | 0.60–0.71（inOutCubic） | 必须落在最沸腾段内完成换字；提前会穿帮看到两行字叠影 |
+| 辉光包络 | burst·0.3 + cond·0.7 − settle·0.45 | 凝聚冲高是卡点位，压 BGM 重音；回落别到 0，留柔光"余温" |
+
+## 已知坑
+- demo 的文案是 `{ video-shotcraft. Now Live }` → 凝聚成 `video-shotcraft` 字标（全小写）；换项目短标时两行 `<text>` 都要改：整行句式 `{ XX. Now Live }` 与短标 XX 必须指同一对象，否则叙事断裂
+- 短标变长（>6 字符）需同步缩字号或加宽选区框 bw，否则凝聚后超出框位视觉重心偏移——demo 的 15 字符品牌名把整行字从 33px 缩到 26px、短标从 54px 缩到 44px，游离砂粒的落点范围同步放宽到字标字面
+- `feDisplacementMap` 在 Safari 上性能较差，这张卡是 2s 短拍可接受；拉长时长需实测帧率
+- 选区框撤场（0.55–0.64）必须早于凝聚完成（0.71）——框留到凝固后会读作"还没选完"，语义反了
+
+## 参考实现
+demos/outro/grain-dissolve/
+（GrainDissolve.tsx）

package/lib/motion/shotcraft/upstream/references/shots/outro/logo-shrink-wordmark-lockup.md

@@ -1,38 +1,38 @@
----
-name: logo-shrink-wordmark-lockup
-一句话: 霓虹切口大环快速收束成中央实心小白 O、过冲刹车时换成 video-shotcraft 标志，图标左移让位，字标字母逐个滑入完成 lockup，强调色标语收尾
-适用: 片尾品牌定妆：从满屏图形能量收束到"图标+字标+标语"的标准 lockup
-时长: 约 4.4s（132f@30fps；收束 0.1–1.2s · 让位 1.5–2.1s · 字母 2–2.7s · 标语 3.2–3.7s）
-能量: 中（收束段有冲击力，整体是沉稳的落定节奏）
----
-
-## 意图
-片尾的"盖章"动作：满屏的霓虹大环携能量坍缩成一枚小图标，愈合缺口、转为纯白（从演出态到标准态），然后按品牌 lockup 的规范一步步落位——图标让位、字标进场、标语押尾。观众看到的是品牌从动态里"站定"。
-
-## 动效核心
-- 收束主曲线：scale 5.4→1（t=0.02–0.28，inOutCubic），t=0.26–0.37 叠 `sin(π)*0.06` 的过冲刹车——到位瞬间胀 6% 再回落，"急停带惯性"
-- 缺口愈合与变色和收束同轨（t=0.10–0.28）：霓虹辉光层淡出、描边从 #dfe9ff 过半切 #fff、实心白 O 淡入——三层交叉在缩小过程中完成，落位时已是干净白标
-- t=0.24–0.32 白 O 交叉换成 video-shotcraft「镜刻」标志（反白版，与刹车、冲击波同拍；换标时已缩到最终尺寸）；环在内层旋转，标志所在的外层只缩放不旋转——斜切角度始终不变
-- t=0.34–0.47 图标整体左移让位（inOutCubic，−90.5px = 整组 lockup 宽的一半减半个图标），为字标腾出中轴右侧
-- 字标 `video-shotcraft`（15 字符，22px / 700，全小写）按 `0.46 + i*(0.24/15)` stagger 滑入：opacity 0→1 + translateX 8px→0，各 0.10 时长 outCubic
-- 标语是品牌短句 `FRAME MOTION. CRAFT THE SHOT.`（强调色 `ACCENT`，12.5px 宽字距）t=0.72–0.84 整行淡入，不逐字——层级低于字标一档
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 收束幅度 | scale 5.4→1 | 起始倍率决定"从多满收到多小"；<3 冲击力不足，>7 初始态糊出画 |
-| 刹车过冲 | +6%，sin 包络 0.26–0.37 | 砍掉读作硬冻结；>10% 变果冻 |
-| 愈合窗口 | 0.10–0.28（与收束同步） | 愈合必须在落位前完成——落位后还在变色读作"没准备好" |
-| 左移让位 | −90.5px（由 `WORD_W`/`GAP`/`ICON` 推出），0.34–0.47 | 与字母首入（0.46）几乎无缝衔接，拉开间隔会有"空等"感 |
-| 字母 stagger | `(0.7-0.46)/n`（15 字符 = 0.016/字），各 0.10 时长 | 5 字母的短词可放宽到 0.035/字；字多时按 `(0.7-0.46)/n` 反算间隔保证 0.7 前全部起跑 |
-| 标语入场 | 0.72–0.84 整行淡入 | 有意不逐字：标语是注脚不是主角；`ACCENT` 常量换项目色 |
-
-## 已知坑
-- `WORDMARK` = `BRAND.name`，标语 = `PITCH.en.motto`；换品牌词时字母 stagger 节奏依赖字数（已按字数自动反算），标语字符数变化时同步调字距，否则宽字距排版会溢出或过疏
-- 图标是"演出态→标准态"两层结构：SVG 双弧切口环（辉光/彩色）愈合成白 O，刹车时再交叉换成 video-shotcraft 标志（纯净态，不加辉光）；换别的 logo 时同样别让 logo 跟着环一起旋转
-- 左移量与字标宽度耦合：`WORD_W` 是字标行实测宽（换字体/字号要重新量），`SHIFT` 与字母行左缘 `ROW_LEFT` 都由它推出，让 lockup 整体在画面居中
-- 收尾后无循环回位设计，作 outro 最后一镜使用；需要循环时在 t=1 后接 1s 静帧
-
-## 参考实现
-demos/outro/logo-shrink-wordmark-lockup/
-（LogoShrinkWordmarkLockup.tsx）
+---
+name: logo-shrink-wordmark-lockup
+一句话: 霓虹切口大环快速收束成中央实心小白 O、过冲刹车时换成 video-shotcraft 标志，图标左移让位，字标字母逐个滑入完成 lockup，强调色标语收尾
+适用: 片尾品牌定妆：从满屏图形能量收束到"图标+字标+标语"的标准 lockup
+时长: 约 4.4s（132f@30fps；收束 0.1–1.2s · 让位 1.5–2.1s · 字母 2–2.7s · 标语 3.2–3.7s）
+能量: 中（收束段有冲击力，整体是沉稳的落定节奏）
+---
+
+## 意图
+片尾的"盖章"动作：满屏的霓虹大环携能量坍缩成一枚小图标，愈合缺口、转为纯白（从演出态到标准态），然后按品牌 lockup 的规范一步步落位——图标让位、字标进场、标语押尾。观众看到的是品牌从动态里"站定"。
+
+## 动效核心
+- 收束主曲线：scale 5.4→1（t=0.02–0.28，inOutCubic），t=0.26–0.37 叠 `sin(π)*0.06` 的过冲刹车——到位瞬间胀 6% 再回落，"急停带惯性"
+- 缺口愈合与变色和收束同轨（t=0.10–0.28）：霓虹辉光层淡出、描边从 #dfe9ff 过半切 #fff、实心白 O 淡入——三层交叉在缩小过程中完成，落位时已是干净白标
+- t=0.24–0.32 白 O 交叉换成 video-shotcraft「镜刻」标志（反白版，与刹车、冲击波同拍；换标时已缩到最终尺寸）；环在内层旋转，标志所在的外层只缩放不旋转——斜切角度始终不变
+- t=0.34–0.47 图标整体左移让位（inOutCubic，−90.5px = 整组 lockup 宽的一半减半个图标），为字标腾出中轴右侧
+- 字标 `video-shotcraft`（15 字符，22px / 700，全小写）按 `0.46 + i*(0.24/15)` stagger 滑入：opacity 0→1 + translateX 8px→0，各 0.10 时长 outCubic
+- 标语是品牌短句 `FRAME MOTION. CRAFT THE SHOT.`（强调色 `ACCENT`，12.5px 宽字距）t=0.72–0.84 整行淡入，不逐字——层级低于字标一档
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 收束幅度 | scale 5.4→1 | 起始倍率决定"从多满收到多小"；<3 冲击力不足，>7 初始态糊出画 |
+| 刹车过冲 | +6%，sin 包络 0.26–0.37 | 砍掉读作硬冻结；>10% 变果冻 |
+| 愈合窗口 | 0.10–0.28（与收束同步） | 愈合必须在落位前完成——落位后还在变色读作"没准备好" |
+| 左移让位 | −90.5px（由 `WORD_W`/`GAP`/`ICON` 推出），0.34–0.47 | 与字母首入（0.46）几乎无缝衔接，拉开间隔会有"空等"感 |
+| 字母 stagger | `(0.7-0.46)/n`（15 字符 = 0.016/字），各 0.10 时长 | 5 字母的短词可放宽到 0.035/字；字多时按 `(0.7-0.46)/n` 反算间隔保证 0.7 前全部起跑 |
+| 标语入场 | 0.72–0.84 整行淡入 | 有意不逐字：标语是注脚不是主角；`ACCENT` 常量换项目色 |
+
+## 已知坑
+- `WORDMARK` = `BRAND.name`，标语 = `PITCH.en.motto`；换品牌词时字母 stagger 节奏依赖字数（已按字数自动反算），标语字符数变化时同步调字距，否则宽字距排版会溢出或过疏
+- 图标是"演出态→标准态"两层结构：SVG 双弧切口环（辉光/彩色）愈合成白 O，刹车时再交叉换成 video-shotcraft 标志（纯净态，不加辉光）；换别的 logo 时同样别让 logo 跟着环一起旋转
+- 左移量与字标宽度耦合：`WORD_W` 是字标行实测宽（换字体/字号要重新量），`SHIFT` 与字母行左缘 `ROW_LEFT` 都由它推出，让 lockup 整体在画面居中
+- 收尾后无循环回位设计，作 outro 最后一镜使用；需要循环时在 t=1 后接 1s 静帧
+
+## 参考实现
+demos/outro/logo-shrink-wordmark-lockup/
+（LogoShrinkWordmarkLockup.tsx）