SceneFab 是一款面向影视和短剧第一人称解说的 AI 视频创作工具。它将视频理解、脚本生成、配音合成、字幕装配和平台导出串成标准化流程，支持从单集创作到整季批量生产的完整链路。
系统围绕 DAG 并行流水线引擎 构建，采用事件驱动架构，支持 10+ 个 LLM 提供商和多平台导出预设。
| 痛点 | SceneFab 方案 |
|---|---|
| 🎞️ 视频拆条全靠手工打点，效率低 | AI 智能语义拆条（Qwen2.5-VL），按情节自动切分 |
| 📝 写脚本要理解人物关系 + 桥段 + 节奏 | 剧情图谱 + 桥段识别 + 第一人称 Hook→主体→钩子结构 |
| 🎙️ 配音成本高、音色不一致 | Edge-TTS 多音色 + F5-TTS 音色克隆，本地运行 |
| ⏱️ 字幕和配音对不齐 | 50ms 精度时间戳对齐，偏差 < 50ms 验收标准 |
| 📱 多平台导出参数杂 | 8 平台预设（抖音/B站/小红书/YouTube/TikTok...），一键导出 |
| 📚 短剧整季批量生产成本高 | 整季批量 + 断点续传 + 并行 worker + 实时进度追踪 |
|
场景分析 · 人物识别 · 情绪峰值检测 |
Hook 改写 · 桥段模板 · 多模型复核 |
Edge-TTS 多音色 · F5-TTS 克隆 |
|
SRT/ASS 双格式 · 安全区控制 |
8 平台预设 · H.264/H.265 |
整季批量 · 断点续传 · 并行 worker |
从 Releases 下载对应平台的安装包：
| 平台 | 文件 | 系统要求 |
|---|---|---|
| Windows | SceneFab-Setup-x.x.x.exe |
Windows 10+ |
| macOS | SceneFab-x.x.x.dmg |
macOS 11+ (Apple Silicon / Intel) |
| Linux | SceneFab-x.x.x.AppImage |
Ubuntu 20.04+ / glibc 2.31+ |
# 1. 安装 SceneFab
pip install scenefab
# 2. 验证 FFmpeg（必需依赖）
ffmpeg -version
# 应输出：ffmpeg version 6.x ...
# 如果未安装 FFmpeg：
brew install ffmpeg # macOS
sudo apt install ffmpeg # Ubuntu/Debian
winget install ffmpeg # Windows编辑 config/llm.yaml，填入至少一个 API Key：
LLM:
default_provider: "deepseek"
deepseek:
enabled: true
api_key: "sk-your-deepseek-key"
model: "deepseek-v4-pro"
qwen:
enabled: true
api_key: "sk-your-qwen-key"
model: "qwen3.7-max"或使用环境变量（更安全）：
export DEEPSEEK_API_KEY="sk-your-deepseek-key"
export QWEN_API_KEY="sk-your-qwen-key"# 启动 GUI（默认）
scenefab
# 查看版本
scenefab --version
# 查看帮助
scenefab --help详细说明请参阅 在线文档 - 快速开始。
SceneFab 采用事件驱动的 DAG 并行流水线架构，每个模块职责清晰、易于扩展：
flowchart TB
subgraph Client["桌面客户端 (PySide6 6.9+)"]
UI[工作台 · 创作流程 · 项目资产]
ViewModel[MVVM ViewModel]
end
subgraph Core["核心引擎"]
Bus[事件总线]
Engine[DAG 流水线引擎]
DI[依赖注入容器]
end
subgraph Services["业务服务"]
AI[AI 服务<br/>LLM · 视觉 · TTS · 脚本生成]
Video[视频服务<br/>分析 · 处理 · 导出]
Export[导出服务<br/>剪映 · MP4 · 字幕]
end
subgraph Pipeline["生产流水线"]
Import[① 素材导入]
Analyze[② 场景分析]
Script[③ 脚本生成]
Voice[④ 配音合成]
Caption[⑤ 字幕对齐]
Pub[⑥ 导出发布]
end
UI --> ViewModel
ViewModel --> Bus
Bus --> Engine
Engine --> DI
DI --> AI
DI --> Video
DI --> Export
Engine --> Pipeline
Import --> Analyze
Analyze --> Script
Script --> Voice
Voice --> Caption
Caption --> Pub
classDef brand fill:#0e7490,stroke:#22d3ee,color:#fff
classDef accent fill:#7c3aed,stroke:#a855f7,color:#fff
class Engine,DI,Bus brand
class AI,Video,Export accent
- MVVM 架构 — UI 与业务逻辑解耦（v2.4.0 全面 ViewModel 化）
- 事件驱动 — 解耦模块通信，所有状态变更可追溯
- DAG 流水线 — 支持并行执行和断点续传
- 插件化 — LLM / TTS / 视觉模型均可热插拔
- 本地优先 — 视频数据不出本机，仅 AI 调用走云端
| 组件 | 技术选型 | 用途 |
|---|---|---|
| 桌面端 | PySide6 6.9+ | Qt 跨平台 GUI |
| 视频处理 | FFmpeg 6.x · OpenCV · MoviePy | 音视频分析与合成 |
| AI 推理 | OpenAI SDK · google-generativeai | LLM 和视觉模型调用 |
| 语音合成 | Edge-TTS · F5-TTS | 解说配音生成 |
| 场景检测 | PySceneDetect | 视频场景自动分割 |
| 数据验证 | Pydantic 2.5+ | 结构化数据校验 |
| 配置管理 | PyYAML · python-dotenv | YAML/环境变量配置 |
| 安全 | cryptography · keyring | API 密钥加密存储 |
| HTTP API | FastAPI · uvicorn | 可选 REST API 服务 |
scene-fab/
├── src/scenefab/ # 主包
│ ├── core/ # 基础设施（事件总线 · DI · 审计 · 流水线引擎）
│ ├── models/ # 数据模型（项目 · 视频 · 叙述 · 媒体）
│ ├── services/ # 业务服务
│ │ ├── ai/ # AI 服务（LLM · 视觉 · TTS · 脚本生成）
│ │ ├── video/ # 视频服务（分析 · 处理 · 导出）
│ │ ├── export/ # 导出服务（剪映 · MP4 · 字幕）
│ │ └── video_tools/ # 视频工具（FFmpeg · 探测 · 硬件加速）
│ ├── pipeline/ # 生产流水线（状态机 · 步骤 · 评估）
│ ├── plugins/ # 插件系统（加载 · 注册 · 接口）
│ ├── api/ # HTTP API（FastAPI 路由）
│ ├── ui/ # 用户界面（PySide6 页面 · 主题）
│ └── utils/ # 工具函数（安全 · 版本 · 日志）
├── tests/ # 测试套件
├── docs/ # VitePress 文档站
├── assets/ # 品牌资源（logo · 徽章）
├── resources/ # 应用资源（图标 · 样式）
├── scripts/ # 构建/工具脚本
└── config/ # 配置文件
| 文档 | 说明 |
|---|---|
| 在线文档 | 完整文档中心（VitePress） |
| 快速开始 | 3 步安装、配置和首次运行 |
| 安装指南 | 各平台完整安装步骤 |
| AI 配置 | 多服务商配置详解 |
| CLI 参考 | 命令行使用说明 |
| Python API | Python API 完整文档 |
| 生产规范 | 第一人称解说完整生产流程 |
| AI 工作流 | 从视频到成片的 AI 流程详解 |
| 导出发布 | 导出格式与平台预设 |
| 疑难排查 | 常见问题解决 |
- Phase 1 — UI 模块化分层（净 -1536 行死代码）
- Phase 2 — ViewModel 化拆分
- Phase 3 — 暗色主题 + 运行时切换端到端
- 品牌重塑 — 双色调 logo 系统 + OG image + 渲染 pipeline
- drag-drop 文件拖拽（
AssetsPage的dragEnterEvent/dropEvent） - ViewModel 严格分层（移除
TYPE_CHECKINGhack, viewmodel 不再依赖 UI 类型） - macOS 公证（解决 Gatekeeper 拦截）
- 批量生产 UI（整季批量可视化调度）
- Web 版本 — Tauri 重写桌面端 + Web 端复用核心
- 多人协作 — 云端项目同步 + 团队权限
- AI 实时预览 — 边生成边预览，减少等待焦虑
- 插件市场 — 第三方 LLM / TTS / 视觉模型接入
欢迎贡献代码、报告问题或提出建议。
# 克隆仓库
git clone https://github.com/Agions/scene-fab.git
cd scene-fab
# 安装开发依赖
pip install -e ".[dev]"
# 运行测试
make test
# 代码检查
make lint
# 格式化
make format| 类型 | 用途 | 示例 |
|---|---|---|
feat |
新功能 | feat(pipeline): add batch production support |
fix |
Bug 修复 | fix(ai): handle Qwen API timeout gracefully |
docs |
文档变更 | docs(readme): update installation steps |
style |
代码格式（无逻辑变更） | style(ui): fix indentation in HomePage |
refactor |
代码重构 | refactor(core): split event bus into modules |
perf |
性能优化 | perf(video): cache scene analysis results |
test |
测试相关 | test(services): add e2e for export pipeline |
chore |
构建/工具 | chore(deps): bump PySide6 to 6.9 |
提交前请运行 make lint 和 make test。
SceneFab 的诞生离不开以下开源项目：
- PySide6 — Qt 官方 Python 绑定
- FFmpeg — 跨平台音视频处理
- Edge-TTS — 免费高质量 TTS
- F5-TTS — 开源音色克隆
- PySceneDetect — 视频场景检测
- Pydantic — 数据验证
- VitePress — 文档站框架
MIT License © 2025-2026 Agions