hand-drawn-explainer-video-nikola
制作、修改和验收中文手绘知识讲解视频,交付配音、字幕、时间轴、可编辑工程和真实 MP4。支持两条不可混淆的制作路线:同一画布持续落墨的逐笔故事动画,以及用 SVG/HTML/GSAP 编排流程卡片、关系图和知识图形的程序动画。逐笔路线可选择自然肤色 Q 版人物、小黑风格或其他手绘风格,并可采用单场景、多幕故事、左右双语义岛等画面结构。用户说“边讲边画”“一笔一笔画出来”“白板手绘”“先画左边再画右边”“知识讲解动画”或希望把文稿、SRT、人物故事做成手绘视频时使用。也支持只输出生图/图生视频提示词。不用于写实数字人或假装已经完成无法验证的成片。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/hi-nikola-hand-drawn-explainer-video-nikola)HTML
<a href="/listings/hi-nikola-hand-drawn-explainer-video-nikola"><img src="/api/listings/hi-nikola-hand-drawn-explainer-video-nikola/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
最简单的方式是让 Codex 安装此仓库,或手动克隆:
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"
提示词模式到这里即可使用。运行脚本需要 Python 3.10+;Windows 若默认 `python` 较旧,请改用 `py -3.12` 或已确认的新版本解释器。逐笔视频首次使用还需:
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
完整 MP4 需要 FFmpeg/FFprobe;程序动画需要 Node.js、浏览器和 HyperFrames。详见 [安装](docs/INSTALL.md)、[配置](docs/CONFIGURATION.md) 和 [排错](docs/TROUBLESHOOTING.md)。
逐笔核心渲染不需要下载本地神经网络小模型或模型权重,也不要求 GPU;已有合格源图/线稿和旁白时,可以使用本地传统图像算法完成。首次安装 Python/npm 依赖需要联网,从文稿生成新插画或新合成刘飞配音则需要相应外部服务。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 74 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: hand-drawn-explainer-video-nikola
- description: 制作、修改和验收中文手绘知识讲解视频,交付配音、字幕、时间轴、可编辑工程和真实 MP4。支持两条不可混淆的制作路线:同一画布持续落墨的逐笔故事动画,以及用 SVG/HTML/GSAP 编排流程卡片、关系图和知识图形的程序动画。逐笔路线可选择自然肤色 Q 版人物、小黑风格或其他手绘风格,并可采用单场景、多幕故事、左右双语义岛等画面结构。用户说“边讲边画”“一笔一笔画出来”“白板手绘”“先画左边再画右边”“知识讲解动画”或希望把文稿、SRT、人物故事做成手绘视频时使用。也支持只输出生图/图生视频提示词。不用于写实数字人或假装已经完成无法验证的成片。
- ---
- # Nikola 手绘讲解视频
- 把中文主题、文稿或 SRT 变成真正可播放、可检查、可继续编辑的手绘讲解视频。先识别用户要的是“画面被逐笔画出来”,还是“手绘风独立元素运动”;不能为了方便把一种效果冒充另一种效果。
- 提示词模式无本地依赖;逐笔渲染器已随仓库打包,首次使用需创建隔离 Python 环境;程序动画模式需 Node.js、HyperFrames、浏览器和 FFmpeg。成片配音默认使用火山引擎刘飞音色,需用户自己的已授权账号或复用已有音轨;图像生成和视频模型为可选能力,可能产生费用。
- ## 先选择交付范围
- - **只要提示词**:读 [prompt-workflow.md](references/prompt-workflow.md),输出自包含提示词,不调用收费接口。
- - **样片**:制作用户指定片段;未指定时用 10–15 秒代表镜头验证人物、笔迹、字幕和节奏。
- - **完整视频**:先读 [安装与预检](references/preflight-and-recovery.md) 和 [完整流程](references/automation-workflow.md)。先内部验证代表镜头,再继续全片;只有用户要求逐步确认或存在关键选择时才暂停。
- - **修改已有视频**:保留未被要求修改的音轨、时间轴和素材,只重做受影响阶段。
- ## 先选两条制作路线之一
- | 用户真正想要的效果 | 制作路线 | 必读 |
- |---|---|---|
- | “画面被画出来”“边讲边画”“逐笔落墨”“笔尖跟着线走” | 逐笔故事动画 | [stroke-story-workflow.md](references/stroke-story-workflow.md) |
- | 流程卡片、概念关系、独立元素组合、确定性文字 | 程序动画 | HyperFrames + SVG/HTML + GSAP,读 [automation-workflow.md](references/automation-workflow.md) |
- 逐笔故事动画选定后,再分别选择画面结构与视觉风格:
- - **画面结构**:单场景、多幕连续故事,或“先左后右并保留前文”的左右双语义岛。双语义岛只是逐笔故事的一种画面组织方法,参考 [semantic-island-storytelling.md](references/semantic-island-storytelling.md)。
- - **视觉风格**:自然肤色 Q 版人物、小黑风格,或用户指定的其他手绘风格。Q 版适合人物传记与历史;小黑适合抽象观点、方法论和隐喻。两种风格都能采用双语义岛,也都能采用其他画面结构。
- 场景视频与“只输出 Flow/Nano Banana 提示词”是可选交付方式,不是本 Skill 的第三条手绘制作路线。自然连续人物动作或复杂运镜需要先核实视频模型、成本和一致性限制;只要提示词时读 [prompt-workflow.md](references/prompt-workflow.md)。
- 逐笔路线使用 `vendor/srt-whiteboard-animation/` 中随仓库发布的 MIT 后端快照。它不包含第二份 `SKILL.md`,不会单独触发或要求重复确认;主 Skill 统一负责路由、配音、字幕、渲染和验收。运行环境不可用时保存已完成资产并报告缺口;除非用户明确同意,不以 SVG 动画冒充真实逐笔绘制。
- ## 可选视觉风格
- - **Q 版人物故事**:自然肤色、人物身体、年龄和服装锚点清楚,适合传记、历史和人物观点。参考 [q-human-story-style.md](references/q-human-story-style.md) 与 [乔布斯案例](examples/stroke-story/steve-jobs/README.md)。
- - **小黑风格**:纯白、稀疏黑线、少量红橙蓝、留白和冷幽默动作主体,适合方法、系统、状态和隐喻。它是本仓库内置、可直接点选的公开预设;使用时必须读取 [完整视觉 DNA、来源说明与提示词骨架](references/xiaohei-style.md)。该风格借鉴 Ian 的开源项目,应始终称为“小黑风格”。
- 程序化知识图形是制作路线,不是视觉风格。参考 [“什么是 Skill”程序动画案例](examples/program-animation/skill-demo/README.md)。逐笔案例见 [《约法三章》](examples/stroke-story/yuefa-sanzhang/README.md) 与 [《乔布斯的一生》](examples/stroke-story/steve-jobs/README.md)。
- 参考图只影响当前项目,除非用户明确要求保存为新预设。人物、画风、动效和声音分别记录,不把换画风等同于换音色或重做旁白。
- ## 公开默认与本地配置
- 仓库中的 [preferences.json](preferences.json) 只含无密钥默认值。用户指令和项目 `DESIGN.md` 优先。成片默认使用火山引擎 `seed-tts-2.0` 的刘飞音色 `zh_male_liufei_uranus_bigtts`;用户明确要求时可选择火山引擎其他已授权音色,已有与文稿一致的合格音轨优先复用。不要自动改用电脑系统朗读、edge-tts 或其他低质量本地 TTS;缺少授权音轨时可以继续提示词、画面和无配音阶段,但必须把配音列为未完成项。
- 首次使用先读 [安装说明](docs/INSTALL.md) 和 [配置说明](docs/CONFIGURATION.md),再运行:
- ```text
- python scripts/setup_check.py
- ```
- 完整视频在首次配音或长渲染前还要运行路线对应的预检。预检失败只阻止依赖该能力的阶段,不重做已经通过的音频、插画或字幕。
- ## 核心制作规则
- 1. **保留内容**:分别保存原稿、合成读音稿和字幕;未经授权不删观点、数字和限定词。
- 2. **声音先行**:优先复用内容一致的完整音轨;新音轨尽量整段或按自然章节合成。
- 3. **时间来自真实音频**:使用有效时间戳、强制对齐或复核后的句级停顿;不能把平均分配说成逐字对齐。
- 4. **动画服务于解释**:逐笔路线按语义区域持续落墨;程序路线拆成可控元素。整图平移、缩放或淡入淡出只能辅助。
- 5. **控制可画性**:真实笔迹速度取决于区域时间和源图复杂度;`hand-follow` 只平滑手部,不能让线条真正减速。
- 6. **精确文字后期生成**:日期、专名、Logo、长中文和关键数字使用字幕或确定性文字层,不交给图片模型猜写。
- 7. **先验证代表镜头**:检查人物一致性、抬笔、补色、遮挡、关键词和字幕,再批量渲染。
- 8. **成片必须真实验收**:完整解码 MP4,检查全部场景、语义边界、切点、音轨和最后 0.3–0.5 秒。
- ## 安全、费用和准确性
- - 不把 API Key、Token、Cookie、请求头、本机绝对路径或私有模型目录写入仓库、命令参数、报告或工程 ZIP。
- - 账号型配音、生图和视频服务可能收费;先复用缓存,不盲目重试状态不明的请求。
- - 真实人物、公司、Logo、日期和数字需要可靠来源或确定性资产。风格参考不能保证实体准确。
- - 用户要求完整视频时,最少交付真实 MP4;工具支持时同时保留 SRT、旁白、时间轴、源图、标注和可编辑工程。
- 质量与交付细节见 [quality-and-delivery.md](references/quality-and-delivery.md)。仓库结构、贡献和许可见 [README](README.md)。
README.md · README · 165 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Hand-drawn Explainer Video Nikola
- 作者 Nikola|联系与交流:[X / Twitter @Nikola314159](https://x.com/Nikola314159)
- 一个面向中文知识讲解的 Codex Skill:把主题、文稿或 SRT 制作成“讲一部分、画一部分”的手绘视频,并交付真实 MP4、字幕、时间轴和可编辑素材。
- 这应该是目前手绘漫画效果最好的skills仓库了,我参考了许多大佬的方法,尝试了多次完成,TOKEN都要给我整完了。希望各位朋友喜欢,有问题直接推特留言或者提pr吧,未来也会持续维护这个仓库,并更新更多的功能。
- 过程示例:
- 
- ## 它能做什么
- 本 Skill 只有两条制作路线。画面结构与视觉风格是逐笔路线中的可组合选项,不是额外路线:
- ```text
- 制作路线
- ├─ 逐笔故事动画
- │ ├─ 画面结构:单场景 / 多幕故事 / 左右双语义岛
- │ └─ 视觉风格:Q版人物 / 小黑风格 / 其他手绘风格
- └─ 程序动画
- ├─ HTML / SVG / GSAP
- └─ 流程卡片 / 关系图 / 精确文字 / 知识图形
- ```
- “左右双语义岛”是逐笔故事动画的一种画面组织方法:先画左边、讲完一部分,再画右边,并保留前面的内容。也可以使用单场景或多幕连续故事。Q 版人物与小黑风格是视觉风格:前者适合乔布斯传记、历史人物等,后者适合抽象观点、方法论和隐喻;两者都能使用双语义岛,也都能使用其他画面结构。
- 除此之外,本 Skill 也能只输出 Flow、Nano Banana 或其他图像/视频模型的自包含提示词;这是交付范围,不是第三条制作路线。
- 这个仓库不把“手绘风静图平移”冒充逐笔绘制。逐笔路线使用内置的 MIT 后端,并在最终交付前检查真实视频、音轨、字幕、场景边界和末帧。
- ## 路线怎么选
- | 你说的话 | 默认路线 |
- |---|---|
- | “边讲边画”“一笔一笔画出来”“笔尖跟着线走” | 逐笔故事 |
- | “先画左边,再画右边,过程中写关键词” | 逐笔故事 + 左右双语义岛画面结构 |
- | “小黑、怪诞、白底、少量彩色批注” | 逐笔故事 + 小黑视觉风格 |
- | “流程卡片、关系图、精确标签、独立元素运动” | 程序动画 |
- | “只给我生图/图生视频提示词” | 提示词模式 |
- 完整风格说明见 [docs/STYLES.md](docs/STYLES.md)。
- ## 案例
- ### 《约法三章》:16:9 多幕逐笔故事动画
- 
- 
- - [38.5 秒 16:9 手速平滑版 MP4](examples/stroke-story/yuefa-sanzhang/yuefa-sanzhang-16x9-stroke-story.mp4)
- - [可编辑工程包](examples/stroke-story/yuefa-sanzhang/editable-project.zip)
- - [七幕结构、时间轴与验证说明](examples/stroke-story/yuefa-sanzhang/README.md)
- 这是最终采用的优秀版本:七幅连续故事画面,每幕从空白纸张开始逐笔落墨,每幅只承载一个完整事件。旧的 9:16 单画布样片存在人物、道具和环境线条互相干扰的问题,因此不作为仓库推荐案例。
- ### 乔布斯的一生:自然肤色 Q 版人物 + 双语义岛
- 
- 
- - [完整 57 秒样片](examples/stroke-story/steve-jobs/steve-jobs-biography.mp4)
- - [8.9 秒双岛代表镜头](examples/stroke-story/steve-jobs/semantic-island-sample.mp4)
- - [源图、区域与时间说明](examples/stroke-story/steve-jobs/README.md)
- ### “什么是 Skill”:程序动画
- 
- - [14 秒真实 MP4 样片](examples/program-animation/skill-demo/what-is-skill-sample.mp4)
- - [可编辑 HTML/SVG/HyperFrames 工程与说明](examples/program-animation/skill-demo/README.md)
- 这个案例展示流程卡片、人物动作、字幕和真实旁白时间轴。出于第三方许可考虑,GSAP 浏览器文件不直接提交,由 `npm install` 获取。
- 《商用Skills_完整手绘视频》是程序化知识图形路线的完整生产案例:44 个场景中的人物、卡片、箭头、放大镜、字幕条等均作为独立 HTML/SVG 元素编排,再由 GSAP/HyperFrames 按真实旁白时间轴驱动。仓库中的 36 秒工程是便于下载和学习的精简公开示例,不包含那条 7 分 29 秒完整成片。
- 它与“边说边画”不是同一种实现:
- | 对比项 | 程序化知识图形 | 逐笔“边说边画” |
- |---|---|---|
- | 画面如何出现 | 独立卡片、人物、箭头和文字按时间移动、缩放、切换或描边 | 同一画布按语义区域持续落墨,先线稿后补色,已画内容保留 |
- | 核心技术 | HTML/SVG + GSAP + HyperFrames | 位图线稿提取 + skeleton/stream 连续笔迹 + 分区遮罩 |
- | 最适合 | 流程、规则、关系、对比、精确文字 | 人物故事、历史叙事、白板讲解、一幅画逐步完成 |
- | 不可混称 | 手绘风元素动画不等于真实逐笔绘制 | 不能用整图淡入、卡片飞入或 SVG 运动冒充落墨 |
- ## 配音默认
- 成片默认使用火山引擎语音合成的刘飞音色 `zh_male_liufei_uranus_bigtts`,资源模型为 `seed-tts-2.0`。用户明确指定时,可以改用火山引擎中的其他已授权音色;已有与文稿一致、质量合格的旁白则优先复用。
- 在火山引擎控制台进入“开通管理”,开通豆包语音的“语音合成 2.0”服务:
- 
- 不建议把电脑系统朗读、edge-tts 或其他低质量本地文本转语音自动当作成片替代方案,它们与已验证的刘飞听感差异明显。若当前环境没有火山引擎授权或用户提供的合格音轨,应保留已完成的画面、字幕与时间轴并说明配音缺口,不应静默换成系统声音后宣称完成。详见 [配音与声音对齐](references/voiceover.md)。
- ## 安装
- 最简单的方式是让 Codex 安装此仓库,或手动克隆:
- ```powershell
- 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"
- ```
- 提示词模式到这里即可使用。运行脚本需要 Python 3.10+;Windows 若默认 `python` 较旧,请改用 `py -3.12` 或已确认的新版本解释器。逐笔视频首次使用还需:
- ```powershell
- 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
- ```
- 完整 MP4 需要 FFmpeg/FFprobe;程序动画需要 Node.js、浏览器和 HyperFrames。详见 [安装](docs/INSTALL.md)、[配置](docs/CONFIGURATION.md) 和 [排错](docs/TROUBLESHOOTING.md)。
- 逐笔核心渲染不需要下载本地神经网络小模型或模型权重,也不要求 GPU;已有合格源图/线稿和旁白时,可以使用本地传统图像算法完成。首次安装 Python/npm 依赖需要联网,从文稿生成新插画或新合成刘飞配音则需要相应外部服务。
- ## 直接可用的触发提示词
- ```text
- 使用 $hand-drawn-explainer-video-nikola,把下面内容做成 45 秒中文手绘讲解视频。讲一部分画一部分,先画左边再画右边,重要结论用准确关键词后期写出;使用自然肤色 Q 版人物,先做代表镜头验证,再交付真实 MP4、SRT、时间轴和可编辑素材。
- ```
- ```text
- 使用 $hand-drawn-explainer-video-nikola,用小黑风格解释这个方法:纯白背景、稀疏黑线、少量红橙蓝批注。要真实逐笔落墨,不要只做静图缩放;字幕和关键词必须准确。
- ```
- ```text
- 使用 $hand-drawn-explainer-video-nikola,把这段内容做成手绘风流程卡片动画。使用可编辑 SVG/HTML,所有标题、数字和箭头关系必须确定性生成,并验证最终 MP4。
- ```
- ## 目录
- - `SKILL.md`:触发说明与总工作流;
- - `references/`:逐笔、双语义岛、程序动画、声音和质量规范;
- - `scripts/`:预检、配音辅助、最终合成和验证;
- - `vendor/srt-whiteboard-animation/`:带来源说明的 MIT 逐笔运行时,不含第二个 Skill;
- - `examples/`:公开样片、源图和可编辑工程;
- - `docs/`:安装、配置、架构、风格和排错。
- ## 安全与费用
- 仓库不含 API Key、Token、Cookie、个人绝对路径或私有模型。云配音、生图和视频服务都是可选能力,可能收费;请先 Dry Run、复用内容匹配的缓存,并避免在结果未知时盲目重试。漏洞和凭据泄露报告见 [SECURITY.md](SECURITY.md)。
- ## 许可
- Skill、原创脚本与文档使用 [Apache License 2.0](LICENSE)。`vendor/srt-whiteboard-animation/` 保留上游 MIT 许可。示例媒体按 [CC BY 4.0 媒体说明](LICENSE-MEDIA.md) 提供(仅限作者有权许可的部分)。第三方软件、人物姓名、产品名和商标不因此获得再许可,详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
- 欢迎阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 后提交新的风格预设、回归用例或渲染改进。
- ## 致谢
- 感谢以下开源项目及其作者分享思路、代码和可复用经验;本仓库只在各自许可与说明范围内借鉴或使用,具体代码来源边界见 [第三方说明](THIRD_PARTY_NOTICES.md)。
- - [kaomei/hand-drawn-video-prompts](https://github.com/kaomei/hand-drawn-video-prompts):中文口播分镜、Q 版蜡笔视觉规范与提示词工作流;
- - [geeklee/srt-whiteboard-animation](https://github.com/geeklee/srt-whiteboard-animation):SRT 语义分区、持续画布与 stream 连续笔迹;
- - [gnipbao/story-to-handdrawn-video](https://github.com/gnipbao/story-to-handdrawn-video):故事到手绘漫画、线稿/彩图配合与风格组织;
- - [ChenShuo2004/cs-board](https://github.com/ChenShuo2004/cs-board):完整白板视频工作台、骨架笔迹与生产流程方面的实践;
- - [heygen-com/hyperframes-launches](https://github.com/heygen-com/hyperframes-launches):HyperFrames 程序动画的镜头与合成范例;
- - [Vincentwei1021/video-shotcraft](https://github.com/Vincentwei1021/video-shotcraft):可复用镜头结构与程序化视频编排思路。
- - [helloianneo/ian-xiaohei-illustrations](https://github.com/helloianneo/ian-xiaohei-illustrations):感谢 Ian 开源“小黑”视觉 IP 与配图 Skill;本仓库的小黑风格借鉴了其黑色实心小角色、白点眼、纯白手绘、大量留白和少量红橙蓝批注的视觉语言。
- 向每一位愿意公开工具、案例和踩坑经验的创作者表示感谢。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.