dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/typography/blur-slide.md

@@ -1,59 +1,59 @@
----
-name: blur-slide
-一句话: 标题逐词入场，y 0.38em→0 + blur 18→0 + opacity 0→1 三通道走同一条 ease-out 同步收敛，词间隔约 4f；副标题在标题收完前就错峰跟进
-适用: 几乎所有标题/副标题成对出现的场合；产品页首屏文案、章节小标题；需要"专业但不抢戏"的默认文字 reveal
-时长: 约 4.0s（120f@30fps）
-能量: 低（一次性收敛，无峰值无循环）
----
-
-## 意图
-这是文字 reveal 的**默认解**——没有奇观、没有机械感，只是把词一个个
-柔和地放到位。它的专业感全来自一件事：y、blur、opacity 三个通道共用
-同一个进度 `p`、同一条缓动，所以词是"从虚焦里浮出来"而不是"滑进来
-顺便淡一下"。当一支片里已经有别的重手法（乱码/滚轮），标题就该
-用这一卡，让位给主角。
-
-## 动效核心
-- 单词进度 `p = ramp(frame, start, dur, EASE.out)`（quint-out 级），三通道全绑同一个 p：
-  `opacity = p`、`translateY = (1-p)·dy`、`blur = (1-p)·B`px（demo 里主角词的字距收紧也挂在同一个 p 上）
-- 主标题（170px 衬线两行）：第一行 3 词 10f 起、词间 4f、每词 22f；第二行先停 6f 换气，
-  "feel" 26f、主角词 "cinematic." 30f 起且入场窗 30f（最后落定）；`dy = 64`px、`B = 18`px
-- 副标题（46px 无衬线，9 词）：34f 起、词间 2.4f、每词 20f、`dy = 26`px、`B = 9`px
-  ——间隔更密、位移更小，**层级差是靠幅度不是靠时长**
-- 错峰而非排队：副标题在 34f 起手，标题要到 60f 才收完，两段有 26f 重叠——
-  排队会读作两拍，重叠才是一句话
-- 拆词不拆字：`text.split(' ')` 后每词一个 span，`line` 用 `gap:0.32em`
-  撑词距（不靠空格）——逐字入场太碎，词级才有"念出来"的语感
-- demo 版式：paper look（暖白纸 + 墨 + 朱红），杂志刊头（video-shotcraft 字标）/刊脚发丝线框成一页，朱红全大写眉题 →
-  170px 衬线主标题（主角词斜体朱红）→ 46px 无衬线副标题，左对齐 168px 网格；后景一枚 5% 墨色的
-  760px 刊号数字反向慢漂做视差；文字层全程极缓推近 1→1.03（smooth），刊脚发丝线 72f 起画给 hold 段收尾
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 词间 stagger | 主 4f / 副 2.4f | 3–4f 是"逐词"的甜点；<2f 整行齐入没有 stagger，>8f 观众开始一个个数词 |
-| 单词入场窗 | 主 22f（主角词 30f）/ 副 20f，`EASE.out` | <10f 读作硬弹；>30f 每个词都在慢慢浮，整句拖沓 |
-| y 位移 | 主 64px（≈0.38em）/ 副 26px | 主副不等幅是层级来源；<0.15em 位移无感，>0.6em 词从画外飞进来变成滑入 |
-| blur 通道 | 主 `(1-p)·18`px / 副 `(1-p)·9`px | 这一通道就是"专业感"，删了退化成普通淡入上移；超过字号的 ~12% 中间帧糊成色块 |
-| 主副错峰 | 主 10f–60f / 副 34f–80f | 重叠 ~26f 是"一句话"；副标题起点推到主标题收完之后就读成两拍 |
-| 字号字重 | 170px 衬线 400 对 46px 无衬线 400 | 差 2 倍以上才有主副关系；字重相同时靠字体家族区分，副标题上 600+ 字重会和主标打架 |
-| 收尾 hold | 副标题 80f 收完，尾部约 40f（只剩极缓推近与刊脚收尾） | 静置 <8f 观众还没读完就切了 |
-
-## 已知坑
-- demo 在占位文案上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **占位文案是主 5 词（两行）/ 副 9 词，换项目文案时词数要贴近**：stagger 总长
-  = `gap × 词数`，词数翻倍末词起点就往后挪一倍，末词的入场会被挤到收尾 hold
-  ——超过 8 词就该同步把 gap 压到 2–2.5f
-- 三通道必须共用同一个 `p`：分开写三条缓动（哪怕曲线相同）就会出现
-  "位移到了但还糊着"的错位，柔和感立刻散掉
-- 词级拆分对中文文案要手动切：`split(' ')` 在中文上得到一整块，
-  须自己按语义分段成 3–5 个 span，别退化成逐字
-- 每行是绝对定位的 `flex` 行（左对齐 168px 网格），词距靠 `gap` 而非空格；
-  换文案时注意第一行不要超过 ~1450px 宽（170px 衬线约 17 个字符），否则撞右侧刊号后景
-- 这是**低能量默认卡**：与本类里的乱码/滚轮属于不同职能，同片可以
-  也应该共存（主角用重手法，其余标题全用本卡）
-
-## 参考实现
-demos/typography/blur-slide/
-（BlurSlide.tsx）
+---
+name: blur-slide
+一句话: 标题逐词入场，y 0.38em→0 + blur 18→0 + opacity 0→1 三通道走同一条 ease-out 同步收敛，词间隔约 4f；副标题在标题收完前就错峰跟进
+适用: 几乎所有标题/副标题成对出现的场合；产品页首屏文案、章节小标题；需要"专业但不抢戏"的默认文字 reveal
+时长: 约 4.0s（120f@30fps）
+能量: 低（一次性收敛，无峰值无循环）
+---
+
+## 意图
+这是文字 reveal 的**默认解**——没有奇观、没有机械感，只是把词一个个
+柔和地放到位。它的专业感全来自一件事：y、blur、opacity 三个通道共用
+同一个进度 `p`、同一条缓动，所以词是"从虚焦里浮出来"而不是"滑进来
+顺便淡一下"。当一支片里已经有别的重手法（乱码/滚轮），标题就该
+用这一卡，让位给主角。
+
+## 动效核心
+- 单词进度 `p = ramp(frame, start, dur, EASE.out)`（quint-out 级），三通道全绑同一个 p：
+  `opacity = p`、`translateY = (1-p)·dy`、`blur = (1-p)·B`px（demo 里主角词的字距收紧也挂在同一个 p 上）
+- 主标题（170px 衬线两行）：第一行 3 词 10f 起、词间 4f、每词 22f；第二行先停 6f 换气，
+  "feel" 26f、主角词 "cinematic." 30f 起且入场窗 30f（最后落定）；`dy = 64`px、`B = 18`px
+- 副标题（46px 无衬线，9 词）：34f 起、词间 2.4f、每词 20f、`dy = 26`px、`B = 9`px
+  ——间隔更密、位移更小，**层级差是靠幅度不是靠时长**
+- 错峰而非排队：副标题在 34f 起手，标题要到 60f 才收完，两段有 26f 重叠——
+  排队会读作两拍，重叠才是一句话
+- 拆词不拆字：`text.split(' ')` 后每词一个 span，`line` 用 `gap:0.32em`
+  撑词距（不靠空格）——逐字入场太碎，词级才有"念出来"的语感
+- demo 版式：paper look（暖白纸 + 墨 + 朱红），杂志刊头（video-shotcraft 字标）/刊脚发丝线框成一页，朱红全大写眉题 →
+  170px 衬线主标题（主角词斜体朱红）→ 46px 无衬线副标题，左对齐 168px 网格；后景一枚 5% 墨色的
+  760px 刊号数字反向慢漂做视差；文字层全程极缓推近 1→1.03（smooth），刊脚发丝线 72f 起画给 hold 段收尾
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 词间 stagger | 主 4f / 副 2.4f | 3–4f 是"逐词"的甜点；<2f 整行齐入没有 stagger，>8f 观众开始一个个数词 |
+| 单词入场窗 | 主 22f（主角词 30f）/ 副 20f，`EASE.out` | <10f 读作硬弹；>30f 每个词都在慢慢浮，整句拖沓 |
+| y 位移 | 主 64px（≈0.38em）/ 副 26px | 主副不等幅是层级来源；<0.15em 位移无感，>0.6em 词从画外飞进来变成滑入 |
+| blur 通道 | 主 `(1-p)·18`px / 副 `(1-p)·9`px | 这一通道就是"专业感"，删了退化成普通淡入上移；超过字号的 ~12% 中间帧糊成色块 |
+| 主副错峰 | 主 10f–60f / 副 34f–80f | 重叠 ~26f 是"一句话"；副标题起点推到主标题收完之后就读成两拍 |
+| 字号字重 | 170px 衬线 400 对 46px 无衬线 400 | 差 2 倍以上才有主副关系；字重相同时靠字体家族区分，副标题上 600+ 字重会和主标打架 |
+| 收尾 hold | 副标题 80f 收完，尾部约 40f（只剩极缓推近与刊脚收尾） | 静置 <8f 观众还没读完就切了 |
+
+## 已知坑
+- demo 在占位文案上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **占位文案是主 5 词（两行）/ 副 9 词，换项目文案时词数要贴近**：stagger 总长
+  = `gap × 词数`，词数翻倍末词起点就往后挪一倍，末词的入场会被挤到收尾 hold
+  ——超过 8 词就该同步把 gap 压到 2–2.5f
+- 三通道必须共用同一个 `p`：分开写三条缓动（哪怕曲线相同）就会出现
+  "位移到了但还糊着"的错位，柔和感立刻散掉
+- 词级拆分对中文文案要手动切：`split(' ')` 在中文上得到一整块，
+  须自己按语义分段成 3–5 个 span，别退化成逐字
+- 每行是绝对定位的 `flex` 行（左对齐 168px 网格），词距靠 `gap` 而非空格；
+  换文案时注意第一行不要超过 ~1450px 宽（170px 衬线约 17 个字符），否则撞右侧刊号后景
+- 这是**低能量默认卡**：与本类里的乱码/滚轮属于不同职能，同片可以
+  也应该共存（主角用重手法，其余标题全用本卡）
+
+## 参考实现
+demos/typography/blur-slide/
+（BlurSlide.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/brace-expand.md

