Novel Video Pipeline

重生爽文全自动流水线 SKILL

概述

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

目录结构要求

工作目录/
├── 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 — 搜索 "nature loop" / "abstract"
  • Pixabay — 完全免版税

bgm.mp3 — 背景音乐

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

FFmpeg

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

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

配置说明（cfg 字典）

cfg = {
    # ── LLM ──────────────────────────────────
    "api_key":   "YOUR_OPENAI_COMPATIBLE_API_KEY",
    "base_url":  "https://api.example.com/v1",   # OpenAI 兼容端点
    "model":     "gpt-4o",

    # ── Prompt（可选，有内置默认值）──────────
    "premise_prompt": "...",   # 脑洞生成 system prompt
    "story_prompt":   "...",   # 正文写作 system prompt

    # ── TTS ──────────────────────────────────
    "tts_delay":  10,          # 每段请求间隔秒数，防限流

    # ── 视频合成 ─────────────────────────────
    "bgm_vol":    0.08,        # 背景音乐音量（建议 0.05~0.15）
    "voice_vol":  1.8,         # 朗读人声音量（建议 1.5~2.5）
}

调用方式

方式一：直接命令行

# 全流程（题材随机）
python pipeline.py --all

# 指定题材
python pipeline.py --all --theme 末日

# 单步执行
python pipeline.py --novel --theme 职场
python pipeline.py --audio
python pipeline.py --video

环境变量传入 API 信息（推荐）：

export OPENAI_API_KEY="sk-xxx"
export OPENAI_BASE_URL="https://api.example.com/v1"
export OPENAI_MODEL="gpt-4o"
python pipeline.py --all --theme 修仙

方式二：Python 代码调用

from pipeline import run_novel, run_audio, run_video

cfg = {
    "api_key":  "sk-xxx",
    "base_url": "https://api.example.com/v1",
    "model":    "gpt-4o",
}

# 顺序执行全流程
run_novel("末日", cfg)
run_audio(cfg)
run_video(cfg)

AI 使用本 SKILL 的指令

当用户请求生成爽文视频时，Claude 应：

1. 读取本 SKILL.md，了解参数结构
2. 询问或推断以下信息：
   • 题材（theme）：用户指定或随机
   • API 配置：优先读环境变量 OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL
3. 调用 bash_tool 执行：

   python pipeline.py --all --theme <题材>
   

4. 实时输出日志，三步完成后告知用户 output.mp4 已生成

常见用户指令映射

输出格式说明

• output.txt 结构：

  【AI生成的绝妙脑洞】
  <一句话核心设定>
  
  【爽文正文】
  <连贯正文，无标题无分章>
  

• output.mp4：竖屏 1080×1920（9:16），适配抖音/视频号/小红书