Jianying Headless：用 Python 和 Agent 自动生成可编辑剪映草稿，并调用本机引擎导出视频
摘要
Jianying Headless 是面向 macOS 剪映专业版的本地自动化项目，可用 Python 和 Agent Skill 根据结构化计划生成可编辑草稿、修改多轨工程并调用本机引擎导出 MP4。本文介绍其核心功能、Hypit 工程交接案例、环境要求、命令行操作、使用限制与非商业授权边界。
本文目录
图片来源：项目 GitHub 仓库
Jianying Headless：用 Python和 Agent自动生成可编辑剪映草稿，并调用本机引擎导出视频
AI可以生成脚本、配音和画面，但把这些素材交给剪辑人员时，只有一条合成视频往往不够：文字、镜头和音频很难再分别调整。Jianying Headless是面向 macOS剪映专业版的本地自动化项目，尝试解决从结构化剪辑计划到可继续修改的原生工程之间的交接问题。它能生成剪映草稿、在独立副本中调整已有多轨项目，并在满足条件时调用本机剪映引擎导出 MP4；项目也提供 Python命令行和 Agent Skill，便于接入自动化视频工作流。
它能做什么：交付可编辑工程，而不只是一条成片
项目的基本流程是先准备本地素材和 JSON剪辑计划，再生成剪映可以打开的草稿。计划可描述视频分段、多轨组合、变速、音量、画中画、字幕和标题；素材可使用本地视频、PNG、JPEG、GIF、配音、音乐及音效。项目还支持静态 OTF/TTF字体、位置与缩放等线性关键帧，以及适配范围内的蒙版、转场和部分原生效果。涉及原生效果时，机器上仍需有匹配的剪映资源和相应使用权限。
相比直接把片段渲染成单层视频，这种做法保留了后续在剪映里编辑时间线的空间。对于已有草稿，工具会先检查来源，再在独立副本中修改，避免直接覆盖原工程。它也能对经过验证的工程快照调用本机原生引擎导出 H.264/AAC MP4，不过用户之后在剪映界面手动做的改动，不会自动同步回旧计划或此前的导出快照。
一个实际案例：把其他工具生成的内容交给剪映继续剪
仓库 README展示了 Hypit到剪映的单向工程交接案例：约50.23秒的 IG滚动动画教程被拆成视频、图片、配音和可编辑文字等独立内容，而非仅作为一条成片导入。项目记录了39份原始素材，转换后的工程包含23条轨道、154个片段，其中可编辑文字占14条轨道、109个片段。
项目维护者报告，该案例在剪映11.5.0上完成了工程构建、打开播放、保存、退出后重新打开及结构回读，并通过原生导出的1507帧完整性检查。但这不是任意 Hypit项目的一键无损转换：特殊字体、逐词颜色动画、部分裁切和阴影未完全保留，个别画面也存在差异，完整主观视听验收仍未结束。这个案例说明了项目的工程交接方向，也提醒使用者逐个检查实际交付内容。
运行环境与兼容边界
项目面向 Apple Silicon Mac，要求 macOS 26.0或更新版本；README中的已验证系统为 macOS 26.5.1。剪映专业版主要适配11.5.0，另有11.4.2对应的兼容配置。还需要 Python 3.9+、FFmpeg/ffprobe和 Xcode Command Line Tools。项目会检查剪映版本、构建身份、官方库哈希及签名，不匹配时停止运行，不通过跳过校验来强行适配。
这些前提很重要：Jianying Headless不是剪映官方 SDK，也不是脱离剪映独立运行的视频编辑器。仓库不分发剪映安装包、官方动态库、账号数据、字体或效果资源。项目说明仍未完成不同干净机器上的完整安装验收，因此即使系统与版本号看起来符合要求，也应先做本机诊断和实际草稿测试。
从环境检查到生成草稿
在安装了符合条件的剪映和上述依赖后，先检出仓库，构建本机桥接组件，再运行环境检查：
git clone https://github.com/mcncarl/jianying-headless.git
cd jianying-headless
python3 tools/build_native_codec.py
python3 skills/yichen-jianying-edit/scripts/headless_draft.py doctor构建步骤只编译仓库的桥接源码并链接本机已安装的程序库，输出必须符合项目预设的哈希检查。`doctor` 负责检查运行条件，并不代表所有视频、声音和工程保存测试都已通过。
接着参照仓库的计划格式编写 JSON，将示例素材路径换成自己有权使用的本地文件。执行构建与结构验证时，把计划路径和输出目录替换为实际位置：
python3 skills/yichen-jianying-edit/scripts/headless_draft.py build \
--plan /absolute/path/to/plan.json --out "$PWD/work/new-build"
python3 skills/yichen-jianying-edit/scripts/headless_draft.py verify-build \
--build "$PWD/work/new-build"完成构建后，先保存现有工作并完全退出剪映，再把新草稿登记到本机剪映首页：
python3 skills/yichen-jianying-edit/scripts/headless_draft.py publish \
--build "$PWD/work/new-build" --audit "$PWD/work/new-publish-audit"这里的 `publish` 只是本机草稿登记，并非把视频发布到互联网。登记后仍需在剪映中实际打开、播放、保存、退出并重新打开，确认工程可继续使用。如果需要导出已验证的快照，可以单独执行：
python3 skills/yichen-jianying-edit/scripts/headless_draft.py export \
--build "$PWD/work/new-build" --out "$PWD/work/new-export"导出结果位于新输出目录内的 `render.mp4`。项目说明导出在独立进程中运行，默认不联网，也不读取账号数据；它不会自动导出使用者后来在界面中修改过的内容。
Agent Skill如何接入工作流
仓库的 `skills/yichen-jianying-edit/` 提供 Agent调用入口、口播剪辑计划辅助脚本及操作说明。它适合把“生成口播与素材—规划镜头和字幕—生成可编辑草稿—人工检查或导出”串成工作流。Skill本身不包含剪映引擎，独立安装时仍需准备核心仓库及本机剪映，并通过环境变量指明项目目录：
export JIANYING_HEADLESS_ROOT="/absolute/path/to/jianying-headless"它更适合素材和剪辑规则比较明确、需要重复生成草稿或把 AI产物交给剪辑师继续精修的场景。要把它用于生产流程，应先用自己的素材、系统版本和目标效果做一轮完整验收，而不是把示例项目通过测试视为所有工程都能稳定导出。
使用限制与授权须知
目前的限制包括：复合片段仍属实验性的离线修改与冻结快照导出能力，不能当作已可靠支持的可编辑嵌套草稿；图片和 GIF测试曾出现间歇性少一帧，严格帧数检查会拒绝缺帧结果。项目也不支持任意剪映版本、任意原生效果组合、在线模板、资源下载、云端工程或账号权益获取。工程结构检查通过、原生播放正常、画面声音符合预期，以及素材本身具有合法使用权限，是需要分别确认的事项。
授权方面，仓库虽公开提供源码，但其原创部分采用个人学习和非商业使用条款，商业用途需取得作者明确书面授权，并非整包 MIT或 Apache-2.0授权。第三方组件继续适用各自许可证；取得项目代码也不等于获得剪映官方集成许可、账号权益或第三方素材的使用权。
Jianying Headless的定位是一座本地工程交接桥梁：把结构化视频计划变成可在剪映继续修改的草稿，再在受控环境中导出。它为 AI辅助剪辑与批量草稿制作提供了一种可研究的实现路径，但能否投入实际工作，仍取决于本机版本匹配、工程验收、所需效果覆盖范围及具体授权条件。
同类栏目导航