图文教程：用 Jianying Headless 让 AI 帮你剪映，草稿可直接精修

第一步：下载源码包并准备环境

到本站「AI插件」栏目下载《Jianying Headless 源码包》，解压到固定目录。

macOS 用户准备：Apple Silicon Mac、剪映专业版 11.5.0、Python 3.9+ 和 Xcode 命令行工具；Windows 用户可走 FFmpeg 导出路径，无需安装剪映。

第二步：环境体检（doctor 命令）

进入解压目录，先构建本机编解码组件：python3 tools/build_native_codec.py。

再运行 python3 skills/yichen-jianying-edit/scripts/headless_draft.py doctor，它会检查剪映版本、组件身份和必要工具。检查通过才继续下一步。

第三步：写剪辑计划并构建草稿

参照 examples/basic.plan.json 写自己的计划：视频放哪条轨、每段几秒、字幕说什么，全部用 JSON 描述。

运行 build 命令生成草稿：python3 headless_draft.py build --plan 计划.json --out work/new-build，再用 verify-build 校验草稿完整性。

素材路径必须换成你本机有权使用的文件。

第四步：登记到剪映首页并导出成片

保存当前工作并完全退出剪映，运行 publish 命令把新草稿登记到剪映首页；打开播放、保存重开确认无误。

需要成片时运行 export 命令，输出目录里的 render.mp4 就是导出的 H.264 视频。后续想改，回剪映里手工精修即可。

官方案例验证：23 条轨道、154 个片段的完整工程可正常交接导出，1507 帧逐帧检查通过。