dsh-motion 0.2.0 → 0.4.0

package/skills/animation-router/references/confirmation.md

@@ -0,0 +1,82 @@
+# 确认门清单
+
+在写完整场景、出全片之前，逐项确认。每一轮只推进一项；用户改了哪项，就回到哪项重确认。
+
+## 0. 选模式
+
+| 模式 | 适用 | 阶段 |
+|---|---|---|
+| `light` | ≤15 s、无旁白、一个结论 | 需求 → 脚本+分镜 → 视觉 → 开工 |
+| `standard` | 15–60 s，或有旁白 | 需求 → 脚本 → 分镜 → 视觉 → 交付 → 开工 |
+| `full` | >60 s、多段、复杂旁白 | 需求 → 脚本 → 分镜 → animatic → 视觉 → 交付 → 开工 |
+
+`light` 把“脚本”和“分镜”合成一张表：每个镜头一行，写秒数、画面、上屏文字/公式。
+
+## 1. 需求
+
+- [ ] 画幅与像素：16:9 / 9:16 / 1:1
+- [ ] 时长
+- [ ] 交付：先出帧 / 静音 mp4 / 旁白 + 字幕（HF）
+- [ ] 风格（或“你决定”）
+- [ ] 受众（数学/科学题材）
+- [ ] 旁白语言与声音（仅旁白交付）
+
+## 2. 脚本 / 文案
+
+| # | 旁白（逐句） | 上屏文字 | 公式 | 备注 |
+|---|---|---|---|---|
+| 1 |  |  |  |  |
+
+- 公式先过 `formula_check`；
+- 旁白按“一句一个意思”拆，标出预计秒数；
+- 没有旁白就只填上屏文字与公式。
+
+## 3. 分镜
+
+| # | 起止秒 | 画面 | 运动 | 字幕 / 旁白 | 验收点 |
+|---|---|---|---|---|---|
+| 1 | 0.0–2.0 |  |  |  |  |
+
+- 镜头数按内容定，不为了凑时长加镜头；
+- 每个镜头写清“观众看到什么变化”；
+- 结论镜头要留够阅读时间（≥1.2 s）。
+
+## 4. 视觉
+
+- [ ] `DESIGN.md`：颜色、字体、禁用项、参考
+- [ ] 3 张风格帧：开场 / 转折 / 结论（真实代码出帧，不渲染视频）
+- [ ] 风格帧通过 `motion_frames` 的 layout 检查
+
+## 5. 交付清单
+
+- [ ] 尺寸 / fps / 时长
+- [ ] 文件：mp4 / `.srt` / 场景源码 / DESIGN.md / 分镜表
+- [ ] 音频：无 / 旁白 / 音乐；响度目标
+- [ ] 字幕：烧录 / 外挂 / 两者
+
+## 6. 账本
+
+```bash
+node scripts/approvals.mjs init <project> --mode light
+node scripts/approvals.mjs set <project> <stage> approved --note "用户确认"
+node scripts/approvals.mjs check <project>
+```
+
+`check` 未全部 approved 时退出 1；不能跳过前置阶段；`start` 必须是用户明确授权。
+
+## 7. 开工指令
+
+只有用户**明确**说出下面这类话，才进入执行：
+
+- “可以开始”
+- “开始做”
+- “按这个执行”
+- “开工”
+
+以下**不算**整体开工：
+
+- 对某个选项说“好 / 可以 / 行”；
+- 确认了脚本或分镜；
+- 说“看着办”但没有明确授权执行。
+
+不确定时问一句：“脚本、分镜、风格帧都确认了，现在开始执行吗？”

package/skills/design-spec/SKILL.md

@@ -19,6 +19,16 @@ HyperFrames 的 look 文档原话：**不给外部输入，相同的 brief 每
 | 4 | 主题自身的世界 | ✅ 年代、材质、展示场景 |
 | 5 | 官方预设（preset） | ⚠️ 幻灯片语言，仅点名或做 deck 时用 |
 
