PickSkill
← Back

jianying-editor

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)。提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。

README.md
Rendered from GitHub raw
View raw ↗

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

封面图

B 站介绍

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

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

能做什么

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

做不到什么

  • 不是剪映的替代品 -- 最终的视频渲染、预览回放还是靠剪映本身完成的,这个工具负责的是"自动帮你把时间轴搭好",帮你点击导出
  • 不能用剪映的实时特效 -- 像智能抠图、美颜、语音识别字幕这些需要剪映 GPU 实时处理的功能,目前无法通过代码调用
  • 不能操作剪映的全部 UI 按钮 -- "一键成片""图文成片"这类剪映内置的 AI 功能暂时没法自动触发
  • 自动导出依赖老版本 -- 自动导出功能目前只支持 剪映 5.9 及以下版本(6.0+ 弹窗太多会干扰自动化脚本)
  • 不支持手机端剪映 -- 只能配合 Windows/Mac 桌面版剪映专业版使用

🚀 快速开始 (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)

⚠️ 重要提示:本 Skill 的自动导出功能深度依赖 剪映 5.9 (或更低版本)。

⬇️ 点击下载 剪映专业版 5.9 (夸克网盘) (下载后请按照说明禁止更新)

4. 试试这样跟 AI 说

随便剪一个试试

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

做个 Vlog

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

写文案 + 配音 + 出片

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

影视解说

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

录个软件教程

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

做个炫酷的片头动画

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

字幕配画面

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

用剪映曲库的音乐

"我想用剪映里那首'阳光旅途'当背景音乐"(需要先在剪映里播放一次建立缓存)

📦 环境准备 (必读)

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

1. 安装 Python 依赖

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

# 安装 Python 依赖
pip install -r requirements.txt
 
# 初始化网页捕获环境 (Web-to-Video 功能必填)
playwright install chromium

2. 确认剪映安装位置

Skill 默认认为您的剪映安装在 C 盘默认位置: C:\Users\Administrator\AppData\Local\JianyingPro\User Data\Projects\com.lveditor.draft

如果您的剪映安装在 D 盘或其他位置,请在使用时直接告诉 AI:

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

📂 文件夹说明

  • SKILL.md: 给 AI 看的说明书。
  • references/: 参考文档与示例资料(非运行时依赖)。
  • scripts/vendor/: 运行时内置依赖(如 pyJianYingDraft)。
  • tools/recording/: 录屏神器,都在这里面。
  • assets/: 演示用的测试视频和音乐。

⚠️ 常见问题 (FAQ)

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

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

    • 运行导出时,请不要动鼠标和键盘。
    • 目前仅支持 剪映 5.9 或更早版本 (新版本弹窗太多容易干扰脚本)。

🔄 如何更新 (Update)

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

cd .agent/skills/jianying-editor
git pull

📅 更新日志 (Changelog)

最新版本请直接查看 CHANGELOG.mdVERSION

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

  • 🧠 AI 语义素材匹配 (Semantic Footage Match):
    • 核心里程碑:现在支持根据“视频画面内容、旁白音频、SRT 字幕”三位一体进行语义分析。AI 会自动理解每一句台词的含义,并从素材库中精准挑选最契合的画面进行剪辑(如说到“爆汁”自动对位流油特写)。

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

  • ✨ 网页转视频 (Web-to-Video):
    • 核心突破!现在支持直接将 HTML/Javascript/Canvas/SVG 编写的网页动效实时录制并无缝导入剪映主轨道。
    • 集成 Playwright 智能录屏引擎,支持自动等待动画结束信号 (window.animationFinished),产出高清无损素材。
    • 真正实现“代码即特效”,让前端动效库(如 Three.js, GSAP, Lottie)成为你的剪接素材库。

🌟 核心特性 (V3 进化版)

  • 顶级素材接入:
    • banana (Imagen 3): 正式接入,支持一行指令生成 4K 电影级神兽/场景贴纸。
    • Grok 3 (Media): 视觉天花板级图生视频,让你的静态素材瞬间化身史诗大片。
  • 多轨管理:支持视频、音频、字幕、贴纸、特效无限叠加,像专业剪辑师一样操作。
  • 全自动闭环: 从 Claude 4.5 剧本创作到素材生成,再到剪映草稿合成,一键全自动。
  • 智能变焦: 独家的 Smart Zoom 功能,能把普通的录屏自动变成“带镜头感”的演示视频。
  • 网页转视频 (Web-to-Video): 完美支持 Canvas/JS 动效实时捕捉,让 Web 的无限创意瞬间化身视频 VFX 素材。
  • 自动导出:内置自动化脚本,支持一键导出 1080P/4K 视频,彻底解放双手。

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

  • ✨ 智能变焦 (Smart Zoom):
    • 录制的教程视频太平淡?现在,它会自动帮你把镜头推进特写到鼠标点击的地方,就像电影镜头一样酷!
    • 自动红圈:鼠标点哪里,那里就自动出现小红圈,观众一眼就能看到重点。
    • 丝滑跟随:鼠标移动时,画面会像摄像机云台一样平滑跟随,再也不怕画面太小看不清了。
  • 🎥 录屏神器大升级:
    • 录完就能一键生成草稿!不用手动打开剪映,不用导入素材,点一下按钮,草稿就躺在你的剪映里了。
    • 终于支持连续录制了,一口气录十段素材也不用重启软件。
    • 录像文件会自动整理好,不再乱丢在桌面。

打赏支持

如果这个项目对你有帮助,欢迎打赏支持。你的支持会直接转化为继续开发和维护的动力。 打赏后有问题请直接联系我微信:wxluoluoluo222