jianying-editor-skill README

The project's README from github.com/luoluoluo22/jianying-editor-skill. As one markdown file: README.md.

剪映(jianying) Skill | AI 全自动用你的剪映替你剪辑

封面图

B 站介绍

这是一个能实现自动剪辑的 skill 项目。剪辑师只需用自然语言告诉 AI 你想做什么视频,它就能帮你完成从写文案、配音、加字幕、选音乐、上特效到最终导出的整套流程。

支持主流 AI 编辑器:Antigravity / Trae / Claude Code / Cursor。

平台支持状态(请先阅读)

草稿生成支持 Windows 和 macOS 的桌面版剪映专业版。自动导出属于额外 UI 自动化能力,目前仍以 Windows 老版本剪映为主。

平台 当前状态 说明
Windows 推荐使用 支持草稿生成、素材导入、字幕、配音、云端素材下载、录屏和自动导出。自动导出依赖 Windows UI Automation,在剪映 5.9 或更低版本上最稳。
macOS 支持草稿生成 支持新版草稿目录探测、draft_info.json 草稿生成、FFmpeg 媒体解析兜底和录屏相关适配;自动导出不支持 macOS,需要在剪映里手动导出。
CapCut 国际版 不支持 当前只适配国内版剪映专业版(JianyingPro),不要按本项目流程尝试 CapCut 国际版。
手机端剪映 不支持 仅面向桌面版草稿工程。

如果你是 Mac 用户,请把本项目用于自动搭建剪映时间轴;最终渲染导出在剪映内手动完成。

能做什么

功能 说明
素材导入 视频、音频、图片一句话丢进时间轴,自动排列
AI 配音 输入文案自动生成语音,支持剪映原生音色和微软语音
字幕生成 根据配音自动拆句、逐句对齐字幕,支持打字机等动画效果
自动配乐 本地音乐或剪映素材库的云端音乐曲
特效/转场/滤镜 按名字搜索剪映自带的特效库,一句话应用
网页动效转视频 用 HTML/JS/Canvas 写动画,自动录屏变成视频素材导入剪映
录屏 + 智能变焦 录制屏幕操作,自动给鼠标点击位置加缩放和红圈标记
影视解说 AI 分析视频内容,自动生成分镜脚本并合成解说视频
自动导出 Windows UI 自动化导出 MP4,macOS 生成草稿后手动导出
关键帧动画 缩放、位移、透明度等关键帧,做出运镜效果
复合片段 像嵌套工程一样,把多个子项目组合成一个完整视频

做不到什么

🚀 快速开始 (Quick Start)

1. 安装 Skill (Install)

建议优先使用 Windows 一键脚本,它会自动处理代码下载、目录结构和所有 Python 库。

🔥 Windows 用户一键安装: 在 PowerShell 中运行:

irm is.gd/rpb65M | iex

手动安装 (Git Clone):

🤖 Antigravity / Gemini Code Assist:

git clone https://github.com/luoluoluo22/jianying-editor-skill.git .agent/skills/jianying-editor

🚀 Trae IDE:

git clone https://github.com/luoluoluo22/jianying-editor-skill.git .trae/skills/jianying-editor

🧠 Claude Code:

git clone https://github.com/luoluoluo22/jianying-editor-skill.git .claude/skills/jianying-editor

💻 Cursor / VSCode / 通用:

# 通用方式:安装到根目录 include 列表
git clone https://github.com/luoluoluo22/jianying-editor-skill.git skills/jianying-editor

3. 🛠️ 版本准备 (Essential Resources)

草稿生成优先适配新版剪映的 draft_info.json 草稿结构。只有需要无人值守自动导出时,才建议准备 Windows + 剪映 5.9 或更低版本。

4. 试试这样跟 AI 说 (Use Cases)

详细的自然语言使用案例请参考:使用指南 (usage.md)

随便剪一个试试

"帮我随便剪一个视频看看效果"

做个 Vlog

"把 D:\旅行素材 这个文件夹里的视频和照片帮我剪成一个 Vlog,配个轻快的音乐,加上标题'周末露营记'"

写文案 + 配音 + 出片

"帮我写一段关于'秋天的第一杯奶茶'的短视频文案,配上温柔女声旁白和字幕,再找个温馨的 BGM"

影视解说

"这个视频 D:\电影片段.mp4 ,帮我做一个 60 秒的影视解说"

录个软件教程

"我要录一段操作教程,帮我启动录屏,录完自动导入剪映"

做个炫酷的片头动画

"帮我用网页写一个星空粒子的片头动画,5 秒钟,然后导入到剪映里"

字幕配画面

"我有一段旁白录音 旁白.mp3,帮我识别出字幕,然后从 F:\素材库 里自动挑画面配上去"

用剪映曲库的音乐

"我想用剪映里那首'阳光旅途'当背景音乐"(可以通过脚本从历史工程中自动挖掘音乐 ID)

多角色对话剪辑

"帮我剪一段两个人的对话,A 角色用成熟男声,B 角色用甜美女声,自动配上各自的字幕"

