用途 whiteboard-video-factory 用于出片手绘白板风格的“边画边讲”讲解视频。每期内容放在期目录中，scenes.js 是唯一手写源（旁白、场景、封面都在里面），中间产物与成片输出到 build 目录。工具通过命令行 bin/wb 驱动，所有参数集中在 config.json，改配置不改代码。
主要能力
- 白板动画：基于 Excalidraw 风格的逐笔绘制，画布固定 1920×1080，y≥960 为字幕区，右上 320×130 为水印区。旁白按 | 切 beat，每个 beat 配一组元素，一屏建议 10~20 个元素。
- 配音通道三选一：火山引擎（seed-tts-2.0，返回逐字时间戳，字幕最准，默认）、小米 MiMo（mimo-v2.5-tts，九个固定音色）、本机 edge-tts（免费无凭证）。语速默认 1.2 倍。
- 字幕与高亮：烧录字幕并支持逐段跟读高亮，高亮粒度、颜色、透明度可配置；字幕文本取原文，时间来自 TTS 时间戳（小米通道为静音检测估算）。
- 品牌层：右上角手写水印（第一个场景逐笔画入）、5.5 秒片尾品牌卡、封面品牌标均由工具生成，品牌名、色、slogan 在 config.json 的 brand 中设置。
- 封面与文案：生成 4:3 横版、3:4 竖版、9:16 抖音竖屏三张封面；发布文案覆盖视频号、小红书、抖音、B 站等平台。
- 素材：公司/产品 Logo 走 Wikimedia Commons 官方 SVG（wb logo），人物、器械、物件用贴纸（wb image 调用本地 codex CLI 生图），文字、箭头、框用 Excalidraw 绘制。
使用方式 常用命令：wb new 建期目录；wb logo 取真实 Logo；wb image 出贴纸（一次 ≤4 张）；wb stills 出每 beat 静帧供检查；wb cover 出三张封面；wb captions 核对字幕时间与高亮分段；wb voice 配音自检；wb build 一条龙出片（scenes → tts → render → mix → cover → clean，产出 outputs/final.mp4、字幕.srt、旁白稿.md）。分步命令还有 scenes / tts / render / mix / clean / open / list，可按场景断点续跑。
流程要点：先立题查证并把数字、日期、来源写进期目录 README.md；再写旁白与场景；然后出 Logo 与贴纸、画场景、做封面；最后出片验收并填写发布.md。交付四件套为成片、三张封面、发布.md。
适用场景与时长 适合知识科普、产品与模型解读、对比讲解等口播动画。时长不是固定值：2~3 分钟约 6~8 个场景、500~700 字；5~10 分钟约 15~25 个场景、分 2~3 幕；15~25 分钟约 40~60 个场景、分 3~5 幕；30~40 分钟约 75~90 个场景、分 5~8 幕。代码层面没有时长上限，长片建议加章节卡、呼吸点和配乐播放列表。
限制与注意事项 工具全链路本地，需自行准备各 TTS 通道的凭证或本机 edge-tts 环境；贴纸生成依赖本地 codex CLI。火山 TTS 两个调用域互不相通，ark- 开头 Key 只走 plan 域，音色与 resourceId 必须配套；小米通道没有语速参数和逐字时间戳，语速靠本地 atempo，时间轴靠静音检测估算。改旁白后需先 wb scenes 再 wb tts，wb build 会整期重渲，长片小改动建议用分步命令。其它平台差异与已知坑在资料中有详细说明。