白板动画制作

技能文档

---
name: whiteboard-animation-maker
title: 白板动画制作
category: 内容创作
description: 把一个概念、一份口播稿或一条对标视频，制作成 1080×1920 竖屏白底黑线手绘讲解片，支持汉字与英文单词逐笔手绘、流程卡片、口播配音与授权声音克隆，可先读取社媒对标视频再拆解结构。当用户需要白板动画、手绘讲解视频、概念科普短片或口播配音视频时触发。触发词：白板动画、手绘视频、讲解视频、概念科普。
---

# 白板动画制作

每次只做一条竖屏白板片：1080×1920，白底黑线手绘，一个声音口播。输入是一个概念、一份写好的口播稿，或一条要对标的视频。一条片子只用一种模式。本包在本地成片，不负责发布。

`$SKILL` 是本 `SKILL.md` 所在目录。脚本、模板和文案规则都在这里。

**本连接上的服务接口是口播合成、声音克隆和对标社媒读取的唯一通道。** 不要改用其他 TTS 或克隆服务，不要让用户自己去下载对标视频，也不要通过 REST、无头浏览器或其他技能去抓社媒。每一个远程工具都只通过随包 `scripts/mcp_client.py` 调用。

## 适用范围与相邻路线

本路线是：一个主题进，一条手绘讲解片出——拆解概念、写口播、分镜、逐笔手绘、可选口播、本地渲染。提示词生成视频、课堂实录、平台发布不属于本包。

## 开始前先收集（缺了再问）

至少要有一项：**要讲什么**、**一份写好的稿**，或 **一条对标视频链接**。

- **要讲什么。** 一个概念、一组对比、或一个要讲清楚的故事，就够开工。
- **对标。** 小红书 / 抖音 / TikTok / YouTube / Instagram / X 链接，或「拆这条」：先按[对标查找](references/benchmark-lookup.md)读完，再拆结构。
- **受众和平台。** 默认做成竖屏知识短片；不要编造人设。
- **不能说的。** 公司名、未公开数字。没有禁说清单时，不要编数字，也不要把没跑过的工作说成已验证。
- **输出目录。** 默认在当前工作目录下新建 `<slug>/`。
- **口播和时长。** 没说就问。默认 1–3 分钟。声音只有两条路：库内声，或克隆（本人声音或已声明授权）。

text 还是 program 在 Gate A 决定；更早不要建草稿。

## 技能工作流

### 步骤1：拆主题并过 Gate A（方向）

拆出骨架：一个记住点、常见混淆、3–5 步、一个可画的主例、一条边界、砍掉清单。太多就提议做成系列。对标要在拆解前读完：只借双文字轨和一句一物，拒绝彩色剪贴画、真人手部照片和关注引导。

然后出示 Gate A 卡片：理解、受众假设、角度、时长、模式、是否口播、砍掉清单和诚实等级；停下来等用户表态：通过 / 改角度 / 改时长 / 改模式 / 去掉口播 / 这次不做。「你看着办」不算通过。

### 步骤2：写口播和分镜并过 Gate B（稿和分镜）

按[口播文案](references/script-copywriting.md)：先诊断开头，用冲突做钩子，再证据，再落地，再收束动作。分镜上的画面字和物件按[默认画面](references/visual-rules.md)；一场一个想法。完整口播加分镜表和时长估计一起出示，停下等：通过 / 改场 / 删场 / 重写 / 回到 Gate A。

Gate B 通过后，「按这张表画」才开工。角度变了重开 Gate A；口播变了重开 Gate B。

### 步骤3：选模式建草稿

- **text**：字逐笔写出来——汉字和英文短词一样——再画对应物件。社交白板讲解默认这条。见 [text 模式](references/mode-text.md)。
- **program**：流程卡片、关系图、必须读准的标签。见 [program 模式](references/mode-program.md)。