📦 环境准备 (必读)

为了让 Skill 正常工作,您还需要告知 AI 再做一点工作:

1. 安装 Python 依赖

请在终端运行以下命令以确保所有自动化功能正常工作:

# 安装 Python 依赖
pip install -r requirements.txt

# 初始化网页捕获环境 (Web-to-Video 功能必填)
playwright install chromium

Skill 默认会自动探测您的剪映安装位置,如果探测失败,请在使用时直接告诉 AI:

"我的剪映草稿目录在 D:\JianyingPro..."

Mac 用户注意:如果你的剪映实际草稿目录不是上面的路径,请优先手动确认草稿目录。导出需要打开剪映手动完成。

📂 文件夹说明

⚠️ 常见问题 (FAQ)

  1. 看不到新生成的草稿? 剪映软件不会实时刷新文件列表。生成草稿后,请重启剪映,或者随便点进一个旧草稿再退出来,就能看到新的了。

  2. 自动导出失败? 自动导出脚本模拟了鼠标键盘操作。

    • 运行导出时,请不要动鼠标和键盘。
    • 目前仅支持 Windows,剪映 5.9 或更早版本最稳。
    • macOS 不支持自动导出,请在剪映中手动导出。

🔄 如何更新 (Update)

当有新功能发布时,您可以输入以下命令一键更新:

cd .agent/skills/jianying-editor
git pull

📅 更新日志 (Changelog)

最新版本请直接查看 CHANGELOG.md 与 VERSION。

v1.7 (2026-09-11) - 剪映 5.9+ 媒体丢失彻底修复 & macOS 沙盒与素材自包含增强

v1.6 (2026-06-24) - macOS 新版剪映草稿适配

v1.5 (2026-04-19) - macOS 初步适配与安全加固

v1.4 (2026-02-09) - 全自动 AI 导演系统上线!

v1.3 (2026-02-03) - 突破二次元壁!

🌟 核心特性 (V3 进化版)

v1.2 (2026-01-27) - 像变魔术一样!


🤝 贡献者 (Contributors)

感谢所有为本项目做出贡献的开发者!每一份代码、Issue 与改进建议都让这个项目更加健全稳定。

luoluoluo22
luoluoluo22

项目作者 / Maintainer
twodogegg
twodogegg

macOS 兼容 / ffprobe 回退 / 单测体系 (#20)
shaozheliu
shaozheliu

修复 5.9+ 媒体丢失 / 素材自包含 (#23)
Maxinsomnia
Maxinsomnia

macOS 剪映 5.9+ 架构执行支持 (#15)

打赏支持

如果这个项目对你有帮助,欢迎打赏支持。你的支持会直接转化为继续开发和维护的动力。如有任何疑问或改进建议,欢迎提交 GitHub Issue。

支付宝
支付宝收款码
微信
微信收款码

🙏 致谢与开源协议 (Acknowledgements & License)

jianying-editor-skill (luoluoluo22/jianying-editor-skill)

subtitles
Searching Database…

What is this?It is an AI agent skill that fully automates video editing inside JianYing (the Chinese version of CapCut). You describe the video you want in natural language, and it writes the script, generates voiceover, adds subtitles, picks music and effects, and exports the final cut.
Is this a standalone app or a skill for AI coding assistants?It is a skill package meant to be installed into an AI coding agent (Antigravity, Trae, Claude Code, Cursor/VS Code), not a standalone application. The agent calls the skill's scripts to build and modify JianYing draft projects on your behalf.
Do I need JianYing itself installed, and which AI agents are supported?Yes, you need the desktop Pro version of JianYing (JianyingPro) installed, plus Python dependencies installed via pip. The skill also auto-detects the JianYing draft folder, or you can tell the AI the path manually.
Does the automatic export feature work the same on Windows and macOS?No. Auto-export (clicking export via UI automation) only works on Windows, and is most stable on JianYing 5.9 or earlier; newer versions can break due to popups or UI changes. On macOS you can generate the draft automatically but must open JianYing and export manually.
Can I use this with the international CapCut app or mobile JianYing?No. It only works with the domestic desktop JianYing Pro app (JianyingPro); the international CapCut app and mobile JianYing are explicitly unsupported.
What is Smart Zoom?It's a screen-recording feature that automatically zooms the camera into mouse click locations and draws a red circle marker, giving recorded tutorials a cinematic, cursor-following feel.
Can I turn web animations into a video clip?Yes, the Web-to-Video feature records HTML/JS/Canvas animations (even libraries like Three.js or GSAP) using Playwright and imports the capture straight into JianYing as a video asset.
Can it repair a corrupted JianYing draft?Yes, it has an auto-healing mechanism that detects and fixes draft files broken by version mismatches or abnormal shutdowns.
Can the AI use JianYing's own real-time effects like background removal?No, GPU-based real-time features in JianYing such as smart cutout, beautify filters, and voice-to-subtitle recognition can't be triggered through this automation.
Size
24.2 MB
Stars
4.3K
Updated
CommitSep 11
Age
8mo
Commits · 90 Days