+## 先路由
+
+写 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。
+
 ## 最小形态
 
 ```markdown
@@ -60,7 +70,7 @@ DESIGN.md 写完不等于风格成立。挑 3 个关键时刻（开场、转折
 - 三张里至少一张是 signature shot；
 - 两轮还不对，就换更接近的参考语法，而不是继续调参。
 
-## 六种已验证的语言
+## 八种已验证的语言
 
 | 语言 | 适合 | 关键手段 |
 |---|---|---|
@@ -70,15 +80,19 @@ DESIGN.md 写完不等于风格成立。挑 3 个关键时刻（开场、转折
 | 瑞士动态排版 | 公式 / 概念 | 12 栏网格、单一信号色、精确缓动 |
 | 数据叙事 | 数据 / 科学 | 图表操作即转场、注释钉在数据上、蓝红语义 |
 | 蓝图工程制图 | 几何 / 工程 | 青晒纸、白线、制图顺序、一次红印章 |
+| 白板讲解 | 科学 / 课程 | 暖白板、三色马克笔、书写顺序 |
+| 3b1b 暗场数学 | 线代 / 微积分 | 近黑底、蓝黄语义、先直觉后公式 |
 
-本仓库现有三套，全部改编自 [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar)（MIT）：
+本仓库现有五套，除 `3b1b` 外均改编自 [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar)（MIT）：
 
 - [`styles/swiss-motion/`](../../styles/swiss-motion/)：公式/排版，默认；
 - [`styles/dataviz/`](../../styles/dataviz/)：图表/数据；
-- [`styles/blueprint/`](../../styles/blueprint/)：几何/工程。
+- [`styles/blueprint/`](../../styles/blueprint/)：几何/工程；
+- [`styles/whiteboard/`](../../styles/whiteboard/)：科学/白板讲解；
+- [`styles/3b1b/`](../../styles/3b1b/)：暗场数学（Manim 社区 3b1b skill）。
 
 规范在 `STYLE.md`，数值在 `tokens.json`，`theme.py` 提供 `apply_config()` 与 `backdrop()`。
-项目 `DESIGN.md` 里写 `style: swiss-motion`（或 `dataviz` / `blueprint`）与 `style_version: 1.0.0`。
+项目 `DESIGN.md` 里写 `style: swiss-motion`（或 `dataviz` / `blueprint` / `whiteboard` / `3b1b`）与 `style_version: 1.0.0`。
 
 参考与示例统一从 HyperFrames 取：[examples](https://hyperframes.heygen.com/examples)、
 [catalog](https://hyperframes.heygen.com/catalog)、[frame.md](https://hyperframes.heygen.com/prompting/design-systems)。

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/STYLE.md

@@ -0,0 +1,68 @@
+---
+name: 3b1b
+version: 1.0.0
+source: https://github.com/subinium/3b1b-style-animation-skill
+license: MIT（上游风格 skill）；非 3Blue1Brown 官方项目
+status: adapted
+---
+
+# 3Blue1Brown Style · 3b1b
+
+> 配色表取自 [subinium/3b1b-style-animation-skill](https://github.com/subinium/3b1b-style-animation-skill)（MIT）；
+> 教学法与动画模式参考 [adithya-s-k/manim_skill](https://github.com/adithya-s-k/manim_skill)（MIT，约 1.2k stars，是这类 skill 里用得最多的）。
+> 本文件是改编，不是原样复制；只保留不变量，实现换成 manimgx。
+
+## 1. 定位
+
+先建立直觉，再给公式。画面为“暗场 + 蓝黄高亮”的数学解释：
+
+- 适合：线性代数、微积分、概率、神经网络、算法；
+- 不适合：没有“为什么”的产品宣传、角色叙事。
+
+## 2. 不变量
+
+| 项 | 规则 |
+|---|---|
+| 底色 | `#1c1c1c`（近黑灰，**不用纯黑**） |
+| 主色 | 蓝 `#3b82f6`：主对象、向量、节点 |
+| 强调 | 黄 `#fbbf24`：高亮、结论、公式 |
+| 语义色 | 绿 `#22c55e` 正 / 红 `#ef4444` 负 / 灰 `#9ca3af` 非活动 |
+| 公式 | 黄色 `#fde047` 或白色；一屏最多 4–5 种颜色 |
+| 字体 | 无衬线（Noto Sans）；公式 New Computer Modern |
+| 运动 | `Create` / `FadeIn` / `Transform`；相关元素**同时**出现（`LaggedStartMap` 式级联），不要一个个 `play()` |
+| 收尾 | 结尾至少 `wait(2)`，给结论停留 |
+
+## 3. 教学法
+
+1. **Hook**：先问一个有意思的问题；
+2. **Intuition**：用图形建立直觉，先不写公式；
+3. **Concrete**：用一个具体数字走一遍；
+4. **Formalization**：最后才给公式/命名。
+
+## 4. manimgx 映射
+
+- `theme.py`：`apply_config()` 设 `#1c1c1c`、`backdrop()` 返回平涂底；
+- 用 `Axes`、`Dot`、`Arrow`、`Line`、`always_redraw` 做旋转/投影/变换；
+- 用 `MathTex` 排版公式，`Text` 做标题与注释；
+- manimgx 的 `Write` 已经足够接近 Manim 的 `Write`；不需要 LaTeX 环境。
+
+## 5. Do / Don't
+
+**Do**
+
+- 先画“正在发生什么”，再写“它叫什么”；
+- 蓝=对象，黄=高亮/结论；颜色有语义；
+- 一次只讲一个变换；结尾停 2 秒。
+
+**Don't**
+
+- 不用纯黑 `#000000`；
+- 不用高饱和纯红/纯绿/纯蓝；
+- 不在建立直觉前抛公式；
+- 不把每个元素拆成单独的 `play()`。
+
+## 6. 与上游的差异
+
+- 上游是 ManimCE/ManimGL skill，包含 40+ 条规则；这里只抽取配色、运动与教学法；
+- 上游使用 Manim 的 `LaggedStartMap` 等 API；manimgx 用 `AnimationGroup`/`LaggedStart` 近似；
+- 不是 3Blue1Brown 官方风格指南，只是社区通行做法的整理。

