dsh-motion 0.2.0 → 0.3.0

package/NOTICE.md

@@ -8,7 +8,9 @@
 | [Manim Community](https://github.com/ManimCommunity/manim) | MIT | 可选渲染后端 |
 | [manimgx](https://github.com/academa-labs/manimgx) | MIT | 默认渲染后端 |
 | [SymPy](https://github.com/sympy/sympy) | BSD-3-Clause | `formula_check` |
-| [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar) | MIT（风格文档/代码）· CC BY 4.0（demo 静帧） | `swiss-motion` / `dataviz` / `blueprint` 三个风格的改编来源；只取语法与规范，不打包 demo 代码 |
+| [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar) | MIT（风格文档/代码）· CC BY 4.0（demo 静帧） | `swiss-motion` / `dataviz` / `blueprint` / `whiteboard` 的改编来源；只取语法与规范，不打包 demo 代码 |
+| [subinium/3b1b-style-animation-skill](https://github.com/subinium/3b1b-style-animation-skill) | MIT | `3b1b` 的配色与教学法来源；非 3Blue1Brown 官方项目 |
+| [adithya-s-k/manim_skill](https://github.com/adithya-s-k/manim_skill) | MIT | `3b1b` 的方法论参考（Manim 社区常用 skill） |
 | [FFmpeg](https://ffmpeg.org) | LGPL/GPL（取决于构建） | 渲染、后期、抽帧；**不打包**，由用户自行安装 |
 
 字体不随包分发；若你的 `DESIGN.md` 指定了第三方字体，请确认其许可（OFL / 商用授权）。

package/README.md

@@ -34,25 +34,31 @@
 
 ## 风格库
 
-默认 **瑞士动态排版（swiss-motion）**；另外两套按题材选。全部改编自 [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar)（MIT），不是自创。
+默认 **瑞士动态排版（swiss-motion）**；另外四套按题材选。四套改编自 [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar)，`3b1b` 来自 Manim 社区，均非自创。
 
 | 风格 | 适合 | 规范 |
 |---|---|---|
 | `swiss-motion`（默认） | 公式、定义、数据结论 | [STYLE](styles/swiss-motion/STYLE.md) · [tokens](styles/swiss-motion/tokens.json) |
 | `dataviz` | 趋势、比较、分布、科学数据 | [STYLE](styles/dataviz/STYLE.md) · [tokens](styles/dataviz/tokens.json) |
 | `blueprint` | 几何证明、结构、尺寸关系 | [STYLE](styles/blueprint/STYLE.md) · [tokens](styles/blueprint/tokens.json) |
+| `whiteboard` | 科学解释、课程、机制说明 | [STYLE](styles/whiteboard/STYLE.md) · [tokens](styles/whiteboard/tokens.json) |
+| `3b1b` | 线代、微积分、概率、神经网络 | [STYLE](styles/3b1b/STYLE.md) · [tokens](styles/3b1b/tokens.json) |
 
 **参考与示例统一用 HyperFrames 的库**：[examples](https://hyperframes.heygen.com/examples)、[catalog](https://hyperframes.heygen.com/catalog)、[frame.md](https://hyperframes.heygen.com/prompting/design-systems)。本仓库不再内置样片/分集；`showcase/` 只放可复现的演示。
 
-项目 `DESIGN.md` 头部写 `style: swiss-motion` + `style_version: 1.0.0`。风格来源、HF 集成、抽帧能力与 Lemo 调研见 [docs/ai-native-motion.md](docs/ai-native-motion.md)。
+路由是显式的：`node scripts/route-style.mjs "<题材>"`（点名优先 → registry 打分 → 默认 `swiss-motion`；分数并列/为 0 时要求确认）。规则在 [styles/registry.json](styles/registry.json)。
+
+项目 `DESIGN.md` 头部写 `style: <slug>` + `style_version: 1.0.0`。风格来源、HF 集成、抽帧能力与 Lemo 调研见 [docs/ai-native-motion.md](docs/ai-native-motion.md)。
 
 ## 演示
 
-三个类别各一支 10 秒内短片，记录出帧/渲染耗时：
+五个类别各一支 10 秒内短片，记录出帧/渲染耗时：
 
 - 公式：[showcase/swiss-euler](showcase/swiss-euler)
 - 数据：[showcase/dataviz-secant](showcase/dataviz-secant)
 - 几何：[showcase/blueprint-pythagoras](showcase/blueprint-pythagoras)
+- 白板：[showcase/whiteboard-derivative](showcase/whiteboard-derivative)
+- 暗场数学：[showcase/3b1b-unit-circle](showcase/3b1b-unit-circle)
 
 汇总见 [showcase/README.md](showcase/README.md)。
 
@@ -186,8 +192,8 @@ npx hyperframes render -o out.mp4
 日常改代码**不需要重装**：link 安装一次后，改 `lib/ops.js` / `lib/doctor.js` 会在下一次工具调用时按 mtime 热加载；只有改工具名/参数 schema 才需要 `⌘⇧R`。风格、`tokens.json`、场景文件本来就是运行时读取，不用重启。详见 [docs/dev-loop.md](docs/dev-loop.md)，也可以完全绕开 Harness：
 
 ```bash
-node scripts/dev.mjs frames showcase/swiss-euler/scene.py 1,3,end
-node scripts/dev.mjs render showcase/swiss-euler/scene.py --fps 30
+node scripts/dev.mjs frames showcase/swiss-euler/scene.py 1,3,end   # → out/swiss-euler-frames.png
+node scripts/dev.mjs render showcase/swiss-euler/scene.py --fps 30   # → out/swiss-euler.mp4
 ```
 
 ## 发版（维护者）

package/docs/ai-native-motion.md

@@ -53,7 +53,19 @@ HF 的卖点是 "same input, same frames, same output"：HTML + 可 seek 的动
 - 可借鉴的三件事：`STYLE.md` 作为 style prompt、三张风格帧验收、分镜只在被要求时做；
 - 授权上，demo 静帧可商用但需署名 LemoLab；风格文件本身是 MIT。
 
-本仓库的选择：删除自创的 `dark-editorial`，改为 3 套改编自 Lemo 的风格（`swiss-motion` / `dataviz` / `blueprint`），每套按 `STYLE.md` + `tokens.json` + `theme.py` + `preview.jpg` 落地；外部参考统一指向 HF。
+本仓库的选择：删除自创的 `dark-editorial`，改为 4 套 Lemo 风格（`swiss-motion` / `dataviz` / `blueprint` / `whiteboard`）+ 1 套 Manim 社区的 `3b1b`，每套按 `STYLE.md` + `tokens.json` + `theme.py` + `preview.jpg` 落地；外部参考统一指向 HF。
+
+### 3b1b 风格：社区里谁在用
+
+3Blue1Brown 本人用的是 ManimGL，官方没有发布“风格规范”。社区里把它固化成 agent skill 的主要有三家：
+
+| 项目 | 规模 | 提供什么 |
+|---|---|---|
+| [adithya-s-k/manim_skill](https://github.com/adithya-s-k/manim_skill) | 约 1.2k stars | ManimCE / ManimGL 两套 best-practice skill，含大量可运行示例；是这类 skill 里用得最多的 |
+| [Yusuke710/manim-skill](https://github.com/Yusuke710/manim-skill) | 约 180 stars | 面向 agent 的 Manim 动画 skill |
+| [subinium/3b1b-style-animation-skill](https://github.com/subinium/3b1b-style-animation-skill) | 约 7 stars | 唯一把 3b1b 配色写成明确 token 的 skill（`#1c1c1c` / 蓝 `#3b82f6` / 黄 `#fbbf24`） |
+
+本仓库的 `3b1b` 取 subinium 的配色 + adithya 的方法论，按 manimgx 重写；不是 3Blue1Brown 官方项目。
 
 ## 3. 和 HyperFrames 怎么结合
 
@@ -177,6 +189,62 @@ DESIGN.md
 
 细节见 [dev-loop.md](dev-loop.md)。
 
+## 4.7 风格路由：目前怎么做，通用标准是什么
+
+### 本仓库
+
+没有隐藏的自动路由。风格在**写作阶段**确定，分三层：
+
+1. `styles/registry.json`：机器可读的风格目录（slug、中文名、uses、keywords、avoid、画幅、复杂度）；
+2. `node scripts/route-style.mjs "<题材>"`：显式打分——点名风格 12 分，`keywords` 命中每个 3 分，`uses` 每个 2 分，命中 `avoid` 扣 2 分；
+3. `DESIGN.md` 头部 `style:` + `style_version:`：最终声明；场景代码从 `styles/<slug>/theme.py` 取 token。
+
+判定规则：
+
+- 点名（"用 3b1b"/"瑞士动态排版"）→ 直接命中，最高优先；
+- 否则打分；`high` 直接写，`medium`/`low`/并列 → 给 top 2–3 让用户确认；
+- 完全无命中 → 回退 `default`（`swiss-motion`），并说明是默认。
+
+这样路由是**可复现的**：同样的题材和 registry 得到同样的推荐，不靠模型"感觉像"。
+
+### 通用做法（没有 ISO 标准，但有事实标准）
+
+| 做法 | 代表 | 要点 |
+|---|---|---|
+| 风格索引 + 元数据 | Lemo `styles/README.md` + `style.json`；HF catalog | 每个风格有稳定 slug、中英文名、分类、`uses`；索引由元数据生成，不手写 |
+| 规范文件做声明 | HF `frame.md`；本仓库 `DESIGN.md` | frontmatter 定 hex/字体，正文定 Do/Don't；agent 先读再画 |
+| 点名优先 + 推荐 2–3 个 | Lemo `AGENTS.md` | 用户没选时给最接近的 2–3 个，不静默换风格 |
+| 打分 / 检索路由 | registry 关键词；HF `catalog --query` 语义检索 | 关键词/描述匹配，输出带理由与置信度 |
+| 人类确认门 | 本仓库 `needsConfirmation` | 低置信度、并列、冲突时不自动拍板 |
+| 版本与许可 | `style_version`、MIT/CC BY 标注 | 风格可升级、可追溯，不把 demo 当规范 |
+
+没有"W3C 风格路由标准"这种东西；能算标准的是 **design tokens**（颜色/字体/间距的可交换格式）和 **DESIGN.md / frame.md** 这类声明文件。路由本身是产品约定，关键不是算法多复杂，而是**规则显式、结果可复现、低置信度会问人**。
+
+### 对齐事实标准：对齐什么，不对齐什么
+
+**对齐（接口层）**
+
+- `style.json` 采用 Lemo 的字段：`slug` / `num` / `en` / `cn` / `category_en` / `category_cn` / `uses` / `line` / `demo`，再扩展 `keywords` / `avoid` / `aspect` / `fps` / `complexity`；
+- `styles/README.md` 的表和 `styles/registry.json` 从 `style.json` 生成，不再手写（对应 Lemo 的 `styleboard/build.py`）；
+- 选风格语义采用 Lemo `AGENTS.md` 的“点名优先 + 推荐 2–3 个 + 不静默换风格”，并加置信度门；
+- 保留 `style_version` / `source` / `license`，保证可升级、可追溯。
+
+**不对齐（实现层）**
+
+- 不复制 Lemo 的 Canvas/WebGL demo 代码，也不改 manimgx 渲染链；
+- 不采用 Lemo 的 24 fps、相机旅行、手写笔刷等实现细节，只取语法；
+- 不把 `tokens.json` 强改成 W3C DTCG：目前没有外部 token 消费方，改了只会增加转换成本；将来要接 Figma/HF design tokens 时再加适配层；
+- 不照搬 59 套风格，只接与数学/数据/科学相关的几套。
+
+这样既能在元数据、索引、选择语义上和生态互操作，又不会把实现绑死在别人的 demo 上。
+
+### 目前的局限
+
+- 打分是关键词匹配，不理解语义；"导数"和"切线"可能一个命中 dataviz、一个命中 3b1b（已通过去掉 3b1b 的"导数"关键词缓解）；
+- 没做向量检索或多语言同义词；
+- registry 的 `keywords` 需要随新题材维护；
+- 画幅/音频/复杂度字段目前只记录，还没参与硬约束（比如 9:16 未验证的风格应直接拒绝）。
+
 ## 5. 现成的风格体系（2026-10 可直接采用）
 
 不必从零写风格文档。这个生态已经沉淀出几套公开、可复用的体系：
@@ -222,7 +290,7 @@ DESIGN.md
 | `pictogram-motion` | Sports events / Visual identity / Event openers | 不选：偏活动/体育，公式场景弱 |
 | `dark-keynote` | Product launches / SaaS / Keynotes | 不选：与 `swiss-motion` 的排版角色重叠 |
 
-已落 **3 个核心**（`swiss-motion` / `dataviz` / `blueprint`）；`whiteboard`、`iso-infographic` 留作可选，等有真实题材再验。这个列表是筛选结果，不是永久名单——风格帧验收不过就换。
+已落 **5 套**：`swiss-motion` / `dataviz` / `blueprint` / `whiteboard` + `3b1b`。`iso-infographic`、`one-line`、`ascii-crt` 仍是候选，等有对应题材再验；这个列表不是永久名单——风格帧验收不过就换。
 
 落地方式：
 

package/docs/dev-loop.md

@@ -40,7 +40,7 @@ node scripts/dev.mjs probe out.mp4
 node scripts/dev.mjs doctor
 ```
 
-它直接 import `lib/ops.js`，不经过插件注册，适合调参数、量耗时、跑回归。改完再让工具层调用同一份代码。
+它直接 import `lib/ops.js`，不经过插件注册，适合调参数、量耗时、跑回归。默认输出到 `out/`（已 git 忽略），不会弄脏场景目录；`showcase/` 里是提交的展示片，测试片不要放那里。
 
 ## 方案 3：把变化关在数据里
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-motion",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Code-generated math & science animations for DeepSeek Harness: frames-first preview, Manim clips, formula checks.",
   "license": "MIT",
   "type": "module",
@@ -38,9 +38,12 @@
   },
   "scripts": {
     "check": "node --check lib/index.js && node --check lib/ops.js && node --check lib/env.js && node --check lib/doctor.js",
-    "test": "node scripts/test-ops.mjs",
+    "test": "node scripts/test-ops.mjs && node scripts/test-route.mjs",
     "smoke": "node scripts/smoke.mjs",
     "dev": "node scripts/dev.mjs",
+    "route": "node scripts/route-style.mjs",
+    "styles:index": "node scripts/build-style-index.mjs",
+    "styles:check": "node scripts/build-style-index.mjs --check",
     "check:meta": "node scripts/check-meta.mjs",
     "prepack": "npm run check && npm test && npm run smoke"
   },

package/skills/animation-router/SKILL.md

@@ -12,7 +12,19 @@ description: 做代码动画/科普视频的总入口：先判题材（关系还
 | 数学讲解 | 一个**关系** | 公式、坐标、推导、表格 |
 | 科普叙事 | 一个**意象** | 画面、比喻、节奏、材质 |
 
-## 2. 选画面层
+## 2. 选风格
+
+先读 `styles/registry.json`，再按顺序：
+
+1. **用户点名**（"用 3b1b / 瑞士动态排版"）→ 直接用，不再打分；
+2. 没有点名 → `node scripts/route-style.mjs "<题材>" --json`；
+3. `confidence: high` → 写进 `DESIGN.md` 的 `style:`；
+4. `medium` / `low` / `needsConfirmation: true` → 给用户 top 2–3 和理由，等确认；
+5. 完全不命中 → 默认 `swiss-motion`，并说明这是默认。
+
+不要用"感觉像"选风格；理由是 registry 的关键词/uses 命中，不是形容词。
+
+## 3. 选画面层
 
 | 画面层 | 适合 | 不用它的理由 |
 |---|---|---|
@@ -22,7 +34,7 @@ description: 做代码动画/科普视频的总入口：先判题材（关系还
 
 三者都只是素材层；**需要交付时**再统一进 HyperFrames 工程，默认的极简模式不经过 HF。
 
-## 3. 固定顺序（默认极简，先帧后片）
+## 4. 固定顺序（默认极简，先帧后片）
 
 ```
 1. DESIGN.md（design spec）      ← 先定颜色/字体/禁用项/参考
@@ -38,7 +50,7 @@ description: 做代码动画/科普视频的总入口：先判题材（关系还
 `motion_frames` 内部是 `manimgx inspect`，只画请求的时刻并做版式检查，几秒出图；
 `motion_probe` 是给已有 mp4 做体检的，不要用它替代看帧。
 
-## 4. 四条硬规则
+## 5. 四条硬规则
 
 1. **没有 DESIGN.md 或参考语法，不开工**——否则每次都是同一个默认 look；
 2. **默认先帧后片**：先用 `motion_frames` 把画面改对，再决定要不要渲染；

package/skills/design-spec/SKILL.md

@@ -19,6 +19,10 @@ HyperFrames 的 look 文档原话：**不给外部输入，相同的 brief 每
 | 4 | 主题自身的世界 | ✅ 年代、材质、展示场景 |
 | 5 | 官方预设（preset） | ⚠️ 幻灯片语言，仅点名或做 deck 时用 |
 
+## 先路由
+
+写 spec 之前先确定风格：`node scripts/route-style.mjs "<题材>"`。点名风格优先；没有点名就按 `styles/registry.json` 打分；`high` 才直接写，`medium`/`low` 先给用户 top 2–3 确认。
+
 ## 最小形态
 
 ```markdown
@@ -60,7 +64,7 @@ DESIGN.md 写完不等于风格成立。挑 3 个关键时刻（开场、转折
 - 三张里至少一张是 signature shot；
 - 两轮还不对，就换更接近的参考语法，而不是继续调参。
 
-## 六种已验证的语言
+## 八种已验证的语言
 
 | 语言 | 适合 | 关键手段 |
 |---|---|---|
@@ -70,15 +74,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/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,43 @@
+"""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"))
+
+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,28 @@
 # 风格库
 
-可复用的视觉语言。当前有 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`；
+- 路由：`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/dataviz/style.json

@@ -4,8 +4,47 @@
   "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/registry.json

@@ -0,0 +1,212 @@
+{
+  "version": 1,
+  "generated": true,
+  "default": "swiss-motion",
+  "styles": [
+    {
+      "slug": "swiss-motion",
+      "num": "01",
+      "name_cn": "瑞士动态排版",
+      "name_en": "Swiss Motion Graphics",
+      "category_cn": "图形与排版",
+      "uses": [
+        "Formula",
+        "Definition",
+        "Data conclusion",
+        "Typography"
+      ],
+      "uses_cn": [
+        "公式",
+        "定义",
+        "数据结论",
+        "排版"
+      ],
+      "keywords": [
+        "公式",
+        "欧拉",
+        "定理",
+        "定义",
+        "恒等式",
+        "推导",
+        "排版",
+        "方程"
+      ],
+      "avoid": [
+        "图表",
+        "几何证明"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "low",
+      "demo": "showcase/swiss-euler",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion"
+    },
+    {
+      "slug": "dataviz",
+      "num": "02",
+      "name_cn": "数据叙事",
+      "name_en": "Data Storytelling",
+      "category_cn": "信息与发布",
+      "uses": [
+        "Trends",
+        "Comparison",
+        "Distribution",
+        "Scientific data"
+      ],
+      "uses_cn": [
+        "趋势",
+        "比较",
+        "分布",
+        "科学数据"
+      ],
+      "keywords": [
+        "数据",
+        "图表",
+        "趋势",
+        "比较",
+        "分布",
+        "斜率",
+        "切线",
+        "割线",
+        "函数",
+        "变化率",
+        "统计"
+      ],
+      "avoid": [
+        "纯文字排版",
+        "角色叙事"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "low",
+      "demo": "showcase/dataviz-secant",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz"
+    },
+    {
+      "slug": "blueprint",
+      "num": "03",
+      "name_cn": "蓝图工程制图",
+      "name_en": "Blueprint",
+      "category_cn": "图形与排版",
+      "uses": [
+        "Geometry proof",
+        "Structures",
+        "Dimensions"
+      ],
+      "uses_cn": [
+        "几何证明",
+        "结构",
+        "尺寸关系"
+      ],
+      "keywords": [
+        "几何",
+        "证明",
+        "三角形",
+        "圆",
+        "角度",
+        "尺寸",
+        "工程",
+        "结构",
+        "作图",
+        "勾股"
+      ],
+      "avoid": [
+        "图表",
+        "手绘"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "medium",
+      "demo": "showcase/blueprint-pythagoras",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint"
+    },
+    {
+      "slug": "whiteboard",
+      "num": "04",
+      "name_cn": "白板讲解",
+      "name_en": "Whiteboard Explainer",
+      "category_cn": "手绘与绘画",
+      "uses": [
+        "Explainers",
+        "Online courses",
+        "Science"
+      ],
+      "uses_cn": [
+        "科学解释",
+        "课程",
+        "机制说明"
+      ],
+      "keywords": [
+        "讲解",
+        "课程",
+        "科学",
+        "机制",
+        "流程",
+        "为什么",
+        "原理",
+        "物理",
+        "化学",
+        "生物"
+      ],
+      "avoid": [
+        "高密度公式",
+        "暗场"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "medium",
+      "demo": "showcase/whiteboard-derivative",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard"
+    },
+    {
+      "slug": "3b1b",
+      "num": "05",
+      "name_cn": "3b1b 数学动画",
+      "name_en": "3Blue1Brown Style",
+      "category_cn": "数学讲解",
+      "uses": [
+        "Linear algebra",
+        "Calculus",
+        "Probability",
+        "Neural networks"
+      ],
+      "uses_cn": [
+        "线代",
+        "微积分",
+        "概率",
+        "神经网络"
+      ],
+      "keywords": [
+        "向量",
+        "矩阵",
+        "特征值",
+        "旋转",
+        "复数",
+        "单位圆",
+        "线代",
+        "概率",
+        "微积分",
+        "神经网络"
+      ],
+      "avoid": [
+        "产品发布",
+        "纯排版"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "medium",
+      "demo": "showcase/3b1b-unit-circle",
+      "source": "https://github.com/subinium/3b1b-style-animation-skill"
+    }
+  ]
+}

package/styles/swiss-motion/style.json

@@ -4,8 +4,44 @@
   "cn": "瑞士动态排版",
   "category_en": "Graphic & Type",
   "category_cn": "图形与排版",
-  "uses": ["Brand identity", "Events", "Design education"],
+  "uses": [
+    "Formula",
+    "Definition",
+    "Data conclusion",
+    "Typography"
+  ],
   "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion",
   "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
-  "implementation": "manimgx (theme.py + tokens.json)"
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "01",
+  "film": "Euler Formula",
+  "line": "A formula on a Swiss grid: one red accent, five constants.",
+  "line_cn": "瑞士网格上的一个公式：一个红色信号色，五个常数。",
+  "uses_cn": [
+    "公式",
+    "定义",
+    "数据结论",
+    "排版"
+  ],
+  "keywords": [
+    "公式",
+    "欧拉",
+    "定理",
+    "定义",
+    "恒等式",
+    "推导",
+    "排版",
+    "方程"
+  ],
+  "avoid": [
+    "图表",
+    "几何证明"
+  ],
+  "demo": "showcase/swiss-euler",
+  "demo_duration_sec": 6.2,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "low"
 }

package/styles/whiteboard/STYLE.md

@@ -0,0 +1,58 @@
+---
+name: whiteboard
+version: 1.0.0
+source: https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard
+license: MIT（上游风格文档）；demo 静帧 CC BY 4.0（LemoLab）
+status: adapted
+---
+
+# Whiteboard Explainer · 白板讲解
+
+> 上游：Lemo-Opuscar `styles/whiteboard`（MIT）。保留“一块板 + 三支马克笔 + 书写顺序”的语法；
+> manimgx 版省掉手/浮空笔/相机旅行，用 draw-on 与固定机位近似。
+
+## 1. 定位
+
+一块暖白干擦板，所有内容都是马克笔“写”出来的：
+
+- 适合：科学解释、课程、机制/流程说明；
+- 不适合：需要真实材质、角色表演、复杂 3D 的题材。
+
+## 2. 不变量
+
+| 项 | 规则 |
+|---|---|
+| 板面 | 暖白 `#F7F5EF`，可有轻微不均与旧字痕 |
+| 墨色 | 黑 `#23262C`：结构与文字 |
+| 过程色 | 蓝 `#2A5CB3`：测量、过程、正在变化 |
+| 强调 | 橙 `#D97757`：结论、最终答案；每区最多一次 |
+| 字体 | 手写体（Chalkboard SE）；公式 New Computer Modern |
+| 运动 | 按书写顺序 draw-on；一笔接一笔；不弹跳 |
+| 版面 | 一个想法一个区域；距离=论证距离；标签要么全在画面内，要么不出现 |
+
+## 3. manimgx 映射
+
+- `theme.py`：`apply_config()`、`backdrop()`（暖白渐变 + 细噪点）；
+- 线条与文字用 `Create` / `Write` 按顺序出现；没有笔、手、橡皮、相机；
+- 字体替换：EMS Tech / Architects Daughter → `Chalkboard SE`；
+- 旧字痕用低透明度 `Text`/`Line` 近似。
+
+## 4. Do / Don't
+
+**Do**
+
+- 先写标题，再按“定义 → 例子 → 结论”在板面上展开；
+- 蓝色只给“正在变化”的对象，橙色只给结论；
+- 结论出现后停住，给读者读完。
+
+**Don't**
+
+- 不画手、笔、光标；
+- 不用第四种马克笔颜色；
+- 不做镜头急推/急拉；文字不压线。
+
+## 5. 与上游的差异
+
+- 上游有浮空马克笔、笔影、干擦纹理、相机旅行；这里只保留书写顺序与三色语义；
+- 上游 24 fps、板面可远大于画幅；本实现 30 fps、固定画幅；
+- 字体与纹理均为近似，验收以帧为准。

package/styles/whiteboard/style.json

@@ -0,0 +1,47 @@
+{
+  "slug": "whiteboard",
+  "en": "Whiteboard Explainer",
+  "cn": "白板讲解",
+  "category_en": "Hand-drawn & Painting",
+  "category_cn": "手绘与绘画",
+  "uses": [
+    "Explainers",
+    "Online courses",
+    "Science"
+  ],
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "04",
+  "film": "Secant on a Whiteboard",
+  "line": "A derivative explained on one warm whiteboard with three markers.",
+  "line_cn": "在一块暖白板上，用三支马克笔讲清导数。",
+  "uses_cn": [
+    "科学解释",
+    "课程",
+    "机制说明"
+  ],
+  "keywords": [
+    "讲解",
+    "课程",
+    "科学",
+    "机制",
+    "流程",
+    "为什么",
+    "原理",
+    "物理",
+    "化学",
+    "生物"
+  ],
+  "avoid": [
+    "高密度公式",
+    "暗场"
+  ],
+  "demo": "showcase/whiteboard-derivative",
+  "demo_duration_sec": 9.6,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "medium"
+}

package/styles/whiteboard/theme.py

@@ -0,0 +1,53 @@
+"""whiteboard 1.0.0 — Lemo-Opuscar 的 Whiteboard Explainer，manimgx 实现层。
+
+上游规范（MIT）：styles/whiteboard/STYLE.md
+暖白板 + 三支马克笔；manimgx 版省掉笔/手/相机旅行，只保留书写与结构。
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import numpy as np
+
+import manimgx as m
+
+TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
+
+BOARD = TOKENS["colors"]["board"]
+BOARD_EDGE = TOKENS["colors"]["board_edge"]
+INK = TOKENS["colors"]["ink"]
+BLUE = TOKENS["colors"]["blue"]
+ORANGE = TOKENS["colors"]["orange"]
+MUTED = TOKENS["colors"]["muted"]
+GHOST = TOKENS["colors"]["ghost"]
+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 = BOARD
+
+
+def backdrop(seed: int = 5) -> m.ImageMobject:
+    """暖白板：轻微渐变 + 细噪点，避免大块纯白。"""
+    w, h = m.config.pixel_width, m.config.pixel_height
+    yy, xx = np.mgrid[0:h, 0:w]
+    u = xx / (w - 1)
+    v = yy / (h - 1)
+    glow = np.exp(-(((u - 0.45) ** 2) / 0.30 + ((v - 0.42) ** 2) / 0.30))
+    rgb = np.empty((h, w, 3), dtype=float)
+    base = np.array([247, 245, 239], dtype=float)
+    edge = np.array([233, 228, 216], dtype=float)
+    rgb[:] = edge + glow[..., None] * (base - edge)
+    rng = np.random.default_rng(seed)
+    rgb = np.clip(rgb + rng.normal(0, 1.0, rgb.shape), 0, 255).astype(np.uint8)
+    img = m.ImageMobject(rgb, scale_to_resolution=min(w, h), resampling_algorithm=3)
+    return img.move_to(m.ORIGIN)
+
+
+def board_line(y: float, x0: float, x1: float, color: str = INK, width: float = 2.4) -> m.Line:
+    return m.Line([x0, y, 0], [x1, y, 0], color=color, stroke_width=width)

package/styles/whiteboard/tokens.json

@@ -0,0 +1,27 @@
+{
+  "name": "whiteboard",
+  "version": "1.0.0",
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "colors": {
+    "board": "#F7F5EF",
+    "board_edge": "#E9E4D8",
+    "ink": "#23262C",
+    "blue": "#2A5CB3",
+    "orange": "#D97757",
+    "muted": "#8A857C",
+    "ghost": "#C9C3B6"
+  },
+  "typography": {
+    "hand": { "family": "Chalkboard SE", "size": 34 },
+    "label": { "family": "Chalkboard SE", "size": 24 },
+    "math": { "family": "New Computer Modern", "size": 54 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.55
+  },
+  "motion": { "fps": 30, "easing": "hand-speed", "hold_min_seconds": 1.4 },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}