JianyingSkill 使用教程

让 Codex 接管剪映替你剪视频的开源 skills

⭐ 开源项目 · MIT

📖 项目简介

jianying-editor 是一个让 Codex 接管桌面版剪映、替你把时间轴搭好的开源 skills。作者 luoluoluo22,GitHub 上 4137 Star(2026 年 10 月 17 日查询),MIT 协议。你用一句话说明想剪成什么样,它就在本机生成一条剪映专业版草稿:素材进时间轴,配音、字幕、音乐、转场排好。Windows 上还可以自动点导出。

它不是剪映的替代品。最终预览和渲染还是剪映自己做。这个 skills 做的是把草稿文件写进剪映的工程目录,底层在开源项目 pyJianYingDraft(Apache 2.0,作者 GuanYixuan)上适配了剪映 5.9 及以上的 draft_info.json。智能抠图、美颜、语音识别字幕这类要剪映实时计算的功能,目前不能靠代码调用。

仓库的安装说明写了 Antigravity、Trae、Claude Code 和 Cursor。Codex 会从项目的 skills 目录读取 skills,把仓库克隆进去之后,直接说人话就能让它剪 Vlog、口播、教程和影视解说。

✨ 核心亮点

💬
一句话出草稿
把素材文件夹丢给它,说想剪成什么样,时间轴按顺序排好
🎙️
配音字幕对齐
文案生成语音,字幕逐句对齐,支持剪映音色和微软语音
🎵
音乐特效转场
按名字搜剪映自带的滤镜、特效、转场和曲库里用过的歌
🪟
Windows 可导出
草稿生成后,Windows 上可以自动点导出;Mac 生成草稿后手动导出

📋 能力速览

项目说明
输入本地视频、图片、音频、一段文案,或一段网页动效
适用类型旅行 Vlog、口播短视频、软件教程录屏、影视解说、片头动画
输出剪映专业版草稿;Windows 上可再导出 MP4 和字幕文件
语言 / 兼容中文口令。Windows 推荐;macOS 只生成草稿;不支持手机版剪映,也不支持 CapCut 国际版
规格草稿适配剪映 5.9 及以上的 draft_info.json。自动导出在剪映 5.9 及更低版本最稳

💻 环境要求

项目要求
操作系统Windows 10 / 11 推荐。macOS 可以生成草稿,导出要在剪映里手动点
运行环境Python 3,本机已安装 FFmpeg。桌面版剪映专业版
硬件没有独立显卡要求。预览和渲染交给剪映
低配方案只让它生成草稿,不跑自动导出。导出时自己打开剪映点
关键依赖仓库 requirements 里的库。网页动效还要装 Playwright 的 Chromium

🚀 如何使用

最省事的路径:把仓库地址发给 Codex,让它克隆到项目的 skills 目录,依赖装好,然后直接说人话。
1

装 Python 依赖

在项目目录打开终端,装仓库列出的依赖。要用网页动效,再装一次浏览器内核。

pip install -r requirements.txt playwright install chromium
2

装进 Codex 的 skills 目录

把仓库地址发给 Codex,让它克隆到当前项目的 skills 目录,文件夹名用 jianying-editor。Windows 也可以直接运行仓库 README 里的一键安装命令,命令放在上面的折叠链接里。

git clone <仓库地址> skills/jianying-editor
3

先跑通一个最小例子

对 Codex 说下面两句。第一句检查 FFmpeg、依赖和剪映草稿目录;第二句会建一条名为 Skill Test 的测试草稿。

检查一下剪映自动化的环境是否正常 随便剪一个测试视频给我看看

剪映不会自动刷新草稿列表。生成之后重启剪映,或者点进一个旧草稿再退出来,新草稿才会出现。

关键参数

参数怎么选
草稿目录它会自己找。找不到就把本机剪映草稿目录直接告诉它,Windows 常见在用户目录下的 JianyingPro 工程文件夹
音色说「温柔女声」「深沉男声」即可。接口里对应剪映音色或微软语音的说话人名字
分辨率初始化工程时按主素材比例设置。不说的话默认横屏 1920×1080
自动导出只在 Windows 上可用,剪映 5.9 及更低版本最稳。导出时不要动鼠标键盘。Mac 请手动导出
4