@@ -1,55 +1,55 @@
----
-name: brace-expand
-一句话: 一对紧贴的小花括号先在正中出现，随即带一次过冲向左右弹开并放大到标题级，文字 clip 宽度严格绑括号内缘、像被拉开幕布般从中间揭示，落定后字距再细微松弛
-适用: 开发者/技术产品的标题字卡；章节开场；需要"一个符号完成揭示"的极简一拍
-时长: 约 4s（120f@30fps：光标 0–6f → 6f 小括号硬切 → 14f 弹开 → 40–64f 字距松弛 → 副标 → hold）
-能量: 中（单次过冲是唯一峰值，其余静止）
----
-
-## 意图
-标题揭示的手法里，本卡最省：不做遮罩条、不做逐字、不做位移——只让
-一对括号往两边走，文字被"括出来"。它天生带代码语感（`{}` 是花括号），
-所以在技术产品语境里读作"这就是内容本体"。命门是 clip 宽度**必须严格
-绑括号位置**：一旦文字自己淡入或自己擦入，括号就退化成装饰，幕布感全失。
-
-## 动效核心
-- 开场第 0 帧中心是一个闪烁的输入光标（编辑器语感，不是空帧）；6f 被一对 0.4 倍、内缘相贴的 "{}" **硬切替换**
-  （不淡入），静置 8f——先建立"这是一对括号"
-- 弹开 `ex = springAt(f, 14, { damping: 14, stiffness: 130 })`：起跳后 ~8f 到位、~11f 过冲峰 ≈9%、~24f 收敛，一次可见回弹
-- 同步放大 `sc = mix(0.4, 1, ex)`；幕布半宽 `x = (HALF − INNER)·ex·sc`、括号中心 `±(x + INNER·sc)`
-  （HALF=676、INNER=64）——**位移与缩放乘在一起**，放大本身也在推开括号；ex=0 时两只括号内缘正好相贴
-- 文字揭示宽度 `clip.width = 2x`（严格绑括号内缘），两侧 14px 羽化（clip 窄时羽化跟着收）
-- 文字同步 `scale(sc)`，与括号共用同一个 sc；落定后字距 −0.05em → −0.03em 松弛（40–64f smooth）——"呼一口气"
-- 质感（midnight）：等宽 300px 电光蓝括号 + 泛光（泛光峰值跟着过冲走、34–64f 回落），弹开快速段按水平速度加方向性
-  运动模糊（amount 0.22、封顶 16，落定为 0）；标题（demo 为品牌名 video-shotcraft，全小写）164px 800 字重白→冷蓝渐变；背景编辑器点阵（32px，径向渐隐）+
-  顶光 + 地平线光带，括号下方一道随弹开展宽的冷光反射
-- 余波：眉题 `// shot recipes for your agent`（等宽 32px 青色）44f 起字距收拢入场，副标（品牌短句 Frame motion. Craft the shot.）54f 起逐词虚化浮现；70–120f 整幅 1→1.012 缓推
-- 定位全部绝对定位（括号 / clip 框 / 文字都以 960 为中线算 left），**不用 flex**：宽度全程在变，flex 会重排
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 括号出现 | 6f 硬切替换光标 | 硬切是对的（符号"啪"地在那儿）；改淡入就少了"先看清括号"的那几帧，弹开显得突然 |
-| 弹开 | 14f 起弹簧 damping 14 / stiffness 130（≈9% 过冲） | 过冲是全片唯一峰值；damping ≥18 读作滑开，没有"撑"的力道；<12 回弹两次读作果冻 |
-| 半距 | HALF = 676px（括号中心）、INNER = 64px（括号中心到内缘） | 决定标题可容纳的宽度：内腔 = 2·(HALF−INNER) = 1224px |
-| 缩放 | `mix(0.4, 1, ex)`，括号 300px / 字 164px | 0.4 起点是"小字号"的量；起点 >0.8 看不出放大，<0.3 括号一开始小得像标点 |
-| 文案宽度 | 「video-shotcraft」164px 落定实测 ≈1130px（内腔 1224px 减两侧羽化） | 字比内腔窄太多，括号还没到位字就露全了，幕布感变弱；比内腔宽则两头被裁 |
-| 字距松弛 | −0.05 → −0.03em，40–64f smooth | 这一下是"落定后的呼吸"；松弛后字会变宽，要留在内腔内 |
-| 运动模糊 | SpeedBlur amount 0.22 / max 16 | amount 0.35 时峰值帧括号糊成三道横线，认不出是括号 |
-
-## 已知坑
-- **文案长度必须与 HALF 匹配**：clip 只做裁切不做缩放——换成长标题时字会被括号裁掉两头，
-  必须同步加大 HALF（或减小字号）；中文标题字宽约为英文两倍，6 个汉字就接近上限
-- clip 宽度是从 0 长起来的，所以文字**总是从中间往两边露**：文案的
-  视觉重心要在中央（居中单行短句最佳），左右不对称的长短句会露得别扭
-- 括号与文字必须共用同一个 `sc`：分别写两条缩放曲线（哪怕数值相同）
-  会在过冲那几帧出现括号已经到位、字还在长的错位
-- 过冲只此一次：全片其他运动都无过冲，这是把注意力压在"撑开"这一
-  动作上；再叠别的 back / 弹簧过冲就贬值了
-- clip 框高度写死 220px（标题 164px 留上下余量），字号大改时要同步——不然上下被切
-- 声音：弹开那一下值得一记短促的机械/木质开合音，落定后无声；
-  配法纪律见 sound-design.md
-
-## 参考实现
-demos/typography/brace-expand/
-（BraceExpand.tsx）
+---
+name: brace-expand
+一句话: 一对紧贴的小花括号先在正中出现，随即带一次过冲向左右弹开并放大到标题级，文字 clip 宽度严格绑括号内缘、像被拉开幕布般从中间揭示，落定后字距再细微松弛
+适用: 开发者/技术产品的标题字卡；章节开场；需要"一个符号完成揭示"的极简一拍
+时长: 约 4s（120f@30fps：光标 0–6f → 6f 小括号硬切 → 14f 弹开 → 40–64f 字距松弛 → 副标 → hold）
+能量: 中（单次过冲是唯一峰值，其余静止）
+---
+
+## 意图
+标题揭示的手法里，本卡最省：不做遮罩条、不做逐字、不做位移——只让
+一对括号往两边走，文字被"括出来"。它天生带代码语感（`{}` 是花括号），
+所以在技术产品语境里读作"这就是内容本体"。命门是 clip 宽度**必须严格
+绑括号位置**：一旦文字自己淡入或自己擦入，括号就退化成装饰，幕布感全失。
+
+## 动效核心
+- 开场第 0 帧中心是一个闪烁的输入光标（编辑器语感，不是空帧）；6f 被一对 0.4 倍、内缘相贴的 "{}" **硬切替换**
+  （不淡入），静置 8f——先建立"这是一对括号"
+- 弹开 `ex = springAt(f, 14, { damping: 14, stiffness: 130 })`：起跳后 ~8f 到位、~11f 过冲峰 ≈9%、~24f 收敛，一次可见回弹
+- 同步放大 `sc = mix(0.4, 1, ex)`；幕布半宽 `x = (HALF − INNER)·ex·sc`、括号中心 `±(x + INNER·sc)`
+  （HALF=676、INNER=64）——**位移与缩放乘在一起**，放大本身也在推开括号；ex=0 时两只括号内缘正好相贴
+- 文字揭示宽度 `clip.width = 2x`（严格绑括号内缘），两侧 14px 羽化（clip 窄时羽化跟着收）
+- 文字同步 `scale(sc)`，与括号共用同一个 sc；落定后字距 −0.05em → −0.03em 松弛（40–64f smooth）——"呼一口气"
+- 质感（midnight）：等宽 300px 电光蓝括号 + 泛光（泛光峰值跟着过冲走、34–64f 回落），弹开快速段按水平速度加方向性
+  运动模糊（amount 0.22、封顶 16，落定为 0）；标题（demo 为品牌名 video-shotcraft，全小写）164px 800 字重白→冷蓝渐变；背景编辑器点阵（32px，径向渐隐）+
+  顶光 + 地平线光带，括号下方一道随弹开展宽的冷光反射
+- 余波：眉题 `// shot recipes for your agent`（等宽 32px 青色）44f 起字距收拢入场，副标（品牌短句 Frame motion. Craft the shot.）54f 起逐词虚化浮现；70–120f 整幅 1→1.012 缓推
+- 定位全部绝对定位（括号 / clip 框 / 文字都以 960 为中线算 left），**不用 flex**：宽度全程在变，flex 会重排
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 括号出现 | 6f 硬切替换光标 | 硬切是对的（符号"啪"地在那儿）；改淡入就少了"先看清括号"的那几帧，弹开显得突然 |
+| 弹开 | 14f 起弹簧 damping 14 / stiffness 130（≈9% 过冲） | 过冲是全片唯一峰值；damping ≥18 读作滑开，没有"撑"的力道；<12 回弹两次读作果冻 |
+| 半距 | HALF = 676px（括号中心）、INNER = 64px（括号中心到内缘） | 决定标题可容纳的宽度：内腔 = 2·(HALF−INNER) = 1224px |
+| 缩放 | `mix(0.4, 1, ex)`，括号 300px / 字 164px | 0.4 起点是"小字号"的量；起点 >0.8 看不出放大，<0.3 括号一开始小得像标点 |
+| 文案宽度 | 「video-shotcraft」164px 落定实测 ≈1130px（内腔 1224px 减两侧羽化） | 字比内腔窄太多，括号还没到位字就露全了，幕布感变弱；比内腔宽则两头被裁 |
+| 字距松弛 | −0.05 → −0.03em，40–64f smooth | 这一下是"落定后的呼吸"；松弛后字会变宽，要留在内腔内 |
+| 运动模糊 | SpeedBlur amount 0.22 / max 16 | amount 0.35 时峰值帧括号糊成三道横线，认不出是括号 |
+
+## 已知坑
+- **文案长度必须与 HALF 匹配**：clip 只做裁切不做缩放——换成长标题时字会被括号裁掉两头，
+  必须同步加大 HALF（或减小字号）；中文标题字宽约为英文两倍，6 个汉字就接近上限
+- clip 宽度是从 0 长起来的，所以文字**总是从中间往两边露**：文案的
+  视觉重心要在中央（居中单行短句最佳），左右不对称的长短句会露得别扭
+- 括号与文字必须共用同一个 `sc`：分别写两条缩放曲线（哪怕数值相同）
+  会在过冲那几帧出现括号已经到位、字还在长的错位
+- 过冲只此一次：全片其他运动都无过冲，这是把注意力压在"撑开"这一
+  动作上；再叠别的 back / 弹簧过冲就贬值了
+- clip 框高度写死 220px（标题 164px 留上下余量），字号大改时要同步——不然上下被切
+- 声音：弹开那一下值得一记短促的机械/木质开合音，落定后无声；
+  配法纪律见 sound-design.md
+
+## 参考实现
+demos/typography/brace-expand/
+（BraceExpand.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/countdown-arc-scatter.md

