pyJianYingDraft：基于 Python 的剪映草稿自动化编辑方案

pyJianYingDraft 概述

pyJianYingDraft 是一款专为 Python 开发者设计的轻量级库，旨在通过自动化生成和导出剪映（Jianying Pro）草稿，帮助用户快速搭建全自动视频剪辑与混剪流水线。

该库在不同版本的剪映中提供差异化支持：

• 版本 5.9 及以下： 支持在模板模式下读取并修改草稿。
• 版本 6 及以下： 支持实现批量导出功能。
• 版本 5 及以上： 兼容丰富的素材操作与轨道管理。

核心功能详解

1. 灵活的模板模式

通过加载未加密的 draft_content.json 文件，开发者可以将现有草稿作为模板，实现高效的重复利用：

• 素材替换： 快速更换模板中的音视频素材及文本内容。
• 轨道迁移： 将模板中的音频、视频或文本轨道整体导入至新草稿。
• 元数据提取： 自动提取模板内贴纸、气泡、花字等关键配置信息。

2. 自动化批量导出

无需手动操作，通过代码控制剪映打开指定草稿并将其导出至目标路径，同时支持自定义输出分辨率与帧率（仅限剪映 6 及以下版本）。

3. 丰富的素材与视觉效果

支持对本地多媒体素材进行精细化控制：

• 基础编辑： 自定义视频 / 图片 / 音频的起止时间、持续时长及播放速度。
• 画面调整： 支持缩放、旋转、亮度调节及关键帧设置。
• 特效增强： 配置入场 / 出场动画、组合动画、蒙版、滤镜及片段特效。
• 进阶元素： 支持背景填充、贴纸关键帧、花字气泡、文字描边等细节设置。

4. 轨道管理与音频处理

• 音频控制： 实现音量关键帧、淡入淡出效果及场景音配置。
• 层级管理： 支持动态增加轨道，分层管理视频、滤镜与特效。

5. 转场与字幕自动化

• 转场配置： 自定义转场效果及其持续时间。
• 字幕生成： 支持导入 .srt 文件一键生成字幕，并提供批量格式化处理。
• 文本优化： 支持自动换行、最大行宽限制及关键帧动画。

安装与快速上手

安装命令：

pip install pyJianYingDraft

环境建议： 推荐使用 Python 3.8 或 3.11。若在 import 时遇到问题，请检查 uiautomation 的兼容性并参考相关 Issue 排查。

快速验证流程：

1. 在剪映中创建空草稿，记录 draft_content.json 的文件路径。
2. 在 demo.py 脚本中配置 DUMP_PATH 变量并运行。
3. 运行后，脚本将自动生成包含视频、音频、转场、花字气泡等效果的草稿。
4. 重新打开剪映草稿，验证时间轴效果是否符合预期。

资源链接

项目 GitHub 地址：https://github.com/GuanYixuan/pyJianYingDraft