Adu Motion Video

adu-motion-video

当前为 3.14.0-rc.1 兼容性升级候选，实际默认映射以 template-catalog.json 为准。新增候选接入横竖屏选型，旧版本可显式使用，稳定验收不追认到新增组；读升级范围与验收。最终效果待用户同视频 A/B 确认。

用户提供剪好的口播视频、文案，最好还有新口播的时间码字幕；选用含录屏、作品墙、头像、标识或配乐的场景时，还须提供本期有权使用的素材。你负责把完整场景编舞适配到新台词与片长，生成可编辑工程，核查后导出新 MP4。先读 制作约定。SKILL_DIR 是本文件目录，PL="$SKILL_DIR/scripts/pipeline.sh"。 制作记录保存实际 Skill 路径、版本和所用入口；同名旧安装、仓库版本与已生成工程的冻结运行代码可能不同，不能用最新版说明追认旧工程。

引导用户开始创作

用户说“加载这个 skill，引导我开始创作”“加载 adu-motion-video Skill，引导我开始创作”或询问怎样开始时，读开始创作引导，在读取成功后发送简短的素材引导：先发已有口播/文案/音频、视频方向及横竖屏；SRT、录屏、图片、Logo、配乐有则一起发，模板未选时由助手推荐。清楚说明附件/本地路径的提供方式及最终 MP4/可编辑工程交付。已有输入直接检查推进，缺项逐步补齐，不强制用户一次填完技术表格；修剪仍默认 off。

平台与助手

同一份 Skill 面向 Windows、macOS、Linux，可由 Codex、Claude Code、豆包、DeepSeek、WorkBuddy 等助手使用。先确认助手执行环境能读写素材并运行命令；有 Skill 机制就加载本文件，否则先读取本文件和 AGENTS.md。不凭助手名称推定当前客户端具备本地执行能力。

优先使用跨平台 Python 入口：Windows 原生 python scripts/pipeline.py 命令，macOS/Linux python3 scripts/pipeline.py 命令；旧 Bash/WSL 入口调用同一实现。下文 bash "$PL" 命令 在 Windows 可直接改用实际 Skill 路径的 python scripts/pipeline.py 命令。按 兼容说明检查路径、字体、浏览器及可选人脸跟踪。指定字体仅优先推荐，缺失/不匹配时自动使用随包 OFL 中英文字体，并记录替换及实际文件摘要；不得要求用户补推荐字体才选型或构建。精确字体复刻只在用户明确要求时选 fontPolicy="exact"。已有 macOS 验收记录描述的是实测环境，不能据此拒绝其他平台的制作请求。

选择入口

用户指定模板编号（如 01-B）或要求选风格时，先读模板与风格目录，按“一级模板 → 二级风格”映射到显式包版本。未发布风格不能按已发布包承诺制作。需要辅助动画素材时，按公开动画素材 API检索并下载到本期工程，再核对所选包的媒体与渲染要求。

用户要求竖屏时，按目录的 portraitSelection 选择对应候选版本，并读取竖屏契约。当前十一种风格、54 个完整组参与竖屏选型，均支持 brief.layout="portrait" → macro-plan → macro-build → render，画幅自动为 1080×1920；旧 1.0.0 稳定包不获得追认。原动作、素材、字幕与音效时钟保持；标题、人物与内容层重排，控制台连接线按原激活落点重绘。候选必须做本期真实素材连续声画检查，几何测试不能当作新路线已验收。

用户新增完成工程、提炼新镜头组或更新模板库时，读持续模板接入。先登记来源和实际状态，再按价值提炼；收到工程不代表已经有可发布模板。bash "$PL" packs 只列包的语义与版本元数据，按任务加载相关清单；同一 ID 有多个版本时显式选择 id@version。

用户指定 03 · 深色 3D / 03-A · 多屏展陈 时，读深色 3D 模板，本次横竖屏均选择 anim4-showcase-macro@1.3.1-candidate，九场有名输入与新增独立成果入口的范围见质量升级说明；旧横屏基线为 anim4-showcase-macro@1.1.1-candidate 并声明 layout。它保留九场作品墙、多屏比较、重点放大与软件窗口编舞，新增 1080×1920 原生竖屏布局。1.1.1 补齐 HDR 抽帧和 SDR 导出色彩核验；此前冷安装记录属于 1.1.0，当前仍待作者连续声画确认；按本期材料选择完整场景，不计入十七个稳定组。旧 1.0.0 保持原字节。

