草稿结构揭秘jianying-editor-skill 如何读写 draft_info.json 与工程自修复完整指南【免费下载链接】jianying-editor-skillSkill for Agent automating JianYing (CapCut Chinese version) video editing.项目地址: https://gitcode.com/gh_mirrors/ji/jianying-editor-skilljianying-editor-skill 是一个让 AI Agent 自动操作剪映JianYing的开源技能库它通过直接读写剪映草稿目录里的draft_info.json文件来生成和修改工程并内置了工程自修复机制能在草稿损坏、版本冲突或剪映占用文件时自动恢复。本文带你拆解这套机制的完整原理。先搞清楚剪映草稿到底由什么组成在剪映草稿根目录get_default_drafts_root()自动探测的位置下每一个草稿就是一个文件夹文件夹名即草稿名。一个合规的草稿目录里至少包含 4 个关键文件文件作用draft_info.json草稿蓝图轨道、片段、素材、时间轴全部存在这里v5.9 架构draft_content.json旧版本剪映的蓝图文件draft_info.json的前身draft_meta_info.json元信息缩略图、最近修改时间等key_value.json/draft_settings键值对缓存与草稿设置jianying-editor-skill 在创建草稿时会把仓库内置的三份模板复制过去再让ScriptFile把save_path指向新生成的draft_info.json——这就是写的起点模板复制逻辑scripts/vendor/pyJianYingDraft/draft_folder.py草稿根目录探测scripts/utils/formatters.py三步读写流水线JyProject 如何操作 JSON你不需要手动碰 JSONJyProject把读写封装成了一条流水线详见 docs/api.md1️⃣ 打开先draft_info.json后draft_content.json加载时DraftFolder.load_template会优先查找draft_info.json找不到才回退到旧版draft_content.json因此新旧版本剪映的草稿都能被同一个 Skill 打开加载与兼容逻辑draft_folder.py2️⃣ 编辑在内存中的 ScriptFile 上操作添加素材、字幕、转场等操作都作用在内存对象上不会立刻落盘保证脚本中途出错也不会写坏草稿。3️⃣ 保存project.save()不只存 JSON保存环节是精髓JyProject.save()会依次做三件事调用script.save()把时间轴序列化写入draft_info.json补丁注入把云端音乐的music_id、字幕特效effectStyle等无法走标准 API 的字段直接写回 JSONscripts/core/mocking_ops.py刷新草稿文件夹时间戳让剪映 UI 感知到变更。这就是为什么规则文档反复强调脚本末尾必须调用project.save()见 rules/core.md。工程自修复四层防线让草稿坏了能救普通脚本遇到坏草稿会直接崩掉而 jianying-editor-skill 在初始化阶段scripts/core/project_base.py设置了四层防线防线触发条件自动动作损坏检测草稿文件夹存在但缺少draft_info.json/ 元信息overwriteTrue时自动清除损坏目录并重建合规草稿名称净化项目名含:/\|?*等非法字符自动替换为_并拒绝路径穿越式名称文件锁释放剪映正在编辑该草稿导致PermissionError最多重试 3 次通过JianyingController把剪映切回主页释放锁定加载兜底读取旧草稿抛出异常提示并强制重建工程对应源码损坏检测与自动清理见 project_base.py锁释放见 project_base.py。所以新手最常用的救命姿势就是一行代码JyProject(项目名, overwriteTrue)——发现草稿损坏时它会打印Auto-healing: Removing corrupted folder...并重建机制说明见 SKILL.md。实战3 条命令体检你的草稿想亲眼看看draft_info.json长什么样项目内置了草稿检查器 scripts/draft_inspector.py全部支持--json机器可读输出# 列出草稿根目录下所有草稿 python scripts/draft_inspector.py list --limit 20 # 查看某个草稿的轨道数、片段数、素材统计 python scripts/draft_inspector.py summary --name 我的草稿 # 完整导出 draft_info.json 内容 python scripts/draft_inspector.py show --name 我的草稿 --kind content --jsonsummary命令会输出track_count、segment_count和每类素材数量是验收保存是否成功最轻量的手段与project.save()验收清单一致见 rules/core.md。新手常见问题为什么剪映里看不到我的改动脚本没调save()或剪映 UI 需要退出重进该草稿才能刷新。旧草稿打不开旧版用的是draft_content.jsonSkill 已自动兼容回退若两文件都缺失属于损坏用overwriteTrue触发自修复。能手动改 JSON 吗可以但官方建议走 APIdraft_inspector show是比手翻 JSON 更安全的查看方式。小结jianying-editor-skill 的核心能力本质是围绕draft_info.json这套草稿蓝图建立的读写与自愈体系读时兼容新旧文件名写时在保存阶段注入补丁字段修时用损坏检测、名称净化、锁释放、加载兜底四层防线兜底。理解这套结构后你就能放心地把批量剪辑交给 Agent 自动完成了。【免费下载链接】jianying-editor-skillSkill for Agent automating JianYing (CapCut Chinese version) video editing.项目地址: https://gitcode.com/gh_mirrors/ji/jianying-editor-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考