adu-motion-video 是一套面向口播与知识讲解的 AI 剪辑 Skill，其auto-plan 自动选型功能可以一条命令同时比较11 种风格、54 套完整动效模板组，自动为你的口播和文案挑出最匹配的路线，并输出可直接构建的工程计划。你不需要在几十个模板里反复预览纠结，也不需要手写任何模板参数表。

什么是 auto-plan 全库自动选型

传统做法是"先选模板，再硬套内容"：你喜欢 01-A 原片节奏，但本期是产品对比内容，套上去总差点意思。auto-plan 反过来——先理解你的内容，再从整个模板库里选模板。

它的工作方式是：

1. auto-capabilities导出一张"全库能力表"，列出每套模板组的意图、阶段、数量、文字容量、动作窗和落点要求；
2. 执行助手通读你的整篇口播文案，按真实表达关系（主张、方法、证据、比较、拆解）整理出候选绑定，形成一份adu-auto-brief/1简报；
3. auto-plan把这条路线与单风格、混合风格的所有合法组合放在一起比较，选出"先满足内容约束、再兼顾风格统一与变化"的最优方案；
4. auto-build按选定路线生成可编辑工程，后续音频、渲染命令一路走完成片。

整个流程的入口是统一的流水线脚本 scripts/pipeline.sh，核心实现见 scripts/auto_templates.py。

参与比较的 11 种风格、54 个完整组

以竖屏（1080×1920）为例，当前共有 11 种风格、54 个完整镜头组参与比较，完整清单见 references/template-catalog.json：

横屏（1920×1080）则比较10 种风格、47 组——06-A 原生竖屏只支持竖屏，其余风格全部参与。模板包源码按"风格/版本"组织在 packs/ 目录下，例如 packs/classic-performance/1.1.1-candidate/。

开始前的准备：三种素材，无需手填模板

auto-plan 对普通用户的要求很低——你只需要提供口播视频 + 文案 + 真实素材，并说明要横屏还是竖屏。简报里的结构化字段（语义阶段、短句、素材绑定、落点）全部由执行助手整理，不要求你为每套模板手填一份 JSON。

几点提示：

• 选用了录屏、作品墙、头像的场景（如 03-A、04-A），请准备好本期有权使用的真实素材；
• 有 SRT 字幕或有词级时间码更好，但没有词码时不要臆测某个词出现的帧，让助手先做对齐；
• 本期配乐用music: {mode:"track", path, offset}显式绑定整首曲目；明确不要 BGM 才用{mode:"none"}。

auto-plan 三步速览：一条命令比较全库

核心命令只有三步（$PL即 scripts/pipeline.sh，Windows 上可直接用python scripts/pipeline.py）：

bash "$PL" auto-capabilities > 已有目录/能力.json bash "$PL" auto-plan 已有目录/本期auto-brief.json 已有目录/新全库规划 bash "$PL" auto-build 已有目录/新全库规划/auto_plan.json 已有目录/剪好口播.mp4 已有目录/新工程 --subs-js 已有目录/字幕.js

• 第一步把 54 组的能力描述导出成文件，供助手填写简报时对照；
• 第二步是"一条命令比较 11 种风格 54 套模板"的关键，输出一整套规划文件（auto_plan.json、report.json、spec.json、report.md等）；
• 第三步按选定路线构建可编辑工程。

简报里有几个对新手很有用的字段：

auto-plan 是怎么从 54 组里挑模板的

比较顺序是"先硬后软"：

1. 硬约束优先：语义阶段、元素数量、文字容量、实际媒体区间、完整动作窗、前后场依赖，任何一项不满足，该候选直接出局。缺素材的候选，无论影片多长，都不能靠"重复惩罚低"混过完整的路线；
2. 风格统一与变化：在全部合法的路线里，优先整片风格统一，再检查节奏——report.rhythm会标出连续同组、固定两三组循环、同类动作连用和超过 4 秒的过长停留；
3. 混合路线是恢复手段：只有在单一风格确实覆盖不了整片表达时，才会组合不同模板，且跨风格切镜使用明确切点，不做未经验证的形变桥接；连续使用同一包的镜头会合并为子工程，各自运行自己的布局与编舞。

这套"完整绑定永远优先于风格统一"的排序逻辑写在 scripts/auto_templates.py 的choose函数里。

看懂输出报告与退出码

auto-plan的输出目录会保存完整比较报告、选中的路线和可构建的分组 spec：

• 退出码 0：导入前绑定检查通过，可以进入auto-build；
• 退出码 2：已保存"待补/受阻"草稿——通常是缺素材或短句超容量，按report.nextActions修改简报重新规划即可（建议最多先试三轮）；
• 退出码 1：简报本身无效。

报告里selectedStyle告诉你最终选中了哪种风格，alternatives列出其他候选的状态与缺口，fontWarnings记录字体回退情况——原字体只是推荐项，缺失时自动使用随包 OFL 中英文字体，不会阻塞制作。

从规划到成片：audio、mix、render、check

构建完成后，剩下的是一条标准产线：

bash "$PL" audio 已有目录/新工程 bash "$PL" mix 已有目录/新工程 bash "$PL" render 已有目录/新工程 已有目录/新片_v1.mp4 bash "$PL" check 已有目录/新片_v1.mp4

混合风格的工程里，口播只导入一次，子工程沿整数帧取区间，根工程始终使用未变速、未重切的完整母版声音；字幕沿用全片时钟，动作音效的起音点、前奏与跨包尾音在全片时钟里合成。

⚠️ 机器检查通过（ready）不代表声画验收完成：风格切镜、真实人物裁切、复杂证据的可读性仍需你完整观看与试听。详见 references/automatic-selection.md 的验证范围说明。

auto-plan 常见问题

Q：我能锁定只用某一个风格吗？能。设置allowedStyles: ['01-B']，比较只在该风格内进行；缺能力时报告会如实给出缺口，而不是悄悄换到别的风格。

Q：口播比较长，一条路线装不下怎么办？提供segmentations：由助手依据真实台词给出其他完整分段路线（1–16 条），每条总帧数必须一致。不允许把同一段复制三遍，也不能用源演示的时间码假装新口播。

Q：报告提示缺字体，制作会失败吗？不会。默认策略下原字体只是"优先推荐"，缺失时自动使用随包字体并写入fontWarnings；只有你显式设置fontPolicy: "exact"才要求字体精确匹配。

Q：这算全自动出片吗？auto-plan 自动化的是选型与绑定校验，机器检查仍标记为 experimental；它不证明表达标注忠于台词，也不替代成片的连续观看与试听。完整测试记录见 docs/template-auto-selection-3.10.md。

延伸阅读

• 全库选型与长短素材适配：references/automatic-selection.md
• 模板与风格目录：references/template-catalog.json
• 3.10 全库测试记录：docs/template-auto-selection-3.10.md
• 能力矩阵：docs/capability-matrix.md
• Skill 总入口与命令约定：SKILL.md

准备好口播和文案后，从auto-capabilities开始跑一遍——54 套模板的比较，一条命令就够。