1. 默认运行 bash "$PL" packs，按表达目的选择显式版本，读取相关包的 README.md 与 manifest.json，并查看完整工程复用说明。classic-performance@1.0.0 保留错峰、人物回应与回稳，共三个已验证组；continuous-performance@1.0.0 保留同物件变形、拆解与闭合，共两个已验证组。paper-balance@1.0.0 是一个纸面透视续接组。既有稳定验收记录使用 macOS 1080p60，不代表整份来源或任意文案已模板化；逐组边界见能力矩阵。旧候选版本保留，B 的计划干扰组仍在候选中。旧 anim3/anim4 分别有 12/9 个完整场景，仍为 experimental。包 ID 与原片标题、品牌无关。 C/D/E 的 stage-performance@1.0.0、editorial-performance@1.0.0 与 kinetic-performance@1.0.0 各有三个稳定组，分别保留前后层与人物让位、分栏与跨栏交接、整词与实体回应。每条路线都由未参与提炼的执行者从冻结公开包和本期输入独立制作一部 99.5 秒新片，作者确认成立。旧候选原字节保留；本期桥接不计作公开稳定组。
2. 只需轻量短片、探索版式时，使用 9 个基础 TPL；它们是 quick-start，不包含完整工程包里的全部动作。
3. 手绘角色、补录同镜头续接，读手绘动画方法。目前没有对应完整工程包，不要把方法文档称为已自动模板化。

3.3.0 新增 02-B · 纸面聚合 paper-ball-performance@1.0.0：六类资料聚合成网络，以及七步日历、六类能力、三项开箱和交付卡堆叠两个稳定组。源/重放对照与 18.2667 秒不同内容样片已获作者声画确认。需要本期真人口播/文案，标题字体优先推荐原字体，缺失时由随包字体回退；详见包说明。这是组级增量，不是新整片路线；严格栅格问题保留在 review.json。3.2.0 的十五个稳定组与旧候选均保持原字节，当前七个风格共十七个稳定组。

3.8.0 新增 05-A · 鲜色角色叙事 vivid-sticker-performance@0.1.1-candidate，读取专门说明。三组分别为关键词递进到结论、两准备者向三接收者交接成果、三反馈汇入后升级。首版已提供横竖屏、命名槽、固定数量和完整动作窗；源码局部、静音文案与真实构建检查不等于新口播连续声画或独立复用已验收。

完整工程包流程

3.6.0 新增当前分镜局部重配和素材版本检查，并为通用视频抽帧接入共享色彩处理。04-A · 仪器台演示 历史候选 doubao-console-performance@0.1.2-candidate 增加有界文字布局，原 0.1.1 三组的同内容技术重放仍保留；静音新文案检查不代替新口播完整声画或独立复用验收，详见模板说明。新预览统一使用带导出证据与版本检查的 preview 命令。

用户未锁定单一风格，或要求自动比较全部模板时，先读全库自动选型，运行 auto-capabilities。助手根据整篇台词整理语义阶段、短标题、真实媒体和准确落点，形成 adu-auto-brief/1，再执行 auto-plan → auto-build。当前 11 种风格、54 组参与竖屏比较，其中 10 种风格、47 组也参与横屏比较，优先完整可用的统一风格；必要时仅在有独立入场合同的组间组合。长段提供有实际内容依据的完整分段路线，不循环补时长。用户锁定风格就设置 allowedStyles；不要让用户手填各套字段。构建会重验选型和素材，混合工程保持全片口播/字幕时钟与音效尾音，整片显式绑定同一首本期配乐，须连续试听。机器检查仍为 experimental，详见本轮测试。

新文案先按系统适配机制形成 brief.json，运行 bash "$PL" macro-plan 包ID@版本 brief.json 新规划目录。该入口按语义阶段、数量、原速动作窗和前后场依赖筛选，再在合法组合内减少效果重复。当前横屏 10 风格/47 组、竖屏 11 风格/54 组已有版本绑定的适配 profile，能力仍为 adaptation-experimental。输出 spec.json/report.json/report.md/profile.json；退出码 0 为绑定检查通过，2 为已保存待补或受阻草稿，1 为无效输入。媒体或真实关键词时码缺失时修改 brief 并重新规划，不填源演示时码。macro-spec 保留为历史/人工配方入口，它不提供这层语义与邻接诊断；新制作优先沿用带 adaptation 的计划，构建会重新验证。

