Downloads

macOS / Windows — 直接下载上方附件

Linux — 请从 CI Artifact 下载(因体积超过 GitHub 2GB 限制):

1. 点击上方 Actions 标签
2. 选择 Release Build workflow
3. 点击对应构建 run
4. 在 Artifacts 中下载 SceneFab-linux-x86_64

# 下载后赋予执行权限
chmod +x SceneFab-4.0.0-linux-x86_64
./SceneFab-4.0.0-linux-x86_64

Downloads

macOS / Windows — 直接下载上方附件

Linux — 请从 CI Artifact 下载(因体积超过 GitHub 2GB 限制):

1. 点击上方 Actions 标签
2. 选择 Release Build workflow
3. 点击对应构建 run
4. 在 Artifacts 中下载 SceneFab-linux-x86_64

# 下载后赋予执行权限
chmod +x SceneFab-4.0.0-linux-x86_64
./SceneFab-4.0.0-linux-x86_64

Downloads

macOS / Windows — 直接下载上方附件

Linux — 请从 CI Artifact 下载(因体积超过 GitHub 2GB 限制):

1. 点击上方 Actions 标签
2. 选择 Release Build workflow
3. 点击对应构建 run
4. 在 Artifacts 中下载 SceneFab-linux-x86_64

# 下载后赋予执行权限
chmod +x SceneFab-4.0.0-linux-x86_64
./SceneFab-4.0.0-linux-x86_64

SceneFab v2.0.0 — 短剧解说特化与 DAG 并行流水线

发布日期: 2026年06月04日 | 完整 CHANGELOG | PR #67

🎯 核心亮点

SceneFab v2.0.0 是一次重大架构升级,专注短剧解说业务和流水线性能。新增 8 个核心模块(~2,700 行)、5 篇架构决策记录、33 个新测试。完全向后兼容 v1.x 公开 API。

🚀 新功能

DAG 并行流水线引擎 (scenefab.core.pipeline_engine)

• 拓扑排序 + parallel_group 并行执行
• always_run 步骤支持(即便上游失败也执行,常用于清理)
• 失败快速终止 / 循环依赖检测

FFmpeg 安全封装 (scenefab.core.ffmpeg_safe)

• 参数白名单(codec/preset/crf)
• 危险字符检测(; & | \ $ ()`)
• 路径黑名单(系统目录)
• 审计日志自动集成

操作审计日志 (scenefab.core.audit)

• SQLite 持久化
• track() 上下文管理器自动捕获 LLM/FFmpeg/流水线调用

批量任务处理器 (scenefab.core.batch_processor)

• 并行 worker(默认 2)
• 自动重试(指数退避)
• SQLite 断点续传

短剧解说特化 (scenefab.core.short_drama)

• 4 风格:悬疑 / 甜宠 / 复仇 / 逆袭
• 7 桥段识别:身份揭露 / 打脸 / 救场 / 背叛 / 心动 / 对峙 / 反转
• 集数扫描(EP01 / 第01集 / E01 等多种格式)

多平台智能适配 (scenefab.core.platform_adapter)

• 8 平台:抖音 / B站 / 小红书 / 西瓜 / YouTube / TikTok / 快手 / 剪映
• AI 智能裁剪(9:16 / 16:9 / 3:4)
• 平台专属封面生成

统一 Worker 基类 (scenefab.core.base_worker)

• PySide6 / headless 双模式
• 取消 / 暂停 / 错误传播
• 审计日志自动集成

LLM 流式输出 Worker (scenefab.core.streaming_llm_worker)

• 逐 token Signal 推送
• 句子边界检测
• 取消支持

📊 性能提升 (vs v1.1.0)

📚 架构决策记录

5 篇 ADR 记录核心架构决策:

• ADR-001: PySide6 vs Electron 桌面端 GUI 框架
• ADR-002: 全量本地处理 vs 云端渲染
• ADR-003: 事件驱动 + IoC 容器架构
• ADR-004: DAG 并行 vs 串行流水线
• ADR-005: F5-TTS 本地零样本 vs 云端 TTS

🧪 测试

• 33 个 v2.0 核心模块测试 — 全通过
• 416 个 v1.x 回归测试 — 零破坏
• 覆盖:循环依赖检测 / parallel timing / 注入防护 / 断点续传 / 桥段识别 / 智能裁剪

🔧 向后兼容

完全保留 v1.x 公开 API:

• EventBus / EventEmitter / ErrorInfo / event_bus / ApplicationState

📦 安装

pip install scenefab>=2.0.0
# 或
uv add scenefab>=2.0.0

🙏 致谢

感谢所有 v1.x 用户的反馈,v2.0 的设计决策来自实际生产痛点。

完整更新日志: CHANGELOG.md
文档: https://agions.github.io/scene-fab/

Downloads

macOS / Windows — 直接下载上方附件

Linux — 请从 CI Artifact 下载(因体积超过 GitHub 2GB 限制):

1. 点击上方 Actions 标签
2. 选择 Release Build workflow
3. 点击对应构建 run
4. 在 Artifacts 中下载 SceneFab-linux-x86_64

# 下载后赋予执行权限
chmod +x SceneFab-4.0.0-linux-x86_64
./SceneFab-4.0.0-linux-x86_64

What's Changed

• refactor(phase-1): unify duplicate type definitions by @Agions in #52
• refactor(phase-2): remove redundant compat layer files by @Agions in #53
• refactor(phase-3): split design_system & animation_helper into packages by @Agions in #54
• refactor(phase-4): remove dead code + unused imports by @Agions in #55
• refactor(phase-5): rename _signals.py to signals_bridge.py + centralize enums by @Agions in #56
• refactor(phase-7-8): UI 枚举导出 + 最终验收 by @Agions in #58
• refactor(phase-6): 配置精简 - 统一工具链与清理冗余 by @Agions in #57
• refactor(deps): 同步 requirements.txt 与 pyproject.toml + 移除冗余工具 by @Agions in #59
• feat(ruff): enable 'UP' (pyupgrade) rules + auto-fix codebase by @Agions in #60
• refactor(phase-3-2): split UI large files (theme_optimizer + home_page) by @Agions in #61
• chore(release): bump v1.0.1 → v1.1.0 by @Agions in #63

Full Changelog: v1.0.1...v1.1.0

Contributors

• @Agions

Downloads

macOS / Windows — 直接下载上方附件

Linux — 请从 CI Artifact 下载(因体积超过 GitHub 2GB 限制):

1. 点击上方 Actions 标签
2. 选择 Release Build workflow
3. 点击对应构建 run
4. 在 Artifacts 中下载 SceneFab-linux-x86_64

# 下载后赋予执行权限
chmod +x SceneFab-4.0.0-linux-x86_64
./SceneFab-4.0.0-linux-x86_64

Full Changelog: v1.0.0...v1.0.1

Downloads

macOS / Windows — 直接下载上方附件

Linux — 请从 CI Artifact 下载(因体积超过 GitHub 2GB 限制):

1. 点击上方 Actions 标签
2. 选择 Release Build workflow
3. 点击对应构建 run
4. 在 Artifacts 中下载 SceneFab-linux-x86_64

# 下载后赋予执行权限
chmod +x SceneFab-4.0.0-linux-x86_64
./SceneFab-4.0.0-linux-x86_64

What's Changed

• refactor: 架构重构 Phase 1-4 — 高内聚低耦合拆分 by @Agions in #48

Full Changelog: https://github.com/Agions/scene-fab/commits/v1.0.0

Contributors

• @Agions