原研究日期：2026-09-18。原文的私有源码、旧适配版本与许可元数据判断已按 2026-10-13 官方文件更新。
这是什么
面向剪映专业版 macOS 的本地自动化工具：从结构化计划生成可编辑草稿，在独立副本里修改工程，明确需要成片时再导出。源码当前可公开访问，但采用限制商业用途的自定义许可，不应因此叫作 MIT/Apache 式开源项目。官方仓库
当前主适配版本是 11.5.0，兼容配置为 11.4.2；不是原文的“只接受 11.4.2”。它不是剪映官方 SDK，也不承诺任意剪映版本或任意机器即装即用。
为什么值得关注
值得学的是把“生成工程、原生打开保存、结构回读、导出解码、画面与听感”分成不同验收层级。环境检查通过，不等于作品通过；成功案例也不能证明所有素材和效果组合可用。
项目说明桥接只链接本机匹配程序库，不下载剪映、不修改官方库或账号权益。这是实现范围说明，不是剪映集成授权或法律合规保证。软件许可、应用使用条款、会员资源和素材权利仍分别适用。README
它怎么转：四层逻辑
触发层
批量生成草稿、在副本中调整已有多轨工程，或把其他工具的素材与时间安排交给剪映。应明确要“可编辑草稿”还是“最终 MP4”，不能把它们视为同一交付物。
核心层
结构化计划与获准素材
→ 版本/组件身份及来源检查
→ 新建草稿或独立副本
→ 结构验证、原生打开保存与回读
→ 明确要求后导出并检查帧数、解码、画面与声音
未知版本、组件指纹不匹配等情况按文档拒绝，不通过降低门禁强行运行。
副本流程减少直接改坏原稿的风险，但依然需要备份。后续在剪映里手改的内容不会自动同步回旧计划或导出快照。
输出层
macOS 路线生成可编辑剪映草稿，并可通过本机引擎导出 H.264/AAC MP4。当前另有 Windows FFmpeg 导出路线：不需要剪映，但不生成可编辑剪映草稿，支持范围也不同。不能把 Windows 的 MP4 路线当成 macOS 原生工程能力已跨平台移植。平台分工
卡点层
官方列出的主环境是 Apple Silicon、macOS 26.0+、匹配剪映版本、Python、FFmpeg/ffprobe 与 Xcode 工具链；维护者记录了特定系统与编译工具链的验证，但另一台干净机器验收仍未完成。不要把维护者本机记录改写为本篇实测。
怎么升级：分三档
入门（先解决“能不能跑”）
当前源码不需要申请私有仓库访问。先阅读安装教程，再按其固定环境构建与检查：
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 只确认环境前提。构建哈希不匹配时应停止，不能把“关闭校验”当成安装修复。从零教程
进阶（生成、编辑与导出）
先准备指向有权使用素材的计划文件，输出选尚不存在的新目录：
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。这些是官方命令整理，本次没有运行。
高手（受控自动化）
远程调度原生路线仍需匹配的 Mac、应用与工具链，不能直接假设普通 Linux 容器或任意托管 CI 就能运行。Windows FFmpeg 是另一条路线，也要按它的支持范围验收。
场景迁移：三个方向
方向 1：AI 视频工作流的工程交接
ArcReel 与本项目可以提出“内容生成→工程交接→本地编辑导出”的分工设想，但本次没有验证两者草稿格式、媒体路径和效果完整兼容。图中虚线“需验证兼容性”应保留，不能称为已经打通的完整生产线。
方向 2：批量草稿
适合探索重复的片段组织、文字与音轨操作。特殊字体、会员资源、效果组合及人工改动的回读都需检查，不能承诺无损转换。
方向 3：自动化导出
把计划、构建、检查与导出拆开，便于定位问题；不要只用“进程成功退出”作为交付标准。
部署风险与收益
收益
独立副本、来源检查和分层验收，比直接覆盖工程更容易追踪。它是工程约束，不是安全审计或法律背书。
风险
验证状态原文件 明确保留未完成事项：图片/GIF 等样本出现间歇少帧；后续诊断定位了部分机制，但正式修复未完成，严格帧数检查仍拒收不完整输出。复合片段的冻结快照导出，也不等于可靠的可编辑嵌套草稿交付。
高清黑白滤镜、橙色描边花字已退出支持范围；普通描边与轻微抖动不能据此混为同一能力。结构、完整解码、主观听感和素材授权是独立验收项，不能相互代替。
注意事项：许可证要读原文件
GitHub 元数据中的 NOASSERTION 不是许可证名称。实际 LICENSE 是 Personal Learning and Non-Commercial Use License：允许相应个人非商业学习研究与工作流用途；客户交付、营收及企业业务运营等用途需作者事前书面许可，公开打包或再发布也有限制。询价或添加联系方式不等于已获授权。
第三方组件继续适用原许可。项目许可不包含剪映集成权、账号权益、字体、配音、音乐和视频素材的使用权。
项目元数据
删除“3 天爆款”、旧体积与 star/fork 比推断。当前公开源码、主适配版本与限制以 README、LICENSE 和验证记录为准；公开可读不等于无限制使用。
关键技术亮点
计划与执行分开、原稿与副本分开、环境与作品验收分开。 这三个分开，比“原生引擎等于合法、安全、无损”的宣传更值得借鉴。
与其他内容工具的关系
它可以作为素材和工程交接的候选环节，不替上游生成工具保证兼容，也不替下游发布平台确认内容权利。
一句话总结
jianying-headless 的灵魂，是把剪映草稿与本地导出做成可检查的自动化环节；适用版本、已知缺帧问题和非商业许可，都是使用前必须接受的边界。
2026-10-13 资料核对：已阅读官方 README、LICENSE 与验证状态原文件；本篇未构建桥接、安装剪映或导出视频，维护者的测试记录未记作本次实测。