### [pyJianYingDraft：用 Python 批量生成剪映草稿，复用模板与字幕](https://www.appmiao.com/article/4698)

**Published:** 2026-11-02T04:54:47

**Author:** 阿喵#

**Excerpt:** pyJianYingDraft 用 Python 批量生成剪映草稿，支持多轨素材、模板替换、关键帧、转场和 S…

## 阿喵前言

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

## 资源介绍

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

### 截图

![pyJianYingDraft官方示例生成的剪映多轨时间线](https://oss.amiao.app/website/2026/11/02042856/pyjianyingdraft-timeline-piclite-advmo-b773faf6fe3d.webp)

示例草稿的文字、视频、贴纸与音频轨道。

![pyJianYingDraft草稿生成和模板替换使用流程](https://oss.amiao.app/website/2026/11/02042900/pyjianyingdraft-workflow-piclite-advmo-3fd5cdd4481c.webp)

草稿生成与模板混剪流程；自动导出须满足下方版本条件。

### 特色

-   **代码组织多轨素材：**控制片段位置、截取范围、速度与轨道顺序。
-   **复用已有剪辑模板：**替换素材或文字，保留模板中的编辑设置。
-   **字幕与效果一起编排：**支持 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 版本源码](https://github.com/GuanYixuan/pyJianYingDraft/tree/0.3.1) 获取 `demo.py` 和同级 `readme_assets/tutorial` 素材目录。pip 安装包不包含 demo。
3.  在 Windows 版剪映的“全局设置 → 草稿位置”查看路径，把 `demo.py` 中的“你的草稿文件夹”替换为该目录。示例会覆盖同名 `demo` 草稿，已有内容请先备份或修改示例草稿名。
4.  在源码目录运行：
    
    ```
    python demo.py
    ```
    
    回到剪映，打开新生成的 `demo` 草稿；列表未刷新时，重新进入已有草稿或重启剪映。
    
5.  检查时间线中的音视频、文字、转场与音频淡入，再按自己的素材修改脚本。需要批量生成时，可循环创建不同名称的草稿；需要自动导出时，再阅读 [JianyingController 使用说明](https://github.com/GuanYixuan/pyJianYingDraft/blob/0.3.1/README.md#%E6%89%B9%E9%87%8F%E5%AF%BC%E5%87%BA%E8%8D%89%E7%A8%BF)，并使用符合版本要求的 Windows 环境。

## 资源获取

[GitHub 项目与中文文档](https://github.com/GuanYixuan/pyJianYingDraft) · [PyPI 0.3.1](https://pypi.org/project/pyjianyingdraft/0.3.1) · [0.3.1 版本说明](https://github.com/GuanYixuan/pyJianYingDraft/releases/tag/0.3.1)

**Tags:** Linux, macOS, Python, windows, 剪映, 字幕, 开源, 批处理, 自动化, 视频剪辑

**Categories:** 开源项目

---