1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | srt-whiteboard-animation |
| 作者/维护者 | geeklee（GitHub 个人开发者） |
| 来源链接 | https://github.com/geeklee/srt-whiteboard-animation |
| 许可证 | MIT（数据来自仓库 LICENSE 文件） |
| GitHub Stars | 1,821（数据来自 GitHub API） |
| Forks | 278（数据来自 GitHub API） |
| 最新版本 | v1.0.0 |
| 安装方式 | 克隆/下载仓库后放入对应 Agent 的 skills 目录，首次使用前运行仓库自带的 Python 环境准备脚本 |
2. 功能介绍与亮点
srt-whiteboard-animation 把一份 SRT 字幕文件转换成一条“暖米黄纸张底”的白板手绘讲解视频。它的核心设计是字幕驱动的叙事编排：技能先解析字幕的时间轴，按 25–35 秒一幕给出分镜与配图策略；确认后生成统一视觉规范的线稿；再把画面中的每个主体与对应字幕事件对齐，标出出场顺序、时间区间与遮挡保护区；最后用“分区依次落墨、每区内先勾线后添彩”的流式笔迹渲染成 MP4，多幕素材还能按顺序合并成一条完整视频。
主要亮点：
- 叙事而非坐标驱动：绘制顺序由字幕事件的先后决定（场景铺垫→关键主体→动作/变化→反应结果），而不是简单按画面位置从左到右扫描，效果更贴近人手绘讲解的逻辑。
- 本地渲染，流程透明：图像合成与视频渲染都由仓库自带的 Python 脚本（依赖 opencv-python / numpy / av）在本地虚拟环境中完成，不依赖任何外部渲染服务。
- 强制分步确认：工作流的每一步（策略→线稿→标注→分区预览→时序调整→渲染→合并）完成后都要求用户确认才能继续，避免在方案未定稿前浪费渲染成本，也降低了自动化流程“跑偏”的风险。
- 可视化预览台：提供基于浏览器的预览台，支持拖拽调整区域范围、出场顺序与时间区间，改完可直接保存回标注文件。
3. 适用场景
所属分类：内容创作与知识管理
适合把知识讲解、故事口播、课程字幕、短视频文案等文本内容，转换成风格统一的手绘叙事视频。典型受益人群：
- 制作科普、故事类短视频的个人创作者与自媒体团队，用它替代人工分镜手绘或高价定制动画服务；
- 需要为课程、讲座配上直观示意图的讲师或内容团队；
- 希望以低成本、可复现的方式批量产出同一视觉风格系列短视频的小型内容工作室。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | SKILL.md 与配套脚本不依赖任何 Claude 专属工具调用，仅需 Agent 能执行 shell/Python 命令，符合 Agent Skills 通用规范 |
| Codex | 原生支持 | 同上，技能全部逻辑封装在通用 Python 脚本与 SKILL.md 指令中，无平台绑定代码 |
| OpenClaw | 原生支持 | 同上 |
| Hermes Agent | 原生支持 | 同上 |
⚠️ 交互式预览台（拖拽调整区域/时序）依赖浏览器的 File System Access API，目前仅 Chrome / Edge 支持写回本地文件；这是浏览器能力限制，不影响命令行渲染主流程在任意 Agent 下运行。
5. 推荐理由
这是一个目标单一、实现完整的内容生产类技能：从字幕到成片的每一步都有明确产出物和确认关卡，不是一次性的“提示词生成”。渲染逻辑用本地脚本实现，效果可预期、可复现，还提供了可视化调整环节弥补自动分镜的偏差。对需要批量产出讲解类短视频、又不想为定制手绘动画付费的个人创作者和小团队，这是一条低成本、风格统一的生产路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 1,821 stars、278 forks，已进入千星量级；GitHub issue 区可见具名用户实际使用后发布社交媒体分享的正面反馈，但独立第三方讨论来源仍偏少 |
| 可用性 | 8 | 需要本地准备 Python 虚拟环境（自带脚本一键安装依赖），步骤清晰、文档完整含示例效果图；仓库近 3 周内有发布记录，处于活跃维护状态 |
| 安全性 | 9 | 全流程本地执行，渲染阶段不联网、不依赖任何 API Key 或凭据；SKILL.md 与脚本中未发现可疑指令；License 明确（MIT）；作者为长期活跃的个人开发者，无造假迹象 |
安全检查清单：
① 执行 shell 命令及权限范围——仅调用仓库自带的本地 Python 脚本完成字幕解析、图像标注与视频渲染，权限范围与技能功能一致，无越权操作。 ② 运行时是否联网外发数据——否，图像生成由使用者的 Agent 自身完成，技能脚本本身不发起任何网络请求。 ③ API key/凭据——不需要任何密钥或账号凭据。 ④ 可疑指令——通读 SKILL.md 全文及各脚本用途说明，未发现要求执行无关操作、访问敏感文件或夹带第三方推广的指令。 ⑤ 作者/组织信誉——GitHub 账号注册于 2013 年，长期活跃，仓库 issue 区有具名用户的真实正面反馈，无信誉异常记录。 ⑥ License——MIT，明确写在仓库 LICENSE 文件中。 ⑦ 最近维护时间——最新提交与发布均在近一个月内，非弃置项目。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| ian-handdrawn-ppt | 把课程/讲解内容转成统一中文手绘风格静态配图 | 产出静态图片而非视频，也没有字幕时间轴驱动的叙事分镜与逐区动画渲染能力 |
| video-recap-worldwonderer-video-recap-skills | 把长视频转成中文解说成片 | 输入是完整视频而非字幕文本，产出是真人解说合成片，风格是写实剪辑而非手绘白板 |
| pixel2motion | 把栅格 Logo 转成矢量并编排揭示动效 | 面向品牌 Logo 单一元素的动效制作，不处理字幕、多场景叙事或分区绘制逻辑 |
srt-whiteboard-animation 的差异化在于：以字幕时间轴为叙事骨架，自动把多主体、多分区的手绘绘制顺序与字幕事件对齐，并在本地完整闭环出成片，同类技能里少见把“叙事编排”和“渲染实现”同时做完整的组合。
8. 用户评价
在仓库的 GitHub Issue 区，用户 weichen-ink 于收录前反馈：此前一直在搭建 AI 自动生成短视频的工作流，唯一缺少的环节是手绘风格素材，尝试过的同类付费方案价格偏高；使用该技能制作出一条视频后评价“非常的丝滑”，并将成片发布到了自己的社交媒体账号。这是目前可查证的唯一一条具名第三方使用反馈，尚未见其他独立平台的公开评价。
9. 其他补充
仓库同时提供 examples 目录下的效果演示（GIF 与线稿 PNG），可在使用前直观了解最终画风与叙事编排效果。
10. 安装使用方式
- 克隆或下载仓库：
git clone https://github.com/geeklee/srt-whiteboard-animation，将其放入所用 Agent 的 skills 目录。 - 首次使用前准备本地环境：
成功后会输出python scripts/prepare_env.py --check python scripts/prepare_env.pyENV_PY=<解释器路径>，后续渲染命令使用该解释器以保证依赖隔离。 - 向 Agent 提供 SRT 字幕文件，触发技能后按提示逐步确认分镜策略、线稿、标注与最终成片。
- 如需手动调整分区、顺序或时间区间，用 Chrome 或 Edge 打开
assets/preview.html，加载对应目录后拖拽调整并保存。 - 命令行渲染与多幕合并分别对应仓库脚本
render_stream_whiteboard.py与merge_scenes.py，详见仓库 README。
11. 注意事项
- 交互式预览台的拖拽保存功能依赖浏览器 File System Access API，仅 Chrome / Edge 支持直接写回文件，其他浏览器需改为下载后手动替换。
- 首次渲染前需要本地 Python 环境联网安装依赖（opencv-python / numpy / av），离线环境需提前准备好这些依赖包。
- 技能默认视觉规范为暖米黄底手绘风格，若需要其他画风需自行调整 SKILL.md 中的视觉规范描述，不是开箱即用的多风格方案。
- 仓库目前只有一个正式发布版本（v1.0.0），长期维护节奏尚待观察。