## ✂️ n8n 剪映插件（JianYing n8n Integration）

**AI 驱动的自动化视频草稿生成工具，连接剪映与 n8n，打造高效、智能的视频创作流程**

---

### 🚀 插件亮点

* ✅ **批量草稿生成**：自动导入图文、语音、配乐等素材，一键生成多个剪映草稿。
* ✅ **AIGC 内容无缝融合**：支持将 ChatGPT 生成的文本、图像、语音等内容自动剪辑、自动配音，创作流程丝滑顺畅。
* ✅ **强大拓展能力**：开放动画、滤镜、转场等参数，灵活适配个性化创意需求。
* ✅ **零代码自动化**：基于 n8n 可视化流程构建，人人都能搭建视频自动化工作流，无需编码基础。

---

## 📦 安装说明

### 1️⃣ 安装插件

通过 n8n CLI 安装：

```bash
npm install n8n-nodes-jianying
```

或在 n8n 界面中的 `Settings > Community Nodes` 中搜索 **`jianying`** 并安装。

---

### 2️⃣ 安装 FFmpeg（视频处理依赖）

本插件依赖 FFmpeg 处理音视频内容，需确保本地或容器环境中安装并配置正确。

#### macOS（使用 Homebrew）：

```bash
brew install ffmpeg
```

#### Ubuntu / Debian：

```bash
sudo apt update && sudo apt install -y ffmpeg
```

#### Windows：

前往 [https://ffmpeg.org/download.html](https://ffmpeg.org/download.html) 下载可执行文件，并将 `ffmpeg.exe` 添加至系统环境变量。

---

## 🐳 n8n Docker 安装 FFmpeg（推荐做法）

若你使用的是 Docker 环境运行 n8n，可通过以下方式添加 FFmpeg 支持：

### ✅ 方法一：构建自定义镜像（推荐）

创建 `Dockerfile`：

```dockerfile
# Dockerfile
FROM n8nio/n8n:latest

USER root

# 安装 ffmpeg（Alpine 用 apk）
RUN apk add --no-cache ffmpeg

USER node
```

构建镜像：

```bash
docker build -t n8n-with-ffmpeg .
```

运行容器：

```bash
docker run -it --rm \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -v /draft:/draft \
  n8n-with-ffmpeg
```

---

### ✅ 方法二：使用 Docker Compose 配置

示例 `docker-compose.yml`：

```yaml
version: "3.8"

services:
  n8n:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
      - /draft:/draft
    environment:
      - GENERIC_TIMEZONE=Asia/Shanghai
      - N8N_BASIC_AUTH_ACTIVE=true
```

确保项目根目录下包含自定义 `Dockerfile`，然后启动：

```bash
docker compose up -d --build
```

---

## 🔧 应用场景

* 🎞 **图文转视频**：将公众号、文章、商品信息等内容一键转为剪映草稿视频。
* 🎙 **语音转视频**：将播客、录音转为视频并配上动态字幕。
* 🤖 **AI 视频生成**：结合 ChatGPT / Stable Diffusion 等工具批量生成视频草稿，适用于短视频矩阵运营。
* 🧠 **私域 / IP 账号运营**：高效输出解说类、带货类视频内容，构建自动化内容产线。
* 📺 **媒体创作者工作流**：通过 n8n 构建选题→生成→剪辑→导出全流程自动化系统。