SRT 白板动画 Skill Skill 技能

技能简介

SRT 白板动画 Skill 是一个开源的 Agent 技能（MIT 协议，GitHub 星标 4200+），能把 SRT 字幕文件自动转成按叙事顺序手绘的白板动画视频。它结合分区遮罩编排与流式笔迹绘制，让画面元素跟随字幕依次出场、笔尖在区域内连续落墨并逐步添彩，最终导出完整 MP4，适合把知识讲解、故事口播、课程字幕与短视频文案制作成暖米黄色纸张质感的手绘动画。

核心能力

• SRT 字幕解析与自动分镜：按建议的 25-35 秒时长拆分场景，先输出分镜与配图策略，保证每一幕只表达一个核心意思

• 语义化绘制顺序：按字幕事件而非画面坐标为元素排序，用 annotation.json 统一管理区域、时序、字幕关联与重叠保护区

• 流式笔迹渲染：每个区域先用 ink 铺线稿、再用 color 添彩，笔尖在区域内连续落墨，避免一次性闪现

• 浏览器预览台：本地 assets/preview.html 可视化调整区域、顺序、时间与字幕关联并保存

• 逐幕渲染与合并：支持逐幕出片，多幕项目确认各幕成片后一键合并为最终 MP4

• 统一视觉规范：暖米黄背景（#F5EBD7）、深灰素描线条、红橙蓝仅作少量概念点缀，极简手绘、干净留白

安装配置

• 克隆仓库：git clone https://github.com/geeklee/srt-whiteboard-animation.git

• 检查环境：运行 python scripts/prepare_env.py --check 输出 ENV_PY=

• 创建独立虚拟环境：运行 python scripts/prepare_env.py，后续所有渲染命令统一使用该解释器，保证依赖隔离

使用步骤

1. 运行 python scripts/parse_srt.py 字幕.srt --target-sec 30 解析字幕并生成分镜建议

2. 确认分镜后生成统一风格线稿，结合字幕与原图创建标注，并载入浏览器预览台

3. 在预览台调整区域、叙事顺序、时间与字幕关联，保存 annotation.json

4. 用 render_stream_whiteboard.py 渲染单幕 MP4，多幕项目再用 merge_scenes.py 合并成片

适用场景

• 知识科普与概念讲解视频的手绘动画化

• 课程字幕转白板板书动画，降低录制成本

• 故事口播、儿童故事的插画式呈现

• 产品功能说明与短视频文案的可视化批量生产

适用人群

AI 内容创作者、知识区 UP 主与讲师、需要批量制作手绘讲解视频的自媒体团队，以及希望用 Agent 自动生成动画的开发者。

工作原理

该技能采用"字幕驱动、逐步确认"的流水线：解析 SRT 得到分镜后，线稿、标注、预览、渲染每一步都等待人工确认，避免在方案未定稿时浪费渲染成本。标注文件用整数像素坐标描述元素区域，并通过 sequence、subtitle、narrativeRole 关联字幕事件，reveal 字段控制遮罩方向与出现时机，protectedRegions 标出相互遮挡时需要延后的区域；渲染器按叙事顺序生成分区与方向检查图，再以矩形遮罩代理驱动流式笔迹，输出首帧干净、未开始区域不提前露出的成片，每幕结束后至少停留 0.5 秒完整画面。

官方链接

GitHub：https://github.com/geeklee/srt-whiteboard-animation