@@ -1,65 +1,65 @@
----
-name: countdown-arc-scatter
-一句话: 纸面表盘 9 个等大数字沿大弧切向排布，整盘扫过 96° 后减速急停，"5" 停在弧顶随即平移落位成标题首字符，其余数字带 blur 原地散去，标题逐词模糊淡入、末词转强调色
-适用: 倒计时/时长承诺类文案（"5 min to install"）；数据揭晓的一拍；需要"仪表盘"语汇的浅底短镜
-时长: 约 3.3s（100f@30fps：扫动 ~30f + 落位 20f + 标题成句 + hold 22f；最短可压到 33f 单拍）
-能量: 高（96° 大幅扫动压进 ~20 帧，纯冲击）
----
-
-## 意图
-"5 分钟装完"写成静态字卡没人信。表盘扫过的做法把这个数字放进一个
-**量程**里：45、35、28、22、17、10 一路扫过去，停在 5——观众看到的是
-"从很多降到很少"，数字自带论证。停下后 "5" 不消失而是**平移变成标题的
-首字符**，一个元素完成从仪表到文案的身份切换，这是本卡最值钱的一手。
-
-## 动效核心
-- 弧线排布：9 个数字挂在同一圆心上（demo 按 1920×1080 原生作画：圆心 (960,1150)、R=700，弧顶 y=450），
-  `ang = (i-6)·24`°，位置 `x = cx + sin·R`、`y = cy - cos·R`，自身再 `rotate(位置角)` —— **切向排布**，
-  数字随弧倾斜像刻在盘面上；数字 112px Helvetica 粗体 tabular，等大同字重
-- 整盘扫动：先 5f 反向蓄力 +3°（anticipation），再一记物理弹簧 99°→0°（damping 12 / stiffness 60，
-  ~24f 冲过 0° 约 2°、~34f 落定）——"减速急停 + 一次表针回弹"是"到位"的全部力道
-- 弧两端淡入淡出：`op = clamp((70 - |pa|)/22)`，位置角超过 ±70° 就归零、±48° 起渐显——
-  **不用遮罩，用角度算透明度**，所以数字是"转进视野"的
-- `i=6` 的 "5" 角度设计为 0（扫完正停弧顶），回弹落定前 2f 即起飞：20f 不对称 in-out（EASE.swift）
-  平移到标题首字符槽，同一条曲线做 112→150px 放大与自转回正。标题首槽是固定宽 0.6em 的空位，
-  飞行的 "5" 也用同宽居中盒，所以落点与槽中心严格对齐、不需要换元素
-- 其余 8 个数字 28→44f 原地失焦淡出（`blur(out·6)`，**不位移**，位移会跟 "5" 的平移抢戏），早于 "5"
-  起飞 4f 先让路；扫动快速段每个数字按切向速度做方向性运动模糊（停稳归零）
-- 盘面层次：数字内侧一圈随盘同速转的细刻度（每 4° 一根、数字位加长）；强调色指针挂在 `rot·0.35`
-  上跟转——**0.35 倍差速**，两条转速造出"盘面 + 指针"的层次；外侧一道静止发丝弧 + 顶部强调色读数标，
-  盘面散去后以 35% 留在海报上（标题像是从仪表上读出来的）
-- 标题三词逐词 `blur((1-p)·10)` + 淡入 + 0.12em 上浮，窗 42–56 / 46–60 / 50–66f（重叠 = 一句话）；
-  末词在 64–76f 从墨色插值到强调色（demo 朱红）——全片唯一的颜色事件；下方 mono 34px 命令行补一句产品事实（demo 为 video-shotcraft 的真实安装命令 `npx skills add Vincentwei1021/video-shotcraft`；右上角是 video-shotcraft 字标）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 数列 | `[45,35,28,22,17,10,5,4,3]`，间距 24° | 递减不等距（45→35→28…）才像真量程，等差数列读作刻度尺；"5" 必须在 i=6 位（前 6 个扫过、后 2 个预留） |
-| 弧半径 | R=700px，圆心在画面下方（弧顶 y≈450） | 半径决定弧的曲度：<R/3 帧宽数字挤成小圈，弧近乎直线时表盘感消失；整条可视弧应横跨画面 60–70% |
-| 扫动 | 蓄力 +3° 5f → 弹簧 99°→0°（damping 12 / stiffness 60，~2° 过冲） | 过冲 >4° 读作弹簧玩具；无过冲的 inOut 缓停没有仪表的干脆 |
-| 可视角窗 | `(70-|pa|)/22`（±70° 外全透） | 22 是渐变宽度（约一格）；调大成 40 数字半透着进出，糊；调 0 就是硬切出现 |
-| "5" 落位 | 32→52f（20f，EASE.swift），112→150px，同步回正 | 落位紧接扫停，中间不留静置——留了就断成两个动作；落点必须是标题首字符槽（固定槽宽保证对齐） |
-| 其余淡出 | 28→44f + `blur(out·6)` | 淡出**早于** "5" 起飞起手，先让路；blur 让散去像失焦而非消失 |
-| 刻度差速 | 指针 `rot·0.35`；标题逐词窗重叠约 10f、`blur (1-p)·10`px | 差速是"盘 vs 指针"的层次来源，1.0（同速）读作一整块贴图在转；逐词窗重叠才是"一句话"，排队读作三个词各自出场 |
-| 末词染色 | 64→76f → 强调色 | 全片唯一的颜色事件，落在最后一个词上就是句子的落点 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **33f 是极限压缩**（motion-lab 原稿：扫动 17f、"5" 落位 6f、三词淡入各约 5f），信息密度远高于可读上限；
-  demo 已拉到 100f。再改时长时把各时间窗按**同一比例**缩放（比例关系是调校过的），别只拉扫动段
-- **换文案时要重估标题宽度**：demo 用 `TITLE_EM`（按字宽估算的整行 em 宽）把标题居中，"5" 的落点
-  由固定 0.6em 首槽推出——文案变了只改 `WORDS` 与 `TITLE_EM`，落点自动对齐，但整行居中要重估
-- 盘面数字必须**等大同字重**（demo 112px/700）：大小不一读作数据可视化，
-  不是仪表盘扫过
-- "5" 的角度设计（i=6 → ang=0）是本卡的地基：改数列长度或改哪个数字
-  是主角，都必须让主角的 `ang` 算出来正好是 0，否则扫停时它不在弧顶
-- 浅底优先：暖白纸底 + 墨色数字 + 单一强调色是这卡的干净感来源；深底版
-  需整套重配（且淡出用的 blur 在深底上会发灰）
-- 声音：扫停那一下 + 落位那一下是两个紧连的节奏点（相隔仅数帧），
-  配两记不同音色的短音（扫停用机械止停、落位用轻质落定）；同音连发
-  会糊成一声，配法纪律见 sound-design.md
-
-## 参考实现
-demos/typography/countdown-arc-scatter/
-（CountdownArcScatter.tsx）
+---
+name: countdown-arc-scatter
+一句话: 纸面表盘 9 个等大数字沿大弧切向排布，整盘扫过 96° 后减速急停，"5" 停在弧顶随即平移落位成标题首字符，其余数字带 blur 原地散去，标题逐词模糊淡入、末词转强调色
+适用: 倒计时/时长承诺类文案（"5 min to install"）；数据揭晓的一拍；需要"仪表盘"语汇的浅底短镜
+时长: 约 3.3s（100f@30fps：扫动 ~30f + 落位 20f + 标题成句 + hold 22f；最短可压到 33f 单拍）
+能量: 高（96° 大幅扫动压进 ~20 帧，纯冲击）
+---
+
+## 意图
+"5 分钟装完"写成静态字卡没人信。表盘扫过的做法把这个数字放进一个
+**量程**里：45、35、28、22、17、10 一路扫过去，停在 5——观众看到的是
+"从很多降到很少"，数字自带论证。停下后 "5" 不消失而是**平移变成标题的
+首字符**，一个元素完成从仪表到文案的身份切换，这是本卡最值钱的一手。
+
+## 动效核心
+- 弧线排布：9 个数字挂在同一圆心上（demo 按 1920×1080 原生作画：圆心 (960,1150)、R=700，弧顶 y=450），
+  `ang = (i-6)·24`°，位置 `x = cx + sin·R`、`y = cy - cos·R`，自身再 `rotate(位置角)` —— **切向排布**，
+  数字随弧倾斜像刻在盘面上；数字 112px Helvetica 粗体 tabular，等大同字重
+- 整盘扫动：先 5f 反向蓄力 +3°（anticipation），再一记物理弹簧 99°→0°（damping 12 / stiffness 60，
+  ~24f 冲过 0° 约 2°、~34f 落定）——"减速急停 + 一次表针回弹"是"到位"的全部力道
+- 弧两端淡入淡出：`op = clamp((70 - |pa|)/22)`，位置角超过 ±70° 就归零、±48° 起渐显——
+  **不用遮罩，用角度算透明度**，所以数字是"转进视野"的
+- `i=6` 的 "5" 角度设计为 0（扫完正停弧顶），回弹落定前 2f 即起飞：20f 不对称 in-out（EASE.swift）
+  平移到标题首字符槽，同一条曲线做 112→150px 放大与自转回正。标题首槽是固定宽 0.6em 的空位，
+  飞行的 "5" 也用同宽居中盒，所以落点与槽中心严格对齐、不需要换元素
+- 其余 8 个数字 28→44f 原地失焦淡出（`blur(out·6)`，**不位移**，位移会跟 "5" 的平移抢戏），早于 "5"
+  起飞 4f 先让路；扫动快速段每个数字按切向速度做方向性运动模糊（停稳归零）
+- 盘面层次：数字内侧一圈随盘同速转的细刻度（每 4° 一根、数字位加长）；强调色指针挂在 `rot·0.35`
+  上跟转——**0.35 倍差速**，两条转速造出"盘面 + 指针"的层次；外侧一道静止发丝弧 + 顶部强调色读数标，
+  盘面散去后以 35% 留在海报上（标题像是从仪表上读出来的）
+- 标题三词逐词 `blur((1-p)·10)` + 淡入 + 0.12em 上浮，窗 42–56 / 46–60 / 50–66f（重叠 = 一句话）；
+  末词在 64–76f 从墨色插值到强调色（demo 朱红）——全片唯一的颜色事件；下方 mono 34px 命令行补一句产品事实（demo 为 video-shotcraft 的真实安装命令 `npx skills add Vincentwei1021/video-shotcraft`；右上角是 video-shotcraft 字标）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 数列 | `[45,35,28,22,17,10,5,4,3]`，间距 24° | 递减不等距（45→35→28…）才像真量程，等差数列读作刻度尺；"5" 必须在 i=6 位（前 6 个扫过、后 2 个预留） |
+| 弧半径 | R=700px，圆心在画面下方（弧顶 y≈450） | 半径决定弧的曲度：<R/3 帧宽数字挤成小圈，弧近乎直线时表盘感消失；整条可视弧应横跨画面 60–70% |
+| 扫动 | 蓄力 +3° 5f → 弹簧 99°→0°（damping 12 / stiffness 60，~2° 过冲） | 过冲 >4° 读作弹簧玩具；无过冲的 inOut 缓停没有仪表的干脆 |
+| 可视角窗 | `(70-|pa|)/22`（±70° 外全透） | 22 是渐变宽度（约一格）；调大成 40 数字半透着进出，糊；调 0 就是硬切出现 |
+| "5" 落位 | 32→52f（20f，EASE.swift），112→150px，同步回正 | 落位紧接扫停，中间不留静置——留了就断成两个动作；落点必须是标题首字符槽（固定槽宽保证对齐） |
+| 其余淡出 | 28→44f + `blur(out·6)` | 淡出**早于** "5" 起飞起手，先让路；blur 让散去像失焦而非消失 |
+| 刻度差速 | 指针 `rot·0.35`；标题逐词窗重叠约 10f、`blur (1-p)·10`px | 差速是"盘 vs 指针"的层次来源，1.0（同速）读作一整块贴图在转；逐词窗重叠才是"一句话"，排队读作三个词各自出场 |
+| 末词染色 | 64→76f → 强调色 | 全片唯一的颜色事件，落在最后一个词上就是句子的落点 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **33f 是极限压缩**（motion-lab 原稿：扫动 17f、"5" 落位 6f、三词淡入各约 5f），信息密度远高于可读上限；
+  demo 已拉到 100f。再改时长时把各时间窗按**同一比例**缩放（比例关系是调校过的），别只拉扫动段
+- **换文案时要重估标题宽度**：demo 用 `TITLE_EM`（按字宽估算的整行 em 宽）把标题居中，"5" 的落点
+  由固定 0.6em 首槽推出——文案变了只改 `WORDS` 与 `TITLE_EM`，落点自动对齐，但整行居中要重估
+- 盘面数字必须**等大同字重**（demo 112px/700）：大小不一读作数据可视化，
+  不是仪表盘扫过
+- "5" 的角度设计（i=6 → ang=0）是本卡的地基：改数列长度或改哪个数字
+  是主角，都必须让主角的 `ang` 算出来正好是 0，否则扫停时它不在弧顶
+- 浅底优先：暖白纸底 + 墨色数字 + 单一强调色是这卡的干净感来源；深底版
+  需整套重配（且淡出用的 blur 在深底上会发灰）
+- 声音：扫停那一下 + 落位那一下是两个紧连的节奏点（相隔仅数帧），
+  配两记不同音色的短音（扫停用机械止停、落位用轻质落定）；同音连发
+  会糊成一声，配法纪律见 sound-design.md
+
+## 参考实现
+demos/typography/countdown-arc-scatter/
+（CountdownArcScatter.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/document-typewriter-reveal.md

