这是什么
hand-drawn-explainer-video-nikola 是一个面向中文知识讲解的 Codex Skill，由作者 hi-nikola 开发，采用 Apache-2.0 许可证。它能把一段主题、文稿甚至 SRT 字幕制作成“讲一部分、画一部分”的手绘风格视频，交付真实 MP4 视频文件、SRT 字幕、时间轴以及可编辑的工程素材。该仓库当前在 GitHub 上拥有 397 个 Star、58 个 Fork，开放 1 个 Issue，最新版本为 v1.1.0。
这个 Skill 的核心价值在于“真实逐笔绘制”：它不把静态手绘图片的平移或淡入冒充成手绘动画，而是通过内置的 MIT 后端实现笔尖跟随线条的连续落墨过程，并在最终交付前检查视频、音轨、字幕、场景边界和末帧。
适合谁
适合需要制作中文知识讲解视频的创作者、教育工作者、自媒体运营者，以及想快速将文稿转化为可视化视频的独立开发者。即使没有专业动画制作经验，只要会使用 Codex 并描述需求，就能借助这个 Skill 产出具有手绘质感的教学或科普视频。
能做什么
本 Skill 提供了两条制作路线，用户可以按需选择：
- 逐笔故事动画：同一画布上持续落墨，适合人物故事、历史叙事、白板讲解。可选画面结构有单场景、多幕故事和左右双语义岛；可选视觉风格包括 Q 版人物、小黑风格或其他手绘风格。
- 程序动画：使用 SVG/HTML/GSAP 编排流程卡片、关系图、精确文字和独立元素运动，适合流程、规则、关系对比等知识图形。
此外，还能输出自包含的提示词，交给 Flow、Nano Banana 等其他图像或视频模型使用，但这属于交付范围而非第三条路线。
使用前准备
该 Skill 是为 Codex 环境设计的。建议先安装 Codex，并准备 Python 3.10+ 环境（Windows 若默认 python 较旧，可改用 py -3.12）。完整 MP4 渲染需要 FFmpeg/FFprobe；程序动画路线需要 Node.js、浏览器和 HyperFrames。首次安装 Python/npm 依赖需要联网，生成插画或合成配音时可能需要外部服务（如火山引擎语音合成），这些服务可选且可能收费。
安装方法
最简单的方式是让 Codex 安装此仓库，或手动克隆并运行检查脚本。以下为 Windows 环境的命令示例：
git clone https://github.com/hi-nikola/hand-drawn-explainer-video-nikola.git "$env:USERPROFILE/.codex/skills/hand-drawn-explainer-video-nikola"
python "$env:USERPROFILE/.codex/skills/hand-drawn-explainer-video-nikola/scripts/setup_check.py"提示词模式到这里即可使用。若要使用逐笔视频，还需要准备环境并执行预检：
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详情可参考仓库中的 docs/INSTALL.md 和 docs/CONFIGURATION.md。
使用示例
在 Codex 中，直接调用技能并描述需求即可。例如：
使用 $hand-drawn-explainer-video-nikola，把下面内容做成 45 秒中文手绘讲解视频。讲一部分画一部分，先画左边再画右边，重要结论用准确关键词后期写出；使用自然肤色 Q 版人物，先做代表镜头验证，再交付真实 MP4、SRT、时间轴和可编辑素材。
仓库提供了多个真实案例，包括《约法三章》16:9 多幕逐笔故事动画、乔布斯传记 Q 版人物双语义岛版，以及“什么是 Skill”程序动画样片。这些案例展示了如何从空白纸张逐笔落墨、如何构造多幕结构，以及如何使用 SVG/HTML 元素编排流程卡片和人物动作。
风险与注意事项
- 外部服务费用：云配音（如火山引擎）、生图和视频服务为可选能力，使用前需确认收费模式，建议先进行 Dry Run 并复用内容匹配的缓存。
- 配音质量：成片默认使用火山引擎的刘飞音色，不建议使用系统朗读或 edge-tts 等低质量语音替代，以免与已验证的听感差异过大。
- 环境依赖：完整 MP4 生成需要 FFmpeg、Node.js 等外部工具，首次安装需要联网下载依赖。
- 版权与许可：Skill 代码采用 Apache-2.0，但引用的第三方库各有其许可（如 vendor 目录保留 MIT），示例媒体按 CC BY 4.0 提供，使用时需注意边界。
- 安全：仓库不含 API Key、Token 或私密路径，但使用外部服务时需自行保管密钥。