课程笔记讲解视频 akshayDev17/ai-explainer-video

explainer-video-from-coursework

把结构化课程笔记目录，变成带旁白的动画讲解视频系列。

这是给 AI 编程智能体用的技能——Claude Code、Codex、DeepSeek Harness 和 Antigravity 都能用。把它指向一个课程笔记文件夹：它会规划整个系列、撰写旁白、合成音频、编写视觉素材，然后渲染并组装出成品 MP4，附带可直接上传 YouTube 的章节和字幕。

它的规划器不只是编几个标题——它会证明完整性：每个承载内容的章节都被分配到一个视频，或被归类为导航（0 orphaned），这一切都发生在任何昂贵阶段运行之前。

流水线

阶段 0（/inputs）收集两件只有你能决定的事——源笔记目录，以及成品视频的落盘位置。

| # | 阶段 | 做什么 | 成本 |
| 1 | /plan | 拆解笔记，证明覆盖完整 | 免费，本地 |
| 2 | /enrich | 重拟标题并筛选（跳过 / 合并） | 免费，智能体 |
| 3 | /script | 撰写旁白分段 | 免费，智能体 |
| 4 | /audio | TTS → 一条实测时间轴 | 联网——消耗 Gemini key |
| 5 | /scene | 编写视觉素材（diagram / code / svg） | 免费，智能体 |
| 6 | /publish | YouTube 章节 + 字幕 | 免费——不跑 TTS，不用 Chromium |
| 7 | /render | 帧 → H.264 MP4 | 本地 CPU |
| 8 | /assemble | 分段部件 → 成品剪辑 | 本地 CPU |

阶段 1–2 对整个目录只跑一次；阶段 3–8 每个视频跑一次。一个视频从头跑到尾就是有效的停止点——可以做试点，也可以只跑单个目标。

安装

Claude Code

claude plugin marketplace add akshayDev17/ai-explainer-video
claude plugin install explainer-video-from-coursework@akshaydev17

Codex

codex plugin marketplace add akshayDev17/ai-explainer-video
codex plugin add explainer-video-from-coursework@akshaydev17

DeepSeek Harness

dsh plugin --profile web add explainer-video-from-coursework

Antigravity

agy plugin install https://github.com/akshayDev17/ai-explainer-video

这四条命令安装的是同一个 npm 包——一个包，三套清单入口，一份九个技能的副本。各平台如何读取它，以及如何发布，见 DISTRIBUTION.md。

前置条件

- Node ≥ 22——render.mjs 依赖内置的全局 WebSocket。
- ffmpeg + ffprobe——H.264 编码、封装、时长测量。
- 无头 Chromium——npx playwright install --with-deps --only-shell。
- Gemini API key——用于 TTS。它存放在操作系统密钥库（macOS Keychain · Linux secret-tool · Windows Credential Manager），服务名为 gemini-tts——绝不放进环境变量，绝不写进明文文件。免费 key：<https://aistudio.google.com/apikey>。

缺少前置条件时，这些工具会大声报错，而不是悄悄产出一个坏掉的视频。各操作系统的命令与出处： SETUP.md。

怎么用

带上笔记目录，调用这个技能：

/explainer-video-from-coursework path/to/your/notes/

每个视频产出一个 .mp4，外加 description.md（简介和一段可直接粘贴的章节块）和 captions.srt，都会复制到你选的目标目录——默认是源目录旁边的 videos/。中间产物留在 gitignore 的 out/<name>/<NN>/ 里。

所有命令都要在项目目录下运行（也就是 out/ 所在的地方），不要在技能的安装目录里跑。工具会自己定位 tools/、src/ 和 scenes/，所以只有工作路径和中间产物路径跟当前目录有关。

仓库结构

plugin.json Agent Plugins manifest (Codex, Antigravity)
.claude-plugin/ plugin.json + marketplace.json (Claude Code)
.agents/plugins/ marketplace.json (Codex)
cordis.patch.yml + lib/index.js DSH bundle plugin (serves this package's skills/)
skills/explainer-video-from-coursework/ the main skill: SKILL.md, tools/, src/, scenes/, SETUP.md
skills/craft-video-<stage>/ the 8 stage skills, separately invocable
DISTRIBUTION.md publish + install commands

文档

| 文件 | 内容 |
| SKILL.md | 正式契约——智能体的入口 |
| SETUP.md | 各操作系统的机器前置条件，附引用 |
| ARCHITECTURE.md | 各部分如何拼在一起 |
| PIPELINE.md | 逐阶段的流水线 |
| ROADMAP.md | 设计记录与待办 |
| DISTRIBUTION.md | 发布，以及在各平台上的安装 |
| RELEASING.md | 一次发布怎么走——打标签，不是敲命令行 |

许可证

MIT——见 LICENSE。