jianying-headless：AI生成可编辑剪映草稿工程，JSON计划驱动多轨视频自动化最新版

一、项目概览

tianmingyun/jianying-headless 是一个面向剪映专业版 macOS 的本地自动化工具——通过结构化的 JSON 剪辑计划，在后台生成可编辑的原生剪映草稿，调用本机剪映引擎导出 MP4，同时保留完整的手工修改空间。

核心定位：不是”鼠标模拟”，而是生成原生剪映工程文件——输出的是一份可以在剪映里继续编辑的项目，而不是一次性成片。

注意：本仓库（tianmingyun/jianying-headless）是作者本人源码发布页，GitHub Trending 上的爆火版本 mcncarl/jianying-headless（700+ Stars，1033 分）是对本仓库的 Fork。

当前数据：

• Stars：0（今日刚创建，是 mcncarl/jianying-headless 的原作者仓库）
• 文件数：78 个
• 技术栈：Python 3 + C++（桥接层）+ JSON 计划文件
• 许可证：个人学习和非商业使用（商业使用需书面授权）
• 创建时间：2026 年 9 月 21 日（今日！）
• 适配剪映版本：11.5.0（兼容 11.4.2）

二、与传统方案的本质区别

目前市面上的剪映自动化方案大多采用”鼠标模拟”——控制鼠标点击剪映界面元素来执行剪辑，输出的是最终成片。jianying-headless 走了完全不同的路线：

三、核心功能

生成可编辑剪映草稿

通过 JSON 剪辑计划声明素材路径和轨道结构，自动生成原生剪映草稿：

• 视频分段、变速、音量调节
• 多轨组合、画中画（PIP）
• 字幕和标题（含原生文字轨道）
• 导入本地素材：视频、PNG、JPEG、GIF、配音、音乐、音效
• 基础关键帧动画（位置、缩放、旋转、透明度、音量）
• 六类静态几何蒙版、叠化转场、轻微抖动

本地字体支持

可使用本地静态 OTF/TTF 字体，新建文字或在草稿副本中批量换字体，字体随草稿保存。

编辑已有工程

在独立副本中修改多轨工程，不覆盖原始项目——适合批量生成变体或对模板进行定制。

原生视频导出

调用本机剪映引擎（隔离进程运行，默认不联网、不读取账号数据）将已验证快照导出为 H.264/AAC MP4，无第三方渲染依赖。

环境与工程检查

内置 doctor 检查命令，核对剪映版本、组件身份、素材完整性和草稿保存结果。应用版本、build、官方库哈希、签名均有校验，未知版本直接拒绝。

四、工作流程

核心流程三步走：

1. 素材 + JSON 剪辑计划 → 定义素材路径、轨道结构、时间线
2. 生成可编辑剪映草稿 → 在隔离副本中构建工程，不破坏原项目
3. 调用原生引擎导出 MP4 → 帧级精确，隔离进程，不联网

JSON 计划格式示例

参考 examples/basic.plan.json，声明素材路径和轨道结构：

{
  "resolution": "1920x1080",
  "fps": 30,
  "tracks": [
    {
      "type": "video",
      "clips": [
        { "source": "/path/to/video1.mp4", "start": "0s", "duration": "10s" },
        { "source": "/path/to/video2.mp4", "start": "10s", "duration": "8s" }
      ]
    },
    {
      "type": "subtitle",
      "clips": [
        { "text": "Hello World", "start": "0s", "duration": "3s" }
      ]
    }
  ]
}

五、快速开始

# 克隆本仓库
git clone https://github.com/tianmingyun/jianying-headless.git
cd jianying-headless

# 构建原生编解码器
python3 tools/build_native_codec.py

# 环境自检
python3 skills/yichen-jianying-edit/scripts/headless_draft.py doctor

doctor 命令检查剪映版本、组件身份和必要工具（FFmpeg、ffprobe、Xcode CLI）。

# 构建草稿
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"

# 导出 MP4（隔离进程）
python3 skills/yichen-jianying-edit/scripts/headless_draft.py export \
  --build "$PWD/work/new-build" --out "$PWD/work/new-export"

六、运行环境要求

• Apple Silicon Mac，macOS 26.0+（已验证 macOS 26.5.1）
• 剪映专业版 11.5.0（或匹配配置的 11.4.2）
• Python 3.9+
• FFmpeg / ffprobe
• Xcode Command Line Tools
• 已验证桥接工具链：Apple clang 21.0.0 / macOS SDK 26.5

⚠️ Windows 用户暂时不支持，仅限 Apple Silicon Mac + macOS 26.0+。

七、与 Hypit 的协作案例

jianying-headless 与 Hypit（AI 视频克隆工具，见本站评测）形成互补工作流：Hypit 生成视频内容 → jianying-headless 将 Hypit 工程转换为剪映原生草稿。

一个约 50.23 秒的 IG 滚动动画教程案例：

该案例在剪映 11.5.0 完成了构建、打开播放、保存、完全退出、冷重开和结构回读，通过原生导出的 1507 / 1507 帧检查与完整解码验证。

八、项目架构

九、与同类工具对比

十、当前限制

• 平台限制：仅 Apple Silicon Mac + macOS 26.0+，Windows 暂不支持
• 版本锁定：仅支持剪映 11.5.0 或 11.4.2，版本不匹配会拒绝运行
• 复合片段：仅支持实验性离线修改与冻结快照导出，尚不能交付为可编辑嵌套草稿
• 图片/GIF：样本曾出现间歇少一帧，严格帧数检查会拒绝缺帧输出
• 高清滤镜：高清黑白滤镜与橙色描边花字已退出支持范围
• 商业授权：需作者书面授权方可商业使用

十一、一句话总结

jianying-headless 是一个面向剪映专业版 macOS 的本地自动化工具，通过 JSON 剪辑计划在后台生成可编辑的原生剪映草稿，调用本机剪映引擎导出 MP4，支持多轨/画中画/字幕/音量/关键帧/本地字体，可与 Hypit 等 AI 视频工具协作组成 AI 视频工作流——不同于传统鼠标模拟方案，它的输出是可以继续在剪映里人工修改的工程文件。

GitHub 地址：https://github.com/tianmingyun/jianying-headless
关联仓库（Trending Fork）：mcncarl/jianying-headless（700+ Stars）
环境要求：Apple Silicon Mac + macOS 26.0+ + 剪映 11.5.0
许可证：个人学习和非商业使用（商业使用需书面授权）