Skip to content
Back to search

easy-jianying

让 AI 把剪辑做成剪映草稿,你在剪映里接着改 · AI → editable JianYing (剪映) drafts on macOS

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yeje-cpu--easy-jianying/badge.svg)](/listings/yeje-cpu--easy-jianying)

HTML

<a href="/listings/yeje-cpu--easy-jianying"><img src="/api/listings/yeje-cpu--easy-jianying/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # Easy 剪映
  3. **让 AI 把剪辑做成剪映草稿,你在剪映里接着改。**
  4. 转场、关键帧、字幕、卡点、口播粗剪,都会变成剪映里正常的轨道和片段,可以拖、可以改,最后在剪映里自己导出。
  5. [English](README.en.md) · [三分钟上手](#三分钟上手) · [它是怎么做到的](docs/how-it-works.md) · [CapCut 国际版](#capcut-国际版)
  6. <img src="docs/media/hero.gif" width="640" alt="一份 JSON 计划生成的剪映草稿,在剪映 11.7 里打开、播放">
  7. <p>这段画面由一份 JSON 计划生成草稿,在<b>剪映 11.7 里打开、播放</b>。<br>(右上角的小圆圈是画中画加了圆形蒙版,蒙版属于会员资源,见下面「免费用户用免费的,会员用会员的」。)</p>
  8. </div>
  9. ---
  10. ## 为什么要做成草稿,而不是直接给成片
  11. AI 剪出来的片子,常常只差一两处:字幕错了一个字,某个镜头长了半秒,音乐想再小一点。
  12. 如果拿到的是成片,改这些就得回到 AI 那边重新生成、重新渲染。片子越长,等得越久,每改一次都要再花一次算力,改完还不一定是你想要的。
  13. 如果拿到的是剪映草稿,打开剪映,点到那条字幕改掉,把片段拖短一点,在剪映里自己导出就行。
  14. | 想改一个错别字 | 拿到成片 | 拿到剪映草稿 |
  15. |---|---|---|
  16. | 怎么改 | 让 AI 重新生成、重新渲染 | 在剪映里双击字幕,改掉 |
  17. | 要等多久 | 再渲染一遍 | 几秒钟 |
  18. | 算力 | 再花一次 | 不用 |
  19. Easy 剪映做的就是这一步:**AI 写剪辑计划 → 生成剪映草稿 → 你在剪映里打开微调。** 每段素材、每条字幕、每个转场都是独立的片段,和你自己剪的工程没有区别。粗活交给 AI,细节你自己定。
  20. <div align="center">
  21. <img src="docs/media/timeline-multitrack.jpg" width="820" alt="剪映时间线:主轨 4 段 + 叠化/推近转场 + 1.5 倍速 + 两条画中画 + 标题 + 字幕 + BGM">
  22. <p>剪映里看到的就是这样:主轨、转场、变速、画中画、标题、字幕、音乐,各在各的轨道上。</p>
  23. </div>
  24. ## 它能做什么
  25. | | 能力 | 具体是什么 |
  26. |---|---|---|
  27. | 🎬 | **生成草稿** | 多轨、切碎、变速、转场、关键帧动画、画中画、文字、字幕、贴纸、特效、滤镜、BGM 淡入淡出、图片/GIF |
  28. | ✂️ | **口播粗剪** | 一条 5 分钟的口播原片,自动剪掉气口、口癖、结巴和说错重来的半句;Agent 再按语义删掉"说了两遍的那句" |
  29. | 💬 | **字幕贴语音** | 本地识别,不上传;生成剪映原生「识别字幕」,在剪映里一键改全部样式 |
  30. | 🥁 | **卡点** | 识别音乐节拍,素材按拍切,再打上剪映原生的踩点标记 |
  31. | 📦 | **批量** | 一个模板 × 一张表格 = N 个草稿,系列视频统一包装 |
  32. | 🎨 | **自动调配** | 转场、特效、字体写 `"auto"`,只在免费资源里挑 |
  33. | 👑 | **会员资源** | 剪映会员声明 `--member`,就能让 AI 直接用会员转场、蒙版、文字动画 |
  34. | 🌏 | **CapCut 国际版** | 同一份计划生成 CapCut 草稿 |
  35. 草稿生成后,打开、微调、导出都在剪映 / CapCut 里完成,会员功能照剪映 / CapCut 自己的规则走。
  36. <div align="center">
  37. <img src="docs/media/frames.jpg" width="820" alt="成片抽帧:标题、画中画、字幕">
  38. </div>
  39. ## 免费用户用免费的,会员用会员的
  40. 转场、特效、贴纸、字体这些是剪映自己的资源,草稿里只记它们的名字和编号,效果文件由剪映按编号下载。
  41. 剪映在每个草稿文件夹的 `key_value.json` 里记着用过的资源是不是会员(`is_vip`)。Easy 剪映据此给内置的 375 个资源都标了记号:**免费 175 个**(`is_vip` 为 0,或剪映安装包自带的字体)、会员 67 个、没有记录的 133 个。
  42. - **默认只用免费的**:贴纸 116、特效 28、字体 23、转场 5(推近、叠化、闪黑、滑动、翻页)、动画 1、滤镜 1、音效 1。`"auto"` 也只从这里面挑。
  43. - **你是剪映会员**:加 `--member`(或在计划里写 `"member": true`),会员资源和没有记录的资源就能点名使用,比如会员转场、蒙版、文字动画。生成时会提醒哪些是会员资源。
  44. - 草稿打开后,会员功能照剪映自己的规则走:剪映照常检查会员,jyr 不绕开任何检查。
  45. ```bash
  46. jyr --member build plan.json --out /tmp/demo --publish
  47. ```
  48. ## 支持哪些版本
  49. jyr 生成的草稿是普通的 JSON 文件,剪映和 CapCut 打开后照常编辑、保存、导出。实测过的版本:
  50. | App | 实测版本 | 生成草稿、放到首页 | 读取 / 导字幕 / 改副本 |
  51. |---|---|:---:|:---:|
  52. | 剪映专业版(macOS) | 11.7.0 | ✅ | 只限 jyr 自己生成、剪映还没存过的草稿 |
  53. | CapCut 国际版(macOS) | 9.4.1 | ✅ | ✅(CapCut 草稿是普通 JSON) |
  54. 其他版本没有实测。剪映升级后先跑 `jyr adapt`,再打开一份生成的草稿确认。
  55. ## CapCut 国际版
  56. 同一份计划,加一个 `--app capcut`,就是一份 CapCut 草稿:
  57. ```bash
  58. jyr --app capcut doctor
  59. jyr --app capcut build examples/capcut.plan.json --out /tmp/cc-demo --publish --name "我的第一个 CapCut 草稿"
  60. jyr --app capcut inspect "我的第一个 CapCut 草稿" # 读草稿、字幕存成 SRT、改副本都行
  61. ```
  62. 只装了一个就自动用它,不写 `--app` 也行;两个都装时默认剪映。
  63. CapCut 一侧**只读写草稿文件**:不调用 CapCut 程序里的任何东西,也不操作它的界面。
  64. CapCut 的资源编号和剪映不完全一样,所以它有自己的资源清单。内置的主要是 CapCut 安装包自带的字体;你在 CapCut 里用过的转场、动画、字体,`jyr --app capcut catalog scan` 扫一遍就能用。规则和剪映一样:默认只用免费的,CapCut Pro 用户加 `--member` 才能用 Pro 资源;`catalog list --free` 只列免费的。
  65. ## 三分钟上手
  66. **你需要**:Mac + 剪映专业版(或 CapCut)、Python 3.10+、ffmpeg。
  67. ```bash
  68. git clone https://github.com/YeJe-cpu/easy-jianying && cd easy-jianying
  69. pip install -e '.[asr,fonts]' # 只生成草稿的话 pip install -e . 就够
  70. jyr doctor # 检查剪映版本,状态应为 ok
  71. ./tools/make_fixtures.sh examples/media
  72. jyr build examples/showcase.plan.json --out /tmp/jyr-demo --publish --name "我的第一个 AI 草稿"
  73. ```
  74. 推送时剪映要完全退出。打开剪映,首页第一个就是它。
  75. 一份计划长这样,时间用秒,资源直接写剪映界面上的中文名:
  76. ```json
  77. {"name": "在路上", "canvas": "16:9",
  78. "tracks": [
  79. {"type": "video", "clips": [
  80. {"src": "雪山列车.mp4", "duration": 4, "transition": "叠化"},
  81. {"src": "牧民.mp4", "duration": 3, "speed": 1.5, "transition": "推近"},
  82. {"src": "小巷.mp4", "duration": 4.5, "keyframes": {"scale": [[0, 1.0], [4.5, 1.25]]}}]},
  83. {"type": "text", "clips": [{"text": "在路上", "duration": 3.4,
  84. "style": {"font": "新青年体", "size": 18, "color": "#FFD400", "stroke": {"color": "#000000"}},
  85. "keyframes": {"opacity": [[0, 0], [0.6, 1]]}}]},
  86. {"type": "subtitle", "clips": [{"text": "雪落下的时候", "duration": 3}]},
  87. {"type": "audio", "clips": [{"src": "bgm.mp3", "volume": 0.7, "fade": {"in": 1, "out": 2}}]}]}
  88. ```
  89. 给 Agent 用:把 [`skills/`](skills/) 下的 Skill 装进 Claude Code / Codex,直接说"把这条口播粗剪一下放进剪映"就行。
  90. ## 我们做了哪些验证
  91. **1. 每个功能都在剪映里看过。**
  92. 用真实素材生成草稿,在剪映里打开、播放、导出,人工逐项看轨道、时间和效果。验收记录见 [docs/acceptance.md](docs/acceptance.md)。
  93. **2. 效果缺了,剪映会自己下载。**
  94. 实测把转场、字体的缓存删掉,剪映打开草稿时会按编号重新下载回来。
  95. **3. 口播粗剪拿人工剪辑做对照。**
  96. 同一条 316 秒的真实口播,人工粗剪到 232 秒。我们只用规则剪到 250 秒,人工保留的内容我们保留了 99%;再让 Agent 读一遍句子,删掉 3 句重复的,剪到 242 秒。
  97. **4. 卡点误差在一帧以内。**
  98. 用节拍器测 90–150 BPM:速度误差不超过 1.5%,节拍位置平均差 2 毫秒,最多差 5 毫秒。
  99. <div align="center">
  100. <img src="docs/media/timeline-beats.jpg" width="820" alt="卡点草稿:素材在每个节拍处切换,音乐轨上有剪映原生踩点标记">
  101. </div>
  102. **5. 方便 Agent 使用。**
  103. 时间用秒,片段不写开始时间就自动接在上一段后面,资源直接写中文名,写错了会列出可用的选项。口播粗剪留了一步给 Agent 判断语义:停顿和口癖按规则剪,"同一句说了两遍"由 Agent 决定删哪句。
  104. ## 边界(先说清楚)
  105. - **只支持 macOS**:剪映专业版 11.7、CapCut 国际版 9.4.1 在 Intel Mac 上实测。Apple Silicon 理论可行,暂未实测;Windows 未测试。
  106. - **jyr 只生成草稿文件,不操作剪映 / CapCut 的界面。** 打开、编辑、导出都由你在 App 里完成。
  107. - **剪映存过的草稿 jyr 不读**:要改就改计划重新生成,或者直接在剪映里改。CapCut 的草稿可以读。
  108. - **默认只用免费资源**;会员声明 `--member` 才会用到会员资源(见上)。会员功能能不能用、能不能导出,以剪映的规则为准。
  109. - CapCut 缺资源时会不会像剪映一样按编号自动下载,还没在别的机器上验证过。
  110. - 还没做的:裁剪、抠图、调色、曲线变速、花字、音频特效。
  111. - 识别字幕会有错字,可以批量替换,也可以接你自己的识别服务。
  112. - **这不是剪映官方工具,和字节跳动没有任何关系。** 剪映 / CapCut 的用户协议依然适用。
  113. ## 致谢
  114. - [pyJianYingDraft](https://github.com/GuanYixuan/pyJianYingDraft)(Gary Guan)——剪映草稿格式研究的开路者。
  115. - [capcut-cli](https://github.com/renezander030/capcut-cli)——公开记录了新版剪映接受普通 JSON 草稿的行为。
  116. - Dan Ellis 的动态规划节拍跟踪;[faster-whisper](https://github.com/SYSTRAN/faster-whisper)。
  117. - 也谢谢逸晨(mcncarl)的 jianying-headless:我们最早是在本机使用并适配它,把它跑通在英特尔 Mac 上,从中学到了很多。它下架后,我们依据自己的实践从头重写了这一版,本仓库不包含它的代码或数据。
  118. ## 写在最后
  119. 这个项目开始于一个很朴素的情况:一个大家都在用的工具下架了,而我们手上正好有一路踩坑攒下来的经验。
  120. 修预览黑屏的时候,我们一度以为是剪映的问题,最后发现是一首 mp3 里嵌了一张专辑封面。这些弯路都记了下来,也写进了代码和测试里。
  121. 它一定还有粗糙的地方。如果你发现剪映某个版本又变了、某个功能不对,欢迎告诉我们,也欢迎把你自己的剪辑套路写成新的 Skill。
  122. ## 协议
  123. [PolyForm Noncommercial 1.0.0](LICENSE.md):个人学习、研究、非商业使用都可以,随便改。**不允许商用**(包括卖课、做付费服务、接单交付);商用请先联系作者。
  124. ## 联系作者
  125. - **想聊聊 / 反馈问题**:X(推特)[@leaf_sanren](https://x.com/leaf_sanren),欢迎私信;也可以直接提 Issue。
  126. - **商业授权与合作**:邮件 [aiesecxuanli@gmail.com](mailto:aiesecxuanli@gmail.com)。
  127. - 同作者的另一个开源项目:[SeeCut](https://github.com/YeJe-cpu/SeeCut)——口播自动精剪成网感动效短视频,也能输出剪映分层草稿。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.