@@ -1,42 +1,42 @@
----
-name: document-typewriter-reveal
-一句话: 悬浮在暗场里的整页真排版文档窗口在光标后自己"写"出来、侧栏跟进、历史条目逐个落入轨道，相机从斜侧标题特写一路后撤到全窗
-适用: 文档/报告/笔记类功能镜头；信息密度最高的一拍
-时长: 150f（约 5s，含 history-list-stack 尾段与标语 hold）
-能量: 低中（信息密度最高，节奏放稳让观众读字）
-标签: ui-entrance
----
-
-## 意图
-观众会读清屏幕上每个字——这一镜的说服力全在"文档是真的"。打字机式写入把静态页面变成"正在被写出来的文档"，侧栏历史条目落入补上"持续产出"的时间纵深。
-
-## 动效核心
-- 内容块两两一对按节拍写入：页面底色遮罩右锚左→右收窄，强调色 caret 骑在揭示前沿
-- 人名 @-mention 在 wipe 完成后长出强调色底色
-- 左右双栏靠底色补丁上→下收走入场，内缘强调色细线随揭示生长后淡去
-- 尾段（history-list-stack）：6 条历史条目从上方逐个落入侧栏轨道，每落一条配一声 pop
-- 相机从斜侧标题特写拉到全窗（双栏必须都入画），之后微俯上移让出底部给一行标语，只做极缓推近；页面是一扇悬浮在暗场里的应用窗口（圆角、亮边、背光、长投影），不铺满全屏
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 写入节拍 | 20 块两两一对，第 g 对 cue = 8 + g·4.4，每块 wipe 9f，最后一对 ~57f 完成（赶在 64f 全窗 settle 前） | 逐块写会超预算——"块数×节拍要先对预算"是这卡的核心算术，先算再写 |
-| 写入手法 | 底色遮罩 width 100%→0，bezier(0.4,0,0.6,1)，遮罩色取纹理纸面实测色、右侧多盖（标题 120px——块测量宽度短于粗体实际字宽，否则尾词漏出）；强调色 caret 3px（深一档的极光紫 + 同色柔光）只跟最新块、只骑在实际文字宽度内，写完 2f 淡出；首块开写前 8f 笔尖在标题起点闪烁待命 | caret 同时出现多个立刻穿帮；永远只有一个"笔尖" |
-| li 圆点 | 遮罩向左多盖 28px（::marker 在文本左 ~22px） | 不多盖圆点会提前穿帮——截图纹理里烤入的排版细节都要这样排查 |
-| @-mention | wipe 完成后 4f 起、8f 长出强调色底（极光紫 0.4）、`mix-blend-mode: multiply`（底色盖在纹理字上方，normal 混合会把人名洗浅）；跳过非人名标题 | 高亮晚于写入才读作"重点被标出"；同帧出现读作贴图 |
-| 双栏入场 | 左栏 cue 54 / 右栏 cue 62，底色补丁上→下 10f 收走 + 内缘 2px 强调色线随揭示生长、24f 淡去 | 双栏与正文错开节拍，同时入场会互相抢视线 |
-| 历史条目落入 | 6 条，cue = 66 + i·5（排在侧栏 wipe 完成 64f 后），每条 9f 落下；起点 −48px，bezier(0.2,1.15,0.3,1) 轻弹跳，空中影 `0 12·air px 24·air px` | 条目几何紧贴烤入纹理已有条目的下方、行高对齐——DOM 重绘条目必须和纹理里的活条目严格对齐 |
-| 舞台 | aurora 暗场：窗口背后一圈强调色背光（页面空间 translateZ −40，随窗口透视）、四周 0 0 0 1.5px 亮边 + 70px 长投影、顶沿一道高光；收尾标语 84px 两段（第二段强调色）左对齐窗口左缘 | 暖白纸面放进冷暗场里像一盏灯——舞台和窗口要同一套光向，背光别盖过纸面 |
-| 相机 | 自写 3D 窗口相机（布局级 CSS zoom，Q2），单调三次 Hermite 样条逐帧展开：f0 zoom 1.42 / rotY −18° / rotX 8°（窗口左上角与舞台光同时入画）→ f26 1.24 → f64 全窗 0.86 → f104 0.74 + rotX 9° + 上移 78px（底部让给标语）→ f150 0.746 | 开场太近（>1.6x）整屏只剩纸面，暗场与窗口边都看不见，读作原版平铺页面；全窗时双栏必须都入画（Q10） |
-
-## 声音
-写入段钉 keyboard.mp3 修剪到 ~50f（8→57f）盖住书写段（拟音与动作严格等长，S4）；历史条目 6 连 pop 每 5f 一发、音量 0.40→0.25 阶梯递减做距离衰减（S2）。
-
-## 已知坑
-- mock 内容必须出版级：产品原生排版、文字铺满、侧栏完整入镜（Q10）——"贴图+标语"级的敷衍文档会导致整镜头重做
-- 数据合规：mock 内容里绝不出现客户/成员真名（Q1）
-- 素材页面是活数据源（协作文档类）时，全量重采会刷掉已定稿纹理——用增量脚本只刷单页单键
-- 强调色示例（caret/@-mention/内缘线）在模板片中为琥珀色，适配新品牌时统一换成目标品牌强调色
-
-## 参考实现
-demos/ui-entrance/document-typewriter-reveal/DocumentTypewriterReveal.tsx（原 template/src/aifl/live/SceneWbr.tsx；打字音效见 template/src/aifl/Main.tsx SFX 表；模板片中此镜承载的是周报文档场景）
+---
+name: document-typewriter-reveal
+一句话: 悬浮在暗场里的整页真排版文档窗口在光标后自己"写"出来、侧栏跟进、历史条目逐个落入轨道，相机从斜侧标题特写一路后撤到全窗
+适用: 文档/报告/笔记类功能镜头；信息密度最高的一拍
+时长: 150f（约 5s，含 history-list-stack 尾段与标语 hold）
+能量: 低中（信息密度最高，节奏放稳让观众读字）
+标签: ui-entrance
+---
+
+## 意图
+观众会读清屏幕上每个字——这一镜的说服力全在"文档是真的"。打字机式写入把静态页面变成"正在被写出来的文档"，侧栏历史条目落入补上"持续产出"的时间纵深。
+
+## 动效核心
+- 内容块两两一对按节拍写入：页面底色遮罩右锚左→右收窄，强调色 caret 骑在揭示前沿
+- 人名 @-mention 在 wipe 完成后长出强调色底色
+- 左右双栏靠底色补丁上→下收走入场，内缘强调色细线随揭示生长后淡去
+- 尾段（history-list-stack）：6 条历史条目从上方逐个落入侧栏轨道，每落一条配一声 pop
+- 相机从斜侧标题特写拉到全窗（双栏必须都入画），之后微俯上移让出底部给一行标语，只做极缓推近；页面是一扇悬浮在暗场里的应用窗口（圆角、亮边、背光、长投影），不铺满全屏
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 写入节拍 | 20 块两两一对，第 g 对 cue = 8 + g·4.4，每块 wipe 9f，最后一对 ~57f 完成（赶在 64f 全窗 settle 前） | 逐块写会超预算——"块数×节拍要先对预算"是这卡的核心算术，先算再写 |
+| 写入手法 | 底色遮罩 width 100%→0，bezier(0.4,0,0.6,1)，遮罩色取纹理纸面实测色、右侧多盖（标题 120px——块测量宽度短于粗体实际字宽，否则尾词漏出）；强调色 caret 3px（深一档的极光紫 + 同色柔光）只跟最新块、只骑在实际文字宽度内，写完 2f 淡出；首块开写前 8f 笔尖在标题起点闪烁待命 | caret 同时出现多个立刻穿帮；永远只有一个"笔尖" |
+| li 圆点 | 遮罩向左多盖 28px（::marker 在文本左 ~22px） | 不多盖圆点会提前穿帮——截图纹理里烤入的排版细节都要这样排查 |
+| @-mention | wipe 完成后 4f 起、8f 长出强调色底（极光紫 0.4）、`mix-blend-mode: multiply`（底色盖在纹理字上方，normal 混合会把人名洗浅）；跳过非人名标题 | 高亮晚于写入才读作"重点被标出"；同帧出现读作贴图 |
+| 双栏入场 | 左栏 cue 54 / 右栏 cue 62，底色补丁上→下 10f 收走 + 内缘 2px 强调色线随揭示生长、24f 淡去 | 双栏与正文错开节拍，同时入场会互相抢视线 |
+| 历史条目落入 | 6 条，cue = 66 + i·5（排在侧栏 wipe 完成 64f 后），每条 9f 落下；起点 −48px，bezier(0.2,1.15,0.3,1) 轻弹跳，空中影 `0 12·air px 24·air px` | 条目几何紧贴烤入纹理已有条目的下方、行高对齐——DOM 重绘条目必须和纹理里的活条目严格对齐 |
+| 舞台 | aurora 暗场：窗口背后一圈强调色背光（页面空间 translateZ −40，随窗口透视）、四周 0 0 0 1.5px 亮边 + 70px 长投影、顶沿一道高光；收尾标语 84px 两段（第二段强调色）左对齐窗口左缘 | 暖白纸面放进冷暗场里像一盏灯——舞台和窗口要同一套光向，背光别盖过纸面 |
+| 相机 | 自写 3D 窗口相机（布局级 CSS zoom，Q2），单调三次 Hermite 样条逐帧展开：f0 zoom 1.42 / rotY −18° / rotX 8°（窗口左上角与舞台光同时入画）→ f26 1.24 → f64 全窗 0.86 → f104 0.74 + rotX 9° + 上移 78px（底部让给标语）→ f150 0.746 | 开场太近（>1.6x）整屏只剩纸面，暗场与窗口边都看不见，读作原版平铺页面；全窗时双栏必须都入画（Q10） |
+
+## 声音
+写入段钉 keyboard.mp3 修剪到 ~50f（8→57f）盖住书写段（拟音与动作严格等长，S4）；历史条目 6 连 pop 每 5f 一发、音量 0.40→0.25 阶梯递减做距离衰减（S2）。
+
+## 已知坑
+- mock 内容必须出版级：产品原生排版、文字铺满、侧栏完整入镜（Q10）——"贴图+标语"级的敷衍文档会导致整镜头重做
+- 数据合规：mock 内容里绝不出现客户/成员真名（Q1）
+- 素材页面是活数据源（协作文档类）时，全量重采会刷掉已定稿纹理——用增量脚本只刷单页单键
+- 强调色示例（caret/@-mention/内缘线）在模板片中为琥珀色，适配新品牌时统一换成目标品牌强调色
+
+## 参考实现
+demos/ui-entrance/document-typewriter-reveal/DocumentTypewriterReveal.tsx（原 template/src/aifl/live/SceneWbr.tsx；打字音效见 template/src/aifl/Main.tsx SFX 表；模板片中此镜承载的是周报文档场景）

