jianying-headless：把剪辑计划变成可编辑的剪映草稿

AI 剪辑工作流最尴尬的一段是最后一步：Agent 能把片子「想」明白，产物却进不了剪辑软件——要么导出成品片失去可改性，要么对着 GUI 一步步点。jianying-headless 补的就是这一段：把结构化剪辑计划生成为可继续编辑的剪映多轨草稿，改完还能调用本机剪映引擎原生导出 H.264/AAC MP4。剪映里后续手工修改的内容不会自动同步回原计划，但草稿本身在剪映里完全可改——这正是它和「直接出片」工具的分界线。仓库 2026-09-15 建立，截至 2026-10-03 有 2,954 星，Python 写成。视频号「AI纪年」10 月 3 日介绍过它。

Hypit 原成片	剪映工程原生导出

README 的 Hypit 协作案例：两组图取自真实案例的 1、8、17、28、37、48 秒。官方说明这是可编辑工程交接，不是视觉无损转换——特殊字体、逐词颜色动画和阴影未原样保留。

核心功能

• 可编辑草稿生成：视频分段、多轨组合、变速、音量、画中画、字幕和标题都进草稿；支持导入本地视频、图片、配音、音乐音效，静态 OTF/TTF 字体随草稿保存。位置、缩放、旋转、透明度和音量支持线性关键帧。
• 编辑已有工程：检查源草稿后在独立副本里修改，不覆盖原项目——工程交接场景的安全设计。
• 原生导出：通过本机剪映引擎把已验证快照导出 MP4。README 的 Hypit 案例规模：23 条轨道、154 个片段，导出通过 1,507/1,507 帧检查和完整解码检查。
• 版本与组件校验：应用版本、build、官方库哈希、签名与开发者身份都检查，未知版本或不匹配组件直接拒绝，不放宽校验强行运行。
• Windows 备援：另有一条社区贡献的 FFmpeg 导出路径（PR #1），不需要剪映、也不生成剪映草稿，只出 MP4——能力范围明确小于 macOS 原生流程。
• Agent Skill：仓库自带独立 Agent Skill（Python CLI 入口），可以直接接进 Agent 工作流做辅助剪辑。

典型使用场景

• AI 视频工作流的工程交接：上游 Agent 产出剪辑计划，下游剪辑师拿到的是能在剪映里继续改的多轨工程，而不是一条锁死的成片。
• 批量草稿生成：口播、图文、字幕批量出草稿，人工精修。
• Agent 辅助剪辑：让 Agent 负责结构性的粗剪和装配，关键帧和原生效果留给剪映。

快速上手

要求 Apple Silicon Mac（macOS 26.0+，已验证 26.5.1）、剪映专业版 11.5.0（兼容 11.4.2）、Python 3.9+、FFmpeg 和 Xcode Command Line Tools：

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 做环境和工程检查；官方的入门教程覆盖了首次安装、拖素材和常见报错。

小结

许可上没有常规开源那回事：LICENSE 是自定义的个人学习与非商用许可，可以查看、克隆、学习和修改，但禁止商用、禁止打包成技能集合或模板再分发，商用要向作者书面申请；视频号把它称作「公开项目」，准确说法是源码可见、非商用。版本匹配是另一道硬门槛：README 明说 11.5.0 仍需匹配安装身份与工具链，「不保证任意电脑安装即用」，官方引擎、账号数据和效果资源也不随源码分发。这是单向转换，剪映里的手工修改不回写计划。仓库最后推送是 2026-09-27，迭代很新。如果你的工作流是从头取素材，可以搭配我们同天收录的 yoinks——终端里把全网视频拉下来再进剪映流程。