Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Agions/scene-fab

Repository files navigation

SceneFab

从一部电影到 25 集短剧解说,AI 全程陪你一气呵成。


Version License Stars Forks Issues

CI Release Deploy

Python Qt FFmpeg Platform

在线文档 · 下载安装 · 报告问题 · 功能建议


📑 目录


它是什么?

SceneFab 是为自媒体解说创作者打造的 AI 影视解说视频一站式创作工具

上传一部电影或短剧 → AI 自动理解视频语义 → 按情节拆条 → 生成第一人称解说稿 → 合成情感化配音 → 对齐字幕 → 输出带解说的完整视频。

为什么选择 SceneFab

痛点 SceneFab 解法
写一篇解说稿要 2-3 小时 DeepSeek-V4 多 LLM 联合生成,7+ 风格,分钟级出稿
配音需要专业设备 Edge-TTS / F5-TTS 双引擎,50+ 音色 + 零样本克隆
字幕对齐手动逐句调整 TTS Word-level Timing,50ms 精度自动对齐
短剧整季 25 集一个个做 DAG 并行流水线,整季 15 分钟批量出
多平台尺寸不同要反复剪 8 平台智能适配,一键导出抖音/B站/小红书
视频文件上传到云端不安全 完全本地处理,素材隐私 100% 安全

目标用户:影视解说自媒体人 · 短剧批量生产团队 · 混剪创作者 · AI 视频工具开发者


核心能力

🎬 AI 语义拆条 ✍️ 智能解说生成 🎙️ 一键配音合成 📺 8 平台适配
Qwen3.7 视觉理解
自动识别场景边界、人物动作、对话起止
情感峰值选段 · ×ばつ音频双维评分
DeepSeek-V4 · 7+ 风格
第一人称视角 · 词级时间戳
短剧 4 风格(悬疑/甜宠/复仇/逆袭)
Edge-TTS · F5-TTS
50ms 精度字幕对齐
零样本音色克隆 · 情感化语音
抖音/B站/小红书/西瓜
YouTube/TikTok/快手/剪映
AI 智能裁剪 + 平台封面
⚡ DAG 并行流水线 📺 短剧整季批量 🔒 安全加固 📊 数据回流
拓扑排序 + parallel_group
解说/配音/封面 3 步并行
整季 25 集 15 分钟出
25-50 集一键导入
自动识别集数 · 断点续传
自动重试 · 进度实时反馈
FFmpeg 参数白名单
消除 90%+ 命令注入面
SQLite 审计日志全程记录
多平台效果追踪
播放/点赞/评论/完播率
智能优化建议 · 闭环迭代

快速开始

下载安装

前往 Releases 页面下载:

平台 架构 安装包
🪟 Windows x64 SceneFab-x.x.x-x64-setup.exe
🍎 macOS Apple Silicon SceneFab-x.x.x-aarch64.dmg
🍎 macOS Intel SceneFab-x.x.x-x64.dmg
🐧 Linux x64 SceneFab-x.x.x-x64.AppImage

配置 AI(只需一个 Key)

# DeepSeek(解说生成主力)
export DEEPSEEK_API_KEY="sk-..."
# 可选:Qwen3.7(视觉理解增强)
export QWEN_API_KEY="sk-..."
# 不配置也能用:Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用

常用命令

# 单视频解说创作
scenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/
# 短剧整季批量生产
scenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2
# 多平台一键导出
scenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu

架构

┌──────────────────────────────────────────────────────────────────┐
│ UI 层 (PySide6 6.9) │
│ SceneFabMainWindow · 工作台 · 创作流程 · 项目资产 · 系统设置 │
└──────────────────────────┬───────────────────────────────────────┘
 │ Signal/Slot
 ▼
┌──────────────────────────────────────────────────────────────────┐
│ v2.x 核心引擎 (scenefab.core.*) │
│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ ┌────────────┐ │
│ │PipelineEngine│ │BatchProcessor│ │ SafeFFmpeg │ │AuditLogger │ │
│ │ (DAG 并行) │ │ (批量+断点) │ │ (白名单) │ │ (SQLite) │ │
│ └─────────────┘ └─────────────┘ └────────────┘ └────────────┘ │
└──────────────────────────┬───────────────────────────────────────┘
 │
 ▼
┌──────────────────────────────────────────────────────────────────┐
│ 业务服务层 (services/) │
│ ai/ LLM · Vision · TTS · ASR 适配器 │
│ video/ FFmpeg · 帧提取 · 合成 · 缓存 │
│ video_understanding/ 长视频剧情理解 (v2.2 状态机 UNDERSTAND) │
│ export/ MP4 · 剪映草稿 · 8 平台导出 │
└──────────────────────────┬───────────────────────────────────────┘
 │
 ▼
┌──────────────────────────────────────────────────────────────────┐
│ Models + Utils + Plugins (数据+工具) │
│ models/ 领域模型 │ utils/ 工具函数 │ plugins/ 插件加载 │
└──────────────────────────────────────────────────────────────────┘

技术栈

技术
视觉理解 Qwen3.7 · Gemini 3.5 Flash
解说生成 DeepSeek-V4 · 多 LLM Fallback
语音合成 Edge-TTS · F5-TTS
视频处理 FFmpeg · OpenCV
UI 框架 PySide6 · Qt Design Tokens
数据存储 SQLite 3 · 本地优先
AI Agent Hermes Agent · MCP Protocol

路线图

已完成 ✅

  • v2.1.1 — 解说生成状态机(5 状态 + 评估循环)· 架构清理
  • v2.1.0 — 统一架构(EventBus + DI + 类型化事件)
  • v2.0.0 — DAG 并行流水线 · FFmpeg 安全加固 · 短剧批量 · 8 平台适配
  • v1.1.0 — 8-Phase 架构重构 · 影视解说基础工作流

进行中 🚧

  • v2.2.0 — AI 模型升级(Qwen3.7 / Gemini 3.5 Flash / 新 TTS)· 数据回流 · 情绪分析 · 爆款预测
  • 插件市场(用户自定义 AI Provider / TTS 音色)

未来规划 🔮

  • 智能字幕翻译(保留时序的多语言翻译)
  • 云端协作(项目云存储 + 多人审稿)
  • 移动端预览(iOS / Android 实时预览 App)

许可证

MIT License · Copyright © 2025-2026 Agions


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

🚀 下载 · 📖 文档 · 🐛 Issue

Packages

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /