adu-motion-video：选个模板丢口播素材，AI 直接剪成 60fps 成片 + 可编辑工程（11,028 Lottie 素材）

一、它是啥：选个模板 + 丢口播素材，AI 剪成 60fps 成片（阿杜 × Opus 5.5）

仓库 adunext/adu-motion-video（简称 adumotion）一句话：阿杜实验室与 Opus 5.5 一起精选、制作的完整动画工程包 + 一套 Skill——你选好「一级模板 × 二级风格」，把剪好的口播、文案、录屏素材交给 AI，它按模板的完整场景编舞把新内容适配进去，交付MP4 + 可编辑工程。仓库描述原话：「选模板和风格，用 Codex / Claude Code 把口播与素材剪成视频；提供 11,028 个精选 Lottie 动画素材 API。」

先按数据红线实查（2026-10-05 查）：★115 / fork 17 / MIT / JavaScript / 约 24.7MB / 09-28 建、10-04 还在推（活跃）/ 1 个 open issue。10-15 复查：★324 / 37 forks / 10-14 仍在推（活跃）——数字活着，引用以当天 GitHub API 为准。。当前 Skill 版本 3.13.0-rc.2（SKILL.md front-matter 写的）。它不是「给你一堆散动效」，是一套带验收矩阵的完整工程包 + 一条可复现的剪辑流水线——下面几节全是只有 clone 下来读 scripts/、packs/ 才写得出的机制。

二、先把口述的「网页交互」跟仓库实查对一遍（红线差异）

我手上收到的口述把它描述成「给 AI Agent 用的网页动画技能：① 鼠标跟随（人物/卡通随光标 360° 转头）② 滚动驱动的一镜到底（随下滑进度播连贯镜头、任意帧可定格）③ 两者可叠加」。按数据红线我把仓库全量 grep 了一遍 scroll / mouse / cursor / 鼠标 / 一镜 / 360 / follow / parallax，结论要如实写——

• 「鼠标跟随 360°、滚动一镜到底、可叠加」这套网页交互，仓库里没有。 grep 命中的 scrollWidth 全在 typography.js（做文字排版的溢出检测）、minFollowingFrames 全在音频（音效帧跟随），没有任何「跟随光标 / 随滚动播镜头」的交互代码。它的核心产物是视频（MP4），不是可交互网页。
• Lottie 是「静态动画素材」，不是「网页滚动引擎」。 那 11,028 个 Lottie 是给人物旁白、图标、点缀、辅助讲解用的动画 JSON，下载到工程里当素材，由 AI 剪进视频；它不负责「网页随滚动一镜到底」。
• 「配 API Key」也不对：README 明写 Lottie 素材 API「无需登录或 API Key」（每 IP 每天 20 次、全接口每天 2,000 次、北京时间零点重置，超额 429）。口述的「配 API Key」是把「给 Agent 发消息就能用」的门槛说重了。

所以这篇文章按仓库实查写主线——「口播视频自动剪辑 Skill + 11,028 个 Lottie 素材」，口述那套网页交互我如实标注为未核实、不照搬，就当你对它有兴趣的另一个方向提一句（见第六节）。

三、模板库：2 类已发布 · 7 风格 · 17 镜头组（候选还在长）

它把「一条完整动画片」拆成一级模板 → 二级风格 → 镜头组三层，模板号不随话题变（比如 01-B 永远是「现代图文口播 × 连续形变」那种编舞）。README 实查（截至 10-05）：已发布 2 类模板 · 7 种风格 · 17 个稳定镜头组，另有深色 3D / 深色科技控制台 / 鲜色角色叙事 / 活力色彩等一批候选（3.13.0-rc.2 竖屏已达 11 风格 / 39 组，横屏 10 风格 / 47 组）。两类已发布：

• 模板 01 · 现代图文口播（5 风格 · 14 组，已发布）：真人讲解 / 知识拆解 / 工具演示。五个风格各管一类编舞——01-A 原片节奏 / 01-B 连续形变 / 01-C 纵深舞台 / 01-D 杂志分屏 / 01-E 节拍字效，都是「完整场景包」，保留原片的运动、人物、声音编舞，只把新内容适配进去。
• 模板 02 · 纸面透视讲解（2 风格 · 3 组，已发布）：两难选择 / 抽象观点 / 资料聚合。天平、聚合成网络这类纸面透视编舞。

候选（还没进稳定库）：03-A 深色 3D · 多屏展陈（9 场，横竖屏）、04-A 深色科技控制台、05-A 鲜色角色叙事、06-A 活力色彩（原生竖屏 7 组）。这些状态都是 candidate / experimental，README 反复强调「候选不等同于已验收，完整连续声画还需作者确认」——这条边界它自己写得很诚实。

四、机制：一条能复现的剪辑流水线（读 scripts/ 才见得到）

它最值钱的是把「剪辑」做成了一条命令可复现的流水线，入口是 scripts/pipeline.sh，一条 PL 打天下。我把 packs（列全部模板包）真跑了一遍（本地 51M clone，exit 0），返回的是真实结构化 JSON 目录——每个包带 id / version / status / roles（逐场景描述）/ units / layouts：

# bash scripts/pipeline.sh packs   （真跑，exit 0，节选）
{
  "id": "anim3-card-continuity",
  "version": "legacy-rc.2",
  "status": "experimental",
  "units": 12,
  "roles": ["双行问题入场，人物卡弹入，关键词重击与物件弹起",
            "中心人物联通六个任务节点，数据包沿曲线流动，停机时整网灰化",
            ... 12 个完整场景 ...],
  "layouts": { "landscape": { "width": 1920, "height": 1080 } }
}

完整链路（README「开始使用」+ SKILL.md 实查）是这几条命令串起来的：

bash "$PL" doctor                    # 环境体检（Node18+/Python/FFmpeg9+/Chrome）
bash "$PL" setup                     # 装依赖（Windows 走 WSL）
bash "$PL" macro-plan  包ID@版本 brief.json 新规划目录   # 语义选型 + 生成 spec
bash "$PL" macro-build 包ID@版本 spec.json 剪好口播.mp4 新工程   # 编舞→工程
bash "$PL" stills / mix / render     # 抽帧 / 混音 / 渲染 MP4（60fps）
bash "$PL" check   成片.mp4          # 帧数 / 解码 / 响度 校验

三个「只有读代码才写得出」的机制点：

① 模板级开源，Token 省在「编舞已冻结」。 README 明写「完整动画已经做好，AI 主要处理文案、素材和时间安排，减少从零编写动画与反复试错的消耗」。它不是让 AI 现画动效，而是把「场景编舞」冻结成可复用的完整包，AI 只做新内容 → 场景的语义映射（macro-plan 的 brief.json 按语义阶段/数量/动作窗筛选）。

② 版本冻结，旧片不会被新版追认。 packs/ 里每个包带 id@version（如 classic-performance@1.0.0），SKILL.md 反复强调「包 ID 与运行代码固定在新工程，后续升级不会自动改变旧片；不能用最新版说明追认旧工程」。这是「同一系列保持质量一致」的工程化关键——它把「哪个版本剪出的」钉死了。

③ 色彩证据 + 验收门禁，不「看着像」就交付。 3.3.1 加了 HDR→SDR 转换 + BT.709 色彩范围校验；check 命令核帧数/解码/响度；README 明写「命令通过 ≠ 视觉验收通过，任何一项没做完只能标 experimental 或局部通过，不能宣称完整复刻验收」。它把自己「待验收」的状态也如实标在每个候选包上。

五、Lottie 素材 API：11,028 个动画，无需 API Key（实查）

「阿杜导演」的公开动画素材 API 是这套东西的另一半——11,028 个精选 Lottie 动画，按需下载到工程里做图标、点缀、辅助讲解。我实查了目录接口（GET /api/lottie-catalog/manifest）：

# curl -fsS https://adudir.com/api/lottie-catalog/manifest   （实查）
{ "version": ..., "total": 11028, "entries": [
  { "preset": "0101bt_tt_01", "category": null, "title": "Comp 1",
    "layers": 2, "duration_s": 3.29, "has_text": false, "anchor_max": 0.7 },
  { "preset": "0101ftue_04", "title": "Map_language", "layers": 7,
    "duration_s": 8.0, "has_text": false, "anchor_max": 0.55 },
  ... 11028 条 ... ] }