package/styles/3b1b/style.json

@@ -0,0 +1,50 @@
+{
+  "slug": "3b1b",
+  "en": "3Blue1Brown Style",
+  "cn": "3b1b 数学动画",
+  "category_en": "Math explainer",
+  "category_cn": "数学讲解",
+  "uses": [
+    "Linear algebra",
+    "Calculus",
+    "Probability",
+    "Neural networks"
+  ],
+  "source": "https://github.com/subinium/3b1b-style-animation-skill",
+  "secondary_source": "https://github.com/adithya-s-k/manim_skill",
+  "license": "MIT (style skills); unofficial tribute",
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "05",
+  "film": "Rotation on the Unit Circle",
+  "line": "A rotation on the unit circle that lands on e^{iθ} = cosθ + i sinθ.",
+  "line_cn": "单位圆上的一次旋转，收束到 e^{iθ} = cosθ + i sinθ。",
+  "uses_cn": [
+    "线代",
+    "微积分",
+    "概率",
+    "神经网络"
+  ],
+  "keywords": [
+    "向量",
+    "矩阵",
+    "特征值",
+    "旋转",
+    "复数",
+    "单位圆",
+    "线代",
+    "概率",
+    "微积分",
+    "神经网络"
+  ],
+  "avoid": [
+    "产品发布",
+    "纯排版"
+  ],
+  "demo": "showcase/3b1b-unit-circle",
+  "demo_duration_sec": 10.3,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "medium"
+}

package/styles/3b1b/theme.py