已有计划新增素材时，按局部分镜重配运行 macro-rematch，检查建议后通过 macro-apply-rematch 保存到新目录。固定原段语义、时间和其它分镜，重验媒体与双侧接缝；基线或素材已改变则拒绝应用。没有兼容新组时保留原组，不随机换效果、不猜其它模板的文案映射。此接口供制作工具调用，尚不等于已接入 ADuDir 拖放界面。

1. bash "$PL" doctor 检查 Node、Python、FFmpeg 和 Chrome；缺依赖且允许安装时再 bash "$PL" setup。保持源工程和原成片只读，输出到不存在的新路径。
2. 先锁定用户指定的模板来源。素材目录里的其他 anim、新工程或旧成片不自动成为动画底稿；不能只插入少数模板片段就称整片使用了指定模板。逐场记录来源包与场景 ID，混用完整包见来源与多包编排。对齐新口播和文案，取得关键台词的准确时间。SRT 只有整句时间时，不可臆测句内某个词的时间；用逐词对齐数据或人工标注。读包的 role、cues、motionWindows、slots，按意义挑选、重排或重复完整场景。先列出分镜和缺少的素材。
3. 按新口播编写 brief，运行 bash "$PL" macro-plan 包ID@版本 /路径/本期brief.json /已有父目录/新规划目录；查看报告，缺项回到 brief 补齐后重新规划，使用生成的 spec.json 构建。在渲染前按复用内容核对核对阶段与真实台词、关键事件落点、素材身份及全片重复。规划器检查声明的结构，不会判断填写的阶段是否忠于台词。仅人工维护历史配方时使用 macro-spec，它的 cue 留空，示例文字及原片时长只供认识接口；必须填写本期内容与实际时码，不能给每个重复组机械加同一偏移。brand 填本期账号。本期音乐必须用 music:{mode:"track",path,offset} 显式绑定；缺曲目就 needs-binding，旧源合成底乐已淘汰。只在用户明确不要背景音乐时使用 music:{mode:"none"}，动作 SFX 保留。人物窗优先使用 macOS Vision，Windows/其他环境使用本地 OpenCV；检测不可用时使用宽幅固定构图并提示复核眼睛、嘴巴和下巴，不能把回退说成跟踪通过。也可显式配置 faceTracking:{mode:"fixed",cx,cy,h}。任何来源演示数据与示例文字都须替换或明确标“示意”。素材的空路径代表缺项；媒体准备与容量限制看包目录中的 README.md。
4. bash "$PL" macro-build 包ID@版本 /路径/新规划目录/spec.json /路径/剪好口播.mp4 /路径/新工程 [--subs-js /路径/字幕.js]。新口播长度应与计划总帧数相符。适配器把关键动作窗口锁在原速，较长段落只伸展可停留区；如果时间不够，会报错，改分镜或片段长度，不靠全片线性拉伸。缺文字、数字、媒体或关键 cue 也会报错。
5. bash "$PL" stills /路径/新工程 0,4,12,... 抽查首帧、每个 cue 前中后、最长文字、场景接缝和片尾；小圆窗需看到双眼、嘴巴和下巴，fixed 参数须从本期素材确定并检查低头、抬头等极端姿态；再播放所有复杂运动区间，与原工程对照。检查字体、媒体比例/裁切、真实口型、字幕、SFX 与音乐。修订配置或工程并重新验证。
6. bash "$PL" audio /路径/新工程 → bash "$PL" mix /路径/新工程 → bash "$PL" render /路径/新工程 /路径/新片_v1.mp4 → bash "$PL" check /路径/新片_v1.mp4。完整观看并听取最终编码文件；check 的帧数、解码和响度不能替代视觉与内容验收。新预览统一通过 bash "$PL" preview /路径/新工程 /路径/新片_v1.mp4 /已有父目录/新预览目录 发布，绑定真实成片 SHA，显示播放版本并提示旧标签页更新。HDR/DV、源位深和元数据风险须按素材色彩与预览留下实际对照证据，不只检查标签。