dsh-motion 0.3.0 → 0.4.1

package/skills/design-spec/SKILL.md

@@ -21,7 +21,13 @@ HyperFrames 的 look 文档原话：**不给外部输入，相同的 brief 每
 
 ## 先路由
 
-写 spec 之前先确定风格：`node scripts/route-style.mjs "<题材>"`。点名风格优先；没有点名就按 `styles/registry.json` 打分；`high` 才直接写，`medium`/`low` 先给用户 top 2–3 确认。
+写 spec 之前先过需求卡点：`node scripts/plan-questions.mjs "<brief>" --json`。它会推断画幅、交付、风格的候选项（选项来自 `styles/registry.json`，不是固定清单），能推断的不问。
+
+风格：点名优先；没有点名就按 `styles/registry.json` 打分；`high` 才直接写，`medium`/`low` 先给用户 top 2–3 确认。
+
+## 确认门
+
+`DESIGN.md` 和 3 张风格帧属于确认门的“视觉”阶段：先有确认过的脚本与分镜，再做视觉。按 `gateMode` 分档（`light` 合并脚本+分镜，`standard` 分开，`full` 加 animatic）。用户明确说“可以开始”之前，不要写完整场景、不要渲染成片。流程与账本见 [animation-router](../animation-router/SKILL.md) 的 §4。
 
 ## 最小形态
 

package/skills/qa-rubric/SKILL.md

@@ -5,6 +5,15 @@ description: 代码动画的自检清单：环境、公式、画面、音频、
 
 # 交付前自检
 
+## 0. 迭代预算
+
+- 首帧 ≤60 s；总时长 ≤400 s（30 s 片）；
+- 输出 tokens ≤30k，上下文 ≤100k；
+- 每次迭代 1 张 contact sheet，读图 ≤10 次；
+- 全文件重写 0 次；`motion_probe` 1 次、`motion_render` 2 次。
+
+详见 [performance-budget.md](../../docs/performance-budget.md)。
+
 ## 1. 环境
 
 先跑 `motion_doctor`，`ready.math` 与 `ready.delivery` 都为 true 再继续。
@@ -34,6 +43,8 @@ npx hyperframes check
 ```
 
 - 返回的 storyboard PNG 逐张看过：无叠字、无出画、字号可读；
+- sheet 每格顶部是 caption 条，不是画面；不要把 caption 当成"上沿被裁"；
+- 中文文本没有用字符级 `Transform` / `ReplacementTransform`；换词用 FadeOut + FadeIn；
 - `layoutProblems` 每一条都要处理或明确接受；
 - 已经生成了 mp4 时，才用 `motion_probe` 抽 contact sheet + 查 `blankFrames`；
 - 用了 HyperFrames 的项目，用 `npx hyperframes snapshot <project> --at 2.9,10.4` 抽帧，不要先 render 再截图。
@@ -53,3 +64,5 @@ npx hyperframes check
 ## 7. 交付
 
 mp4 + `.srt` + 场景源码 + `DESIGN.md` + 分镜表。
+
+开工前跑过 `node scripts/approvals.mjs check <project>`；确保 `APPROVALS.json` 里 `start` 是用户明确授权，而不是 agent 自己填的。

package/styles/3b1b/theme.py

@@ -13,6 +13,9 @@ import manimgx as m
 
 TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
 
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
 BG = TOKENS["colors"]["bg"]
 TEXT = TOKENS["colors"]["text"]
 LABEL = TOKENS["colors"]["label"]

package/styles/README.md

@@ -17,6 +17,8 @@
 - 每个风格目录：`style.json`（元数据）+ `STYLE.md`（不变量）+ `tokens.json` + `theme.py` + `preview.jpg`；
 - `STYLE.md` 是**改编**，必须在上游基础上写清楚差异；不复制 demo 代码；
 - 颜色、字体、时间表、音频以 `tokens.json` 为准；版面坐标与组件配方写在 `STYLE.md`；
+- 中文文本不做字符级 `ReplacementTransform` / `Transform`（会出字形碎片）；用 Fade/Write/Indicate，换词用 FadeOut+FadeIn；
+- `theme.py` 必须在**模块 import 时**设置 `m.config.frame_rate`（不能只在 `construct` 里），否则 `manimgx inspect` 会按默认 60fps 取帧，30fps 场景的后半段会报 no frame；
 - 路由：`styles/registry.json` 是元数据，`node scripts/route-style.mjs "<题材>"` 打分；点名优先，低置信度/并列先问用户；
 - 新片在自己的项目目录写 `DESIGN.md`，头部 `style: <slug>` + `style_version: 1.0.0`；
 - 参考与示例统一用 HyperFrames 的 [examples](https://hyperframes.heygen.com/examples) / [catalog](https://hyperframes.heygen.com/catalog)，不在仓库里放样片（`showcase/` 只放可复现的演示）。

package/styles/blueprint/theme.py

@@ -15,6 +15,9 @@ import manimgx as m
 
 TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
 
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
 TABLE = TOKENS["colors"]["table"]
 PAPER = TOKENS["colors"]["paper"]
 PAPER_LIGHT = TOKENS["colors"]["paper_light"]

package/styles/dataviz/style.json

@@ -29,6 +29,7 @@
     "趋势",
     "比较",
     "分布",
+    "导数",
     "斜率",
     "切线",
     "割线",

package/styles/dataviz/theme.py

@@ -13,6 +13,9 @@ import manimgx as m
 
 TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
 
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
 PAPER = TOKENS["colors"]["paper"]
 PAPER_SHADOW = TOKENS["colors"]["paper_shadow"]
 INK = TOKENS["colors"]["ink"]

package/styles/registry.json

@@ -67,6 +67,7 @@
         "趋势",
         "比较",
         "分布",
+        "导数",
         "斜率",
         "切线",
         "割线",

package/styles/swiss-motion/theme.py

@@ -13,6 +13,9 @@ import manimgx as m
 
 TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
 
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
 GROUND = TOKENS["colors"]["ground"]
 PAPER = TOKENS["colors"]["paper"]
 INK = TOKENS["colors"]["ink"]

package/styles/whiteboard/theme.py

@@ -15,6 +15,9 @@ import manimgx as m
 
 TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
 
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
 BOARD = TOKENS["colors"]["board"]
 BOARD_EDGE = TOKENS["colors"]["board_edge"]
 INK = TOKENS["colors"]["ink"]