Skip to main content

SceneFab - AI 影视解说视频创作工具,一键完成智能拆条 · 解说生成 · 配音合成

Project description

SceneFab

AI 影视解说创作工具 — 智能拆条 · AI 解说生成 · 一键配音合成

License: MIT Python PySide6 Platform Releases


定位

SceneFab — 上传一部电影/短剧,AI 自动完成语义拆条、生成解说稿、合成配音,一键导出解说视频。

从「几天一条」变成「一天十条」。

成本 隐私 效率
< ¥0.01/视频(DeepSeek-V4) 视频永不上传云端,全本地 5-15 分钟/条

核心能力

能力 说明
🎬 AI 语义拆条 Qwen2.5-VL 理解视频语义,按情节/场景自动切分,无需手动打点
🎭 情感峰值选段 视觉 + 音频双维评分,优先选取叙事高潮片段
✍️ AI 解说稿生成 DeepSeek-V4 生成情感丰富解说,7 种风格一键切换
🎙️ 一键配音合成 Edge-TTS / F5-TTS,50ms 精度字幕对齐
📦 多格式导出 H.264/H.265 MP4 直出,或原生剪映草稿 JSON
💻 命令行原生 pip 安装即用,支持 Agent 工作流接入(SKILL.md)

5 步创作流程

上传视频(mp4/mov/avi/webm)
    │
    ▼
┌──────────────────────────────────────────┐
│  Step 1 · AI 语义拆条                      │
│  Qwen2.5-VL 视觉理解,场景边界检测          │
└──────────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────────┐
│  Step 2 · 情感峰值选段                     │
│  视觉信息密度 × 0.6 + 音频语调 × 0.4       │
└──────────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────────┐
│  Step 3 · 解说稿生成                       │
│  DeepSeek-V4 · 7 种情感风格               │
└──────────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────────┐
│  Step 4 · 配音合成                         │
│  Edge-TTS / F5-TTS + 词级时间戳           │
└──────────────────────────────────────────┘
    │
    ▼
┌──────────────────────────────────────────┐
│  Step 5 · 视频合成导出                     │
│  FFmpeg H.264/H.265 · MP4 / 剪映草稿      │
└──────────────────────────────────────────┘

技术栈

模块 模型 / 技术 说明
语义拆条 Qwen2.5-VL 视频帧逐帧理解,语义场景边界检测
解说生成 DeepSeek-V4 第一人称视角,7 种预设风格
情感评分 视觉 + 音频双维 画面信息密度 + 语调变化,综合排序
配音合成 Edge-TTS · F5-TTS Edge 主流低延迟,F5 零样本音色克隆
字幕对齐 TTS Word-level Timing 精确到每个字的起止时间,50ms 精度
视频合成 FFmpeg H.264/H.265 编码,本地处理
导出格式 MP4 · 剪映草稿 直出发布 / 继续精剪

快速开始

安装

方式一:从 PyPI 安装(待发布)

pip install scenefab

方式二:从源码安装(推荐)

git clone https://github.com/Agions/scene-fab.git
cd scene-fab
pip install -e .

运行

# GUI 模式
scenefab gui

# 命令行模式
scenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/

配置 AI(只需一个 Key)

# DeepSeek(解说生成主力)
export DEEPSEEK_API_KEY="sk-..."

# 不配置时:Edge-TTS 配音等基础功能仍可正常使用

文档

文档 说明
快速开始 5 分钟上手
功能详解 全部功能说明
AI 工作流 5 步流水线详解
配置参考 环境变量与配置文件
疑难排查 常见问题

在线文档:https://agions.github.io/scene-fab/


许可证

MIT License · Copyright © 2025-2026 Agions


⭐ 如果 SceneFab 对你有帮助,请给一个 Star

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scenefab-1.1.0.tar.gz (630.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scenefab-1.1.0-py3-none-any.whl (675.3 kB view details)

Uploaded Python 3

File details

Details for the file scenefab-1.1.0.tar.gz.

File metadata

  • Download URL: scenefab-1.1.0.tar.gz
  • Upload date:
  • Size: 630.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for scenefab-1.1.0.tar.gz
Algorithm Hash digest
SHA256 05ecc4762b702d1cbd256e78212660deef51d817d7e903e5b953899032044a00
MD5 2d9786e73b50dd2a0d00b88bda811e8a
BLAKE2b-256 3ba26c5f866c4bc74ba636c571fc968da156a1eb521167ee51b53f8777dfc4ac

See more details on using hashes here.

File details

Details for the file scenefab-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: scenefab-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 675.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for scenefab-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7f948f27d72a2d8ade51d95ac00f7f0fc32121803b1de438c6dbfa7dedd6040d
MD5 3ffbbeda7b3b74271b6e01e0feb7f681
BLAKE2b-256 fcfd175c9cfd6adc087ca5c2ff08ebf8e9f7346560d1d726930e1a6367f4543c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page