YeJe-cpu/easy-jianying

项目介绍

Easy 剪映（命令行工具 jyr）把一份 JSON 剪辑计划转换成 macOS 上剪映专业版或 CapCut 国际版的原生草稿。生成的工程包含独立的主轨、画中画、文字、字幕和音频轨道，以及转场、关键帧、变速和踩点标记，你可以在剪映里逐条修改字幕、拖短片段、调整音量，最后在 App 内导出，不需要让 AI 重新渲染成片。

除草稿生成外，它还提供口播粗剪（按规则剪掉气口、口癖，并留一步给 Agent 判断语义）、本地语音识别生成字幕、音乐节拍卡点、模板批量生成，以及用 "auto" 自动从免费资源中选转场和特效。草稿格式和实现原理见工作方式文档。

快速开始

需要 Mac、剪映专业版（或 CapCut）、Python 3.10+ 和 ffmpeg。推送草稿时剪映必须完全退出。

git clone https://github.com/YeJe-cpu/easy-jianying && cd easy-jianying
pip install -e '.[asr,fonts]'
jyr doctor
./tools/make_fixtures.sh examples/media
jyr build examples/showcase.plan.json --out /tmp/jyr-demo --publish --name "我的第一个 AI 草稿"

jyr doctor 应返回 ok；最后一条命令把草稿发布到剪映首页。CapCut 用户给 doctor、build、inspect 加上 --app capcut 即可。三分钟上手还给出了示例计划，时间以秒为单位，资源直接写剪映界面上的中文名。

给 Agent 使用时，把 skills/ 下的 Skill 装进 Claude Code 或 Codex，就可以直接让它把口播粗剪放进剪映。

版本与资源限制

草稿只在 Intel Mac 上的剪映 11.7.0 和 CapCut 9.4.1 中实测过；Apple Silicon 理论可行但未实测，Windows 未测试。剪映已经保存过的草稿无法读回，要修改就改计划重新生成，或直接在剪映里改；CapCut 草稿可以读取，也能导出字幕为 SRT。

默认只使用内置的免费资源（375 个资源中免费 175 个）。会员转场、蒙版和文字动画需要加 --member 或在计划中写 "member": true；会员校验由剪映/CapCut 自己完成，工具不会绕过。尚未实现的功能包括裁剪、抠图、调色、曲线变速、花字和音频特效。识别字幕可能有错字，支持批量替换或接入自己的识别服务。

本项目不是剪映官方工具，与字节跳动无关。协议为 PolyForm Noncommercial 1.0.0：允许个人学习、研究和非商业使用，不允许商用（包括卖课、付费服务和接单交付）。

HotRepo 点评

该项目没有进入 GitHub 全语言日榜。在新项目榜上，2026-11-02 记录到 107 Star 和 29 Fork，一小时窗口内新增 6 Star、2 Fork。这个窗口只有一条记录，不足以判断趋势；更有参考价值的是项目记录了在剪映里逐项播放验收的结果，以及用同一条口播对比人工粗剪的保留率，这些具体验证比 Star 数更能说明它已经覆盖了哪些使用场景。