Easy 剪映

让 AI 把剪辑做成剪映草稿，你在剪映里接着改。

转场、蒙版、关键帧、字幕、卡点、口播粗剪，都会变成剪映里正常的轨道和片段，可以拖、可以改，改完直接导出。

English · 三分钟上手 · 它是怎么做到的 · 剪映 11.7 分水岭

为什么要做成草稿，而不是直接给成片

AI 剪出来的片子，常常只差一两处：字幕错了一个字，某个镜头长了半秒，音乐想再小一点。

如果拿到的是成片，改这些就得回到 AI 那边重新生成、重新渲染。片子越长，等得越久，每改一次都要再花一次算力，改完还不一定是你想要的。

如果拿到的是剪映草稿，打开剪映，点到那条字幕改掉，把片段拖短一点，导出就完了。

Easy 剪映做的就是这一步：AI 写剪辑计划 → 生成剪映草稿 → 你在剪映里打开微调。 每段素材、每条字幕、每个转场都是独立的片段，和你自己剪的工程没有区别。粗活交给 AI，细节你自己定。

它能做什么

剪映 11.7 是一道分水岭

做这个项目的过程中，剪映自动升级到了 11.7，原来的做法有一半用不了了。

剪映的草稿是加密的。之前社区的做法不是破解，而是调用剪映程序里自带的加密、解密功能。

到了 11.7，这个功能还在，但它需要的密钥只在剪映自己运行时才提供，外部程序调用只能拿到空结果。这是剪映有意收紧的，所以我们没有去找这把密钥。

我们换了个做法：写一份不加密的草稿交给剪映，剪映打开后会自己加密保存。 实测 11.7 能正常打开、播放、导出。

工具会自动识别剪映版本，不需要手动设置。需要修改已有草稿的，可以留在（或退回）11.6；只是往剪映里放新草稿的，用最新版就行。

三分钟上手

你需要：Mac + 剪映专业版、Python 3.10+、ffmpeg、Xcode 命令行工具。

git clone https://github.com/YeJe-cpu/easy-jianying && cd easy-jianying
pip install -e '.[asr,fonts]'          # 只生成草稿的话 pip install -e . 就够
jyr doctor                             # 检查剪映版本，状态应为 ok

./tools/make_fixtures.sh examples/media
jyr build examples/showcase.plan.json --out /tmp/jyr-demo --publish --name "我的第一个 AI 草稿"

推送时剪映要完全退出。打开剪映，首页第一个就是它。

一份计划长这样，时间用秒，资源直接写剪映界面上的中文名：

{"name": "在路上", "canvas": "16:9",
 "tracks": [
  {"type": "video", "clips": [
    {"src": "雪山列车.mp4", "duration": 4, "transition": "叠化"},
    {"src": "牧民.mp4", "duration": 3, "speed": 1.5, "transition": "推近"},
    {"src": "小巷.mp4", "duration": 4.5, "keyframes": {"scale": [[0, 1.0], [4.5, 1.25]]}}]},
  {"type": "text", "clips": [{"text": "在路上", "duration": 3.4,
     "style": {"font": "新青年体", "size": 18, "color": "#FFD400", "stroke": {"color": "#000000"}},
     "anim": {"in": "打字机 I", "out": "闭幕"}}]},
  {"type": "subtitle", "clips": [{"text": "雪落下的时候", "duration": 3}]},
  {"type": "audio", "clips": [{"src": "bgm.mp3", "volume": 0.7, "fade": {"in": 1, "out": 2}}]}]}

给 Agent 用：把 skills/ 下的五个 Skill 装进 Claude Code / Codex，直接说"把这条口播粗剪一下放进剪映"就行。

我们做了哪些验证

1. 每个功能都在剪映里验收过。 生成草稿后让剪映打开，剪映会按自己的格式重新保存一遍，我们再逐项比对轨道、时间和素材，一致才算通过。最后用真实素材人工看一遍、导出一遍。

2. 常用效果直接能用，缓存清了也没关系。 工具附带 375 个常用转场、蒙版、动画、滤镜、特效、贴纸和字体的资料。实测把缓存删掉后，剪映打开草稿时会按编号把效果和字体重新下载回来。

3. 口播粗剪拿人工剪辑做对照。 同一条 316 秒的真实口播，人工粗剪到 232 秒。我们只用规则剪到 250 秒，人工保留的内容我们保留了 99%；再让 Agent 读一遍句子，删掉 3 句重复的，剪到 242 秒。

4. 卡点误差在一帧以内。 用节拍器测 90–150 BPM：速度误差不超过 1.5%，节拍位置平均差 2 毫秒，最多差 5 毫秒。

5. 方便 Agent 使用。 时间用秒，片段不写开始时间就自动接在上一段后面，资源直接写中文名，写错了会列出可用的选项。口播粗剪留了一步给 Agent 判断语义：停顿和口癖按规则剪，"同一句说了两遍"由 Agent 决定删哪句。

边界（先说清楚）

• 只支持 macOS 剪映专业版，在 Intel Mac + 剪映 11.6 / 11.7 上实测。Apple Silicon 理论可行，暂未实测；Windows 和 CapCut 国际版未测试。
• 剪映 11.7 起只能"写"不能"读"，详见上面的分水岭。
• 还没做的：裁剪、抠图、调色、曲线变速、花字、音频特效。
• 识别字幕会有错字，可以批量替换，也可以接你自己的识别服务。
• 导出沿用剪映上一次的导出设置。会员素材能不能用、能不能导出，以剪映的规则为准。
• 这不是剪映官方工具，和字节跳动没有任何关系。 它通过你本机已安装的剪映工作，剪映的用户协议依然适用。

致谢

• pyJianYingDraft（Gary Guan）——剪映草稿格式研究的开路者。
• jy-draftc（wenshui330）——第一个想到"别破解，直接请剪映自己加解密"的人。
• capcut-cli——公开记录了新版剪映接受明文草稿的行为。
• Dan Ellis 的动态规划节拍跟踪；faster-whisper。
• 也谢谢逸晨（mcncarl）的 jianying-headless：我们最早是在本机使用并适配它，把它跑通在英特尔 Mac 上，从中学到了很多。它下架后，我们依据自己的实践从头重写了这一版，本仓库不包含它的代码或数据。

写在最后

这个项目开始于一个很朴素的情况：一个大家都在用的工具下架了，而我们手上正好有一路踩坑攒下来的经验。

做到一半，剪映升级，原来的做法有一半不能用了；修预览黑屏的时候，我们一度以为是剪映的问题，最后发现是一首 mp3 里嵌了一张专辑封面。这些弯路都记了下来，也写进了代码和测试里。

它一定还有粗糙的地方。如果你发现剪映某个版本又变了、某个功能不对，欢迎告诉我们，也欢迎把你自己的剪辑套路写成新的 Skill。

协议

PolyForm Noncommercial 1.0.0：个人学习、研究、非商业使用都可以，随便改。不允许商用（包括卖课、做付费服务、接单交付）；商用请先联系作者。

联系作者

• 想聊聊 / 反馈问题：X（推特）@leaf_sanren，欢迎私信；也可以直接提 Issue。
• 商业授权与合作：邮件 aiesecxuanli@gmail.com。
• 同作者的另一个开源项目：SeeCut——口播自动精剪成网感动效短视频，也能输出剪映分层草稿。