剪映无头自动化工具（Jianying Headless）

这是什么

Jianying Headless 是一个面向剪映专业版 macOS 的本地自动化工具，开发者是 mcncarl。它让你通过结构化的剪辑计划（JSON）生成可编辑的剪映草稿，在独立副本中修改多轨工程，并调用本机剪映引擎导出 MP4。这个项目不是剪映官方 SDK，而是社区驱动的开源方案，当前主要适配版本为 11.5.0，兼容 11.4.2。

它提供 Python 命令行入口，同时自带一个 Agent Skill（目录为 skills/yichen-jianying-edit/），方便接入 Claude Code、Cursor 等支持 Agent 的工具，让 AI 帮助你完成视频剪辑的草稿生成和导出。

适合谁

AI 视频工作流开发者：需要将 AI 生成的剪辑计划无缝转换到剪映中进行进一步编辑或导出。
批量视频创作者：希望用脚本或智能体同时生成多个草稿，避免重复手工操作。
视频编辑自动化爱好者：想用代码控制剪映，但又不愿意放弃剪映的编辑体验。
Agent / Skill 使用者：希望让 AI 助手直接操作剪映工程，完成从计划到成片的自动化。

能做什么

根据项目 README，核心功能包括：

生成可编辑草稿：支持视频分段、多轨组合、变速、音量、画中画、字幕和标题。
导入本地素材：视频、PNG、JPEG、GIF、配音、音乐和音效。
基础动画：位置、缩放、旋转、透明度和音量的线性关键帧。
原生效果：六类静态几何蒙版、叠化转场、轻微抖动（需要匹配的本机资源与使用权限）。
编辑已有工程：检查源草稿，在独立副本中修改，不覆盖原项目。
原生视频导出：通过本机剪映引擎将已验证快照导出为 H.264/AAC MP4。
环境与工程检查：核对运行版本、组件身份、素材完整性和草稿保存结果。

核心流程为：素材与剪辑计划 → 可编辑剪映草稿 → 原生引擎导出。剪映中后续手工修改的内容不会自动同步回原计划或旧导出快照。

使用前准备

硬件与系统：需要一台 Apple Silicon Mac，macOS 26.0 以上（已验证环境为 macOS 26.5.1）。
安装剪映专业版：版本须为 11.5.0 或兼容的 11.4.2。项目会严格检查应用版本、build、库哈希、签名和开发者身份，未知或不匹配版本会拒绝运行。
开发工具链：Python 3.9+、FFmpeg / ffprobe、Xcode Command Line Tools。需要 Apple clang（已验证 21.0.0）和 macOS SDK 26.5。
获取项目：克隆仓库并构建原生桥接组件。

安装方法

根据 README 的快速开始，先克隆仓库并进入目录，然后运行构建脚本和环境检查命令：

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（参考 examples/basic.plan.json 或 examples/hypit-handoff.plan.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"

需要成片时，可独立导出已验证快照：

python3 skills/yichen-jianying-edit/scripts/headless_draft.py export \
  --build "$PWD/work/new-build" --out "$PWD/work/new-export"

输出目录必须不存在，成片为该目录下的 render.mp4。导出在隔离进程中运行，默认不联网、不读取账号数据。

风险与注意事项

非官方工具：与剪映官方无关联，运行时依赖本机已安装的剪映，且版本必须严格匹配。
功能限制：复合片段仅支持实验性的离线修改；图片/GIF 偶现缺一帧问题；不支持任意效果组合、在线模板、资源下载、云端工程或账号权益获取。
不可逆性：编辑是在独立副本中进行，不会覆盖原项目，但草稿在剪映中的手工修改不会自动同步回计划。
质量验收：工程结构检查、原生播放、视觉一致性、主观听感与素材许可是不同的验收项目；本项目不保证视觉无损转换。
许可限制：原创部分采用个人学习和非商业使用许可，商业使用需作者书面授权；第三方内容适用原许可证。不是 MIT / Apache-2.0 整包授权。
生态现状：项目当前星标 1449，分支 633，开放问题 5，尚属小众工具，文档和社区支持有限。

总之，这个工具适合已经熟悉剪映和命令行，并且希望将 AI 或脚本能力嵌入视频工作流的进阶用户。如果你只是偶尔剪几条视频，可能不值得折腾；但对于批量生产和自动化探索，它提供了独特的价值。