# 按 preset 下载单个动画（实测 200，3109B，合法 Lottie body）
curl -fsS https://adudir.com/api/lottie-catalog/file/insider_loading.json
# → { "v":"5.5.5","fr":25,"ip":0,"op":79,"w":300,"h":150,"nm":"Loading-2", ... }

额度：每 IP 每天 20 次、全接口每天合计 2,000 次、北京时间零点重置，超额返回 429（按 Retry-After 等）。用法很克制——README 专门叮嘱「先查目录与注解，再按 preset 下载需要的 JSON，保存到本期工程的素材目录，避免每条视频都重新拉全库」。仓库 MIT，但第三方 Lottie 素材沿用各自原许可，仓库协议不替代素材许可（THIRD_PARTY.md 有列）。

六、横向对比 + 坑边界 + 我的判断

适合谁：手里有剪好的口播 / 讲解 / 工具演示素材、想快速出「带完整动效的成片 + 还能再改的工程」的人。把仓库链接丢给 Codex / Claude Code / 豆包 / DeepSeek / WorkBuddy（它跨助手），说一句「加载 adu-motion-video，引导我开始创作」，再报模板编号 + 素材目录就行。

不适合 / 坑：① 没有剪好的口播 + 素材，它就转不起来（它吃「成品素材」，不吃「从零想」）；② 候选模板（03/04/05/06）还是 candidate/experimental，连续声画没验收完，拿它们当稳定生产工具会翻车；③ Windows 得走 WSL，字体/系统/Python 组合换了要重跑 doctor；④ Lottie 素材吃每日额度，别每条视频重拉全库；⑤ 第三方 Lottie 沿用各自许可，仓库 MIT 不覆盖素材。

回到口述那个方向：如果你确实想要的是「鼠标跟随 360° + 滚动一镜到底的网页动画」，那 adu-motion-video 不是那个仓库（我全仓 grep 验证过，它做视频不做网页交互）。那个玩法更贴近「Lottie/Three.js 网页组件 + 滚动驱动」的自定义前端，或本站 awesome-opus5-5-videos 里「让 Opus 写代码出网页动效」的 prompt 思路——别把口述的能力记到 adu 头上。

七、10 月升级：全系列迁到 MotionGit .motion 开放格式（10-05 后新增）

137 首发（10-05）时，模板还是仓库里的目录包。10 月中旬阿杜把全系列模板升级成 MotionGit 平台的 .motion 开放格式（仓库 README 现开头即「全系列模板已升级为面向 AI 创作的 MotionGit .motion 开放格式」）。口播常说「AI 时代的全新视频格式」，这里把升级讲清、并纠一句：.motion 不是视频容器（不是 mp4 那种）。

• .motion = 给 AI 用的完整动画模板包，把代码级动画、画面布局、时间轴、转场、音效编排、可替换内容、使用引导、运行说明全打进一个文件。README 原话「.motion 是给 AI 使用的完整动画模板包，不是提示词，也不是参考视频」。AI 读取后按你的口播/素材填内容，导 MP4 + 可编辑工程——它是「模板包」的单位，不是「视频」的单位。
• 卡片那个 motiontemplates/385712 是平台镜像仓，不是主仓：MotionGit（motiongit.com）把每个模板自动推一个公共 GitHub 镜像（★14 / org「motiontemplates」查无 / 10-12 建），真主仓始终是 adunext/adu-motion-video（10-15 实查 ★324 / 37 forks / MIT / pushed 10-14）。
• 「请 AI 识别地址开始创作」真路径：motiongit.com/@adunext 下载 .motion 文件 → 连同你的口播/文案/录屏一起丢给 Codex / Claude Code → 助手按模板说明创作。平台页 10-15 探活 200，.motion 下载入口在。

一句话总结：升级把「clone 仓库里的模板目录」变成「下一个 .motion 文件发给助手」，门槛更低、更跨助手；核心机制（编舞冻结省 token、11,028 个 Lottie、验收门禁）没变，变的是分发与调用方式。