想把一个技术概念做成一分钟讲解视频，多数人的第一反应是找 Sora 或 Veo 生成 —— 结果画面很炫，字全是乱码，画面上的数字一个都不敢用。第二条路是自己开剪辑软件，一帧一帧摆元素，做一条四分钟的片要熬夜。
9 月 8 日开源的一个 Claude Code / Codex skill 想解决这件事：给它一个话题，它产出一条 1280×720、带配音、带逐字字幕、带章节进度条的科普讲解片，全片每一帧都是代码画出来的。上线三天多，954 星、172 个 fork —— 这是我这两天见过涨得最快的 AI 视频方向仓库。
它到底交付了什么
先纠正一个预期：它不是一个「一句话出片」的工具。作者在 README 里写得很直白：这不是 CLI，交付的是「一个 AI 编程 agent 拍完一条片所需要的全部方法」。
拆开看是四层：
| 层 | 内容 | 规模 |
|---|---|---|
| 流程 | SKILL.md：9 个阶段、4 个确认点、8 条硬性原则 | 86 行 |
| 规范 | reference/ 九份文档：风格、动效词汇、构图与光、配音分镜、多 agent 协议 | 687 行 |
| 工程 | 可编译的 Remotion 4 模板 + 图元库 + 11 个脚本 | 7998 行 TSX/TS + 768 行 Python |
| 标尺 | 样片《RAG 与知识库》全套档案：调研、解说词、分镜、44 个镜头源码、QC 报告、成片帧 | 8246 帧 = 4 分 35 秒 |
真正稀有的不是模板，是把审美写成了可判定的数字。 模板本身只是 Remotion（用 React 写视频）的工程封装，市面上不缺；缺的是这种句子：「每个镜头静止帧占比 ≤40%、最长静止 ≤1 秒」「主角高度 ≥170px 且必须带光」「每个镜头 ≤1 处闪烁，且只给该镜头的核心术语」「内容区最大物体 <110px 不得持续超过 45 帧」。这些数字不是宣传语，仓库里有对应的检测脚本。规则可判定，才谈得上验收。
它怎么跑一遍
它的运行方式更像一个剧组，而不是一个按钮。九个阶段里，主会话只做编排与验收，调研、打样、构建、QC 都是派出去的 agent：
- 调研 1 个 agent 先产出带来源的调研文档（样片那份 29222 字符、128 个 URL，覆盖定义的每条数字）；画面上出现的每个数字、年份、英文术语都必须能在调研文档里查到出处，没核实的不许上画面。
- 写完解说词后
tts_build.py用词级边界把每句切成字幕块，直接算出每句的起止帧号，写进时间轴与字幕表。
- 主会话定分镜、补图元，先只派第 1 组做出前 30 秒给你看，确认风格后才并行派剩下的 7 组。
- 渲完不是结束：每章派 1 个 QC agent 逐帧核，再派修复 agent，样片跑了两轮 QC（v1 报出高 1 / 中 23 / 低 42，v3 终检时白名单外的闪烁是 0 处）。
我核对过它的时间轴算术：8246 帧 = 274.9 秒、44 句净朗读 249.9 秒、留白 25 秒占 9% —— 全部对得上。这不是拍出来的片子，是算出来的。
代价也写得很清楚：一条 4 分半的片子，约 2 小时、8 个构建组并行 40 分钟、磁盘预留 5GB 以上。
实测：模板能编译，工具链有坑
我在手机上（Android 内的 Alpine Linux aarch64 沙盒，Node 22）clone 了仓库实测，宣称与实测对比如下：
| 项目 | 仓库宣称 | 实测结果 |
|---|---|---|
| 模板可编译 | 开箱 npm install + tsc |
250 个包 / 263MB / 36 秒；tsc --noEmit 15 秒，0 个类型错误 |
| 静态自检 | 几秒查帧覆盖、闪烁白名单、字面量 | 44 个镜头全覆盖；但报 18 个问题，其中 17 个是误报 |
| 默认配音 | edge-tts 免费云端合成 | 44 句里 34 句拿到音频，随后一句连续 4 次重试失败，脚本当场退出 |
| 成片渲染 | 无 GPU，CPU 渲染 | 没跑通：需下载 chrome-headless-shell，下载源不通且无 linux-arm64 版 |
| 跨平台 | macOS 验证过，Linux 应该能用 | 5 个 shell 脚本写死 #!/bin/zsh，建项目第一步就中止 |
自检脚本那 17 个误报值得单独说：脚本要求闪烁白名单以固定格式内联写在分镜表里，而样片的分镜表写的是「白名单见 AGENT_RAG_BUILD_RULES.md §8」，正则抓不到，白名单被读成 0 条，19 处合规闪烁全部标红。唯一那条真问题也很有意思 —— SC27 的代码帧区间比分镜表多 4 帧，注释写明是第二轮 QC 故意做的淡出重叠。也就是说：这条检查只能报「对不上」，不能判断「是不是有意为之」。
sed -i '' 是 BSD 语法，在 Linux 上会报 No such file or directory 然后中止。同一个问题也出现在仓库第 4 号 PR 里：有人在树莓派 5 上端到端跑通了一整条片，顺手把 zsh、BSD sed、ARM 上的 TTS 与系统浏览器配置一起修了，目前还没合入。
有意思的是它自曝的返工日志
仓库里最有价值的文件可能是 reference/lessons.md（199 行）。作者用这个 skill 拍了至少 4 部片，每踩一个坑就写一条根因，其中几条是自曝：
- 样片自己不合格。 第 4 部片加入「持续动作」规则后，回头量化样片：4/6 镜头静止帧占 42%–72%、最长静止 2.8 秒，全部超过新规则。作者原话是「样片也有同样的毛病，所以『对标样片』筛不出它。」
- 检测分级会骗人。 组级低分辨率检测 48/48 全部通过，成片复测却有 11 个镜头超限（3 个真静止、8 个只有小面积动作）。于是流程里写死了：成片复测才算判据。
- 一个静默降级的 bug 藏了很久。 edge-tts 从 7.2.0 起默认不再返回词级边界，脚本拿不到词边界就退化成「按字数插值」估字幕位置。作者实测最大偏差 15 帧 —— 整块字幕晚半秒，并承认「这个洞在所有 edge 引擎的成片里一直存在」。
一个项目敢把自家样片的实测短板写进仓库，比任何宣传语都有说服力。
谁适合，谁别碰
先划清路线：这类需求和 OpenMontage 那种「121 个工具调云 API 出片」不是一条路 —— 后者靠生成模型要素材，它一帧都不用生成模型，全部代码绘制，所以任何一帧都能改、每个数字都能追到来源。另一条路是 Manim / Remotion 手写，它比手写多的正是那套流程和判据。
适合：做技术科普、课程、产品原理动画的个人或小团队，愿意花约 2 小时等一条 4 分半的片，并且看重「画面上每个数字都能溯源」。中文是一等公民，文档中文优先，还有独立的英文片配置。
不适合：想一句话出片的人 —— 它会在写文案前、配音前、定稿前、前 30 秒样片这四个节点停下来等你确认；要竖屏的人（模板与安全区全部按 1280×720 横屏）；以及任何商业用途。
商业许可这条不是假设。项目用的是 PolyForm 非商业许可，商用需要作者单独授权，而仓库第 5 号 issue 就是一位教育自媒体在问商业授权怎么办理、是否支持多个账号、能不能改模板做竖屏 —— 截至今天，作者没有回复。
结论
三天 954 星、172 个 fork，说明「把内容变成讲得清楚的视频」这个需求是真实的。但它的价值不在自动化，而在它把一件靠审美的活儿拆成了可验收的工程步骤 —— 从 把审美纪律编译进 agent 到 把方法论写成 skill，这条路数上的极端版本就是它。多数 AI 视频工具还停在「能不能生成」，它已经在回答「能不能验收」。
值得放进观察清单。但真正上手前，先把 zsh / sed 和默认 TTS 这两个动手就遇到的坑解决掉。
关注 AI商业快讯，每天一篇 AI 热点深度解读。