进阶:解说、录屏、网页动效

影视解说、录屏变焦、把一段网页动画录进时间轴,都是直接说人话,不用自己记命令。

把这段电影片段做成六十秒的影视解说,配深沉一点的男声,做完直接导出到桌面 我要录一段操作教程,录完自动加缩放,再导入剪映 用网页写一个 5 秒的星空粒子片头,然后导入剪映
5

和 Codex 一起用

装好之后不要再记脚本路径。业务脚本让 Codex 写在你自己的项目根目录,不要写进 skills 安装目录,以后更新才不会把你的脚本冲掉。

把这个文件夹里的露营素材剪成一条 Vlog,配轻快的音乐,标题叫周末露营记。

🎯 典型应用场景

🏕️
旅行 Vlog
一个文件夹的视频和照片,按顺序排好,配音乐和标题
🗣️
口播短视频
写文案、配音、字幕对齐,一次进草稿
🖥️
软件教程
录屏之后按鼠标点击加缩放和标记,再导入剪映
🎬
影视解说
给一段影片写解说、配音,句子和画面对齐
✨
片头动画
用网页写出几秒动效,录成视频放进时间轴
👥
多角色对话
两个说话人用不同音色,字幕跟着人换样式

⚙️ 和同类做法对比

做法差别
自己在剪映里拖素材、配音、字幕、音乐都要手工对轨。这个 skills 把这些步骤写成草稿
剪映里的一键成片那是剪映自己的功能。这个项目明确写了:这类内置按钮目前不能自动点
直接生成成片的工具那些工具输出的是视频文件。这个 skills 输出的是剪映工程,进软件后每一轨还能改
原理就一句:它改的是剪映草稿文件,不是去模拟你每一个鼠标点击。自动导出才是 Windows 上的界面自动化,所以导出时手要离开鼠标。

❓ 常见问题

Q:和剪映自己的 AI 助手有什么区别?

剪映助手是软件里面的功能。这个 skills 跑在 Codex 这类编程助手里,直接改本机的草稿文件,适合已经有素材、想按一句话把时间轴搭好的人。

Q:支持哪些剪映?

只支持国内桌面版剪映专业版。手机版剪映和 CapCut 国际版都不要按这个流程试。

Q:生成了,剪映里却看不到新草稿?

剪映不会实时刷新文件列表。重启剪映,或者点进一个旧草稿再退出来。

Q:自动导出失败了?

导出脚本在模拟鼠标和键盘,运行时不要碰它们。目前仅 Windows,剪映 5.9 或更早版本最稳。新版本弹窗一变就可能点偏。macOS 不支持自动导出,请在剪映里手动导出。

Q:Mac 能不能用?

能生成草稿、导入素材、用 FFmpeg 解析媒体。导出要自己打开剪映点。草稿目录和 Windows 不一样,找不到就手动把路径告诉 Codex。

Q:草稿目录在哪?

它会先自动探测。Windows 常见在本机用户目录的 JianyingPro 工程文件夹里;macOS 常见在「影片」下面的 JianyingPro 目录。探测失败时,把真实路径发一句给 Codex。

Q:提示媒体丢失、素材对不上?

剪映 5.9 及以上曾出现导入后提示媒体丢失。v1.7 起会把外部素材暂存进草稿目录,并给视频和音频补上稳定的本地素材编号。请把 skills 更新到这个版本之后再生成一次。

Q:怎么和 Codex 配合?

克隆到项目的 skills 目录,依赖装好,然后说人话。不要把你自己的剪辑脚本写进 skills 安装目录,更新时容易被盖掉。

Q:和 pyJianYingDraft 是什么关系?

草稿读写的底层来自 pyJianYingDraft,协议是 Apache 2.0。本仓库在它之上做了 5.9 及以上草稿结构、素材自包含、macOS 适配,以及给 AI 用的高层封装。本仓库本身是 MIT。

Q:能不能调用剪映的美颜、抠图、识别字幕?

不能。这些要剪映在界面里实时计算,目前没有代码接口。字幕请走它自己的「文案转语音再对齐」,或者你已经有旁白音频,让它识别后铺字幕。