package/lib/motion/shotcraft/upstream/references/shots/typography/flying-words.md

@@ -1,64 +1,64 @@
----
-name: flying-words
-一句话: 22 个关键词按黄金角铺在扁椭圆截面上，沿 z 轴从远处飞到相机前擦身而过，透明度走 [0,1,0.5,0.2,0] 生命曲线，跑满 2 整圈首尾无缝
-适用: 关键词云/能力清单的动态背景；片头片尾的"信息量"垫底层；需要纵深穿越感的转场
-时长: 约 6.0s（180f@30fps，2 个完整循环，可无缝接续）
-能量: 高（全屏持续 3D 位移，画面无一刻静止）
----
-
-## 意图
-关键词列举最土的做法是堆一屏静态词云。词语隧道把同一批词**摊到时间轴上**：
-远处生成、由小变大、擦过镜头消失，观众永远只在读三五个词，但主观感受是
-"词很多"。它是背景层不是主角层——相机不动、元素动，所以前景压一层标题
-或 UI 完全不打架。词表整体替换成项目关键词即可，不改一行运动逻辑。
-
-## 动效核心
-- 透视（480 设计坐标下）`perspective:1100px`，词沿 z 从 **-1750 → 800px** 线性推进——正值即穿过
-  相机平面，这才有"擦身"。demo 按 1920 原生作画，同一套数值整体 ×4：P=4400、z −7000 → +3200，
-  投影手算 `s = P/(P−z)`（与 CSS perspective 逐点等价）
-- 铺位用黄金角：`a = i·2.39996 + rand(i·7+1)·0.8`，半径 `r = 82 + rand·165`（原生 ×4：330 + rand·660），
-  y 半径再 ×0.6 压成扁椭圆——避开正中、避免近处几个词堆成一团
-- 生命曲线 `OP=[0,1,0.5,0.2,0]` @ `OT=[0,0.25,0.6,0.85,1]`：**前 1/4 猛亮到满，
-  中段降到半透，末段拖尾消失**——不是简单淡入淡出，中段压暗才不遮前景
-- 向外散开 `drift = 0.5 + u·1.35`：远处收拢在中心、越近越往画外甩，
-  和 z 轴推进叠成真透视感
-- 近端糊化：`u > 0.86` 时按 `(u-0.86)` 线性加失焦——词冲到眼前会大到失控，这一层模糊是遮丑；
-  真正的速度感交给按屏幕速度的方向拖尾（demo：沿 −v 方向 6 层渐虚 text-shadow 残影，比给每个词套
-  全屏 SVG 滤镜便宜得多）；远端前 22% 行程再加大气雾失焦
-- demo 另加两层同一条隧道运动的纵深参照：10 道扁椭圆发丝环（隧道壁，近处变粗淡出）+ 56 粒尘埃画成
-  沿径向拉长的光速流线（线长 = 近 2.6 帧的屏幕位移）；整条隧道 `±2.5°·sin(2πt)` 极缓滚转（周期函数，首尾一致）
-- 前景：demo 正中压一组静态字标（mono 眉题 + 112px 标题 + 径向暗幕），飞进字标椭圆区的词透明度压到 20%
-  ——演示"背景层 + 前景标题不打架"的用法；字标静止，循环仍无缝
-- `CYCLES = 2` 是整数圈，demo 取 `t = frame / DURATION`（末帧的下一帧 = 第 0 帧）可无缝 loop；每词相位
-  `ph = i/N` 均分、spawn 全确定性；中心电光蓝光晕 `opacity = 0.82 + sin(t·4π)·0.14` 呼吸 2 次，
-  钉住"隧道尽头"这个视觉锚
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 词表 | 22 词，字号 `20 + rand·16`px（20–36；原生 64–120），700 字重 + 6 个衬线斜体词 | 词数与相位 `i/N` 绑定：<12 词画面稀，>30 词近处糊成一片；字号随机是层次感来源，全同号读作贴图 |
-| 纵深行程 | z −1750 → +800px，perspective 1100（原生 ×4） | 起点更远（−2500+）词太小认不出；终点不过 0 就没有"穿过去"只有"飞到脸前停住" |
-| 散开系数 | `drift = 0.5 + u·1.35` | 系数 <1 词全从正中喷出像爆炸；>2 早早飞出画外，隧道变喷泉 |
-| 生命曲线 | `[0,1,0.5,0.2,0]` @ `[0,0.25,0.6,0.85,1]` | 中段那个 0.5 是给前景让位的；改成一路满亮就抢主角，改成早早归零隧道变空 |
-| 循环圈数 | `CYCLES = 2`（必须整数） | 非整数 → t=1 与 t=0 不接，loop 处一跳；圈数越多单词过镜越快 |
-| 近端模糊 | `u>0.86` 起线性失焦 + 速度向方向拖尾 | 阈值提到 0.95 巨大词硬边扎眼；系数 >40 末段成色斑 |
-| 配色 | demo（midnight）：冷白三阶 `#f2f5ff/#c3cbe2/#8a95b5` + 4 个电光蓝强调词 `#86a8ff`（只有强调词带泛光），中心光晕电光蓝 | 深底浅字发光是身份证，白底套本卡直接失效——要浅底得整套重配 |
-| 中心光晕 | ~1040×720 径向渐变、呼吸 2 次/片 | 删了隧道尽头没有焦点，词像随机乱飞；呼吸频率跟 CYCLES 对齐才不打拍 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 词表替换要**保持词数与字长量级**（demo 22 词、单词 4–9 字母）：相位是
-  `i/N` 均分的，词数一变密度整体缩放；中文词字宽是英文的两倍以上，
-  换中文关键词须同步下调字号否则近处直接占满画面
-- `CYCLES` 必须是整数，否则首尾不接——这是本卡"可无缝 loop"的唯一前提，
-  想调过镜速度就整数加减，别改小数
-- 只做背景层：中段生命曲线压到 0.5 就是为了给前景让位，把它当主角
-  （拉满亮度）反而读作杂乱
-- 深底专用：`text-shadow` 发光 + 径向暗角是效果的一半，浅底上词会糊成
-  脏点；22 个词元素全程挂在 DOM 里（不销毁重建）只改 transform/opacity，
-  移植 Remotion 时保持这个结构，别改成按帧增删节点
-
-## 参考实现
-demos/typography/flying-words/
-（FlyingWords.tsx）
+---
+name: flying-words
+一句话: 22 个关键词按黄金角铺在扁椭圆截面上，沿 z 轴从远处飞到相机前擦身而过，透明度走 [0,1,0.5,0.2,0] 生命曲线，跑满 2 整圈首尾无缝
+适用: 关键词云/能力清单的动态背景；片头片尾的"信息量"垫底层；需要纵深穿越感的转场
+时长: 约 6.0s（180f@30fps，2 个完整循环，可无缝接续）
+能量: 高（全屏持续 3D 位移，画面无一刻静止）
+---
+
+## 意图
+关键词列举最土的做法是堆一屏静态词云。词语隧道把同一批词**摊到时间轴上**：
+远处生成、由小变大、擦过镜头消失，观众永远只在读三五个词，但主观感受是
+"词很多"。它是背景层不是主角层——相机不动、元素动，所以前景压一层标题
+或 UI 完全不打架。词表整体替换成项目关键词即可，不改一行运动逻辑。
+
+## 动效核心
+- 透视（480 设计坐标下）`perspective:1100px`，词沿 z 从 **-1750 → 800px** 线性推进——正值即穿过
+  相机平面，这才有"擦身"。demo 按 1920 原生作画，同一套数值整体 ×4：P=4400、z −7000 → +3200，
+  投影手算 `s = P/(P−z)`（与 CSS perspective 逐点等价）
+- 铺位用黄金角：`a = i·2.39996 + rand(i·7+1)·0.8`，半径 `r = 82 + rand·165`（原生 ×4：330 + rand·660），
+  y 半径再 ×0.6 压成扁椭圆——避开正中、避免近处几个词堆成一团
+- 生命曲线 `OP=[0,1,0.5,0.2,0]` @ `OT=[0,0.25,0.6,0.85,1]`：**前 1/4 猛亮到满，
+  中段降到半透，末段拖尾消失**——不是简单淡入淡出，中段压暗才不遮前景
+- 向外散开 `drift = 0.5 + u·1.35`：远处收拢在中心、越近越往画外甩，
+  和 z 轴推进叠成真透视感
+- 近端糊化：`u > 0.86` 时按 `(u-0.86)` 线性加失焦——词冲到眼前会大到失控，这一层模糊是遮丑；
+  真正的速度感交给按屏幕速度的方向拖尾（demo：沿 −v 方向 6 层渐虚 text-shadow 残影，比给每个词套
+  全屏 SVG 滤镜便宜得多）；远端前 22% 行程再加大气雾失焦
+- demo 另加两层同一条隧道运动的纵深参照：10 道扁椭圆发丝环（隧道壁，近处变粗淡出）+ 56 粒尘埃画成
+  沿径向拉长的光速流线（线长 = 近 2.6 帧的屏幕位移）；整条隧道 `±2.5°·sin(2πt)` 极缓滚转（周期函数，首尾一致）
+- 前景：demo 正中压一组静态字标（mono 眉题 + 112px 标题 + 径向暗幕），飞进字标椭圆区的词透明度压到 20%
+  ——演示"背景层 + 前景标题不打架"的用法；字标静止，循环仍无缝
+- `CYCLES = 2` 是整数圈，demo 取 `t = frame / DURATION`（末帧的下一帧 = 第 0 帧）可无缝 loop；每词相位
+  `ph = i/N` 均分、spawn 全确定性；中心电光蓝光晕 `opacity = 0.82 + sin(t·4π)·0.14` 呼吸 2 次，
+  钉住"隧道尽头"这个视觉锚
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 词表 | 22 词，字号 `20 + rand·16`px（20–36；原生 64–120），700 字重 + 6 个衬线斜体词 | 词数与相位 `i/N` 绑定：<12 词画面稀，>30 词近处糊成一片；字号随机是层次感来源，全同号读作贴图 |
+| 纵深行程 | z −1750 → +800px，perspective 1100（原生 ×4） | 起点更远（−2500+）词太小认不出；终点不过 0 就没有"穿过去"只有"飞到脸前停住" |
+| 散开系数 | `drift = 0.5 + u·1.35` | 系数 <1 词全从正中喷出像爆炸；>2 早早飞出画外，隧道变喷泉 |
+| 生命曲线 | `[0,1,0.5,0.2,0]` @ `[0,0.25,0.6,0.85,1]` | 中段那个 0.5 是给前景让位的；改成一路满亮就抢主角，改成早早归零隧道变空 |
+| 循环圈数 | `CYCLES = 2`（必须整数） | 非整数 → t=1 与 t=0 不接，loop 处一跳；圈数越多单词过镜越快 |
+| 近端模糊 | `u>0.86` 起线性失焦 + 速度向方向拖尾 | 阈值提到 0.95 巨大词硬边扎眼；系数 >40 末段成色斑 |
+| 配色 | demo（midnight）：冷白三阶 `#f2f5ff/#c3cbe2/#8a95b5` + 4 个电光蓝强调词 `#86a8ff`（只有强调词带泛光），中心光晕电光蓝 | 深底浅字发光是身份证，白底套本卡直接失效——要浅底得整套重配 |
+| 中心光晕 | ~1040×720 径向渐变、呼吸 2 次/片 | 删了隧道尽头没有焦点，词像随机乱飞；呼吸频率跟 CYCLES 对齐才不打拍 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 词表替换要**保持词数与字长量级**（demo 22 词、单词 4–9 字母）：相位是
+  `i/N` 均分的，词数一变密度整体缩放；中文词字宽是英文的两倍以上，
+  换中文关键词须同步下调字号否则近处直接占满画面
+- `CYCLES` 必须是整数，否则首尾不接——这是本卡"可无缝 loop"的唯一前提，
+  想调过镜速度就整数加减，别改小数
+- 只做背景层：中段生命曲线压到 0.5 就是为了给前景让位，把它当主角
+  （拉满亮度）反而读作杂乱
+- 深底专用：`text-shadow` 发光 + 径向暗角是效果的一半，浅底上词会糊成
+  脏点；22 个词元素全程挂在 DOM 里（不销毁重建）只改 transform/opacity，
+  移植 Remotion 时保持这个结构，别改成按帧增删节点
+
+## 参考实现
+demos/typography/flying-words/
+（FlyingWords.tsx）