pyJianYingDraft：用 Python 批量生成剪映草稿，复用模板与字幕

阿喵前言

同一套片头、字幕和转场，换一批素材就得在剪映时间线上重新排一次，能不能把这些重复操作交给代码？pyJianYingDraft 可以用 Python 批量生成可继续编辑的剪映草稿，也能复用模板替换素材与文字。适合会写脚本、想把固定剪辑流程自动化的人；准备连导出也一起自动跑，还要先选对剪映版本。

资源介绍

pyJianYingDraft 是面向剪映专业版的 Python 草稿生成库，适合批量编排素材和复用模板。它可以组织视频、图片、音频和文本，设置关键帧、动画、滤镜、转场，并导入 SRT 字幕；生成的工程仍可在剪映里打开调整。项目采用 Apache-2.0 许可，当前版本为 0.3.1，需要 Python 3.8 或更新版本。草稿生成可在 Windows、macOS 和 Linux 上运行，最终在 Windows 版剪映中导出。

截图

特色

• 代码组织多轨素材：控制片段位置、截取范围、速度与轨道顺序。
• 复用已有剪辑模板：替换素材或文字，保留模板中的编辑设置。
• 字幕与效果一起编排：支持 SRT 导入、文本样式、关键帧、滤镜及转场。
• 批量生成后继续精修：输出剪映草稿，再进编辑器检查和修改。

注意

• 草稿兼容与自动导出是两件事。功能表列有剪映 5.9、10.8 的草稿支持情况；自动导出仅支持 Windows 上的剪映 6 及以下版本，已在 5.9、6.8 测试，7 及以上不支持。
• 新版剪映模板通常不是明文 JSON，需要自行通过 fallback_loader 接入额外读取器。项目不内置解密实现，导入轨道也不能像新建轨道一样任意追加效果与片段。
• 未缓存的字体、动画和特效可能加载失败或需要重新打开草稿；涉及剪映 VIP 素材时，需具备相应导出权限。

使用教程

1. 准备 Python 环境。项目要求 Python 3.8 及以上，入门可选开发时测试过的 3.8 或 3.11，然后运行：

   pip install pyJianYingDraft==0.3.1

2. 从仓库的 0.3.1 版本源码 获取 demo.py 和同级 readme_assets/tutorial 素材目录。pip 安装包不包含 demo。
3. 在 Windows 版剪映的“全局设置 → 草稿位置”查看路径，把 demo.py 中的“你的草稿文件夹”替换为该目录。示例会覆盖同名 demo 草稿，已有内容请先备份或修改示例草稿名。
4. 在源码目录运行：

   python demo.py

   回到剪映，打开新生成的 demo 草稿；列表未刷新时，重新进入已有草稿或重启剪映。

5. 检查时间线中的音视频、文字、转场与音频淡入，再按自己的素材修改脚本。需要批量生成时，可循环创建不同名称的草稿；需要自动导出时，再阅读 JianyingController 使用说明，并使用符合版本要求的 Windows 环境。

资源获取

GitHub 项目与中文文档 · PyPI 0.3.1 · 0.3.1 版本说明