用 `new_draft.mjs` 建草稿，写入已通过的 `script.txt` 和 `DESIGN.md`，再画 `<outdir>/index.html`。前置和完整命令序列见[流水线命令](references/pipeline-commands.md)（Node 18+、npm、ffmpeg）。画面字来自笔顺数据，不用系统字体：

```bash
python3 "$SKILL/scripts/text_svg.py" '目标' --id goalText --cx 540 --cy 280 --size 80
```

### 步骤4：口播合成

按[口播与同步](references/voiceover-and-sync.md)：提交、轮询、收取。口播没变就不要再合成。声音克隆只在用户声明本人声音或已获授权时进行。

### 步骤5：渲染与交付

```bash
node "$SKILL/scripts/render.mjs" <outdir>
```

交付前用 `renders/preview/sN.jpg` 对照口播里的名词：某一刻屏幕上的字或物件必须就是那一刻说出的名词。

## 付费确认与账户

规划免费：Gate A 卡片和 Gate B 的稿加分镜在扣费前交付，规划不是批准。付费调用共三种：口播合成、声音克隆、对标查找。每一种都有自己的六字段确认卡，每个逻辑请求一个新 `client_request_id`。价格以 `beatra.models.list`（`{"capability": "text_to_speech"}` / `{"capability": "voice_clone"}`）和 `beatra.social.tools.get` 的实时返回为准，绝不用记忆数字。参数变了就是新卡、新标识；完全相同的再提交复用原标识。余额不足时原样转达官方说明和充值链接，用户确认充值前不重试。

用户问余额用 `beatra.wallet.get`，问扣费用 `beatra.wallet.ledger`；不要从流水行里读价格。

## 按任务查阅的参考

- 创作主线：[工作流](references/workflow.md)、[口播文案](references/script-copywriting.md)、[默认画面](references/visual-rules.md)
- 模式：[text 模式](references/mode-text.md)、[program 模式](references/mode-program.md)
- 成片：[口播与同步](references/voiceover-and-sync.md)、[对标查找](references/benchmark-lookup.md)、[流水线命令](references/pipeline-commands.md)
- 连接与账户：[安装与授权](references/installation-and-auth.md)、[MCP 连接诊断](references/mcp-connection.md)、[任务与结果](references/tasks-and-results.md)、[计费、错误与恢复](references/billing-errors-and-recovery.md)、[卸载与断开连接](references/uninstall-and-disconnect.md)

## 依赖

- Node.js 18+（npm 首次使用自动装依赖）、Python 3.10+、系统 ffmpeg/ffprobe
- 口播合成、声音克隆与对标查找为付费能力，需授权连接

使用说明

# 白板动画制作

把一个概念、一份口播稿或一条对标视频，做成 1080×1920 竖屏白底黑线手绘讲解片，支持逐笔手绘汉字与英文短词、口播配音与授权声音克隆，本地渲染成片。

## 使用

对助手说：

```text
帮我做一条 90 秒的白板动画，讲清楚什么是 Agent
```

或提供写好的口播稿、对标视频链接。两道确认闸（方向、稿+分镜）通过后自动建草稿、绘制、合成口播并本地渲染。

## 工作原理

技能先拆主题定角度（Gate A），按社媒钩子弧线写口播与分镜（Gate B），再按 text（逐笔描字）或 program（流程卡片）模式绘制 SVG 合成，口播经付费合成并与画面逐场对齐，最后用 ffmpeg 渲染出竖屏 MP4 与逐场预览帧。口播未变时只改画面不重复计费。

## 目录结构

- `SKILL.md`：创作主线、模式与付费确认规则
- `references/`：工作流、文案、画面规则、口播同步、对标查找、连接与计费
- `scripts/`：草稿、绘制、字幕、对齐、渲染与客户端脚本
- `templates/`：text / program 两种模式的草稿模板
- `assets/`：笔顺数据

## 依赖

- Node.js 18+、Python 3.10+、系统 ffmpeg/ffprobe
- 口播、克隆、对标查找为付费能力，需授权

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。