用途:以程序化方式读取、创建和修改 CapCut 桌面版(macOS)项目文件,适合批量或脚本化处理本地剪辑工程。
主要能力:列出项目、检查项目是否可读、读取项目摘要;从零创建项目;查看与编辑片段(缩放、变速、音量、旋转、翻转、透明度、裁剪、分割、删除、移动、重置变换);编辑音频轨(音量、静音、位置、变速、裁剪、删除、淡入淡出);添加视频特效、转场、HSL 调色与文字叠加。
使用方式:项目位于 ~/Movies/CapCut/User Data/Projects/com.lveditor.draft/。可用 python3 scripts/create-project.py <name> 创建项目,用 python3 scripts/edit-clips.py <project> --info 查看时间线,用 --scale、--speed、--volume、--trim、--split 等参数编辑片段;特效、转场、调色、文字分别由 add-effect.py、add-transition.py、add-color.py、add-text.py 处理。操作前需关闭 CapCut,否则启动时会覆盖 root_meta_info.json。
限制:仅能读写本地创建的项目;从模板库下载的项目其 draft_info.json 经 ByteDance 专有加密(base64),无法修改,可用 json.loads() 判断是否加密。创建项目需生成 3 个独立 UUID 并维护 22 个文件结构。资料未提供收费、价格、平台支持范围及效果保证等信息。