novel-video-pipeline

# 重生爽文全自动流水线 SKILL

## 概述

本 SKILL 封装三条独立流水线，可单独调用，也可顺序串联：

| 步骤 | 函数入口 | 输入 | 输出 |
|------|----------|------|------|
| 1. 生成小说 | `run_novel(theme, cfg)` | 题材字符串 | `output.txt` |
| 2. 生成语音 | `run_audio(cfg)` | `output.txt` | `audio/*.mp3` |
| 3. 生成视频 | `run_video(cfg)` | `audio/` + `video/` + `bgm.mp3` | `output.mp4` |

---

## 目录结构要求

```
工作目录/
├── pipeline.py        # 本 SKILL 的执行脚本
├── video/             # 竖屏或横屏 .mp4 素材（至少 1 个）
├── bgm.mp3            # 背景音乐
├── output.txt         # 步骤1生成，步骤2读取（自动创建）
├── audio/             # 步骤2生成，步骤3读取（自动创建/清空）
└── output.mp4         # 最终输出（自动创建）
```

---

## 素材准备（首次使用必读）

步骤3（生成视频）需要用户自行准备以下两个素材，**缺失时脚本会打印详细提示并终止**，不会静默失败。

### video/ — 视频背景素材

- 在脚本同级目录新建 `video/` 文件夹
- 放入至少 **1 个 `.mp4` 文件**（多个会随机拼接）
- 推荐使用**竖屏（9:16）无版权**背景视频，横屏也可自动居中裁剪成 1080×1920
- 免费素材推荐：
  - [Pexels Videos](https://www.pexels.com/videos/) — 搜索 "nature loop" / "abstract"
  - [Pixabay](https://pixabay.com/videos/) — 完全免版税

### bgm.mp3 — 背景音乐

- 将背景音乐文件**重命名为 `bgm.mp3`**，放在脚本同级目录
- 建议时长 **> 3 分钟**（脚本会循环播放，太短会有卡顿感）
- 默认混音：bgm 音量 `0.08`，人声音量 `1.8`（可通过 cfg 或 CLI 参数调整）
- 免费素材推荐：
  - [Free Music Archive](https://freemusicarchive.org/)
  - [YouTube 音频库](https://www.youtube.com/audiolibrary)（需登录）

### FFmpeg

系统需安装 FFmpeg（含 ffprobe），缺失时脚本会打印安装指引：

```bash
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows：下载后将 bin/ 加入系统 PATH
# https://ffmpeg.org/download.html
```

---



## 配置说明（cfg 字典）

```python
cfg = {
    # ── LLM ──────────────────────────────────
    "api_key":   "YOUR_OPENAI_COMPATIBLE_API_KEY",
    "base_url":  "https://api.example.com/v1",   # O...