dsh-animation-studio

配置

## 使用

### 让 AI 做一支片子

在 DSH 会话里直接说需求即可，典型流程是：

你：用动画讲一下"梯度下降"的直觉，30 秒以内，中文。 AI：anim_diagnose → 环境自检 anim_create_spec → 建立时间线文档（30fps，1280x720） anim_plan → 写分镜大纲，工具做节奏体检（太短/太长/缺意图会提示） anim_draft_scene → 逐幕写入图层与关键帧（可反复调用） anim_preview → 低分辨率抽几帧自查 anim_patch → "第二个关键帧挪到 1.8s""小球改橙色" anim_render → 渲染成 MP4，报告输出路径

你会拿到的每个工具回执都带"下一步该做什么"的引导；`anim_patch` 返回的 `inverse` 可以直接喂回给 `anim_patch` 撤销，`anim_undo` 则是它的快捷方式。

### 工具一览

| 工具 | 作用 |
| --- | --- |
| `anim_diagnose` | 环境自检：后端、ffmpeg、浏览器、中文字体 |
| `anim_create_spec` | 新建一份时间线文档，返回 specId |
| `anim_plan` | 记录分镜大纲 + 节奏体检 |
| `anim_draft_scene` | 逐幕写入图层与关键帧 |
| `anim_get` | 按 JSON Pointer 精确读取 spec 片段 |
| `anim_patch` | 结构化补丁修改（唯一写途径），返回 inverse |
| `anim_undo` | 撤销上一次修改 |
| `anim_preview` | 低分辨率抽帧检查效果 |
| `anim_render` | 渲染成 MP4（可只渲指定场景抽查） |

### 不装 DSH 也能跑：样例工程

`examples/hello-gradient` 是一条 8 秒的中文教学片《梯度下降：直觉理解》，走通"IR → Motion Canvas 源码 → MP4"全链路：

```bash
pnpm install
cd examples/hello-gradient
node --import tsx scripts/generate.ts   # spec → Motion Canvas 源码（src/ 下）
node --import tsx scripts/render.ts     # 源码 → output/output.mp4（需要渲染环境）