pyjianyingdraft

pyJianYingDraft 是一个轻量、灵活、易上手的 Python 剪映草稿生成及导出工具，目标是构建全自动化的视频剪辑/混剪流水线。项目通过 pip 安装（推荐 Python 3.8 或 3.11），当前 0.3.0 版本经历了大规模更新。其 CapCut 版本在独立仓库中开发。 核心能力 视频与图片：支持本地视频/图片素材与时间控制、整体调节（旋转、翻转、缩放、透明度、位移）、关键帧、蒙版、色度抠图、背景填充、混合模式（正片叠底、滤色、叠加等 10 种）。 音频：支持本地音频素材与时间控制、淡入淡出与音量、场景音与音色效果；声音成曲效果在剪映 5.9 下不生效，在 10.8 下可生效。 文本与字幕：支持文本样式、字体、关键帧、动画、描边/背景/阴影、气泡与花字效果、自动换行，并可导入 SRT 字幕文件，支持时间偏移与样式参考。 特效、滤镜与转场：提供视频片段动画、片段特效、片段滤镜，以及独立特效轨道和滤镜轨道；特效类型以枚举类命名并带参数注释，可用 from_name 模糊匹配。 轨道管理：提供 append_track/append_tracks 与 insert_track/insert_tracks 两组接口，可通过 over_track、under_track 或 at_index 控制层级。 模板模式：可加载已有剪映草稿作为模板，支持按名称替换素材、按片段替换素材（可重新选取素材范围并伸缩片段）、替换文本内容、导入模板中的音视频/文本轨道，以及提取贴纸/气泡/花字等素材元数据。新版剪映的 draft_content.json 常非明文 JSON，需通过 fallback_loader 接入额外读取器。 批量导出：通过 JianyingController 控制剪映导出草稿，可调节分辨率与帧率。该功能依赖 uiautomation，仅支持 Windows，且仅适用于剪映 6 及以下版本（剪映 7+ 隐藏了相关控件）。 时间处理：内部以微秒为单位，同时支持字符串形式（如 "1.5s"、"1h3m12s"），提供 tim、trange、trange_seconds 等便捷函数。 跨平台兼容性：Windows 支持草稿生成、模板模式和自动导出（受剪映版本限制）；Linux/MacOS 支持草稿生成和模板模式，但不支持自动导出，生成的草稿仍需在 Windows 版剪映下导出。 注意事项：剪映打开草稿时会尝试自动下载未缓存的动画/特效/转场，可能超时并显示加载失败；未缓存的字体需要二次打开草稿；自动导出会将剪映窗口置顶并控制光标点击，建议在闲时运行，且需确认有导出权限。