@@ -0,0 +1,46 @@
+"""3b1b 1.0.0 — 3Blue1Brown 风格（Manim 社区通行做法）的 manimgx 实现层。
+
+来源与许可：subinium/3b1b-style-animation-skill（MIT），配色表取自其 color-scheme.md；
+方法论参考 adithya-s-k/manim_skill（MIT，1.2k stars）。不是 3Blue1Brown 官方项目。
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+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"]
+BLUE = TOKENS["colors"]["blue"]
+YELLOW = TOKENS["colors"]["yellow"]
+TEAL = TOKENS["colors"]["teal"]
+GREEN = TOKENS["colors"]["green"]
+RED = TOKENS["colors"]["red"]
+GRAY = TOKENS["colors"]["gray"]
+MATH = TOKENS["colors"]["math"]
+AXIS = TOKENS["colors"]["axis"]
+LAYOUT = TOKENS["layout"]
+
+
+def apply_config(width: int = 1920, height: int = 1080, fps: int = 30) -> None:
+    m.config.pixel_width = width
+    m.config.pixel_height = height
+    m.config.frame_rate = fps
+    m.config.background_color = BG
+
+
+def backdrop() -> m.Rectangle:
+    """近黑灰底；3b1b 规定不用纯黑。"""
+    return (
+        m.Rectangle(width=LAYOUT["frame"]["width"], height=LAYOUT["frame"]["height"], color=BG)
+        .set_fill(BG, 1)
+        .set_stroke(width=0)
+    )

package/styles/3b1b/tokens.json

@@ -0,0 +1,32 @@
+{
+  "name": "3b1b",
+  "version": "1.0.0",
+  "source": "https://github.com/subinium/3b1b-style-animation-skill",
+  "license": "MIT (style skill); unofficial tribute to 3Blue1Brown",
+  "colors": {
+    "bg": "#1c1c1c",
+    "text": "#FFFFFF",
+    "label": "#E5E5E5",
+    "blue": "#3b82f6",
+    "yellow": "#fbbf24",
+    "teal": "#14b8a6",
+    "green": "#22c55e",
+    "red": "#ef4444",
+    "gray": "#9ca3af",
+    "math": "#fde047",
+    "axis": "#5A5A5A"
+  },
+  "typography": {
+    "display": { "family": "Noto Sans", "weight": "BOLD", "size": 46 },
+    "body": { "family": "Noto Sans", "size": 28 },
+    "mono": { "family": "Menlo", "size": 18 },
+    "math": { "family": "New Computer Modern", "size": 64 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.5
+  },
+  "motion": { "fps": 30, "easing": "smooth", "hold_min_seconds": 2.0 },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}

package/styles/README.md

@@ -1,23 +1,30 @@
 # 风格库
 
-可复用的视觉语言。当前有 3 套，全部**改编自 Lemo-Opuscar** 的公开风格（MIT），不是自创：
+可复用的视觉语言。当前有 5 套：4 套改编自 [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar)（MIT），1 套来自 Manim 社区的 3b1b skill。都不是自创。`style.json` 是唯一事实来源；下面的表和 `registry.json` 由 `node scripts/build-style-index.mjs` 生成，不手改：
 
+<!-- styles:start -->
 | 风格 | 适合 | 来源 | 入口 |
 |---|---|---|---|
-| `swiss-motion` / 瑞士动态排版（默认） | 公式、定义、数据结论 | [Lemo](https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion) | [STYLE](swiss-motion/STYLE.md) · [tokens](swiss-motion/tokens.json) · [theme](swiss-motion/theme.py) |
-| `dataviz` / 数据叙事 | 趋势、比较、分布、科学数据 | [Lemo](https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz) | [STYLE](dataviz/STYLE.md) · [tokens](dataviz/tokens.json) · [theme](dataviz/theme.py) |
-| `blueprint` / 蓝图工程制图 | 几何证明、结构、尺寸关系 | [Lemo](https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint) | [STYLE](blueprint/STYLE.md) · [tokens](blueprint/tokens.json) · [theme](blueprint/theme.py) |
+| `swiss-motion` / 瑞士动态排版（默认） | 公式、定义、数据结论、排版 | Lemo-Opuscar | [STYLE](swiss-motion/STYLE.md) · [tokens](swiss-motion/tokens.json) · [theme](swiss-motion/theme.py) |
+| `dataviz` / 数据叙事 | 趋势、比较、分布、科学数据 | Lemo-Opuscar | [STYLE](dataviz/STYLE.md) · [tokens](dataviz/tokens.json) · [theme](dataviz/theme.py) |
+| `blueprint` / 蓝图工程制图 | 几何证明、结构、尺寸关系 | Lemo-Opuscar | [STYLE](blueprint/STYLE.md) · [tokens](blueprint/tokens.json) · [theme](blueprint/theme.py) |
+| `whiteboard` / 白板讲解 | 科学解释、课程、机制说明 | Lemo-Opuscar | [STYLE](whiteboard/STYLE.md) · [tokens](whiteboard/tokens.json) · [theme](whiteboard/theme.py) |
+| `3b1b` / 3b1b 数学动画 | 线代、微积分、概率、神经网络 | subinium + manim_skill | [STYLE](3b1b/STYLE.md) · [tokens](3b1b/tokens.json) · [theme](3b1b/theme.py) |
+<!-- styles:end -->
 
 ## 约定
 
 - 每个风格目录：`style.json`（元数据）+ `STYLE.md`（不变量）+ `tokens.json` + `theme.py` + `preview.jpg`；
 - `STYLE.md` 是**改编**，必须在上游基础上写清楚差异；不复制 demo 代码；
 - 颜色、字体、时间表、音频以 `tokens.json` 为准；版面坐标与组件配方写在 `STYLE.md`；
-- 新片在自己的项目目录写 `DESIGN.md`，头部 `style: swiss-motion` + `style_version: 1.0.0`；
+- 中文文本不做字符级 `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/` 只放可复现的演示）。
 
 ## 许可
 
-- 上游风格文档：MIT，署名 LemoLab；
+- 上游风格文档：Lemo-Opuscar / subinium / adithya-s-k 均为 MIT，分别署名；
 - 上游 demo 静帧：CC BY 4.0，商用需署名；
 - 本仓库的 `theme.py` / `tokens.json` / 场景代码：MIT。

package/styles/blueprint/style.json

@@ -1,11 +1,47 @@
 {
   "slug": "blueprint",
   "en": "Blueprint",
-  "cn": "蓝图 / 工程制图",
+  "cn": "蓝图工程制图",
   "category_en": "Graphic & Type",
   "category_cn": "图形与排版",
-  "uses": ["Engineering", "Hardware launches", "Tech explainers"],
+  "uses": [
+    "Geometry proof",
+    "Structures",
+    "Dimensions"
+  ],
   "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint",
   "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
-  "implementation": "manimgx (theme.py + tokens.json)"
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "03",
+  "film": "Pythagorean Triple",
+  "line": "A 3-4-5 triangle drawn in drafting order, stamped Q.E.D.",
+  "line_cn": "按制图顺序画出的 3-4-5 三角形，最后盖上 Q.E.D.",
+  "uses_cn": [
+    "几何证明",
+    "结构",
+    "尺寸关系"
+  ],
+  "keywords": [
+    "几何",
+    "证明",
+    "三角形",
+    "圆",
+    "角度",
+    "尺寸",
+    "工程",
+    "结构",
+    "作图",
+    "勾股"
+  ],
+  "avoid": [
+    "图表",
+    "手绘"
+  ],
+  "demo": "showcase/blueprint-pythagoras",
+  "demo_duration_sec": 6.9,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "medium"
 }

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

@@ -4,8 +4,48 @@
   "cn": "数据叙事",
   "category_en": "Information & Keynote",
   "category_cn": "信息与发布",
-  "uses": ["Data journalism", "Reports", "Climate & science"],
+  "uses": [
+    "Trends",
+    "Comparison",
+    "Distribution",
+    "Scientific data"
+  ],
   "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz",
   "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
-  "implementation": "manimgx (theme.py + tokens.json)"
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "02",
+  "film": "Secant to Tangent",
+  "line": "A secant slides into a tangent; the slope reading falls from 2.50 to 2.00.",
+  "line_cn": "割线滑成切线，斜率读数从 2.50 落到 2.00。",
+  "uses_cn": [
+    "趋势",
+    "比较",
+    "分布",
+    "科学数据"
+  ],
+  "keywords": [
+    "数据",
+    "图表",
+    "趋势",
+    "比较",
+    "分布",
+    "导数",
+    "斜率",
+    "切线",
+    "割线",
+    "函数",
+    "变化率",
+    "统计"
+  ],
+  "avoid": [
+    "纯文字排版",
+    "角色叙事"
+  ],
+  "demo": "showcase/dataviz-secant",
+  "demo_duration_sec": 10.1,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "low"
 }

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"]