capcut-edit 是一个通过版本感知存储来编辑 CapCut / 剪映草稿的 CLI。v0.11 可检测并同步 draft_content.json、draft_info.json、draft_meta_info.json 与 template-2.tmp 中可读的时间线。
用途：读写字幕、时间、速度、音量、透明度、裁剪，应用模板与动画（淡入淡出、Ken Burns），将长视频剪成短视频。
主要能力：capcut info、doctor、diagnose、tracks、materials、segments、segment 等命令用于渐进式查看项目；输出支持 JSON（默认）、-H 人类可读表格、-q 仅退出码。批量写入通过 capcut batch 执行 set-text、shift、shift-all、speed、volume、opacity、trim，且为事务性，单个失败不写入，除非显式使用 --continue-on-error。枚举可通过 capcut enums --<category> 查询，类别包括 transitions、masks、image-intros、image-outros、image-combos、text-intros、text-outros、text-loop-anims、scene-effects、character-effects、audio-effects、fonts，加 --jianying 切换命名空间。scripts/ 提供 anim.sh、fade-in.sh、fade-out.sh、ken-burns.sh、long-to-short.sh、stamp-cta.sh 等封装。
使用方式：编辑前需在 CapCut 中关闭项目，编辑后重新打开。每次写入都会做冲突检查、原子准备并同步到所有可读时间线目标，同时生成 .bak 与滚动历史快照。除非用户明确接受覆盖磁盘已变更状态或打开中的编辑器，否则不要传 --force-write。capcut cut 写入 --out，不修改源文件。ID 支持 UUID 前 6 位以上前缀匹配。时间格式支持 1.5s、500ms、+0.5s、-1s、1:30、0:05.5，纯数字表示秒。
适用场景：批量修改字幕与时间、调整速度音量、应用动画与模板、长转短、卡拉 OK 字幕、代理渲染与自动化任务。
限制：音频片段 clip 为 null，无透明度/缩放；alpha 关键帧不渲染，应改用 anim.sh 淡入；项目路径在 macOS 为 ~/Movies/CapCut/User Data/Projects/com.lveditor.draft/<project>/，Windows 为 %LOCALAPPDATA%\CapCut\User Data\Projects\com.lveditor.draft<project>\。其余收费、价格、平台支持等事实暂未提供。