Hand-drawn Explainer Video Nikola

Nikola 开源面向中文知识讲解的 Codex Skill Hand‑drawn Explainer Video Nikola，可以输入主题、文稿、SRT字幕脚本，生成「讲一部分、画一部分」的手绘讲解视频，直接输出 MP4成片、字幕SRT、时间轴、可编辑工程素材。

该仓库区分真实逐笔绘制动画与普通图片平移/卡片飞入动画，拒绝把手绘风静图滑动冒充白板逐笔作画。

两大制作路线

画面结构、视觉风格属于逐笔故事动画的可组合选项，不属于独立路线；额外支持仅输出提示词的交付模式。

1. 逐笔故事动画（真实笔迹落墨）
   • 画面结构：单场景 / 多幕故事 / 左右双语义岛（先绘制左侧讲完，再绘制右侧，保留已有画面）
   • 视觉风格：Q版人物、小黑风格、其他手绘风格
   • 底层技术：位图线稿提取 + 连续笔迹生成 + 分区遮罩；无需本地AI权重、不需要GPU，依靠传统图像算法渲染。
   • 适用场景：人物传记、历史叙事、白板科普讲解，画面一笔一笔逐步呈现。
2. 程序动画（HTML/SVG/GSAP）
   • 输出流程卡片、关系图、知识图形、精确标签文字。
   • 底层技术：HTML+SVG+GSAP+HyperFrames，元素独立控制位移、缩放、描边。
   • 适用场景：业务流程、逻辑关系对比、规则说明，追求元素位置文字绝对精确。
3. 提示词输出模式
   仅输出 Flow / Nano Banana 等图像视频模型的完整提示词，不渲染视频。

风格选型参考

重要区分：程序动画不等于逐笔手绘动画。卡片飞入、整图淡入缩放，不能冒充逐笔落墨效果。

配音方案

• 默认音色：火山引擎 Seed‑TTS‑2.0 刘飞 zh_male_liufei_uranus_bigtts
• 可切换火山引擎其他授权音色；有现成合格旁白音频会优先复用。
• 要求：需要开通火山引擎豆包语音合成2.0；禁止静默降级为 edge‑tts、系统朗读，没有可用配音资源时保留画面、字幕、时间轴，明确标注配音缺失。

安装部署

仓库克隆

git clone [https://github.com/hi-nikola/hand-drawn-explainer-video-nikola](https://github.com/hi-nikola/hand-drawn-explainer-video-nikola) "$env:USERPROFILE/.codex/skills/hand-drawn-explainer-video-nikola"

执行环境预检脚本

python "$env:USERPROFILE/.codex/skills/hand-drawn-explainer-video-nikola/scripts/setup_check.py"

• 提示词模式到此即可使用。
• 依赖：Python3.10+；完整MP4输出需要 FFmpeg；程序动画需要 Node.js、浏览器、HyperFrames。
• 逐笔视频额外环境初始化：

cd "$env:USERPROFILE/.codex/skills/hand-drawn-explainer-video-nikola"
python vendor/srt-whiteboard-animation/scripts/prepare_env.py
python scripts/stroke_story_preflight.py --report preflight-stroke-story.json

可直接复制的触发示例

$hand-drawn-explainer-video-nikola，把下面内容做成45秒中文手绘讲解视频。讲一部分画一部分，先画左边再画右边，重要结论用准确关键词后期写出；使用自然肤色 Q 版人物，先做代表镜头验证，再交付真实 MP4、SRT、时间轴和可编辑素材。

$hand-drawn-explainer-video-nikola，用小黑风格解释这个方法：纯白背景、稀疏黑线、少量红橙蓝批注。要真实逐笔落墨，不要只做静图缩放；字幕和关键词必须准确。

$hand-drawn-explainer-video-nikola，把这段内容做成手绘风流程卡片动画。使用可编辑 SVG/HTML，所有标题、数字和箭头关系必须确定性生成，并验证最终 MP4。

仓库目录结构

• SKILL.md：触发规则、完整工作流
• references/：逐笔动画、双语义岛、声音对齐、质量规范文档
• scripts/：环境预检、配音辅助、视频合成、结果校验脚本
• vendor/srt-whiteboard-animation/：MIT协议逐笔渲染运行时
• examples/：公开样片、源文件、工程示例
• docs/：安装配置、排错、风格指南

安全与成本

仓库不携带密钥、token、私有路径。图像生成、语音合成属于外部可选服务，会产生费用。建议先做Dry‑Run预校验，合理使用缓存，避免无限制重复调用。