批量剪视频最耗人的不是剪辑判断，而是重复动作：一百条素材套同一个片头、同一组字幕、同一条转场，手点一遍要几小时，点完还容易漏。pyJianYingDraft 换了个思路，它不渲染视频，而是直接生成剪映的草稿工程文件——把素材、轨道、关键帧、字幕、转场这些结构用 Python 描述出来，写进草稿目录，再用剪映打开草稿点导出。剪辑软件负责渲染，脚本负责重复劳动。这个项目在 GitHub 上有 4.8k 星、723 次 fork，累计提交 221 次，说明它不是玩票。
pyJianYingDraft 是什么
它是一个 Python 库，作者是 GuanYixuan，采用 Apache-2.0 协议开源，当前版本 0.3.1。定位写得很清楚：轻量、灵活、易上手的剪映草稿生成与导出工具，用来搭全自动的视频剪辑与混剪流水线。它不替代剪映，也不做视频编码，工作方式是在本地生成符合剪映格式的 draft 目录结构，让剪映把这些结构当成一份正常草稿打开。项目另有一个 CapCut 版本在开发中，作者也在 Discord 上收集用法与新功能方面的讨论。
核心功能
- 草稿级生成——不碰渲染只生成工程：库输出的是剪映能识别的草稿文件，渲染交给剪映本身，所以画质与编码参数不用自己操心，也不需要显卡。
- 视频图片全覆盖——素材控制到帧级：本地视频与图片素材可设定入出点，支持整体调节、关键帧、蒙版、色度抠图、背景填充与混合模式，裁剪与变速这类基础操作也在支持范围内。
- 文本与字幕成体系——批量套字幕不必手打：文本支持样式、关键帧、动画、描边背景阴影、气泡与花字效果、自动换行，还能直接导入 srt 字幕文件，做多语言版本时换一份字幕就能出一版。
- 音频能力完整——淡入淡出与音量可脚本化：本地音频素材带时间控制，支持淡入淡出、音量调整，另支持场景音与音色效果，混剪时不必来回切轨道手动调。
- 轨道与转场可控——多轨拼装顺序能定：可添加轨道与片段，并控制轨道顺序，视频动画、特效、滤镜、独立轨道的特效与滤镜、转场都能通过代码指定。
- 版本适配明确——5.9 与新版分别标注：项目 README 用表格把每项能力在剪映 5.9 与新版 10.8 上的支持状态标出来，哪些是全部支持、哪些带限制一目了然，不用自己试。
- 模板与自动导出——能接进完整流水线：模板模式下可通过 DraftFolder 的 fallback_loader 参数接入额外的草稿读取器，另有一个基础的 Jianying_controller 用来做自动导出。
使用场景
| 人群/角色 | 场景描述 | 推荐指数 |
|---|---|---|
| 批量混剪的短视频运营 | 一套模板套上千条素材，脚本跑完再统一导出 | ★★★★★ |
| 需要批量出多语言版本的团队 | 换 srt 字幕文件即可换语种 | ★★★★★ |
| 做数据可视化成片的开发者 | 用代码控制文本与关键帧动画 | ★★★★☆ |
| 想学剪映草稿结构的人 | 源码就是一份结构说明 | ★★★★☆ |
| 完全不写代码的剪辑师 | 需要 Python 基础，上手有门槛 | ★★☆☆☆ |
| 需要服务端渲染的场景 | 依赖本地剪映客户端导出 | ★☆☆☆☆ |
操作指南
- 打开 pyJianYingDraft，先看 README 里的功能支持表，确认你要用的能力在手上的剪映版本上是勾还是黄标。
- 按文档装库，用 pip 装最新版本，确认 Python 环境版本符合要求。
- 跑一遍 `demo.py`，它会生成一份示例草稿，用剪映打开看结构是否符合预期。
- 改 `demo.py` 里的素材路径与时间参数，换成自己的素材，先做一条最短的验证链路。
- 素材量大时，把素材列表读成数组循环生成草稿，每条草稿对应一个输出目录。
- 需要自动导出时，接上 Jianying_controller，或先手动在剪映里打开草稿检查一遍再批量导。
支持平台
库运行在 Python 环境，Windows 与 macOS 都能装，实际使用时依赖本地安装的剪映客户端，因为最终渲染要靠剪映打开草稿完成。剪映 5.9 与新版 10.8 的支持状态在 README 里逐项标注，新版上有几处限制：从其它草稿导入的轨道可能存在顺序问题，未缓存的字体会要求二次打开草稿。模板模式在新版上需要注意 draft_content.json 往往不是可直接读取的明文，需要通过 fallback_loader 接入额外读取器。项目另在开发 CapCut 版本，尚未合并进主线。
产品定价
库本身免费，Apache-2.0 协议允许商用与修改，不需要付费授权，也没有按次调用或订阅收费。实际成本在两处：一是剪映客户端，基础功能免费，部分素材与特效属于会员内容，脚本生成的草稿里如果引用了会员素材，导出时仍受客户端限制；二是运行环境，批量生成草稿不占显卡，但成百上千条视频的最终渲染要靠剪映逐条导出，时间成本与机器占用是主要开销。作者接受赞助，但不影响功能可用性。
常见问题
Q：生成的草稿打开后特效加载失败怎么办？
这是已知情况：剪映打开草稿时会尝试下载未缓存的动画、特效与转场，网络不好或素材已被下架就会超时，表现为某项加载失败。处理方式是先让剪映把依赖缓存完再预览，或者在脚本里避开冷门特效，改用基础转场。
Q：能直接输出 mp4 吗？
不能。库只生成草稿，不负责编码输出，导这一步必须由剪映完成。项目里的 Jianying_controller 做的是驱动剪映执行导出，属于自动化的辅助，渲染仍然是客户端在做。要完全脱离剪映，得换用其它渲染方案。
Q：新版剪映的模板模式为什么读不到配置？
新版剪映里的 draft_content.json 常常不是明文 JSON，直接读会失败。项目为此提供了 fallback_loader 参数，需要自己接一个额外的读取器进去。这也是新版适配里最容易卡住的一环，动手前先看文档里对应章节。
开发者小结
这类工具的价值在于把剪辑软件当成渲染后端，把重复劳动交给代码，思路比一键成片工具更可控：成片长什么样由脚本决定，不由模板决定。项目的工程完成度也不错，功能支持表按版本逐项标注，这种诚实对使用者最有用，能省掉大量试错。短板同样明确：它绑定了剪映的草稿格式，剪映改结构就得跟着改，新版适配的压力一直在；导出仍依赖本地客户端，不适合做服务端批量渲染；对不写代码的人门槛偏高。实际用法建议：先用 demo 跑通一条最短链路，确认版本支持后再上量，别一上来就写完整流水线。
相关导航
