JianYing Agent Automation

让 AI Agent 在 Windows 上生成、修改并自动导出 剪映专业版 工程。

这个仓库不是另一个剪辑器，而是一层部署与兼容封装：

Chat / Agent
    ↓
jianying-editor-skill
    ↓
pyJianYingDraft
    ↓
剪映专业版 5.9.x
    ↓
可继续人工编辑的剪映草稿 / MP4

重点解决两个问题：

1. 把 jianying-editor-skill 部署成稳定、可复用的本地自动化后端。
2. 修复部分剪映 5.9 build 项目加载较慢时，旧 UI Automation 导出脚本过早判定失败的问题。

已完成端到端测试：Windows + 剪映专业版 5.9.0.11611 + Python 3.12， 从生成草稿到自动设置 1080p/30fps 并导出 MP4 均通过。

• 自动创建剪映草稿
• 批量导入视频、图片、音频
• 精确裁剪和排列时间线
• 添加字幕、文字、BGM、转场、滤镜、关键帧等
• 保留正常剪映工程，方便人工继续修改和团队协作
• Windows 下自动打开工程并导出 MP4
• 作为 Antigravity 等 Agent 的 Skill 使用
• 也可以由能够调用本机终端的 Chat/Agent 直接运行

• 不包含或分发剪映安装包
• 不破解 VIP/SVIP
• 不替换剪映 DLL
• 不绕过账号或服务器权限
• 不保证剪映 7.x+ 的旧式 UI 自动导出兼容性

本项目是非官方工具，与字节跳动/剪映无关联。

• Windows 10 / 11
• 剪映专业版 5.9.x
  • 最推荐、已实测：5.9.0.11611
  • 其他 5.9.x 会尝试工作，但可能需要额外适配
• Python 3.12
• Git for Windows
• 自动导出时需要正常的交互式 Windows 桌面会话

剪映默认安装结构应类似：

%LOCALAPPDATA%\JianyingPro\Apps\5.9.0.11611\JianyingPro.exe

为了便于审查，不把 irm | iex 作为首选安装方式。

git clone https://github.com/V0idream/Jianying-Agent-Automation.git
cd Jianying-Agent-Automation
powershell -ExecutionPolicy Bypass -File .\install.ps1

安装器会：

1. 自动检测已安装的剪映 5.9.x
2. 拉取固定、已验证的上游 jianying-editor-skill commit
3. 创建独立 Python 3.12 虚拟环境
4. 安装依赖
5. 应用 5.9 项目/导出窗口等待兼容补丁
6. 写入本机配置
7. 生成启动、自动化终端和自动导出入口
8. 自动执行基本验证

默认安装位置：

%LOCALAPPDATA%\JianyingAgentAutomation

如果剪映路径无法自动发现：

.\install.ps1 -JianyingExe "D:\JianyingPro\Apps\5.9.0.11611\JianyingPro.exe"

安装时直接绑定项目：

.\install.ps1 -AgentProject "D:\MyVideoProject"

或者稍后单独执行：

.\setup-agent.ps1 -ProjectRoot "D:\MyVideoProject" -WriteAgentGuide

它会建立 Junction：

D:\MyVideoProject\.agent\skills\jianying-editor
        ↓
%LOCALAPPDATA%\JianyingAgentAutomation\jianying-editor-skill

因此多个 Agent 项目可以共用同一份 Skill 和虚拟环境，不需要重复安装依赖。

之后可以直接对 Agent 说，例如：

按照 剪辑脚本.md，分析 素材 文件夹里的所有视频，生成一个约 3 分钟的剪映草稿。先不要导出，完成后检查时间线和素材引用。

如果你的 Chat 环境已经被授权调用本机文件系统和终端，可以直接运行本项目生成的入口， 不必额外使用 Codex。

启动指定剪映：

%LOCALAPPDATA%\JianyingAgentAutomation\start_jianying_590.cmd

打开已经配置好的 Python 环境：

%LOCALAPPDATA%\JianyingAgentAutomation\automation_shell.cmd

自动导出：

%LOCALAPPDATA%\JianyingAgentAutomation\export_draft.cmd "草稿名称" "D:\output.mp4" 1080 30

分辨率支持取决于上游导出器，常用值包括 720、1080、2K、4K； 帧率常用值包括 24、25、30、50、60。

.\verify.ps1

会检查：

• 剪映可执行文件
• Skill checkout
• Python 虚拟环境
• 剪映草稿目录
• 5.9 等待兼容补丁
• Python 自动化依赖

在 automation_shell.cmd 打开的终端里：

python examples\simple_project.py "D:\素材\clip.mp4" Demo_Project

更完整的 API 与自然语言工作流，请查看安装后的：

jianying-editor-skill\SKILL.md
jianying-editor-skill\usage.md
jianying-editor-skill\docs\

自动化依赖 UI 描述、草稿结构和 Python API。为了避免上游更新后突然破坏可复现性， 安装器固定到已经实际测试过的：

32c56928ded4f9e2c2b80e099dc7abb793d2c30b

需要升级时应先在测试工程验证，然后再更新此仓库的固定 commit。

原始导出控制器在点击草稿和点击“导出”后采用固定等待时间。 在 5.9.0.11611 上，项目加载偶尔会超过固定等待时间，从而出现：

未在编辑窗口中找到导出按钮

本仓库将这两处改成带超时的状态等待：

• 等待 edit 编辑窗口，最长 30 秒
• 等待 pre_export 导出窗口，最长 30 秒
• 导出按钮本身允许最多 15 秒出现

这不会修改剪映程序，只修改 Python 自动化控制逻辑。

自动导出依赖 Windows UI Automation：

• 导出过程中尽量不要抢鼠标/键盘焦点
• Windows 会话应保持登录、解锁
• 会员素材仍需要账号本身拥有对应权限
• 剪映弹窗、版本变化可能导致 UI 自动化失效
• 正式项目建议先生成可编辑草稿，再决定是否无人值守导出

本仓库采用 MIT License。

核心剪辑能力来自 jianying-editor-skill， 其本身采用 MIT License，并包含 Apache-2.0 的 pyJianYingDraft 组件。

详细归属见 NOTICE.md。

当前主要验证目标：

• Windows
• JianYing Pro 5.9.0.11611
• Python 3.12
• 草稿生成
• UI Automation 识别主页/编辑页
• 1080p / 30fps 自动导出
• Antigravity Junction 接入
• 更多 5.9.x build 回归测试
• 统一的高层 MCP Server