仓库：luoluoluo22/jianying-editor-skill。原文基于较早版本；本次按当前文档重新区分草稿生成与桌面导出。
一句话定性
给 AI Agent 用的剪映自动化工具库：把自然语言要求转成 Python 操作，写入剪映草稿数据，再在剪映里检查和导出。它不是一个能自动判断所有节奏、版权和画面质量的真人剪辑师。
我看重的是“绕过大量重复点击，直接组织时间轴”。但直接写工程文件也意味着：格式兼容、原稿保护和最终验收必须自己管，不能只看生成了 JSON 就算成功。
它怎么转（运转链路）
触发层
Agent 阅读 SKILL.md 和相应规则，调用 Python 工具。不同宿主的 Skill 安装位置不同，按官方说明选择一个明确位置，不要混装后期待自动发现。
核心层
JyProject 及配套脚本处理媒体、文字、字幕、关键帧和草稿组织；项目还提供录屏分析、缩放和 Web-to-Video 等路线。网页录制需要 Playwright/Chromium 等额外环境，不是每次生成草稿都必须安装的组件。功能与安装说明
配音路线也要分清：剪映云端音色需要联网，edge-tts 同样调用 Microsoft Edge 的在线语音服务，不是离线 TTS。Python 包可本地安装，不代表音频生成在本地完成。edge-tts 官方说明
输出层
- 剪映草稿与媒体组织，具体文件结构按所选版本处理。
- 字幕等中间产物，以及在相应平台条件下完成的成片。
- 草稿生成与 GUI 自动导出是两套能力，不能写成“生成后必然自动导出”。
卡点层
当前官方文档支持 Windows 与 macOS 草稿生成；Windows GUI 自动导出对剪映 5.9 及以下更稳定，macOS 需要手动导出。它不等于“所有功能必须降级到 5.9”，也不能据此认定现代版本草稿均不可用。国际版 CapCut 与手机版不在文档支持范围。平台与版本限制
三段位升级路线
| 段位 | 关键动作 | 卡点 |
|---|---|---|
| 入门 | 按所选宿主安装 Skill，在独立 Python 环境按仓库 requirements 安装，先用新建草稿试一个小项目 | 确认安装目录、剪映路径及当前版本 |
| 进阶 | 逐项试配音、字幕、录屏缩放和网页素材，不把所有功能一次接入 | 云端素材可访问不代表可自由商用 |
| 高手 | 把业务脚本与 Skill 本体分开维护，复制模板后批量替换并回读检查 | 固定版本、备份工程，防止覆盖和格式变化 |
overwrite=True 表示可能覆盖目标，不能把 Auto-healing 当成备份或无损修复保证。业务素材应留独立副本；任何“修复成功”都要重新打开草稿验证。
场景迁移
1. 桌面软件与工程数据的自动化
这个项目展示的是“优先找文档支持的导入格式或可验证的工程接口”。可以借鉴到其他剪辑与设计工具，但不能把某个后缀都当成可任意编辑的 JSON/XML，更不能从剪映的实现推断 Premiere、Resolve 或 Final Cut 的兼容方式。
2. 自然语言与重复性设计任务
模板复制、物料替换、时间轴组织可迁移到课程、产品演示和批量素材制作。模板要先复制，替换后检查时长、路径、文字及媒体引用，而不是直接覆盖原模板。
部署的取舍
上图保留了旧文的平台示意；当前应读成“草稿生成支持 Windows/macOS，Windows GUI 自动导出另有版本限制”，不能再按图把全部能力限定为 Windows 工作机。
好处
- 将重复的媒体组织、文字与字幕操作交给脚本。
- 录屏缩放、网页录制等能力可以成为技术教程的素材环节。
- 中间草稿可以在剪映里继续人工调整，不只交付一个不可编辑视频。
注意事项
- Linux 容器不等于具备剪映桌面导出环境。反过来，不能把这个限制扩大成所有纯数据脚本都只能在 Windows 上运行。
- GUI 自动导出可能受弹窗、窗口焦点和版本更新影响；建议先核对支持矩阵，不为自动化盲目降级主力环境。
- 远程配音和素材同步可能向服务方发送数据，先确认素材许可、服务条款与上传范围。
风险
项目主许可证是 MIT，内嵌 pyJianYingDraft 的 Apache-2.0 归属也需保留。它们不是云端音色、音乐、字体或剪映账户权益的通用授权。贡献人数、issues 多少和 stars 都不足以推出可靠性；本次也未做覆盖写入、安全或导出测试。
灵魂
这个项目的灵魂仍是“绕过 UI 直达数据”。这是有价值的自动化路径，但不是所有桌面软件的标准答案。能否交付，要看工程是否可打开、媒体是否齐全、成片是否正确，而不是脚本有没有报“成功”。
2026-10-13 资料核对：已核对官方 README、许可证及 edge-tts 原始说明，修正平台、版本与在线配音表述；未安装或导出视频。