{"repo": "agions/scene-fab", "files": {"README.md": {"2dd89ad8cf59f03c551c82e3c4e9b5e205b6c0b9": {"t": 1785747352.6507182, "n": 10482, "h": "0a7881a2ff3595d7", "c": "\n\n
![\"SceneFab\"](\"assets/logo-horizontal.svg\")
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **从素材理解、脚本生成、配音合成到多平台导出，一站式自动化生产流程**\n\n[](https://github.com/Agions/scene-fab/releases)\n[](https://www.python.org/)\n[](https://doc.qt.io/qtforpython/)\n[](https://ffmpeg.org/)\n[](LICENSE)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/issues)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**快速开始**](#快速开始) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new?template=bug_report.md) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n 🎬 AI 视频理解\n 场景分析 · 人物识别 · 情绪峰值检测
桥段识别 · StoryGraph 剧情图谱 \n | \n \n 📝 第一人称脚本\n Hook 改写 · 桥段模板 · 多模型复核
字数约束 · 风格预设（7 种） \n | \n \n 🎙️ 智能配音合成\n Edge-TTS 多音色 · F5-TTS 克隆
50ms 时间戳对齐 · 音量稳定 \n | \n
\n \n \n 📐 字幕装配\n SRT/ASS 双格式 · 安全区控制
样式保留 · 多平台适配 \n | \n \n 📱 多平台导出\n 8 平台预设 · H.264/H.265
剪映草稿 JSON · MP4 直出 \n | \n \n 🔄 批量生产\n 整季批量 · 断点续传 · 并行 worker
实时进度 · 失败重试 \n | \n
\n
\n\n---\n\n## ⚡ 快速开始\n\n### 📥 安装 SceneFab\n\n#### 方式一：下载安装包（推荐新手）\n\n从 [Releases](https://github.com/Agions/scene-fab/releases) 下载对应平台的安装包：\n\n| 平台 | 文件 | 系统要求 |\n|------|------|----------|\n| Windows | `SceneFab-Setup-x.x.x.exe` | Windows 10+ |\n| macOS | `SceneFab-x.x.x.dmg` | macOS 11+ (Apple Silicon / Intel) |\n| Linux | `SceneFab-x.x.x.AppImage` | Ubuntu 20.04+ / glibc 2.31+ |\n\n#### 方式二：pip 安装（推荐开发者）\n\n```bash\n# 1. 安装 SceneFab\npip install scenefab\n\n# 2. 验证 FFmpeg（必需依赖）\nffmpeg -version\n# 应输出：ffmpeg version 6.x ...\n\n# 如果未安装 FFmpeg：\nbrew install ffmpeg # macOS\nsudo apt install ffmpeg # Ubuntu/Debian\nwinget install ffmpeg # Windows\n```\n\n### ⚙️ 配置 AI 服务\n\n编辑 `config/llm.yaml`，填入至少一个 API Key：\n\n```yaml\nLLM:\n default_provider: \"deepseek\"\n\n deepseek:\n enabled: true\n api_key: \"sk-your-deepseek-key\"\n model: \"deepseek-v4-pro\"\n\n qwen:\n enabled: true\n api_key: \"sk-your-qwen-key\"\n model: \"qwen3.7-max\"\n```\n\n或使用环境变量（更安全）：\n\n```bash\nexport DEEPSEEK_API_KEY=\"sk-your-deepseek-key\"\nexport QWEN_API_KEY=\"sk-your-qwen-key\"\n```\n\n### ▶️ 启动 SceneFab\n\n```bash\n# 启动 GUI（默认）\nscenefab\n\n# 查看版本\nscenefab --version\n\n# 查看帮助\nscenefab --help\n```\n\n详细说明请参阅 [在线文档 - 快速开始](https://agions.github.io/scene-fab/guide/quick-start)。\n\n---\n\n## 🏗️ 技术架构\n\nSceneFab 采用**事件驱动的 DAG 并行流水线**架构，每个模块职责清晰、易于扩展：\n\n```mermaid\nflowchart TB\n subgraph Client[\"桌面客户端 (PySide6 6.9+)\"]\n UI[工作台 · 创作流程 · 项目资产]\n ViewModel[MVVM ViewModel]\n end\n\n subgraph Core[\"核心引擎\"]\n Bus[事件总线]\n Engine[DAG 流水线引擎]\n DI[依赖注入容器]\n end\n\n subgraph Services[\"业务服务\"]\n AI[AI 服务
LLM · 视觉 · TTS · 脚本生成]\n Video[视频服务
分析 · 处理 · 导出]\n Export[导出服务
剪映 · MP4 · 字幕]\n end\n\n subgraph Pipeline[\"生产流水线\"]\n Import[① 素材导入]\n Analyze[② 场景分析]\n Script[③ 脚本生成]\n Voice[④ 配音合成]\n Caption[⑤ 字幕对齐]\n Pub[⑥ 导出发布]\n end\n\n UI --> ViewModel\n ViewModel --> Bus\n Bus --> Engine\n Engine --> DI\n DI --> AI\n DI --> Video\n DI --> Export\n Engine --> Pipeline\n\n Import --> Analyze\n Analyze --> Script\n Script --> Voice\n Voice --> Caption\n Caption --> Pub\n\n classDef brand fill:#0e7490,stroke:#22d3ee,color:#fff\n classDef accent fill:#7c3aed,stroke:#a855f7,color:#fff\n class Engine,DI,Bus brand\n class AI,Video,Export accent\n```\n\n### 关键设计决策\n\n- **MVVM 架构** — UI 与业务逻辑解耦（v2.4.0 全面 ViewModel 化）\n- **事件驱动** — 解耦模块通信，所有状态变更可追溯\n- **DAG 流水线** — 支持并行执行和断点续传\n- **插件化** — LLM / TTS / 视觉模型均可热插拔\n- **本地优先** — 视频数据不出本机，仅 AI 调用走云端\n\n---\n\n## 🛠️ 技术栈\n\n| 组件 | 技术选型 | 用途 |\n|------|----------|------|\n| 桌面端 | PySide6 6.9+ | Qt 跨平台 GUI |\n| 视频处理 | FFmpeg 6.x · OpenCV · MoviePy | 音视频分析与合成 |\n| AI 推理 | OpenAI SDK · google-generativeai | LLM 和视觉模型调用 |\n| 语音合成 | Edge-TTS · F5-TTS | 解说配音生成 |\n| 场景检测 | PySceneDetect | 视频场景自动分割 |\n| 数据验证 | Pydantic 2.5+ | 结构化数据校验 |\n| 配置管理 | PyYAML · python-dotenv | YAML/环境变量配置 |\n| 安全 | cryptography · keyring | API 密钥加密存储 |\n| HTTP API | FastAPI · uvicorn | 可选 REST API 服务 |\n\n---\n\n## 📁 项目结构\n\n```\nscene-fab/\n├── src/scenefab/ # 主包\n│ ├── core/ # 基础设施（事件总线 · DI · 审计 · 流水线引擎）\n│ ├── models/ # 数据模型（项目 · 视频 · 叙述 · 媒体）\n│ ├── services/ # 业务服务\n│ │ ├── ai/ # AI 服务（LLM · 视觉 · TTS · 脚本生成）\n│ │ ├── video/ # 视频服务（分析 · 处理 · 导出）\n│ │ ├── export/ # 导出服务（剪映 · MP4 · 字幕）\n│ │ └── video_tools/ # 视频工具（FFmpeg · 探测 · 硬件加速）\n│ ├── pipeline/ # 生产流水线（状态机 · 步骤 · 评估）\n│ ├── plugins/ # 插件系统（加载 · 注册 · 接口）\n│ ├── api/ # HTTP API（FastAPI 路由）\n│ ├── ui/ # 用户界面（PySide6 页面 · 主题）\n│ └── utils/ # 工具函数（安全 · 版本 · 日志）\n├── tests/ # 测试套件\n├── docs/ # VitePress 文档站\n├── assets/ # 品牌资源（logo · 徽章）\n├── resources/ # 应用资源（图标 · 样式）\n├── scripts/ # 构建/工具脚本\n└── config/ # 配置文件\n```\n\n---\n\n## 📚 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [在线文档](https://agions.github.io/scene-fab/) | 完整文档中心（VitePress） |\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 3 步安装、配置和首次运行 |\n| [安装指南](https://agions.github.io/scene-fab/guide/installation) | 各平台完整安装步骤 |\n| [AI 配置](https://agions.github.io/scene-fab/guide/ai-configuration) | 多服务商配置详解 |\n| [CLI 参考](https://agions.github.io/scene-fab/guide/cli-reference) | 命令行使用说明 |\n| [Python API](https://agions.github.io/scene-fab/guide/python-api) | Python API 完整文档 |\n| [生产规范](https://agions.github.io/scene-fab/guide/first-person-narration-production) | 第一人称解说完整生产流程 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 从视频到成片的 AI 流程详解 |\n| [导出发布](https://agions.github.io/scene-fab/guide/exporting) | 导出格式与平台预设 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题解决 |\n\n---\n\n## 🗺️ 路线图\n\n### ✅ v2.4.0（2026-07-01）— UI 架构升级\n\n- [x] **Phase 1** — UI 模块化分层（净 -1536 行死代码）\n- [x] **Phase 2** — ViewModel 化拆分\n- [x] **Phase 3** — 暗色主题 + 运行时切换端到端\n- [x] **品牌重塑** — 双色调 logo 系统 + OG image + 渲染 pipeline\n\n### 🚧 v2.5.0（计划中）\n\n- [ ] **drag-drop 文件拖拽**（`AssetsPage` 的 `dragEnterEvent`/`dropEvent`）\n- [ ] **ViewModel 严格分层**（移除 `TYPE_CHECKING` hack, viewmodel 不再依赖 UI 类型）\n- [ ] **macOS 公证**（解决 Gatekeeper 拦截）\n- [ ] **批量生产 UI**（整季批量可视化调度）\n\n### 💡 v3.0.0（远期）\n\n- [ ] **Web 版本** — Tauri 重写桌面端 + Web 端复用核心\n- [ ] **多人协作** — 云端项目同步 + 团队权限\n- [ ] **AI 实时预览** — 边生成边预览，减少等待焦虑\n- [ ] **插件市场** — 第三方 LLM / TTS / 视觉模型接入\n\n---\n\n## 🤝 贡献\n\n欢迎贡献代码、报告问题或提出建议。\n\n### 开发环境\n\n```bash\n# 克隆仓库\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\n\n# 安装开发依赖\npip install -e \".[dev]\"\n\n# 运行测试\nmake test\n\n# 代码检查\nmake lint\n\n# 格式化\nmake format\n```\n\n### 提交规范（Conventional Commits）\n\n| 类型 | 用途 | 示例 |\n|------|------|------|\n| `feat` | 新功能 | `feat(pipeline): add batch production support` |\n| `fix` | Bug 修复 | `fix(ai): handle Qwen API timeout gracefully` |\n| `docs` | 文档变更 | `docs(readme): update installation steps` |\n| `style` | 代码格式（无逻辑变更） | `style(ui): fix indentation in HomePage` |\n| `refactor` | 代码重构 | `refactor(core): split event bus into modules` |\n| `perf` | 性能优化 | `perf(video): cache scene analysis results` |\n| `test` | 测试相关 | `test(services): add e2e for export pipeline` |\n| `chore` | 构建/工具 | `chore(deps): bump PySide6 to 6.9` |\n\n提交前请运行 `make lint` 和 `make test`。\n\n### 问题反馈\n\n- 🐛 [Bug 报告](https://github.com/Agions/scene-fab/issues/new?template=bug_report.md)\n- 💡 [功能建议](https://github.com/Agions/scene-fab/issues/new?template=feature_request.md)\n- 💬 [讨论区](https://github.com/Agions/scene-fab/discussions)\n\n---\n\n## 🙏 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython/) — Qt 官方 Python 绑定\n- [FFmpeg](https://ffmpeg.org/) — 跨平台音视频处理\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 免费高质量 TTS\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 开源音色克隆\n- [PySceneDetect](https://www.scenedetect.com/) — 视频场景检测\n- [Pydantic](https://pydantic-docs.helpmanual.io/) — 数据验证\n- [VitePress](https://vitepress.dev/) — 文档站框架\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n**[⭐ Star](https://github.com/Agions/scene-fab)** · **[🍴 Fork](https://github.com/Agions/scene-fab/fork)** · **[📖 文档](https://agions.github.io/scene-fab/)** · **[📝 更新日志](CHANGELOG.md)**\n\nSceneFab v2.4.0 · Made with ❤️ by [Agions](https://github.com/Agions) and [contributors](https://github.com/Agions/scene-fab/graphs/contributors)\n\n
"}, "b4ecd2188a784d0e8d256d127fd1b3dc09da8037": {"t": 1785772719.522652, "n": 10482, "h": "0a7881a2ff3595d7", "c": "\n\n
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **从素材理解、脚本生成、配音合成到多平台导出，一站式自动化生产流程**\n\n[](https://github.com/Agions/scene-fab/releases)\n[](https://www.python.org/)\n[](https://doc.qt.io/qtforpython/)\n[](https://ffmpeg.org/)\n[](LICENSE)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/issues)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**快速开始**](#快速开始) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new?template=bug_report.md) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n 🎬 AI 视频理解\n 场景分析 · 人物识别 · 情绪峰值检测
桥段识别 · StoryGraph 剧情图谱 \n | \n \n 📝 第一人称脚本\n Hook 改写 · 桥段模板 · 多模型复核
字数约束 · 风格预设（7 种） \n | \n \n 🎙️ 智能配音合成\n Edge-TTS 多音色 · F5-TTS 克隆
50ms 时间戳对齐 · 音量稳定 \n | \n
\n \n \n 📐 字幕装配\n SRT/ASS 双格式 · 安全区控制
样式保留 · 多平台适配 \n | \n \n 📱 多平台导出\n 8 平台预设 · H.264/H.265
剪映草稿 JSON · MP4 直出 \n | \n \n 🔄 批量生产\n 整季批量 · 断点续传 · 并行 worker
实时进度 · 失败重试 \n | \n
\n
\n\n---\n\n## ⚡ 快速开始\n\n### 📥 安装 SceneFab\n\n#### 方式一：下载安装包（推荐新手）\n\n从 [Releases](https://github.com/Agions/scene-fab/releases) 下载对应平台的安装包：\n\n| 平台 | 文件 | 系统要求 |\n|------|------|----------|\n| Windows | `SceneFab-Setup-x.x.x.exe` | Windows 10+ |\n| macOS | `SceneFab-x.x.x.dmg` | macOS 11+ (Apple Silicon / Intel) |\n| Linux | `SceneFab-x.x.x.AppImage` | Ubuntu 20.04+ / glibc 2.31+ |\n\n#### 方式二：pip 安装（推荐开发者）\n\n```bash\n# 1. 安装 SceneFab\npip install scenefab\n\n# 2. 验证 FFmpeg（必需依赖）\nffmpeg -version\n# 应输出：ffmpeg version 6.x ...\n\n# 如果未安装 FFmpeg：\nbrew install ffmpeg # macOS\nsudo apt install ffmpeg # Ubuntu/Debian\nwinget install ffmpeg # Windows\n```\n\n### ⚙️ 配置 AI 服务\n\n编辑 `config/llm.yaml`，填入至少一个 API Key：\n\n```yaml\nLLM:\n default_provider: \"deepseek\"\n\n deepseek:\n enabled: true\n api_key: \"sk-your-deepseek-key\"\n model: \"deepseek-v4-pro\"\n\n qwen:\n enabled: true\n api_key: \"sk-your-qwen-key\"\n model: \"qwen3.7-max\"\n```\n\n或使用环境变量（更安全）：\n\n```bash\nexport DEEPSEEK_API_KEY=\"sk-your-deepseek-key\"\nexport QWEN_API_KEY=\"sk-your-qwen-key\"\n```\n\n### ▶️ 启动 SceneFab\n\n```bash\n# 启动 GUI（默认）\nscenefab\n\n# 查看版本\nscenefab --version\n\n# 查看帮助\nscenefab --help\n```\n\n详细说明请参阅 [在线文档 - 快速开始](https://agions.github.io/scene-fab/guide/quick-start)。\n\n---\n\n## 🏗️ 技术架构\n\nSceneFab 采用**事件驱动的 DAG 并行流水线**架构，每个模块职责清晰、易于扩展：\n\n```mermaid\nflowchart TB\n subgraph Client[\"桌面客户端 (PySide6 6.9+)\"]\n UI[工作台 · 创作流程 · 项目资产]\n ViewModel[MVVM ViewModel]\n end\n\n subgraph Core[\"核心引擎\"]\n Bus[事件总线]\n Engine[DAG 流水线引擎]\n DI[依赖注入容器]\n end\n\n subgraph Services[\"业务服务\"]\n AI[AI 服务
LLM · 视觉 · TTS · 脚本生成]\n Video[视频服务
分析 · 处理 · 导出]\n Export[导出服务
剪映 · MP4 · 字幕]\n end\n\n subgraph Pipeline[\"生产流水线\"]\n Import[① 素材导入]\n Analyze[② 场景分析]\n Script[③ 脚本生成]\n Voice[④ 配音合成]\n Caption[⑤ 字幕对齐]\n Pub[⑥ 导出发布]\n end\n\n UI --> ViewModel\n ViewModel --> Bus\n Bus --> Engine\n Engine --> DI\n DI --> AI\n DI --> Video\n DI --> Export\n Engine --> Pipeline\n\n Import --> Analyze\n Analyze --> Script\n Script --> Voice\n Voice --> Caption\n Caption --> Pub\n\n classDef brand fill:#0e7490,stroke:#22d3ee,color:#fff\n classDef accent fill:#7c3aed,stroke:#a855f7,color:#fff\n class Engine,DI,Bus brand\n class AI,Video,Export accent\n```\n\n### 关键设计决策\n\n- **MVVM 架构** — UI 与业务逻辑解耦（v2.4.0 全面 ViewModel 化）\n- **事件驱动** — 解耦模块通信，所有状态变更可追溯\n- **DAG 流水线** — 支持并行执行和断点续传\n- **插件化** — LLM / TTS / 视觉模型均可热插拔\n- **本地优先** — 视频数据不出本机，仅 AI 调用走云端\n\n---\n\n## 🛠️ 技术栈\n\n| 组件 | 技术选型 | 用途 |\n|------|----------|------|\n| 桌面端 | PySide6 6.9+ | Qt 跨平台 GUI |\n| 视频处理 | FFmpeg 6.x · OpenCV · MoviePy | 音视频分析与合成 |\n| AI 推理 | OpenAI SDK · google-generativeai | LLM 和视觉模型调用 |\n| 语音合成 | Edge-TTS · F5-TTS | 解说配音生成 |\n| 场景检测 | PySceneDetect | 视频场景自动分割 |\n| 数据验证 | Pydantic 2.5+ | 结构化数据校验 |\n| 配置管理 | PyYAML · python-dotenv | YAML/环境变量配置 |\n| 安全 | cryptography · keyring | API 密钥加密存储 |\n| HTTP API | FastAPI · uvicorn | 可选 REST API 服务 |\n\n---\n\n## 📁 项目结构\n\n```\nscene-fab/\n├── src/scenefab/ # 主包\n│ ├── core/ # 基础设施（事件总线 · DI · 审计 · 流水线引擎）\n│ ├── models/ # 数据模型（项目 · 视频 · 叙述 · 媒体）\n│ ├── services/ # 业务服务\n│ │ ├── ai/ # AI 服务（LLM · 视觉 · TTS · 脚本生成）\n│ │ ├── video/ # 视频服务（分析 · 处理 · 导出）\n│ │ ├── export/ # 导出服务（剪映 · MP4 · 字幕）\n│ │ └── video_tools/ # 视频工具（FFmpeg · 探测 · 硬件加速）\n│ ├── pipeline/ # 生产流水线（状态机 · 步骤 · 评估）\n│ ├── plugins/ # 插件系统（加载 · 注册 · 接口）\n│ ├── api/ # HTTP API（FastAPI 路由）\n│ ├── ui/ # 用户界面（PySide6 页面 · 主题）\n│ └── utils/ # 工具函数（安全 · 版本 · 日志）\n├── tests/ # 测试套件\n├── docs/ # VitePress 文档站\n├── assets/ # 品牌资源（logo · 徽章）\n├── resources/ # 应用资源（图标 · 样式）\n├── scripts/ # 构建/工具脚本\n└── config/ # 配置文件\n```\n\n---\n\n## 📚 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [在线文档](https://agions.github.io/scene-fab/) | 完整文档中心（VitePress） |\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 3 步安装、配置和首次运行 |\n| [安装指南](https://agions.github.io/scene-fab/guide/installation) | 各平台完整安装步骤 |\n| [AI 配置](https://agions.github.io/scene-fab/guide/ai-configuration) | 多服务商配置详解 |\n| [CLI 参考](https://agions.github.io/scene-fab/guide/cli-reference) | 命令行使用说明 |\n| [Python API](https://agions.github.io/scene-fab/guide/python-api) | Python API 完整文档 |\n| [生产规范](https://agions.github.io/scene-fab/guide/first-person-narration-production) | 第一人称解说完整生产流程 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 从视频到成片的 AI 流程详解 |\n| [导出发布](https://agions.github.io/scene-fab/guide/exporting) | 导出格式与平台预设 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题解决 |\n\n---\n\n## 🗺️ 路线图\n\n### ✅ v2.4.0（2026-07-01）— UI 架构升级\n\n- [x] **Phase 1** — UI 模块化分层（净 -1536 行死代码）\n- [x] **Phase 2** — ViewModel 化拆分\n- [x] **Phase 3** — 暗色主题 + 运行时切换端到端\n- [x] **品牌重塑** — 双色调 logo 系统 + OG image + 渲染 pipeline\n\n### 🚧 v2.5.0（计划中）\n\n- [ ] **drag-drop 文件拖拽**（`AssetsPage` 的 `dragEnterEvent`/`dropEvent`）\n- [ ] **ViewModel 严格分层**（移除 `TYPE_CHECKING` hack, viewmodel 不再依赖 UI 类型）\n- [ ] **macOS 公证**（解决 Gatekeeper 拦截）\n- [ ] **批量生产 UI**（整季批量可视化调度）\n\n### 💡 v3.0.0（远期）\n\n- [ ] **Web 版本** — Tauri 重写桌面端 + Web 端复用核心\n- [ ] **多人协作** — 云端项目同步 + 团队权限\n- [ ] **AI 实时预览** — 边生成边预览，减少等待焦虑\n- [ ] **插件市场** — 第三方 LLM / TTS / 视觉模型接入\n\n---\n\n## 🤝 贡献\n\n欢迎贡献代码、报告问题或提出建议。\n\n### 开发环境\n\n```bash\n# 克隆仓库\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\n\n# 安装开发依赖\npip install -e \".[dev]\"\n\n# 运行测试\nmake test\n\n# 代码检查\nmake lint\n\n# 格式化\nmake format\n```\n\n### 提交规范（Conventional Commits）\n\n| 类型 | 用途 | 示例 |\n|------|------|------|\n| `feat` | 新功能 | `feat(pipeline): add batch production support` |\n| `fix` | Bug 修复 | `fix(ai): handle Qwen API timeout gracefully` |\n| `docs` | 文档变更 | `docs(readme): update installation steps` |\n| `style` | 代码格式（无逻辑变更） | `style(ui): fix indentation in HomePage` |\n| `refactor` | 代码重构 | `refactor(core): split event bus into modules` |\n| `perf` | 性能优化 | `perf(video): cache scene analysis results` |\n| `test` | 测试相关 | `test(services): add e2e for export pipeline` |\n| `chore` | 构建/工具 | `chore(deps): bump PySide6 to 6.9` |\n\n提交前请运行 `make lint` 和 `make test`。\n\n### 问题反馈\n\n- 🐛 [Bug 报告](https://github.com/Agions/scene-fab/issues/new?template=bug_report.md)\n- 💡 [功能建议](https://github.com/Agions/scene-fab/issues/new?template=feature_request.md)\n- 💬 [讨论区](https://github.com/Agions/scene-fab/discussions)\n\n---\n\n## 🙏 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython/) — Qt 官方 Python 绑定\n- [FFmpeg](https://ffmpeg.org/) — 跨平台音视频处理\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 免费高质量 TTS\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 开源音色克隆\n- [PySceneDetect](https://www.scenedetect.com/) — 视频场景检测\n- [Pydantic](https://pydantic-docs.helpmanual.io/) — 数据验证\n- [VitePress](https://vitepress.dev/) — 文档站框架\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n**[⭐ Star](https://github.com/Agions/scene-fab)** · **[🍴 Fork](https://github.com/Agions/scene-fab/fork)** · **[📖 文档](https://agions.github.io/scene-fab/)** · **[📝 更新日志](CHANGELOG.md)**\n\nSceneFab v2.4.0 · Made with ❤️ by [Agions](https://github.com/Agions) and [contributors](https://github.com/Agions/scene-fab/graphs/contributors)\n\n
"}, "3a541585084838ca71627bba698a2ad08380b0d4": {"t": 1785772722.3502007, "n": 6288, "h": "434e7de1bd9ba789", "c": "\n\n
\n\n
SceneFab · AI 影视解说视频创作工具
\n\n
从素材理解、脚本生成、配音合成到多平台导出，一站式自动化生产流程
\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](https://www.python.org/)\n[](https://doc.qt.io/qtforpython/)\n[](https://ffmpeg.org/)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n
\n\n[快速开始](#快速开始) · [功能特性](#功能特性) · [安装](#安装) · [文档](https://agions.github.io/scene-fab/guide/quick-start) · [贡献](#贡献)\n\n
\n\n**[文档](https://agions.github.io/scene-fab/)** · **[更新日志](CHANGELOG.md)** · **[许可证](LICENSE)**\n\n
\n"}, "2663f757b3cbd2af564a648f5917dab2af69a530": {"t": 1785772725.7210407, "n": 9560, "h": "8db1f073a5d1692d", "c": "\n\n
\n\n
AI 驱动的影视/短剧第一人称解说生产工具
\n\n
将素材理解、脚本生成、配音合成、字幕装配和平台导出串成标准化流程
\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](https://www.python.org/)\n[](https://doc.qt.io/qtforpython/)\n[](https://ffmpeg.org/)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n[](https://github.com/Agions/scene-fab/stargazers)\n\n
\n\n[快速开始](#快速开始) · [功能特性](#功能特性) · [架构概览](#架构概览) · [文档](#文档) · [贡献](#贡献)\n\n
\n\n**[文档](https://agions.github.io/scene-fab/)** · **[更新日志](CHANGELOG.md)** · **[许可证](LICENSE)**\n\n
\n"}, "8d96f16e82e178fcaea19c7b75c2a4e9532ba7cd": {"t": 1785772726.9396508, "n": 9560, "h": "6b7a8e400468b7af", "c": "\n\n
\n\n
AI 驱动的影视/短剧第一人称解说生产工具
\n\n
将素材理解、脚本生成、配音合成、字幕装配和平台导出串成标准化流程
\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](https://www.python.org/)\n[](https://doc.qt.io/qtforpython/)\n[](https://ffmpeg.org/)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n[](https://github.com/Agions/scene-fab/stargazers)\n\n
\n\n[快速开始](#快速开始) · [功能特性](#功能特性) · [架构概览](#架构概览) · [文档](#文档) · [贡献](#贡献)\n\n
\n\n**[文档](https://agions.github.io/scene-fab/)** · **[更新日志](CHANGELOG.md)** · **[许可证](LICENSE)**\n\n
\n"}, "2a814933bd39cd164c249773bb67fefe55b7c278": {"t": 1785772728.6508784, "n": 9560, "h": "a01ed0fde02cfa47", "c": "\n\n
\n\n
AI 驱动的影视/短剧第一人称解说生产工具
\n\n
将素材理解、脚本生成、配音合成、字幕装配和平台导出串成标准化流程
\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](https://www.python.org/)\n[](https://doc.qt.io/qtforpython/)\n[](https://ffmpeg.org/)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n[](https://github.com/Agions/scene-fab/stargazers)\n\n
\n\n[快速开始](#快速开始) · [功能特性](#功能特性) · [架构概览](#架构概览) · [文档](#文档) · [贡献](#贡献)\n\n
\n\n**[文档](https://agions.github.io/scene-fab/)** · **[更新日志](CHANGELOG.md)** · **[许可证](LICENSE)**\n\n
\n"}, "2e4024bd8cd48812687b2148c5a1be55530f9fe9": {"t": 1785772730.7122219, "n": 3113, "h": "fe969df31eb92274", "c": "\n\n
\n\n
\n\n### AI 影视解说视频一站式创作工具\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n
\n\n
\n\n
\n\n### AI 影视解说视频一站式创作工具\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n
\n \n \n AI 智能理解
\n 视频语义拆解 · 场景识别 · 人物关系\n | \n \n 解说生成
\n 多风格文案 · 多角色配音 · 字幕同步\n | \n \n 一键导出
\n 8 平台预设 · 批量导出 · 硬件加速\n | \n
\n
\n\n---\n\n## 快速开始\n\n**1. 安装**\n\n```bash\npip install scenefab\n# 或前往 Releases 下载安装包\n```\n\n**2. 配置**\n\n```bash\nexport DEEPSEEK_API_KEY=\"sk-...\"\n# 可选：QWEN_API_KEY（视觉增强）\n```\n\n**3. 运行**\n\n```bash\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n```\n\n---\n\n## 架构\n\n```\nUI 层 (PySide6) → 核心引擎 (DAG 并行 · 批量处理 · 安全审计)\n ↓ ↓\n业务服务层 (AI · 视频 · 导出) → 数据层 (Models · Utils · Plugins)\n```\n\n---\n\n## 文档\n\n[快速开始](https://agions.github.io/scene-fab/guide/quickstart) · [AI 配置](https://agions.github.io/scene-fab/guide/ai-configuration) · [架构设计](https://agions.github.io/scene-fab/architecture) · [常见问题](https://agions.github.io/scene-fab/faq)\n\n---\n\n## 技术栈\n\n\n\n\n\n\n\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) © 2025-2026 [Agions](https://github.com/Agions)\n"}, "f20052299beb12a41e7e9dbcb408cd959e627dcd": {"t": 1785772733.1218598, "n": 8852, "h": "8a3ff1797ab5c757", "c": "\n\n
\n\n
\n\n**从一部电影到 25 集短剧解说，AI 全程陪你一气呵成。**\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/network/members)\n[](https://github.com/Agions/scene-fab/issues)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n | 🎬 AI 语义拆条 | \n ✍️ 智能解说生成 | \n 🎙️ 一键配音合成 | \n 📺 8 平台适配 | \n
\n \n \n Qwen3.7 视觉理解
\n 自动识别场景边界、人物动作、对话起止
\n 情感峰值选段 · 视觉×音频双维评分\n | \n \n DeepSeek-V4 · 7+ 风格
\n 第一人称视角 · 词级时间戳
\n 短剧 4 风格（悬疑/甜宠/复仇/逆袭）\n | \n \n Edge-TTS · F5-TTS
\n 50ms 精度字幕对齐
\n 零样本音色克隆 · 情感化语音\n | \n \n 抖音/B站/小红书/西瓜
\n YouTube/TikTok/快手/剪映
\n AI 智能裁剪 + 平台封面\n | \n
\n \n | ⚡ DAG 并行流水线 | \n 📺 短剧整季批量 | \n 🔒 安全加固 | \n 📊 数据回流 | \n
\n \n \n 拓扑排序 + parallel_group
\n 解说/配音/封面 3 步并行
\n 整季 25 集 15 分钟出\n | \n \n 25-50 集一键导入
\n 自动识别集数 · 断点续传
\n 自动重试 · 进度实时反馈\n | \n \n FFmpeg 参数白名单
\n 消除 90%+ 命令注入面
\n SQLite 审计日志全程记录\n | \n \n 多平台效果追踪
\n 播放/点赞/评论/完播率
\n 智能优化建议 · 闭环迭代\n | \n
\n
\n\n---\n\n## 快速开始\n\n### 下载安装\n\n前往 [Releases](https://github.com/Agions/scene-fab/releases) 页面下载：\n\n| 平台 | 架构 | 安装包 |\n| ---------- | ------------- | ------------------------------ |\n| 🪟 Windows | x64 | `SceneFab-x.x.x-x64-setup.exe` |\n| 🍎 macOS | Apple Silicon | `SceneFab-x.x.x-aarch64.dmg` |\n| 🍎 macOS | Intel | `SceneFab-x.x.x-x64.dmg` |\n| 🐧 Linux | x64 | `SceneFab-x.x.x-x64.AppImage` |\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen3.7（视觉理解增强）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n### 常用命令\n\n```bash\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n\n# 短剧整季批量生产\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n```\n\n---\n\n## 架构\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ UI 层 (PySide6 6.9) │\n│ SceneFabMainWindow · 工作台 · 创作流程 · 项目资产 · 系统设置 │\n└──────────────────────────┬───────────────────────────────────────┘\n │ Signal/Slot\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ v2.x 核心引擎 (scenefab.core.*) │\n│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ ┌────────────┐ │\n│ │PipelineEngine│ │BatchProcessor│ │ SafeFFmpeg │ │AuditLogger │ │\n│ │ (DAG 并行) │ │ (批量+断点) │ │ (白名单) │ │ (SQLite) │ │\n│ └─────────────┘ └─────────────┘ └────────────┘ └────────────┘ │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ 业务服务层 (services/) │\n│ ai/ LLM · Vision · TTS · ASR 适配器 │\n│ video/ FFmpeg · 帧提取 · 合成 · 缓存 │\n│ video_understanding/ 长视频剧情理解 (v2.2 状态机 UNDERSTAND) │\n│ export/ MP4 · 剪映草稿 · 8 平台导出 │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Models + Utils + Plugins (数据+工具) │\n│ models/ 领域模型 │ utils/ 工具函数 │ plugins/ 插件加载 │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n| ------------ | ------------------------------------------------------------------------------------------------ |\n| **视觉理解** | [Qwen3.7](https://help.aliyun.com/zh/model-studio/) · [Gemini 3.5 Flash](https://ai.google.dev/) |\n| **解说生成** | [DeepSeek-V4](https://www.deepseek.com/) · 多 LLM Fallback |\n| **语音合成** | [Edge-TTS](https://github.com/rany2/edge-tts) · [F5-TTS](https://github.com/SWivid/F5-TTS) |\n| **视频处理** | [FFmpeg](https://ffmpeg.org/) · [OpenCV](https://opencv.org/) |\n| **UI 框架** | [PySide6](https://doc.qt.io/qtforpython/) · Qt Design Tokens |\n| **数据存储** | SQLite 3 · 本地优先 |\n| **AI Agent** | Hermes Agent · MCP Protocol |\n\n---\n\n## 路线图\n\n### 已完成 ✅\n\n- v2.1.1 — 解说生成状态机（5 状态 + 评估循环）· 架构清理\n- v2.1.0 — 统一架构（EventBus + DI + 类型化事件）\n- v2.0.0 — DAG 并行流水线 · FFmpeg 安全加固 · 短剧批量 · 8 平台适配\n- v1.1.0 — 8-Phase 架构重构 · 影视解说基础工作流\n\n### 进行中 🚧\n\n- [ ] v2.2.0 — AI 模型升级（Qwen3.7 / Gemini 3.5 Flash / 新 TTS）· 数据回流 · 情绪分析 · 爆款预测\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n\n### 未来规划 🔮\n\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n[🚀 下载](https://github.com/Agions/scene-fab/releases) · [📖 文档](https://agions.github.io/scene-fab/) · [🐛 Issue](https://github.com/Agions/scene-fab/issues)\n\n
\n"}, "ee0346241554fb0bc58d798e59c0d8e9aeb9b25d": {"t": 1785772734.4744685, "n": 7969, "h": "bc42f65ee9538ba5", "c": "\n\n
\n\n
\n\n**从一部电影到 25 集短剧解说，AI 全程陪你一气呵成。**\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/network/members)\n[](https://github.com/Agions/scene-fab/issues)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n | 🎬 AI 语义拆条 | \n ✍️ 智能解说生成 | \n 🎙️ 一键配音合成 | \n 📺 8 平台适配 | \n
\n \n \n Qwen3.7 视觉理解
\n 自动识别场景边界、人物动作、对话起止
\n 情感峰值选段 · 视觉×音频双维评分\n | \n \n DeepSeek-V4 · 7+ 风格
\n 第一人称视角 · 词级时间戳
\n 短剧 4 风格（悬疑/甜宠/复仇/逆袭）\n | \n \n Edge-TTS · F5-TTS
\n 50ms 精度字幕对齐
\n 零样本音色克隆 · 情感化语音\n | \n \n 抖音/B站/小红书/西瓜
\n YouTube/TikTok/快手/剪映
\n AI 智能裁剪 + 平台封面\n | \n
\n \n | ⚡ DAG 并行流水线 | \n 📺 短剧整季批量 | \n 🔒 安全加固 | \n 📊 数据回流 | \n
\n \n \n 拓扑排序 + parallel_group
\n 解说/配音/封面 3 步并行
\n 整季 25 集 15 分钟出\n | \n \n 25-50 集一键导入
\n 自动识别集数 · 断点续传
\n 自动重试 · 进度实时反馈\n | \n \n FFmpeg 参数白名单
\n 消除 90%+ 命令注入面
\n SQLite 审计日志全程记录\n | \n \n 多平台效果追踪
\n 播放/点赞/评论/完播率
\n 智能优化建议 · 闭环迭代\n | \n
\n
\n\n---\n\n## 快速开始\n\n### 下载安装\n\n前往 [Releases](https://github.com/Agions/scene-fab/releases) 页面下载：\n\n| 平台 | 架构 | 安装包 |\n|------|------|--------|\n| 🪟 Windows | x64 | `SceneFab-x.x.x-x64-setup.exe` |\n| 🍎 macOS | Apple Silicon | `SceneFab-x.x.x-aarch64.dmg` |\n| 🍎 macOS | Intel | `SceneFab-x.x.x-x64.dmg` |\n| 🐧 Linux | x64 | `SceneFab-x.x.x-x64.AppImage` |\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen3.7（视觉理解增强）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n### 常用命令\n\n```bash\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n\n# 短剧整季批量生产\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n```\n\n---\n\n## 架构\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ UI 层 (PySide6 6.9) │\n│ SceneFabMainWindow · 工作台 · 创作流程 · 项目资产 · 系统设置 │\n└──────────────────────────┬───────────────────────────────────────┘\n │ Signal/Slot\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ v2.x 核心引擎 (scenefab.core.*) │\n│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ ┌────────────┐ │\n│ │PipelineEngine│ │BatchProcessor│ │ SafeFFmpeg │ │AuditLogger │ │\n│ │ (DAG 并行) │ │ (批量+断点) │ │ (白名单) │ │ (SQLite) │ │\n│ └─────────────┘ └─────────────┘ └────────────┘ └────────────┘ │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ 业务服务层 (services/) │\n│ ai/ LLM · Vision · TTS · ASR 适配器 │\n│ video/ FFmpeg · 帧提取 · 合成 · 缓存 │\n│ video_understanding/ 长视频剧情理解 (v2.2 状态机 UNDERSTAND) │\n│ export/ MP4 · 剪映草稿 · 8 平台导出 │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Models + Utils + Plugins (数据+工具) │\n│ models/ 领域模型 │ utils/ 工具函数 │ plugins/ 插件加载 │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|---|---|\n| **视觉理解** | [Qwen3.7](https://help.aliyun.com/zh/model-studio/) · [Gemini 3.5 Flash](https://ai.google.dev/) |\n| **解说生成** | [DeepSeek-V4](https://www.deepseek.com/) · 多 LLM Fallback |\n| **语音合成** | [Edge-TTS](https://github.com/rany2/edge-tts) · [F5-TTS](https://github.com/SWivid/F5-TTS) |\n| **视频处理** | [FFmpeg](https://ffmpeg.org/) · [OpenCV](https://opencv.org/) |\n| **UI 框架** | [PySide6](https://doc.qt.io/qtforpython/) · Qt Design Tokens |\n| **数据存储** | SQLite 3 · 本地优先 |\n| **AI Agent** | Hermes Agent · MCP Protocol |\n\n---\n\n## 路线图\n\n### 已完成 ✅\n\n- v2.1.1 — 解说生成状态机（5 状态 + 评估循环）· 架构清理\n- v2.1.0 — 统一架构（EventBus + DI + 类型化事件）\n- v2.0.0 — DAG 并行流水线 · FFmpeg 安全加固 · 短剧批量 · 8 平台适配\n- v1.1.0 — 8-Phase 架构重构 · 影视解说基础工作流\n\n### 进行中 🚧\n\n- [ ] v2.2.0 — AI 模型升级（Qwen3.7 / Gemini 3.5 Flash / 新 TTS）· 数据回流 · 情绪分析 · 爆款预测\n- [ ] Web Dashboard（轻量级远程监控 + 任务管理）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] 多语言 i18n（日 / 韩 / 英 / 西）\n\n### 未来规划 🔮\n\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n[🚀 下载](https://github.com/Agions/scene-fab/releases) · [📖 文档](https://agions.github.io/scene-fab/) · [🐛 Issue](https://github.com/Agions/scene-fab/issues)\n\n
\n"}, "38f2701dafd6c49f186c2841f698143d20acc790": {"t": 1785772735.7284017, "n": 8847, "h": "499672d7c92f729d", "c": "\n\n
\n\n
\n\n**从一部电影到 25 集短剧解说，AI 全程陪你一气呵成。**\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/network/members)\n[](https://github.com/Agions/scene-fab/issues)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n | 🎬 AI 语义拆条 | \n ✍️ 智能解说生成 | \n 🎙️ 一键配音合成 | \n 📺 8 平台适配 | \n
\n \n \n Qwen3.7 视觉理解
\n 自动识别场景边界、人物动作、对话起止
\n 情感峰值选段 · 视觉×音频双维评分\n | \n \n DeepSeek-V4 · 7+ 风格
\n 第一人称视角 · 词级时间戳
\n 短剧 4 风格（悬疑/甜宠/复仇/逆袭）\n | \n \n Edge-TTS · F5-TTS
\n 50ms 精度字幕对齐
\n 零样本音色克隆 · 情感化语音\n | \n \n 抖音/B站/小红书/西瓜
\n YouTube/TikTok/快手/剪映
\n AI 智能裁剪 + 平台封面\n | \n
\n \n | ⚡ DAG 并行流水线 | \n 📺 短剧整季批量 | \n 🔒 安全加固 | \n 📊 数据回流 | \n
\n \n \n 拓扑排序 + parallel_group
\n 解说/配音/封面 3 步并行
\n 整季 25 集 15 分钟出\n | \n \n 25-50 集一键导入
\n 自动识别集数 · 断点续传
\n 自动重试 · 进度实时反馈\n | \n \n FFmpeg 参数白名单
\n 消除 90%+ 命令注入面
\n SQLite 审计日志全程记录\n | \n \n 多平台效果追踪
\n 播放/点赞/评论/完播率
\n 智能优化建议 · 闭环迭代\n | \n
\n
\n\n---\n\n## 快速开始\n\n### 下载安装\n\n前往 [Releases](https://github.com/Agions/scene-fab/releases) 页面下载：\n\n| 平台 | 架构 | 安装包 |\n|------|------|--------|\n| 🪟 Windows | x64 | `SceneFab-x.x.x-x64-setup.exe` |\n| 🍎 macOS | Apple Silicon | `SceneFab-x.x.x-aarch64.dmg` |\n| 🍎 macOS | Intel | `SceneFab-x.x.x-x64.dmg` |\n| 🐧 Linux | x64 | `SceneFab-x.x.x-x64.AppImage` |\n\n### 从源码安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\n\n# 安装依赖\npip install -e .\n\n# 启动 GUI\nscenefab gui\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen3.7（视觉理解增强）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n### 常用命令\n\n```bash\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n\n# 短剧整季批量生产\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n```\n\n---\n\n## 架构\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ UI 层 (PySide6 6.9) │\n│ HomePage · 5-Step Wizard · MonitorPanel · Worker │\n└──────────────────────────┬───────────────────────────────────────┘\n │ Signal/Slot\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ v2.x 核心引擎 (scenefab.core.*) │\n│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ ┌────────────┐ │\n│ │PipelineEngine│ │BatchProcessor│ │ SafeFFmpeg │ │AuditLogger │ │\n│ │ (DAG 并行) │ │ (批量+断点) │ │ (白名单) │ │ (SQLite) │ │\n│ └─────────────┘ └─────────────┘ └────────────┘ └────────────┘ │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ 业务服务层 (services/) │\n│ ai/ LLM · Vision · TTS · ASR 适配器 │\n│ video/ FFmpeg · 帧提取 · 合成 · 缓存 │\n│ video_understanding/ 长视频剧情理解 (v2.2 状态机 UNDERSTAND) │\n│ export/ MP4 · 剪映草稿 · 8 平台导出 │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Models + Utils + Plugins (数据+工具) │\n│ models/ 领域模型 │ utils/ 工具函数 │ plugins/ 插件加载 │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|---|---|\n| **视觉理解** | [Qwen3.7](https://help.aliyun.com/zh/model-studio/) · [Gemini 3.5 Flash](https://ai.google.dev/) |\n| **解说生成** | [DeepSeek-V4](https://www.deepseek.com/) · 多 LLM Fallback |\n| **语音合成** | [Edge-TTS](https://github.com/rany2/edge-tts) · [F5-TTS](https://github.com/SWivid/F5-TTS) |\n| **视频处理** | [FFmpeg](https://ffmpeg.org/) · [OpenCV](https://opencv.org/) |\n| **UI 框架** | [PySide6](https://doc.qt.io/qtforpython/) · Qt Design Tokens |\n| **数据存储** | SQLite 3 · 本地优先 |\n| **代码质量** | [Ruff](https://github.com/astral-sh/ruff) · [pytest](https://docs.pytest.org/) · GitHub Actions CI |\n| **AI Agent** | Hermes Agent · MCP Protocol |\n\n---\n\n## 路线图\n\n### 已完成 ✅\n\n- v2.2.0 — AI 模型升级（Qwen3.7 / Gemini 3.5 Flash / 新 TTS）· 数据回流 · 情绪分析 · 爆款预测\n- v2.1.0 — 统一架构（EventBus + DI + 类型化事件）\n- v2.0.0 — DAG 并行流水线 · FFmpeg 安全加固 · 短剧批量 · 8 平台适配\n- v1.1.0 — 8-Phase 架构重构 · ruff UP 规则 · 完全向后兼容\n\n### 进行中 🚧\n\n- [ ] Web Dashboard（轻量级远程监控 + 任务管理）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] 多语言 i18n（日 / 韩 / 英 / 西）\n\n### 未来规划 🔮\n\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n---\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（遵循 [Conventional Commits](https://www.conventionalcommits.org/)）\n4. 推送分支并创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n| 类型 | 用途 | 示例 |\n|------|------|------|\n| `feat` | 新功能 | `feat(pipeline): commentary 5-step pipeline` |\n| `fix` | Bug 修复 | `fix(ci): correct vision_providers import path` |\n| `perf` | 性能优化 | `perf(pipeline): parallel narration state machine` |\n| `docs` | 文档更新 | `docs(readme): professional redesign` |\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n[🚀 下载](https://github.com/Agions/scene-fab/releases) · [📖 文档](https://agions.github.io/scene-fab/) · [🐛 Issue](https://github.com/Agions/scene-fab/issues) · [🤝 贡献](https://github.com/Agions/scene-fab/blob/main/CONTRIBUTING.md)\n\n
\n"}, "08fa05c3ca7911ca0f0a104b4e68a98568af1182": {"t": 1785772737.0182908, "n": 8967, "h": "df244323b8bf6b08", "c": "\n\n
\n\n
\n\n**从一部电影到 25 集短剧解说，AI 全程陪你一气呵成。**\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/network/members)\n[](https://github.com/Agions/scene-fab/issues)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n | 🎬 AI 语义拆条 | \n ✍️ 智能解说生成 | \n 🎙️ 一键配音合成 | \n 📺 8 平台适配 | \n
\n \n \n Qwen3.7 视觉理解
\n 自动识别场景边界、人物动作、对话起止
\n 情感峰值选段 · 视觉×音频双维评分\n | \n \n DeepSeek-V4 · 7+ 风格
\n 第一人称视角 · 词级时间戳
\n 短剧 4 风格（悬疑/甜宠/复仇/逆袭）\n | \n \n Edge-TTS · F5-TTS
\n 50ms 精度字幕对齐
\n 零样本音色克隆 · 情感化语音\n | \n \n 抖音/B站/小红书/西瓜
\n YouTube/TikTok/快手/剪映
\n AI 智能裁剪 + 平台封面\n | \n
\n \n | ⚡ DAG 并行流水线 | \n 📺 短剧整季批量 | \n 🔒 安全加固 | \n 📊 数据回流 | \n
\n \n \n 拓扑排序 + parallel_group
\n 解说/配音/封面 3 步并行
\n 整季 25 集 15 分钟出\n | \n \n 25-50 集一键导入
\n 自动识别集数 · 断点续传
\n 自动重试 · 进度实时反馈\n | \n \n FFmpeg 参数白名单
\n 消除 90%+ 命令注入面
\n SQLite 审计日志全程记录\n | \n \n 多平台效果追踪
\n 播放/点赞/评论/完播率
\n 智能优化建议 · 闭环迭代\n | \n
\n
\n\n---\n\n## 快速开始\n\n### 下载安装\n\n前往 [Releases](https://github.com/Agions/scene-fab/releases) 页面下载：\n\n| 平台 | 架构 | 安装包 |\n|------|------|--------|\n| 🪟 Windows | x64 | `SceneFab-x.x.x-x64-setup.exe` |\n| 🍎 macOS | Apple Silicon | `SceneFab-x.x.x-aarch64.dmg` |\n| 🍎 macOS | Intel | `SceneFab-x.x.x-x64.dmg` |\n| 🐧 Linux | x64 | `SceneFab-x.x.x-x64.AppImage` |\n\n### 从源码安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\n\n# 安装依赖\npip install -e .\n\n# 启动 GUI\nscenefab gui\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen3.7（视觉理解增强）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n### 常用命令\n\n```bash\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n\n# 短剧整季批量生产\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n```\n\n---\n\n## 架构\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ UI 层 (PySide6 6.9) │\n│ HomePage · 5-Step Wizard · MonitorPanel · Worker │\n└──────────────────────────┬───────────────────────────────────────┘\n │ Signal/Slot\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ v2.x 核心引擎 (scenefab.core.*) │\n│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ ┌────────────┐ │\n│ │PipelineEngine│ │BatchProcessor│ │ SafeFFmpeg │ │AuditLogger │ │\n│ │ (DAG 并行) │ │ (批量+断点) │ │ (白名单) │ │ (SQLite) │ │\n│ └─────────────┘ └─────────────┘ └────────────┘ └────────────┘ │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ 业务服务层 (services/) │\n│ ai/ LLM · Vision · TTS · ASR 适配器 │\n│ video/ FFmpeg · 帧提取 · 合成 · 缓存 │\n│ emotion/ 情绪弧线分析 · 节奏检测 │\n│ cover/ 智能封面 · 元数据生成 │\n│ data_feedback/ 多平台数据回流 · 效果分析 │\n│ export/ MP4 · 剪映草稿 · 8 平台导出 │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Models + Utils + Plugins (数据+工具) │\n│ models/ 领域模型 │ utils/ 工具函数 │ plugins/ 插件加载 │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|---|---|\n| **视觉理解** | [Qwen3.7](https://help.aliyun.com/zh/model-studio/) · [Gemini 3.5 Flash](https://ai.google.dev/) |\n| **解说生成** | [DeepSeek-V4](https://www.deepseek.com/) · 多 LLM Fallback |\n| **语音合成** | [Edge-TTS](https://github.com/rany2/edge-tts) · [F5-TTS](https://github.com/SWivid/F5-TTS) |\n| **视频处理** | [FFmpeg](https://ffmpeg.org/) · [OpenCV](https://opencv.org/) |\n| **UI 框架** | [PySide6](https://doc.qt.io/qtforpython/) · Qt Design Tokens |\n| **数据存储** | SQLite 3 · 本地优先 |\n| **代码质量** | [Ruff](https://github.com/astral-sh/ruff) · [pytest](https://docs.pytest.org/) · GitHub Actions CI |\n| **AI Agent** | Hermes Agent · MCP Protocol |\n\n---\n\n## 路线图\n\n### 已完成 ✅\n\n- v2.2.0 — AI 模型升级（Qwen3.7 / Gemini 3.5 Flash / 新 TTS）· 数据回流 · 情绪分析 · 爆款预测\n- v2.1.0 — 统一架构（EventBus + DI + 类型化事件）\n- v2.0.0 — DAG 并行流水线 · FFmpeg 安全加固 · 短剧批量 · 8 平台适配\n- v1.1.0 — 8-Phase 架构重构 · ruff UP 规则 · 完全向后兼容\n\n### 进行中 🚧\n\n- [ ] Web Dashboard（轻量级远程监控 + 任务管理）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] 多语言 i18n（日 / 韩 / 英 / 西）\n\n### 未来规划 🔮\n\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n---\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（遵循 [Conventional Commits](https://www.conventionalcommits.org/)）\n4. 推送分支并创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n| 类型 | 用途 | 示例 |\n|------|------|------|\n| `feat` | 新功能 | `feat(pipeline): commentary 5-step pipeline` |\n| `fix` | Bug 修复 | `fix(ci): correct vision_providers import path` |\n| `perf` | 性能优化 | `perf(emotion): parallel detection + audio cache` |\n| `docs` | 文档更新 | `docs(readme): professional redesign` |\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n[🚀 下载](https://github.com/Agions/scene-fab/releases) · [📖 文档](https://agions.github.io/scene-fab/) · [🐛 Issue](https://github.com/Agions/scene-fab/issues) · [🤝 贡献](https://github.com/Agions/scene-fab/blob/main/CONTRIBUTING.md)\n\n
\n"}, "aa3fd24339dbfe2aadd3950aa6f20b2632938c88": {"t": 1785772738.3057737, "n": 9001, "h": "7ea61c726241e9ce", "c": "\n\n
\n\n
\n\n**从一部电影到 25 集短剧解说，AI 全程陪你一气呵成。**\n\n
\n\n[](https://github.com/Agions/scene-fab/releases)\n[](LICENSE)\n[](https://github.com/Agions/scene-fab/stargazers)\n[](https://github.com/Agions/scene-fab/network/members)\n[](https://github.com/Agions/scene-fab/issues)\n\n[](https://github.com/Agions/scene-fab/actions)\n[](https://github.com/Agions/scene-fab/actions)\n[](https://agions.github.io/scene-fab/)\n\n\n\n\n\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n | 🎬 AI 语义拆条 | \n ✍️ 智能解说生成 | \n 🎙️ 一键配音合成 | \n 📺 8 平台适配 | \n
\n \n \n Qwen3.7 视觉理解
\n 自动识别场景边界、人物动作、对话起止
\n 情感峰值选段 · 视觉×音频双维评分\n | \n \n DeepSeek-V4 · 7+ 风格
\n 第一人称视角 · 词级时间戳
\n 短剧 4 风格（悬疑/甜宠/复仇/逆袭）\n | \n \n Edge-TTS · F5-TTS
\n 50ms 精度字幕对齐
\n 零样本音色克隆 · 情感化语音\n | \n \n 抖音/B站/小红书/西瓜
\n YouTube/TikTok/快手/剪映
\n AI 智能裁剪 + 平台封面\n | \n
\n \n | ⚡ DAG 并行流水线 | \n 📺 短剧整季批量 | \n 🔒 安全加固 | \n 📊 数据回流 | \n
\n \n \n 拓扑排序 + parallel_group
\n 解说/配音/封面 3 步并行
\n 整季 25 集 15 分钟出\n | \n \n 25-50 集一键导入
\n 自动识别集数 · 断点续传
\n 自动重试 · 进度实时反馈\n | \n \n FFmpeg 参数白名单
\n 消除 90%+ 命令注入面
\n SQLite 审计日志全程记录\n | \n \n 多平台效果追踪
\n 播放/点赞/评论/完播率
\n 智能优化建议 · 闭环迭代\n | \n
\n
\n\n---\n\n## 快速开始\n\n### 下载安装\n\n前往 [Releases](https://github.com/Agions/scene-fab/releases) 页面下载：\n\n| 平台 | 架构 | 安装包 |\n|------|------|--------|\n| 🪟 Windows | x64 | `SceneFab-x.x.x-x64-setup.exe` |\n| 🍎 macOS | Apple Silicon | `SceneFab-x.x.x-aarch64.dmg` |\n| 🍎 macOS | Intel | `SceneFab-x.x.x-x64.dmg` |\n| 🐧 Linux | x64 | `SceneFab-x.x.x-x64.AppImage` |\n\n### 从源码安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\n\n# 安装依赖\npip install -e .\n\n# 启动 GUI\nscenefab gui\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen3.7（视觉理解增强）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n### 常用命令\n\n```bash\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n\n# 短剧整季批量生产\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n```\n\n---\n\n## 架构\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ UI 层 (PySide6 6.9) │\n│ HomePage · 5-Step Wizard · MonitorPanel · Worker │\n└──────────────────────────┬───────────────────────────────────────┘\n │ Signal/Slot\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ v2.x 核心引擎 (scenefab.core.*) │\n│ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ ┌────────────┐ │\n│ │PipelineEngine│ │BatchProcessor│ │ SafeFFmpeg │ │AuditLogger │ │\n│ │ (DAG 并行) │ │ (批量+断点) │ │ (白名单) │ │ (SQLite) │ │\n│ └─────────────┘ └─────────────┘ └────────────┘ └────────────┘ │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ 业务服务层 (services/) │\n│ ai/ LLM · Vision · TTS · ASR 适配器 │\n│ video/ FFmpeg · 帧提取 · 合成 · 缓存 │\n│ emotion/ 情绪弧线分析 · 节奏检测 │\n│ cover/ 智能封面 · 元数据生成 │\n│ data_feedback/ 多平台数据回流 · 效果分析 │\n│ export/ MP4 · 剪映草稿 · 8 平台导出 │\n└──────────────────────────┬───────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Models + Utils + Plugins (数据+工具) │\n│ models/ 领域模型 │ utils/ 工具函数 │ plugins/ 插件加载 │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|---|---|\n| **视觉理解** | [Qwen3.7](https://help.aliyun.com/zh/model-studio/) · [Gemini 3.5 Flash](https://ai.google.dev/) |\n| **解说生成** | [DeepSeek-V4](https://www.deepseek.com/) · 多 LLM Fallback |\n| **语音合成** | [Edge-TTS](https://github.com/rany2/edge-tts) · [F5-TTS](https://github.com/SWivid/F5-TTS) |\n| **视频处理** | [FFmpeg](https://ffmpeg.org/) · [OpenCV](https://opencv.org/) |\n| **UI 框架** | [PySide6](https://doc.qt.io/qtforpython/) · Qt Design Tokens |\n| **数据存储** | SQLite 3 · 本地优先 |\n| **代码质量** | [Ruff](https://github.com/astral-sh/ruff) · [pytest](https://docs.pytest.org/) · GitHub Actions CI |\n| **AI Agent** | Hermes Agent · MCP Protocol |\n\n---\n\n## 路线图\n\n### 已完成 ✅\n\n- v2.2.0 — AI 模型升级（Qwen3.7 / Gemini 3.5 Flash / 新 TTS）· 数据回流 · 情绪分析 · 爆款预测\n- v2.1.0 — 统一架构（EventBus + DI + 类型化事件）\n- v2.0.0 — DAG 并行流水线 · FFmpeg 安全加固 · 短剧批量 · 8 平台适配\n- v1.1.0 — 8-Phase 架构重构 · ruff UP 规则 · 完全向后兼容\n\n### 进行中 🚧\n\n- [ ] Web Dashboard（轻量级远程监控 + 任务管理）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] 多语言 i18n（日 / 韩 / 英 / 西）\n\n### 未来规划 🔮\n\n- [ ] 直播解说模式（实时视频流接入 + 低延迟 AI 解说）\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n---\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（遵循 [Conventional Commits](https://www.conventionalcommits.org/)）\n4. 推送分支并创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n| 类型 | 用途 | 示例 |\n|------|------|------|\n| `feat` | 新功能 | `feat(pipeline): commentary 5-step pipeline` |\n| `fix` | Bug 修复 | `fix(ci): correct vision_providers import path` |\n| `perf` | 性能优化 | `perf(emotion): parallel detection + audio cache` |\n| `docs` | 文档更新 | `docs(readme): professional redesign` |\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n[🚀 下载](https://github.com/Agions/scene-fab/releases) · [📖 文档](https://agions.github.io/scene-fab/) · [🐛 Issue](https://github.com/Agions/scene-fab/issues) · [🤝 贡献](https://github.com/Agions/scene-fab/blob/main/CONTRIBUTING.md)\n\n
\n"}, "61aea4c00e8f3d1dffb551c4677c2fb76211031d": {"t": 1785772739.840978, "n": 13034, "h": "5e5a32ebab09ec08", "c": "\n\n
\n
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **上传一部短剧 → AI 自动完成 25 集整季批量生产 → 一键导出抖音/B站/小红书**\n> 从「几天一条」变成「一天十条」，从「单平台发布」变成「一键多平台分发」。\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab/releases)\n[](https://github.com/Agions/scene-fab/releases/tag/v2.0.0)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载 v2.0.0**](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n ⚡ DAG 并行流水线\n 拓扑排序 + parallel_group
解说生成/配音/封面 3 步并行，整季 25 集 15 分钟出 \n | \n \n 📺 短剧整季批量\n 25-50 集一键导入
自动识别集数（EP01/第01集），断点续传，自动重试 \n | \n \n 🎬 8 平台智能适配\n 抖音/B站/小红书/西瓜/YouTube/TikTok/快手/剪映
一键导出多版本，AI 智能裁剪 + 平台封面 \n | \n \n 🔒 FFmpeg 安全加固\n 参数白名单 + 注入防护
消除 90%+ 命令注入面，审计日志全程记录 \n | \n
\n \n 📝 LLM 流式输出\n 逐 token UI 推送
首字延迟 < 2s，实时看到解说稿生成过程 \n | \n 🎭 短剧 4 风格\n 悬疑/甜宠/复仇/逆袭
7 桥段识别（打脸/救场/心动/反转…） \n | \n 📊 审计日志\n SQLite 持久化
所有 LLM/FFmpeg 调用可追溯 \n | \n 🛠️ 统一 Worker 基类\n PySide6/headless 双模式
取消/暂停/错误传播统一封装 \n | \n
\n
\n\n---\n\n## 它是什么？\n\n**SceneFab** 是为自媒体解说创作者打造的 **AI 影视解说视频一站式创作工具**。上传一部电影或短剧，AI 自动理解视频语义、按情节拆条、生成第一人称解说稿、合成情感化配音、对齐字幕、最终输出带解说的完整视频。\n\n### 核心能力（继承自 v1.x）\n\n\n \n \n 🎬 AI 语义拆条\n Qwen3.7 视觉理解
自动识别场景边界、人物动作、对话起止 \n | \n \n 🎭 情感峰值选段\n 视觉 × 音频双维评分
优先挑选叙事高潮片段 \n | \n \n ✍️ AI 解说稿生成\n DeepSeek-V4 · 7+ 风格
第一人称视角，词级时间戳 \n | \n
\n \n 🎙️ 一键配音合成\n Edge-TTS · F5-TTS
50ms 精度字幕对齐，零样本音色克隆 \n | \n 💻 命令行原生\n pip install 即用
完整 CLI + SKILL.md Agent 接入 \n | \n 🔒 完全本地\n 视频文件永不上传
全本地处理，素材隐私 100% 安全 \n | \n
\n
\n\n## 快速开始\n\n### 下载安装\n\n| 平台 | 架构 | 文件 |\n|------|------|------|\n| **Windows** | x64 | [SceneFab-2.0.0-win-x64.exe](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n| **macOS** | Apple Silicon | [SceneFab-2.0.0-mac-arm64.dmg](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n| **macOS** | Intel | [SceneFab-2.0.0-mac-x64.dmg](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n| **Linux** | x64 | [SceneFab-2.0.0-linux-x64.AppImage](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n\n> 📦 也可从 PyPI / 源码安装：\n\n```bash\n# PyPI（推荐用户）\npip install scenefab>=2.0.0\n\n# 源码（推荐开发者）\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# 启动 GUI\nscenefab gui\n\n# 短剧整季批量生产（v2.0 新增）\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出（v2.0 新增）\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen3.7（视觉理解）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n## 架构\n\nSceneFab v2.0 采用 **分层 + 模块化** 架构，8 个 v2.0 新核心模块（`scenefab.core.*`）与 v1.x 服务层无缝集成：\n\n```\n┌────────────────────────────────────────────────────────────────────┐\n│ 🎬 SceneFab v2.0 Architecture │\n└────────────────────────────────────────────────────────────────────┘\n\n ┌──────────────────────────────────────────────────────────┐\n │ UI 层 (PySide6 6.9 + Design Tokens) │\n │ HomePage · 5-Step Wizard · MonitorPanel · Worker │\n │ ↓ Signal/Slot │\n └──────────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────────┐\n │ v2.0 核心引擎 (scenefab.core.*) │\n │ │\n │ ┌─────────────────┐ ┌─────────────────┐ ┌────────────┐ │\n │ │ PipelineEngine │ │ BatchProcessor │ │ BaseWorker │ │\n │ │ (DAG 并行) │ │ (批量+断点) │ │ (统一基类) │ │\n │ └─────────────────┘ └─────────────────┘ └────────────┘ │\n │ ┌─────────────────┐ ┌─────────────────┐ ┌────────────┐ │\n │ │ SafeFFmpegCmd │ │ AuditLogger │ │ShortDrama │ │\n │ │ (白名单+审计) │ │ (SQLite 审计) │ │ Narrator │ │\n │ └─────────────────┘ └─────────────────┘ └────────────┘ │\n │ ┌─────────────────┐ ┌─────────────────┐ │\n │ │PlatformAdapter │ │ StreamingLLM │ │\n │ │ (8 平台适配) │ │ Worker (流式) │ │\n │ └─────────────────┘ └─────────────────┘ │\n └──────────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────────┐\n │ v1.x Services (业务服务层) │\n │ │\n │ services/ai/ LLM / Vision / TTS / ASR 适配器 │\n │ services/video/ FFmpeg / 帧提取 / 合成 / 缓存 │\n │ services/audio/ 音频处理 / 字幕对齐 │\n │ services/export/ MP4 / 剪映草稿 / 平台导出 │\n │ services/orchestration/ 任务调度 / 项目管理 │\n └──────────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────────┐\n │ Models + Utils + Plugins (数据+工具) │\n │ models/ 枚举 + 领域模型 │ utils/ 工具函数 │\n │ interfaces/ 抽象接口 │ plugins/ 插件加载 │\n └──────────────────────────────────────────────────────────┘\n```\n\n更详细的架构文档请见 [在线文档 - 架构](https://agions.github.io/scene-fab/dev/architecture) 与 [ADR 决策记录](https://github.com/Agions/scene-fab/tree/main/docs/adr)。\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|------------|------|\n| **v2.0 DAG 流水线** | ThreadPoolExecutor + 拓扑排序 | 短剧整季并行处理 ↓48% |\n| **v2.0 审计日志** | SQLite 3 | LLM/FFmpeg 调用全程追溯 |\n| **v2.0 FFmpeg 封装** | 参数白名单 + 危险字符检测 | 消除 90%+ 命令注入面 |\n| 语义拆条 | **Qwen3.7** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7+ 预设风格 + 短剧 4 风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 多平台导出 | **v2.0 PlatformAdapter** | 8 平台 (抖音/B站/小红书/西瓜/YouTube/TikTok/快手/剪映) |\n| UI 框架 | **PySide6 6.9** | Qt for Python，原生桌面体验 |\n| 状态管理 | **PyQt Signal/Slot** | 跨组件解耦，事件驱动 |\n\n## 短剧解说业务流\n\nv2.0 为短剧（1-3 分钟/集，整季 25-50 集）业务做了深度优化：\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ 短剧整季批量生产 (v2.0 Short Drama Mode) │\n└─────────────────────────────────────────────────────────────┘\n\n INPUT: /series/重生女王归来/\n ├── EP01.mp4 ─┐\n ├── EP02.mp4 ─┤\n ├── ... ├─→ 自动识别集数 + 剧情连贯性分析\n └── EP25.mp4 ─┘\n │\n ▼\n ┌─────────────────────────────────────────────────────────┐\n │ Phase 1: 全局预分析（一次性，整季共享） │\n │ · 快速扫描 → 剧情时间线 │\n │ · 主角团识别 → 角色关系图谱 │\n │ · 提取高光时刻 → 高潮索引 │\n └─────────────────────────────────────────────────────────┘\n │\n ▼\n ┌─────────────────────────────────────────────────────────┐\n │ Phase 2: 并行批量处理（2-4 集并行） │\n │ Worker 1: EP01 → EP03 → EP05 ... │\n │ Worker 2: EP02 → EP04 → EP06 ... │\n │ 每集：拆条→桥段识别→解说→配音→合成（v2.0 DAG 并行） │\n └─────────────────────────────────────────────────────────┘\n │\n ▼\n ┌─────────────────────────────────────────────────────────┐\n │ Phase 3: 整季后处理 + 多平台分发 │\n │ · 统一封面风格（视觉一致性） │\n │ · 整季剧情摘要 │\n │ · 一键导出 8 平台版本（v2.0 PlatformAdapter） │\n └─────────────────────────────────────────────────────────┘\n │\n ▼\n OUTPUT:\n output/重生女王归来/\n ├── douyin/ # 抖音 9:16 竖屏\n ├── bilibili/ # B站 16:9 横屏\n ├── xiaohongshu/ # 小红书 3:4\n ├── xigua/ # 西瓜视频 16:9\n ├── youtube/ # YouTube 16:9\n └── jianying/ # 剪映草稿 (可二次编辑)\n```\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [架构设计](https://agions.github.io/scene-fab/dev/architecture) | 模块划分 + 数据流 |\n| [ADR 决策记录](https://github.com/Agions/scene-fab/tree/main/docs/adr) | 5 篇架构决策（v2.0） |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n**在线文档：https://agions.github.io/scene-fab/**\n\n## 路线图\n\n### ✅ v2.0.0 (2026-06-04) — 当前版本\n\n- [x] **DAG 并行流水线引擎**（拓扑排序 + parallel_group + always_run）\n- [x] **FFmpeg 安全封装**（参数白名单 + 注入防护 + 审计集成）\n- [x] **操作审计日志**（SQLite 持久化）\n- [x] **批量任务处理器**（并行 + 断点续传 + 自动重试）\n- [x] **短剧解说特化**（4 风格 + 7 桥段识别 + 整季批量）\n- [x] **多平台智能适配**（8 平台 + 智能裁剪 + 平台封面）\n- [x] **统一 Worker 基类**（PySide6/headless 双模式）\n- [x] **LLM 流式输出**（逐 token 推送 + 句子边界检测）\n- [x] **5 篇架构决策记录**（ADR-001 ~ 005）\n\n### ✅ v1.1.0 (2026-06-02) — 8-Phase 架构重构\n\n- [x] 8-Phase 架构重构（类型统一、兼容层清理、大文件拆分）\n- [x] 启用 ruff `UP` (pyupgrade) 规则（1573 个 lint 错误清零）\n- [x] 完全向后兼容 v1.0.x\n\n### 🚧 进行中\n\n- [ ] Web Dashboard（轻量级远程监控 + 任务管理）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] 多语言 i18n（日 / 韩 / 英 / 西 4 语言界面）\n\n### 🔮 未来规划\n\n- [ ] 直播解说模式（实时视频流接入 + 低延迟 AI 解说）\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！请遵循以下流程：\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（[Conventional Commits](https://www.conventionalcommits.org/) 规范）：\n ```\n feat: 新功能\n fix: bug 修复\n docs: 文档更新\n style: 格式调整（无逻辑变化）\n refactor: 重构（无新功能/无 bug 修复）\n perf: 性能优化\n test: 测试\n chore: 构建/工具链\n ```\n4. 推送分支（`git push origin feat/amazing-feature`）\n5. 创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n## 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython-6/) — Qt for Python，桌面 UI 框架\n- [Qwen3-VL](https://github.com/QwenLM/Qwen3-VL) — 阿里通义千问视觉语言模型（最新版 Qwen3.7 已发布）\n- [DeepSeek](https://www.deepseek.com/) — 高性价比中文 LLM\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 微软 Edge 文本转语音\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 零样本语音克隆\n- [FFmpeg](https://ffmpeg.org/) — 视频处理瑞士军刀\n- [Ruff](https://github.com/astral-sh/ruff) — 极速 Python linter\n- [orjson](https://github.com/ijl/orjson) — 高性能 JSON 序列化\n- [pytest](https://docs.pytest.org/) — 测试框架\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star · 🐛 遇到问题请提交 [Issue](https://github.com/Agions/scene-fab/issues)\n\n[🚀 立即下载 v2.0.0](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) · [📖 阅读 ADR](https://github.com/Agions/scene-fab/tree/main/docs/adr) · [🤝 加入贡献](https://github.com/Agions/scene-fab/blob/main/CONTRIBUTING.md)\n\n
\n"}, "d74ccf9ccb74602d42e47e0bb0b81be82587aed4": {"t": 1785772741.118425, "n": 13030, "h": "25118d63a4625199", "c": "\n\n
\n
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **上传一部短剧 → AI 自动完成 25 集整季批量生产 → 一键导出抖音/B站/小红书**\n> 从「几天一条」变成「一天十条」，从「单平台发布」变成「一键多平台分发」。\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab/releases)\n[](https://github.com/Agions/scene-fab/releases/tag/v2.0.0)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载 v2.0.0**](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n ⚡ DAG 并行流水线\n 拓扑排序 + parallel_group
解说生成/配音/封面 3 步并行，整季 25 集 15 分钟出 \n | \n \n 📺 短剧整季批量\n 25-50 集一键导入
自动识别集数（EP01/第01集），断点续传，自动重试 \n | \n \n 🎬 8 平台智能适配\n 抖音/B站/小红书/西瓜/YouTube/TikTok/快手/剪映
一键导出多版本，AI 智能裁剪 + 平台封面 \n | \n \n 🔒 FFmpeg 安全加固\n 参数白名单 + 注入防护
消除 90%+ 命令注入面，审计日志全程记录 \n | \n
\n \n 📝 LLM 流式输出\n 逐 token UI 推送
首字延迟 < 2s，实时看到解说稿生成过程 \n | \n 🎭 短剧 4 风格\n 悬疑/甜宠/复仇/逆袭
7 桥段识别（打脸/救场/心动/反转…） \n | \n 📊 审计日志\n SQLite 持久化
所有 LLM/FFmpeg 调用可追溯 \n | \n 🛠️ 统一 Worker 基类\n PySide6/headless 双模式
取消/暂停/错误传播统一封装 \n | \n
\n
\n\n---\n\n## 它是什么？\n\n**SceneFab** 是为自媒体解说创作者打造的 **AI 影视解说视频一站式创作工具**。上传一部电影或短剧，AI 自动理解视频语义、按情节拆条、生成第一人称解说稿、合成情感化配音、对齐字幕、最终输出带解说的完整视频。\n\n### 核心能力（继承自 v1.x）\n\n\n \n \n 🎬 AI 语义拆条\n Qwen2.5-VL 视觉理解
自动识别场景边界、人物动作、对话起止 \n | \n \n 🎭 情感峰值选段\n 视觉 × 音频双维评分
优先挑选叙事高潮片段 \n | \n \n ✍️ AI 解说稿生成\n DeepSeek-V4 · 7+ 风格
第一人称视角，词级时间戳 \n | \n
\n \n 🎙️ 一键配音合成\n Edge-TTS · F5-TTS
50ms 精度字幕对齐，零样本音色克隆 \n | \n 💻 命令行原生\n pip install 即用
完整 CLI + SKILL.md Agent 接入 \n | \n 🔒 完全本地\n 视频文件永不上传
全本地处理，素材隐私 100% 安全 \n | \n
\n
\n\n## 快速开始\n\n### 下载安装\n\n| 平台 | 架构 | 文件 |\n|------|------|------|\n| **Windows** | x64 | [SceneFab-2.0.0-win-x64.exe](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n| **macOS** | Apple Silicon | [SceneFab-2.0.0-mac-arm64.dmg](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n| **macOS** | Intel | [SceneFab-2.0.0-mac-x64.dmg](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n| **Linux** | x64 | [SceneFab-2.0.0-linux-x64.AppImage](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) |\n\n> 📦 也可从 PyPI / 源码安装：\n\n```bash\n# PyPI（推荐用户）\npip install scenefab>=2.0.0\n\n# 源码（推荐开发者）\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# 启动 GUI\nscenefab gui\n\n# 短剧整季批量生产（v2.0 新增）\nscenefab batch /path/to/series/ --preset short_drama_suspense --parallel 2\n\n# 多平台一键导出（v2.0 新增）\nscenefab export master.mp4 --platforms douyin,bilibili,xiaohongshu\n\n# 单视频解说创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 可选：Qwen2.5-VL（视觉理解）\nexport QWEN_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n## 架构\n\nSceneFab v2.0 采用 **分层 + 模块化** 架构，8 个 v2.0 新核心模块（`scenefab.core.*`）与 v1.x 服务层无缝集成：\n\n```\n┌────────────────────────────────────────────────────────────────────┐\n│ 🎬 SceneFab v2.0 Architecture │\n└────────────────────────────────────────────────────────────────────┘\n\n ┌──────────────────────────────────────────────────────────┐\n │ UI 层 (PySide6 6.9 + Design Tokens) │\n │ HomePage · 5-Step Wizard · MonitorPanel · Worker │\n │ ↓ Signal/Slot │\n └──────────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────────┐\n │ v2.0 核心引擎 (scenefab.core.*) │\n │ │\n │ ┌─────────────────┐ ┌─────────────────┐ ┌────────────┐ │\n │ │ PipelineEngine │ │ BatchProcessor │ │ BaseWorker │ │\n │ │ (DAG 并行) │ │ (批量+断点) │ │ (统一基类) │ │\n │ └─────────────────┘ └─────────────────┘ └────────────┘ │\n │ ┌─────────────────┐ ┌─────────────────┐ ┌────────────┐ │\n │ │ SafeFFmpegCmd │ │ AuditLogger │ │ShortDrama │ │\n │ │ (白名单+审计) │ │ (SQLite 审计) │ │ Narrator │ │\n │ └─────────────────┘ └─────────────────┘ └────────────┘ │\n │ ┌─────────────────┐ ┌─────────────────┐ │\n │ │PlatformAdapter │ │ StreamingLLM │ │\n │ │ (8 平台适配) │ │ Worker (流式) │ │\n │ └─────────────────┘ └─────────────────┘ │\n └──────────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────────┐\n │ v1.x Services (业务服务层) │\n │ │\n │ services/ai/ LLM / Vision / TTS / ASR 适配器 │\n │ services/video/ FFmpeg / 帧提取 / 合成 / 缓存 │\n │ services/audio/ 音频处理 / 字幕对齐 │\n │ services/export/ MP4 / 剪映草稿 / 平台导出 │\n │ services/orchestration/ 任务调度 / 项目管理 │\n └──────────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────────┐\n │ Models + Utils + Plugins (数据+工具) │\n │ models/ 枚举 + 领域模型 │ utils/ 工具函数 │\n │ interfaces/ 抽象接口 │ plugins/ 插件加载 │\n └──────────────────────────────────────────────────────────┘\n```\n\n更详细的架构文档请见 [在线文档 - 架构](https://agions.github.io/scene-fab/dev/architecture) 与 [ADR 决策记录](https://github.com/Agions/scene-fab/tree/main/docs/adr)。\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|------------|------|\n| **v2.0 DAG 流水线** | ThreadPoolExecutor + 拓扑排序 | 短剧整季并行处理 ↓48% |\n| **v2.0 审计日志** | SQLite 3 | LLM/FFmpeg 调用全程追溯 |\n| **v2.0 FFmpeg 封装** | 参数白名单 + 危险字符检测 | 消除 90%+ 命令注入面 |\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7+ 预设风格 + 短剧 4 风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 多平台导出 | **v2.0 PlatformAdapter** | 8 平台 (抖音/B站/小红书/西瓜/YouTube/TikTok/快手/剪映) |\n| UI 框架 | **PySide6 6.9** | Qt for Python，原生桌面体验 |\n| 状态管理 | **PyQt Signal/Slot** | 跨组件解耦，事件驱动 |\n\n## 短剧解说业务流\n\nv2.0 为短剧（1-3 分钟/集，整季 25-50 集）业务做了深度优化：\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ 短剧整季批量生产 (v2.0 Short Drama Mode) │\n└─────────────────────────────────────────────────────────────┘\n\n INPUT: /series/重生女王归来/\n ├── EP01.mp4 ─┐\n ├── EP02.mp4 ─┤\n ├── ... ├─→ 自动识别集数 + 剧情连贯性分析\n └── EP25.mp4 ─┘\n │\n ▼\n ┌─────────────────────────────────────────────────────────┐\n │ Phase 1: 全局预分析（一次性，整季共享） │\n │ · 快速扫描 → 剧情时间线 │\n │ · 主角团识别 → 角色关系图谱 │\n │ · 提取高光时刻 → 高潮索引 │\n └─────────────────────────────────────────────────────────┘\n │\n ▼\n ┌─────────────────────────────────────────────────────────┐\n │ Phase 2: 并行批量处理（2-4 集并行） │\n │ Worker 1: EP01 → EP03 → EP05 ... │\n │ Worker 2: EP02 → EP04 → EP06 ... │\n │ 每集：拆条→桥段识别→解说→配音→合成（v2.0 DAG 并行） │\n └─────────────────────────────────────────────────────────┘\n │\n ▼\n ┌─────────────────────────────────────────────────────────┐\n │ Phase 3: 整季后处理 + 多平台分发 │\n │ · 统一封面风格（视觉一致性） │\n │ · 整季剧情摘要 │\n │ · 一键导出 8 平台版本（v2.0 PlatformAdapter） │\n └─────────────────────────────────────────────────────────┘\n │\n ▼\n OUTPUT:\n output/重生女王归来/\n ├── douyin/ # 抖音 9:16 竖屏\n ├── bilibili/ # B站 16:9 横屏\n ├── xiaohongshu/ # 小红书 3:4\n ├── xigua/ # 西瓜视频 16:9\n ├── youtube/ # YouTube 16:9\n └── jianying/ # 剪映草稿 (可二次编辑)\n```\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [架构设计](https://agions.github.io/scene-fab/dev/architecture) | 模块划分 + 数据流 |\n| [ADR 决策记录](https://github.com/Agions/scene-fab/tree/main/docs/adr) | 5 篇架构决策（v2.0） |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n**在线文档：https://agions.github.io/scene-fab/**\n\n## 路线图\n\n### ✅ v2.0.0 (2026-06-04) — 当前版本\n\n- [x] **DAG 并行流水线引擎**（拓扑排序 + parallel_group + always_run）\n- [x] **FFmpeg 安全封装**（参数白名单 + 注入防护 + 审计集成）\n- [x] **操作审计日志**（SQLite 持久化）\n- [x] **批量任务处理器**（并行 + 断点续传 + 自动重试）\n- [x] **短剧解说特化**（4 风格 + 7 桥段识别 + 整季批量）\n- [x] **多平台智能适配**（8 平台 + 智能裁剪 + 平台封面）\n- [x] **统一 Worker 基类**（PySide6/headless 双模式）\n- [x] **LLM 流式输出**（逐 token 推送 + 句子边界检测）\n- [x] **5 篇架构决策记录**（ADR-001 ~ 005）\n\n### ✅ v1.1.0 (2026-06-02) — 8-Phase 架构重构\n\n- [x] 8-Phase 架构重构（类型统一、兼容层清理、大文件拆分）\n- [x] 启用 ruff `UP` (pyupgrade) 规则（1573 个 lint 错误清零）\n- [x] 完全向后兼容 v1.0.x\n\n### 🚧 进行中\n\n- [ ] Web Dashboard（轻量级远程监控 + 任务管理）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] 多语言 i18n（日 / 韩 / 英 / 西 4 语言界面）\n\n### 🔮 未来规划\n\n- [ ] 直播解说模式（实时视频流接入 + 低延迟 AI 解说）\n- [ ] 智能字幕翻译（保留时序的多语言翻译）\n- [ ] 云端协作（项目云存储 + 多人审稿）\n- [ ] 移动端预览（iOS / Android 实时预览 App）\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！请遵循以下流程：\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（[Conventional Commits](https://www.conventionalcommits.org/) 规范）：\n ```\n feat: 新功能\n fix: bug 修复\n docs: 文档更新\n style: 格式调整（无逻辑变化）\n refactor: 重构（无新功能/无 bug 修复）\n perf: 性能优化\n test: 测试\n chore: 构建/工具链\n ```\n4. 推送分支（`git push origin feat/amazing-feature`）\n5. 创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n## 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython-6/) — Qt for Python，桌面 UI 框架\n- [Qwen2.5-VL](https://github.com/QwenLM/Qwen2.5-VL) — 阿里通义千问视觉语言模型\n- [DeepSeek](https://www.deepseek.com/) — 高性价比中文 LLM\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 微软 Edge 文本转语音\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 零样本语音克隆\n- [FFmpeg](https://ffmpeg.org/) — 视频处理瑞士军刀\n- [Ruff](https://github.com/astral-sh/ruff) — 极速 Python linter\n- [orjson](https://github.com/ijl/orjson) — 高性能 JSON 序列化\n- [pytest](https://docs.pytest.org/) — 测试框架\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star · 🐛 遇到问题请提交 [Issue](https://github.com/Agions/scene-fab/issues)\n\n[🚀 立即下载 v2.0.0](https://github.com/Agions/scene-fab/releases/tag/v2.0.0) · [📖 阅读 ADR](https://github.com/Agions/scene-fab/tree/main/docs/adr) · [🤝 加入贡献](https://github.com/Agions/scene-fab/blob/main/CONTRIBUTING.md)\n\n
\n"}, "30cabcf21a79da9f2cbf028d895c85384cf7095a": {"t": 1785772742.5508752, "n": 8130, "h": "80e47861662dcd6a", "c": "\n
\n
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **上传一部电影 → AI 自动完成语义拆条、解说稿、配音、字幕、合成导出**\n> 从「几天一条」变成「一天十条」。\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab/releases)\n[](https://github.com/Agions/scene-fab/releases)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n 🎬 AI 语义拆条\n Qwen2.5-VL 视觉理解
自动识别场景边界、人物动作、对话起止，按情节/叙事单元切分，无需手动打点 \n | \n \n 🎭 情感峰值选段\n 视觉 × 音频双维评分
画面信息密度 + 语调变化，优先挑选叙事高潮片段，让解说更抓人 \n | \n \n ✍️ AI 解说稿生成\n DeepSeek-V4 · 7 种情感风格
纪录片 / 剧情 / 搞笑 / 悬疑… 第一人称视角，词级时间戳自动对齐 \n | \n
\n \n 🎙️ 一键配音合成\n Edge-TTS · F5-TTS
50ms 精度字幕对齐，零样本音色克隆，主流低延迟与高品质兼顾 \n | \n 📦 多格式导出\n H.264 / H.265 MP4 · 剪映草稿
直出发布平台，或导出原生 JSON 继续精剪，无缝对接现有工作流 \n | \n 💻 命令行原生\n pip install 即用
提供完整 CLI，SKILL.md 支持 Agent 工作流接入（OpenCode / Claude Code / Hermes） \n | \n
\n
\n\n## 快速开始\n\n### 下载安装\n\n| 平台 | 架构 | 文件 |\n|------|------|------|\n| **Windows** | x64 | [SceneFab-1.1.0-win-x64.exe](https://github.com/Agions/scene-fab/releases/latest) |\n| **macOS** | Apple Silicon | [SceneFab-1.1.0-mac-arm64.dmg](https://github.com/Agions/scene-fab/releases/latest) |\n| **macOS** | Intel | [SceneFab-1.1.0-mac-x64.dmg](https://github.com/Agions/scene-fab/releases/latest) |\n| **Linux** | x64 | [SceneFab-1.1.0-linux-x64.AppImage](https://github.com/Agions/scene-fab/releases/latest) |\n\n> 📦 也可从源码安装（推荐开发者）：\n\n```bash\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# 启动 GUI\nscenefab gui\n\n# 或纯命令行创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n## 架构\n\nSceneFab 采用 **Python + PySide6** 单体桌面应用架构，5 步流水线串接 AI 服务与本地媒体处理：\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ 🎬 SceneFab Architecture │\n└──────────────────────────────────────────────────────────────────┘\n\n ┌──────────────────────────────────────────────────────┐\n │ UI 层 (PySide6 6.9 + Design Tokens) │\n │ HomePage · 5-Step Wizard · MonitorPanel · ... │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Core Engine (核心业务引擎) │\n │ │\n │ pipeline.py ─── 串联 5 步处理流水线 │\n │ │ │\n │ ├─ Step 1: frame_extractor (Qwen2.5-VL 语义拆条) │\n │ ├─ Step 2: emotion_detector (情感峰值选段) │\n │ ├─ Step 3: script_generator (DeepSeek-V4 解说稿) │\n │ ├─ Step 4: tts_generator (Edge-TTS / F5-TTS) │\n │ └─ Step 5: video_compositor (FFmpeg H.264/H.265) │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Services (业务服务层) │\n │ │\n │ services/ai/ LLM / Vision / TTS / ASR 适配器 │\n │ services/video/ FFmpeg 包装 / 帧提取 / 合成 │\n │ services/audio/ 音频处理 / 字幕对齐 │\n │ services/export/ MP4 / 剪映草稿导出 │\n │ services/orchestration/ 流水线编排 / 任务调度 │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Models + Utils (数据 + 工具) │\n │ │\n │ models/ 领域数据模型 + 集中枚举 (enums.py) │\n │ utils/ 帧编码 / 媒体工具 / 进度 / 图像分析 │\n │ interfaces/ Cache / Service Provider 抽象 │\n └──────────────────────────────────────────────────────┘\n```\n\n更详细的架构文档（含 Mermaid 流程图）请见 [在线文档 - 架构](https://agions.github.io/scene-fab/dev/architecture)。\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|------------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n| UI 框架 | **PySide6 6.9** | Qt for Python，原生桌面体验 |\n| 状态管理 | **PyQt Signal/Slot** | 跨组件解耦，事件驱动 |\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [架构设计](https://agions.github.io/scene-fab/dev/architecture) | 模块划分 + 数据流 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n**在线文档：https://agions.github.io/scene-fab/**\n\n## 路线图\n\n### ✅ 已完成（v1.0.x / v1.1.0）\n\n- [x] AI 语义拆条（Qwen2.5-VL）\n- [x] 情感峰值选段（视觉+音频双维）\n- [x] DeepSeek-V4 解说生成（7 种风格）\n- [x] Edge-TTS / F5-TTS 配音合成\n- [x] 词级字幕对齐（50ms 精度）\n- [x] H.264/H.265 MP4 导出\n- [x] 剪映草稿 JSON 导出\n- [x] GUI 桌面应用（PySide6）\n- [x] 命令行接口（CLI）\n- [x] **v1.1.0 8-Phase 架构重构**（类型统一、兼容层清理、大文件拆分、命名规范化）\n- [x] **启用 ruff `UP` (pyupgrade) 规则**（1573 个 lint 错误清零）\n\n### 🚧 进行中\n\n- [ ] 主窗口与监控面板拆分（需 PySide6 运行时验证）\n- [ ] 跨平台打包优化（Windows / macOS / Linux 三端）\n\n### 🔮 规划\n\n- [ ] 多模态解说（图像+文本混合输入）\n- [ ] 实时协作（多人协同编辑项目）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] Web 端预览（无需安装即可体验）\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！请遵循以下流程：\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（[Conventional Commits](https://www.conventionalcommits.org/) 规范）：\n ```\n feat: 新功能\n fix: bug 修复\n docs: 文档更新\n style: 格式调整（无逻辑变化）\n refactor: 重构（无新功能/无 bug 修复）\n perf: 性能优化\n test: 测试\n chore: 构建/工具链\n ```\n4. 推送分支（`git push origin feat/amazing-feature`）\n5. 创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n## 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython-6/) — Qt for Python，桌面 UI 框架\n- [Qwen2.5-VL](https://github.com/QwenLM/Qwen2.5-VL) — 阿里通义千问视觉语言模型\n- [DeepSeek](https://www.deepseek.com/) — 高性价比中文 LLM\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 微软 Edge 文本转语音\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 零样本语音克隆\n- [FFmpeg](https://ffmpeg.org/) — 视频处理瑞士军刀\n- [Ruff](https://github.com/astral-sh/ruff) — 极速 Python linter\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star · 🐛 遇到问题请提交 [Issue](https://github.com/Agions/scene-fab/issues)\n\n
\n"}, "16cf4bfdb28f6dbaf5b42026e66eafab1b1714a1": {"t": 1785772744.8359303, "n": 8137, "h": "7b1789b064434a9e", "c": "\n
\n
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **上传一部电影 → AI 自动完成语义拆条、解说稿、配音、字幕、合成导出**\n> 从「几天一条」变成「一天十条」。\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab/releases)\n[](https://github.com/Agions/scene-fab/releases)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n 🎬 AI 语义拆条\n Qwen2.5-VL 视觉理解
自动识别场景边界、人物动作、对话起止，按情节/叙事单元切分，无需手动打点 \n | \n \n 🎭 情感峰值选段\n 视觉 × 音频双维评分
画面信息密度 + 语调变化，优先挑选叙事高潮片段，让解说更抓人 \n | \n \n ✍️ AI 解说稿生成\n DeepSeek-V4 · 7 种情感风格
纪录片 / 剧情 / 搞笑 / 悬疑… 第一人称视角，词级时间戳自动对齐 \n | \n
\n \n 🎙️ 一键配音合成\n Edge-TTS · F5-TTS
50ms 精度字幕对齐，零样本音色克隆，主流低延迟与高品质兼顾 \n | \n 📦 多格式导出\n H.264 / H.265 MP4 · 剪映草稿
直出发布平台，或导出原生 JSON 继续精剪，无缝对接现有工作流 \n | \n 💻 命令行原生\n pip install 即用
提供完整 CLI，SKILL.md 支持 Agent 工作流接入（OpenCode / Claude Code / Hermes） \n | \n
\n
\n\n## 快速开始\n\n### 下载安装\n\n| 平台 | 架构 | 文件 |\n|------|------|------|\n| **Windows** | x64 | [SceneFab-1.1.0-win-x64.exe](https://github.com/Agions/scene-fab/releases/latest) |\n| **macOS** | Apple Silicon | [SceneFab-1.1.0-mac-arm64.dmg](https://github.com/Agions/scene-fab/releases/latest) |\n| **macOS** | Intel | [SceneFab-1.1.0-mac-x64.dmg](https://github.com/Agions/scene-fab/releases/latest) |\n| **Linux** | x64 | [SceneFab-1.1.0-linux-x64.AppImage](https://github.com/Agions/scene-fab/releases/latest) |\n\n> 📦 也可从源码安装（推荐开发者）：\n\n```bash\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# 启动 GUI\nscenefab gui\n\n# 或纯命令行创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n## 架构\n\nSceneFab 采用 **Python + PySide6** 单体桌面应用架构，5 步流水线串接 AI 服务与本地媒体处理：\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ 🎬 SceneFab Architecture │\n└──────────────────────────────────────────────────────────────────┘\n\n ┌──────────────────────────────────────────────────────┐\n │ UI 层 (PySide6 6.9 + Design Tokens) │\n │ HomePage · 5-Step Wizard · MonitorPanel · ... │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Core Engine (核心业务引擎) │\n │ │\n │ pipeline.py ─── 串联 5 步处理流水线 │\n │ │ │\n │ ├─ Step 1: frame_extractor (Qwen2.5-VL 语义拆条) │\n │ ├─ Step 2: emotion_detector (情感峰值选段) │\n │ ├─ Step 3: script_generator (DeepSeek-V4 解说稿) │\n │ ├─ Step 4: tts_generator (Edge-TTS / F5-TTS) │\n │ └─ Step 5: video_compositor (FFmpeg H.264/H.265) │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Services (业务服务层) │\n │ │\n │ services/ai/ LLM / Vision / TTS / ASR 适配器 │\n │ services/video/ FFmpeg 包装 / 帧提取 / 合成 │\n │ services/audio/ 音频处理 / 字幕对齐 │\n │ services/export/ MP4 / 剪映草稿导出 │\n │ services/orchestration/ 流水线编排 / 任务调度 │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Models + Utils (数据 + 工具) │\n │ │\n │ models/ 领域数据模型 + 集中枚举 (enums.py) │\n │ utils/ 帧编码 / 媒体工具 / 进度 / 图像分析 │\n │ interfaces/ Cache / Service Provider 抽象 │\n └──────────────────────────────────────────────────────┘\n```\n\n更详细的架构文档（含 Mermaid 流程图）请见 [在线文档 - 架构](https://agions.github.io/scene-fab/dev/architecture)。\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|------------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n| UI 框架 | **PySide6 6.9** | Qt for Python，原生桌面体验 |\n| 状态管理 | **PyQt Signal/Slot** | 跨组件解耦，事件驱动 |\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [架构设计](https://agions.github.io/scene-fab/dev/architecture) | 模块划分 + 数据流 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n**在线文档：https://agions.github.io/scene-fab/**\n\n## 路线图\n\n### ✅ 已完成（v1.0.x / v1.1.0）\n\n- [x] AI 语义拆条（Qwen2.5-VL）\n- [x] 情感峰值选段（视觉+音频双维）\n- [x] DeepSeek-V4 解说生成（7 种风格）\n- [x] Edge-TTS / F5-TTS 配音合成\n- [x] 词级字幕对齐（50ms 精度）\n- [x] H.264/H.265 MP4 导出\n- [x] 剪映草稿 JSON 导出\n- [x] GUI 桌面应用（PySide6）\n- [x] 命令行接口（CLI）\n- [x] **v1.1.0 8-Phase 架构重构**（类型统一、兼容层清理、大文件拆分、命名规范化）\n- [x] **启用 ruff `UP` (pyupgrade) 规则**（1573 个 lint 错误清零）\n\n### 🚧 进行中\n\n- [ ] 主窗口与监控面板拆分（需 PySide6 运行时验证）\n- [ ] 跨平台打包优化（Windows / macOS / Linux 三端）\n\n### 🔮 规划\n\n- [ ] 多模态解说（图像+文本混合输入）\n- [ ] 实时协作（多人协同编辑项目）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] Web 端预览（无需安装即可体验）\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！请遵循以下流程：\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（[Conventional Commits](https://www.conventionalcommits.org/) 规范）：\n ```\n feat: 新功能\n fix: bug 修复\n docs: 文档更新\n style: 格式调整（无逻辑变化）\n refactor: 重构（无新功能/无 bug 修复）\n perf: 性能优化\n test: 测试\n chore: 构建/工具链\n ```\n4. 推送分支（`git push origin feat/amazing-feature`）\n5. 创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n## 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython-6/) — Qt for Python，桌面 UI 框架\n- [Qwen2.5-VL](https://github.com/QwenLM/Qwen2.5-VL) — 阿里通义千问视觉语言模型\n- [DeepSeek](https://www.deepseek.com/) — 高性价比中文 LLM\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 微软 Edge 文本转语音\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 零样本语音克隆\n- [FFmpeg](https://ffmpeg.org/) — 视频处理瑞士军刀\n- [Ruff](https://github.com/astral-sh/ruff) — 极速 Python linter\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star · 🐛 遇到问题请提交 [Issue](https://github.com/Agions/scene-fab/issues)\n\n
\n\n\n"}, "c715f418ceab3d3980defcdf3b0a42950a779306": {"t": 1785772746.1545668, "n": 8130, "h": "80e47861662dcd6a", "c": "\n
\n
\n\n# SceneFab · AI 影视解说视频创作工具\n\n> **上传一部电影 → AI 自动完成语义拆条、解说稿、配音、字幕、合成导出**\n> 从「几天一条」变成「一天十条」。\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab/releases)\n[](https://github.com/Agions/scene-fab/releases)\n\n[**在线文档**](https://agions.github.io/scene-fab/) · [**下载安装**](https://github.com/Agions/scene-fab/releases) · [**报告问题**](https://github.com/Agions/scene-fab/issues/new) · [**功能建议**](https://github.com/Agions/scene-fab/discussions)\n\n
\n \n \n 🎬 AI 语义拆条\n Qwen2.5-VL 视觉理解
自动识别场景边界、人物动作、对话起止，按情节/叙事单元切分，无需手动打点 \n | \n \n 🎭 情感峰值选段\n 视觉 × 音频双维评分
画面信息密度 + 语调变化，优先挑选叙事高潮片段，让解说更抓人 \n | \n \n ✍️ AI 解说稿生成\n DeepSeek-V4 · 7 种情感风格
纪录片 / 剧情 / 搞笑 / 悬疑… 第一人称视角，词级时间戳自动对齐 \n | \n
\n \n 🎙️ 一键配音合成\n Edge-TTS · F5-TTS
50ms 精度字幕对齐，零样本音色克隆，主流低延迟与高品质兼顾 \n | \n 📦 多格式导出\n H.264 / H.265 MP4 · 剪映草稿
直出发布平台，或导出原生 JSON 继续精剪，无缝对接现有工作流 \n | \n 💻 命令行原生\n pip install 即用
提供完整 CLI，SKILL.md 支持 Agent 工作流接入（OpenCode / Claude Code / Hermes） \n | \n
\n
\n\n## 快速开始\n\n### 下载安装\n\n| 平台 | 架构 | 文件 |\n|------|------|------|\n| **Windows** | x64 | [SceneFab-1.1.0-win-x64.exe](https://github.com/Agions/scene-fab/releases/latest) |\n| **macOS** | Apple Silicon | [SceneFab-1.1.0-mac-arm64.dmg](https://github.com/Agions/scene-fab/releases/latest) |\n| **macOS** | Intel | [SceneFab-1.1.0-mac-x64.dmg](https://github.com/Agions/scene-fab/releases/latest) |\n| **Linux** | x64 | [SceneFab-1.1.0-linux-x64.AppImage](https://github.com/Agions/scene-fab/releases/latest) |\n\n> 📦 也可从源码安装（推荐开发者）：\n\n```bash\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# 启动 GUI\nscenefab gui\n\n# 或纯命令行创作\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置也能用：Edge-TTS 配音、字幕对齐、视频合成等基础功能全本地可用\n```\n\n## 架构\n\nSceneFab 采用 **Python + PySide6** 单体桌面应用架构，5 步流水线串接 AI 服务与本地媒体处理：\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ 🎬 SceneFab Architecture │\n└──────────────────────────────────────────────────────────────────┘\n\n ┌──────────────────────────────────────────────────────┐\n │ UI 层 (PySide6 6.9 + Design Tokens) │\n │ HomePage · 5-Step Wizard · MonitorPanel · ... │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Core Engine (核心业务引擎) │\n │ │\n │ pipeline.py ─── 串联 5 步处理流水线 │\n │ │ │\n │ ├─ Step 1: frame_extractor (Qwen2.5-VL 语义拆条) │\n │ ├─ Step 2: emotion_detector (情感峰值选段) │\n │ ├─ Step 3: script_generator (DeepSeek-V4 解说稿) │\n │ ├─ Step 4: tts_generator (Edge-TTS / F5-TTS) │\n │ └─ Step 5: video_compositor (FFmpeg H.264/H.265) │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Services (业务服务层) │\n │ │\n │ services/ai/ LLM / Vision / TTS / ASR 适配器 │\n │ services/video/ FFmpeg 包装 / 帧提取 / 合成 │\n │ services/audio/ 音频处理 / 字幕对齐 │\n │ services/export/ MP4 / 剪映草稿导出 │\n │ services/orchestration/ 流水线编排 / 任务调度 │\n └──────────────────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────────────────┐\n │ Models + Utils (数据 + 工具) │\n │ │\n │ models/ 领域数据模型 + 集中枚举 (enums.py) │\n │ utils/ 帧编码 / 媒体工具 / 进度 / 图像分析 │\n │ interfaces/ Cache / Service Provider 抽象 │\n └──────────────────────────────────────────────────────┘\n```\n\n更详细的架构文档（含 Mermaid 流程图）请见 [在线文档 - 架构](https://agions.github.io/scene-fab/dev/architecture)。\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|------------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n| UI 框架 | **PySide6 6.9** | Qt for Python，原生桌面体验 |\n| 状态管理 | **PyQt Signal/Slot** | 跨组件解耦，事件驱动 |\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [架构设计](https://agions.github.io/scene-fab/dev/architecture) | 模块划分 + 数据流 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n**在线文档：https://agions.github.io/scene-fab/**\n\n## 路线图\n\n### ✅ 已完成（v1.0.x / v1.1.0）\n\n- [x] AI 语义拆条（Qwen2.5-VL）\n- [x] 情感峰值选段（视觉+音频双维）\n- [x] DeepSeek-V4 解说生成（7 种风格）\n- [x] Edge-TTS / F5-TTS 配音合成\n- [x] 词级字幕对齐（50ms 精度）\n- [x] H.264/H.265 MP4 导出\n- [x] 剪映草稿 JSON 导出\n- [x] GUI 桌面应用（PySide6）\n- [x] 命令行接口（CLI）\n- [x] **v1.1.0 8-Phase 架构重构**（类型统一、兼容层清理、大文件拆分、命名规范化）\n- [x] **启用 ruff `UP` (pyupgrade) 规则**（1573 个 lint 错误清零）\n\n### 🚧 进行中\n\n- [ ] 主窗口与监控面板拆分（需 PySide6 运行时验证）\n- [ ] 跨平台打包优化（Windows / macOS / Linux 三端）\n\n### 🔮 规划\n\n- [ ] 多模态解说（图像+文本混合输入）\n- [ ] 实时协作（多人协同编辑项目）\n- [ ] 插件市场（用户自定义 AI Provider / TTS 音色）\n- [ ] Web 端预览（无需安装即可体验）\n\n## 贡献\n\n欢迎 PR / Issue / Discussion！请遵循以下流程：\n\n1. **Fork** 本仓库\n2. 创建 feature 分支（`git checkout -b feat/amazing-feature`）\n3. 提交改动（[Conventional Commits](https://www.conventionalcommits.org/) 规范）：\n ```\n feat: 新功能\n fix: bug 修复\n docs: 文档更新\n style: 格式调整（无逻辑变化）\n refactor: 重构（无新功能/无 bug 修复）\n perf: 性能优化\n test: 测试\n chore: 构建/工具链\n ```\n4. 推送分支（`git push origin feat/amazing-feature`）\n5. 创建 [Pull Request](https://github.com/Agions/scene-fab/pulls)\n\n## 致谢\n\nSceneFab 的诞生离不开以下开源项目：\n\n- [PySide6](https://doc.qt.io/qtforpython-6/) — Qt for Python，桌面 UI 框架\n- [Qwen2.5-VL](https://github.com/QwenLM/Qwen2.5-VL) — 阿里通义千问视觉语言模型\n- [DeepSeek](https://www.deepseek.com/) — 高性价比中文 LLM\n- [Edge-TTS](https://github.com/rany2/edge-tts) — 微软 Edge 文本转语音\n- [F5-TTS](https://github.com/SWivid/F5-TTS) — 零样本语音克隆\n- [FFmpeg](https://ffmpeg.org/) — 视频处理瑞士军刀\n- [Ruff](https://github.com/astral-sh/ruff) — 极速 Python linter\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star · 🐛 遇到问题请提交 [Issue](https://github.com/Agions/scene-fab/issues)\n\n
\n"}, "a1adab42f5e0f9b3fc7e5ec3ef852fde9215fdaf": {"t": 1785772747.8440704, "n": 3572, "h": "9392fa120a7400a0", "c": "# SceneFab\n\n**AI 影视解说创作工具 — 智能拆条 · AI 解说生成 · 一键配音合成**\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab)\n[](https://github.com/Agions/scene-fab/releases)\n\n---\n\n## 定位\n\n> **SceneFab** — 上传一部电影/短剧，AI 自动完成语义拆条、生成解说稿、合成配音，一键导出解说视频。\n>\n> 从「几天一条」变成「一天十条」。\n\n| 成本 | 隐私 | 效率 |\n|------|------|------|\n| < ¥0.01/视频（DeepSeek-V4） | 视频永不上传云端，全本地 | 5-15 分钟/条 |\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **AI 语义拆条** | Qwen2.5-VL 理解视频语义，按情节/场景自动切分，无需手动打点 |\n| 🎭 **情感峰值选段** | 视觉 + 音频双维评分，优先选取叙事高潮片段 |\n| ✍️ **AI 解说稿生成** | DeepSeek-V4 生成情感丰富解说，7 种风格一键切换 |\n| 🎙️ **一键配音合成** | Edge-TTS / F5-TTS，50ms 精度字幕对齐 |\n| 📦 **多格式导出** | H.264/H.265 MP4 直出，或原生剪映草稿 JSON |\n| 💻 **命令行原生** | pip 安装即用，支持 Agent 工作流接入（SKILL.md） |\n\n---\n\n## 5 步创作流程\n\n```\n上传视频（mp4/mov/avi/webm）\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 1 · AI 语义拆条 │\n│ Qwen2.5-VL 视觉理解，场景边界检测 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 2 · 情感峰值选段 │\n│ 视觉信息密度 × 0.6 + 音频语调 × 0.4 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 3 · 解说稿生成 │\n│ DeepSeek-V4 · 7 种情感风格 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 4 · 配音合成 │\n│ Edge-TTS / F5-TTS + 词级时间戳 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 5 · 视频合成导出 │\n│ FFmpeg H.264/H.265 · MP4 / 剪映草稿 │\n└──────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|-----------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n\n---\n\n## 快速开始\n\n### 安装\n\n**方式一：从 PyPI 安装（待发布）**\n```bash\npip install scenefab\n```\n\n**方式二：从源码安装（推荐）**\n```bash\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# GUI 模式\nscenefab gui\n\n# 命令行模式\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置时：Edge-TTS 配音等基础功能仍可正常使用\n```\n\n---\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n在线文档：**https://agions.github.io/scene-fab/**\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n
\n"}, "f43190bca56a935628963fe679a434bb347e52bd": {"t": 1785772749.559129, "n": 3572, "h": "a5da7c0e50a5cad7", "c": "# SceneFab\n\n**AI 影视解说创作工具 — 智能拆条 · AI 解说生成 · 一键配音合成**\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab)\n[](https://github.com/Agions/scene-fab/releases)\n\n---\n\n## 定位\n\n> **SceneFab** — 上传一部电影/短剧，AI 自动完成语义拆条、生成解说稿、合成配音，一键导出解说视频。\n>\n> 从「几天一条」变成「一天十条」。\n\n| 成本 | 隐私 | 效率 |\n|------|------|------|\n| < ¥0.01/视频（DeepSeek-V4） | 视频永不上传云端，全本地 | 5-15 分钟/条 |\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **AI 语义拆条** | Qwen2.5-VL 理解视频语义，按情节/场景自动切分，无需手动打点 |\n| 🎭 **情感峰值选段** | 视觉 + 音频双维评分，优先选取叙事高潮片段 |\n| ✍️ **AI 解说稿生成** | DeepSeek-V4 生成情感丰富解说，7 种风格一键切换 |\n| 🎙️ **一键配音合成** | Edge-TTS / F5-TTS，50ms 精度字幕对齐 |\n| 📦 **多格式导出** | H.264/H.265 MP4 直出，或原生剪映草稿 JSON |\n| 💻 **命令行原生** | pip 安装即用，支持 Agent 工作流接入（SKILL.md） |\n\n---\n\n## 5 步创作流程\n\n```\n上传视频（mp4/mov/avi/webm）\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 1 · AI 语义拆条 │\n│ Qwen2.5-VL 视觉理解，场景边界检测 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 2 · 情感峰值选段 │\n│ 视觉信息密度 × 0.6 + 音频语调 × 0.4 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 3 · 解说稿生成 │\n│ DeepSeek-V4 · 7 种情感风格 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 4 · 配音合成 │\n│ Edge-TTS / F5-TTS + 词级时间戳 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 5 · 视频合成导出 │\n│ FFmpeg H.264/H.265 · MP4 / 剪映草稿 │\n└──────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|-----------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n\n---\n\n## 快速开始\n\n### 安装\n\n**方式一：从 PyPI 安装（待发布）**\n```bash\npip install scenefab\n```\n\n**方式二：从源码安装（推荐）**\n```bash\ngit clone https://github.com/Agions/scene-fab.git\ncd scene-fab\npip install -e .\n```\n\n### 运行\n\n```bash\n# GUI 模式\nscenefab gui\n\n# 命令行模式\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置时：Edge-TTS 配音等基础功能仍可正常使用\n```\n\n---\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n在线文档：**https://agions.github.io/scene-fab/**\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n
\n"}, "9cce4aa2091ba619591069555787feb2b5fa5bf8": {"t": 1785772750.73756, "n": 3438, "h": "7f3391111f920d85", "c": "# SceneFab\n\n**AI 影视解说创作工具 — 智能拆条 · AI 解说生成 · 一键配音合成**\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab)\n[](https://github.com/Agions/scene-fab/releases)\n\n---\n\n## 定位\n\n> **SceneFab** — 上传一部电影/短剧，AI 自动完成语义拆条、生成解说稿、合成配音，一键导出解说视频。\n>\n> 从「几天一条」变成「一天十条」。\n\n| 成本 | 隐私 | 效率 |\n|------|------|------|\n| < ¥0.01/视频（DeepSeek-V4） | 视频永不上传云端，全本地 | 5-15 分钟/条 |\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **AI 语义拆条** | Qwen2.5-VL 理解视频语义，按情节/场景自动切分，无需手动打点 |\n| 🎭 **情感峰值选段** | 视觉 + 音频双维评分，优先选取叙事高潮片段 |\n| ✍️ **AI 解说稿生成** | DeepSeek-V4 生成情感丰富解说，7 种风格一键切换 |\n| 🎙️ **一键配音合成** | Edge-TTS / F5-TTS，50ms 精度字幕对齐 |\n| 📦 **多格式导出** | H.264/H.265 MP4 直出，或原生剪映草稿 JSON |\n| 💻 **命令行原生** | pip 安装即用，支持 Agent 工作流接入（SKILL.md） |\n\n---\n\n## 5 步创作流程\n\n```\n上传视频（mp4/mov/avi/webm）\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 1 · AI 语义拆条 │\n│ Qwen2.5-VL 视觉理解，场景边界检测 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 2 · 情感峰值选段 │\n│ 视觉信息密度 × 0.6 + 音频语调 × 0.4 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 3 · 解说稿生成 │\n│ DeepSeek-V4 · 7 种情感风格 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 4 · 配音合成 │\n│ Edge-TTS / F5-TTS + 词级时间戳 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 5 · 视频合成导出 │\n│ FFmpeg H.264/H.265 · MP4 / 剪映草稿 │\n└──────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|-----------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n\n---\n\n## 快速开始\n\n### 安装\n\n```bash\npip install scenefab\n```\n\n### 运行\n\n```bash\n# GUI 模式\nscenefab gui\n\n# 命令行模式\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置时：Edge-TTS 配音等基础功能仍可正常使用\n```\n\n---\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n在线文档：**https://agions.github.io/scene-fab/**\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n
\n"}, "ef5009927c6ee75f45d94acfb8ce041cefd26f9f": {"t": 1785772751.9010057, "n": 3752, "h": "4a2668e6115b52a6", "c": "# SceneFab\n\n**AI 影视解说创作工具 — 智能拆条 · AI 解说生成 · 一键配音合成**\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab)\n[](https://github.com/Agions/scene-fab/releases)\n\n---\n\n## 定位\n\n> **SceneFab** — 上传一部电影/短剧，AI 自动完成语义拆条、生成解说稿、合成配音，一键导出解说视频。\n>\n> 从「几天一条」变成「一天十条」。\n\n| 成本 | 隐私 | 效率 |\n|------|------|------|\n| < ¥0.01/视频（DeepSeek-V4） | 视频永不上传云端，全本地 | 5-15 分钟/条 |\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **AI 语义拆条** | Qwen2.5-VL 理解视频语义，按情节/场景自动切分，无需手动打点 |\n| 🎭 **情感峰值选段** | 视觉 + 音频双维评分，优先选取叙事高潮片段 |\n| ✍️ **AI 解说稿生成** | DeepSeek-V4 生成情感丰富解说，7 种风格一键切换 |\n| 🎙️ **一键配音合成** | Edge-TTS / F5-TTS，50ms 精度字幕对齐 |\n| 📦 **多格式导出** | H.264/H.265 MP4 直出，或原生剪映草稿 JSON |\n| 💻 **命令行原生** | pip 安装即用，支持 Agent 工作流接入（SKILL.md） |\n\n---\n\n## 5 步创作流程\n\n```\n上传视频（mp4/mov/avi/webm）\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 1 · AI 语义拆条 │\n│ Qwen2.5-VL 视觉理解，场景边界检测 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 2 · 情感峰值选段 │\n│ 视觉信息密度 × 0.6 + 音频语调 × 0.4 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 3 · 解说稿生成 │\n│ DeepSeek-V4 · 7 种情感风格 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 4 · 配音合成 │\n│ Edge-TTS / F5-TTS + 词级时间戳 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 5 · 视频合成导出 │\n│ FFmpeg H.264/H.265 · MP4 / 剪映草稿 │\n└──────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|-----------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n\n---\n\n## 快速开始\n\n### 安装\n\n```bash\npip install scenefab\n```\n\n### 运行\n\n```bash\n# GUI 模式\nscenefab gui\n\n# 命令行模式\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置时：Edge-TTS 配音等基础功能仍可正常使用\n```\n\n---\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n在线文档：**https://agions.github.io/scene-fab/**\n\n---\n\n## 竞品对比\n\n| 功能 | SceneFab | NarratoAI | AI解说大师 |\n|------|---------|-----------|-----------|\n| 语义拆条 | ✅ Qwen2.5-VL | ⚠️ 基础 | ⚠️ 基础 |\n| 影视解说 | ✅ 7种风格 | ✅ | ✅ |\n| 短剧解说 | ✅ | ❌ | ⚠️ |\n| 命令行原生 | ✅ | ❌ | ✅ |\n| Agent Skill 接入 | ✅ SKILL.md | ❌ | ✅ |\n| 剪映草稿导出 | ✅ | ❌ | ❌ |\n| 完全本地 | ✅ | ❌ | ❌ |\n| 开源 | ✅ MIT | ✅ | ❌ |\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n
\n"}, "d994598bc407e1c2612928a190583ea708779e8a": {"t": 1785772753.1361296, "n": 3752, "h": "b904c8bd51dc2d18", "c": "# SceneFab\n\n**AI 影视解说创作工具 — 智能拆条 · AI 解说生成 · 一键配音合成**\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/scene-fab)\n[](https://github.com/Agions/scene-fab/releases)\n\n---\n\n## 定位\n\n> **SceneFab** — 上传一部电影/短剧，AI 自动完成语义拆条、生成解说稿、合成配音，一键导出解说视频。\n>\n> 从「几天一条」变成「一天十条」。\n\n| 成本 | 隐私 | 效率 |\n|------|------|------|\n| < ¥0.01/视频（DeepSeek-V4） | 视频永不上传云端，全本地 | 5-15 分钟/条 |\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **AI 语义拆条** | Qwen2.5-VL 理解视频语义，按情节/场景自动切分，无需手动打点 |\n| 🎭 **情感峰值选段** | 视觉 + 音频双维评分，优先选取叙事高潮片段 |\n| ✍️ **AI 解说稿生成** | DeepSeek-V4 生成情感丰富解说，7 种风格一键切换 |\n| 🎙️ **一键配音合成** | Edge-TTS / F5-TTS，50ms 精度字幕对齐 |\n| 📦 **多格式导出** | H.264/H.265 MP4 直出，或原生剪映草稿 JSON |\n| 💻 **命令行原生** | pip 安装即用，支持 Agent 工作流接入（SKILL.md） |\n\n---\n\n## 5 步创作流程\n\n```\n上传视频（mp4/mov/avi/webm）\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 1 · AI 语义拆条 │\n│ Qwen2.5-VL 视觉理解，场景边界检测 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 2 · 情感峰值选段 │\n│ 视觉信息密度 × 0.6 + 音频语调 × 0.4 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 3 · 解说稿生成 │\n│ DeepSeek-V4 · 7 种情感风格 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 4 · 配音合成 │\n│ Edge-TTS / F5-TTS + 词级时间戳 │\n└──────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────┐\n│ Step 5 · 视频合成导出 │\n│ FFmpeg H.264/H.265 · MP4 / 剪映草稿 │\n└──────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|-----------|------|\n| 语义拆条 | **Qwen2.5-VL** | 视频帧逐帧理解，语义场景边界检测 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 情感评分 | 视觉 + 音频双维 | 画面信息密度 + 语调变化，综合排序 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕对齐 | TTS Word-level Timing | 精确到每个字的起止时间，50ms 精度 |\n| 视频合成 | **FFmpeg** | H.264/H.265 编码，本地处理 |\n| 导出格式 | **MP4** · **剪映草稿** | 直出发布 / 继续精剪 |\n\n---\n\n## 快速开始\n\n### 安装\n\n```bash\npip install scenefab\n```\n\n### 运行\n\n```bash\n# GUI 模式\nscenefab gui\n\n# 命令行模式\nscenefab commentary create-movie ./movie.mp4 --style 纪录片 --output ./output/\n```\n\n### 配置 AI（只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 不配置时：Edge-TTS 配音等基础功能仍可正常使用\n```\n\n---\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](https://agions.github.io/scene-fab/guide/quick-start) | 5 分钟上手 |\n| [功能详解](https://agions.github.io/scene-fab/features) | 全部功能说明 |\n| [AI 工作流](https://agions.github.io/scene-fab/guide/ai-video-guide) | 5 步流水线详解 |\n| [配置参考](https://agions.github.io/scene-fab/config) | 环境变量与配置文件 |\n| [疑难排查](https://agions.github.io/scene-fab/guide/troubleshooting) | 常见问题 |\n\n在线文档：**https://agions.github.io/scene-fab/**\n\n---\n\n## 竞品对比\n\n| 功能 | SceneFab | NarratoAI | AI解说大师 |\n|------|---------|-----------|-----------|\n| 语义拆条 | ✅ Qwen2.5-VL | ⚠️ 基础 | ⚠️ 基础 |\n| 影视解说 | ✅ 7种风格 | ✅ | ✅ |\n| 短剧解说 | ✅ | ❌ | ⚠️ |\n| 命令行原生 | ✅ | ❌ | ✅ |\n| Agent Skill 接入 | ✅ SKILL.md | ❌ | ✅ |\n| 剪映草稿导出 | ✅ | ❌ | ❌ |\n| 完全本地 | ✅ | ❌ | ❌ |\n| 开源 | ✅ MIT | ✅ | ❌ |\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 SceneFab 对你有帮助，请给一个 Star\n\n
\n"}, "92d68b48d479da32e98a9eeb91facbd0ff2eab50": {"t": 1785772754.3392045, "n": 3352, "h": "a6474656cecfdcfc", "c": "# Voxplore\n\n**AI First-Person Video Narrator — 多视频智能合并解说专家**\n\n[](LICENSE)\n[](https://www.python.org/)\n[](https://qt.io/)\n[](https://github.com/Agions/Voxplore)\n[](https://github.com/Agions/Voxplore/releases)\n\n---\n\n## 定位\n\n> **Voxplore** — 批量上传视频，AI 自动分组选段，一键生成电影感第一人称配音解说。\n>\n> 短剧 / 影视 / Vlog，一键变成\"我在现场\"的专业叙事视频。\n\n**成本**：< ¥0.01 / 视频（DeepSeek-V4） \n**隐私**：视频永不上传云端，全本地处理\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **多视频智能合并** | 批量上传，AI 视觉+声纹混合分组，避免同一人重复解说 |\n| 👤 **第一人称片段提取** | Qwen2.5-VL 逐帧分析，提取\"我\"的视角高光片段（9–60 秒） |\n| 💡 **情感峰值驱动选段** | 叙事完整优先 + 情感峰值加权排序 |\n| 🎙️ **7 种情感风格** | 治愈 / 悬疑 / 励志 / 怀旧 / 浪漫 / 幽默 / 纪录片 |\n| ✍️ **精准字幕** | TTS word-level，音字同步 50ms 精度 |\n| 📦 **模块化成品输出** | 合并版（完整叙事）+ 高光片段（单独分发）|\n| 🖥️ **剪映草稿导出** | 原生 JSON，无缝导入剪映继续精剪 |\n| 🌐 **全本地运行** | 视频永不上传云端 |\n\n---\n\n## 4 步创作流程\n\n```\n批量上传视频（文件夹 / Ctrl 多选）\n │\n ▼\n┌────────────────────────────────────────────┐\n│ Step 1 · 场景理解 │\n│ Qwen2.5-VL 逐帧分析，提取\"我\"的主体视角 │\n└────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────┐\n│ Step 2 · 智能分组 │\n│ 视觉 embedding（0.7）+ 声纹（0.3）混合相似度 │\n└────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────┐\n│ Step 3 · 叙事选段 │\n│ 叙事完整优先 + 情感峰值驱动 │\n│ 悬疑铺垫 → 剧情高潮 → 情感共鸣 │\n└────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────┐\n│ Step 4 · 解说生成 + 导出 │\n│ DeepSeek-V4 + Edge-TTS / F5-TTS │\n│ MP4（H.264/H.265）/ 剪映草稿 JSON │\n└────────────────────────────────────────────┘\n```\n\n---\n\n## 技术栈\n\n| 模块 | 模型 / 技术 | 说明 |\n|------|-----------|------|\n| 智能分组 | **Qwen2.5-VL** + 声纹 | 视觉 0.7 + 音频 0.3 混合相似度 |\n| 第一人称提取 | **Qwen2.5-VL** | 逐帧分析，主体视角判断 |\n| 解说生成 | **DeepSeek-V4** | 第一人称视角，7 种预设风格 |\n| 语音识别 | **SenseVoice** | 阿里 FunAudioLLM，本地 ASR |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 音色克隆 |\n| 字幕 | TTS word-level timing | 50ms 以内精度 |\n| UI 框架 | **PySide6** Qt 6.5+ | OKLCH Design System |\n\n---\n\n## 快速开始\n\n### 下载安装包\n\n访问 [Releases](https://github.com/Agions/Voxplore/releases/latest) 下载 Windows `.exe` / macOS `.dmg` / Linux `.AppImage`。\n\n### 从源码运行\n\n```bash\ngit clone https://github.com/Agions/Voxplore.git\ncd Voxplore\npip install -r requirements.txt\npython app/main.py\n```\n\n### 配置 AI（最低只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力，推荐）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 阿里云百炼（视频理解，备选）\nexport DASHSCOPE_API_KEY=\"...\"\n\n# 不配置时：Edge-TTS 配音合成等基础功能仍可正常使用\n```\n\n---\n\n## 文档\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](docs/guide/quick-start.md) | 5 分钟上手 |\n| [功能详解](docs/features.md) | 全部功能说明 |\n| [AI 模型配置](docs/ai-models.md) | 各模型配置指南 |\n| [配置参考](docs/config.md) | 环境变量与配置文件 |\n| [常见问题](docs/faq.md) | FAQ 与疑难排查 |\n\n---\n\n## 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 Voxplore 对你有帮助，请给一个 Star\n\n
\n"}, "bf5c145ff24696ac82f67ba44e32b7a4e059167a": {"t": 1785772756.1243134, "n": 4395, "h": "805b164c10d8b1d5", "c": "# Voxplore\n\n\n\n\n\n### AI First-Person Video Narrator\n\n**批量上传视频 · AI 自动分组选段 · 一键生成电影感配音解说**\n\n[](https://github.com/Agions/Voxplore/stargazers)\n[](LICENSE)\n[](https://www.python.org/)\n[](https://www.qt.io/)\n[](https://github.com/Agions/Voxplore)\n[](https://github.com/Agions/Voxplore/releases)\n\n**免费 · 开源 · 跨平台**\n\n
\n\n---\n\n## 🎯 一句话定位\n\n> **Voxplore** v1.0 — 多视频智能合并解说专家。批量上传 → AI 视觉+声纹混合分组 → 第一人称片段提取 → 模块化成品输出，让短剧/影视/vlog 一键变成\"我在现场\"的专业叙事视频。\n\n---\n\n## 4 步创作流程\n\n```\n批量上传视频（文件夹 / Ctrl多选）\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 1 · 场景理解 │\n│ AI 逐帧分析，判断\"我\"的主体视角，提取高光片段 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 2 · 智能分组 │\n│ 视觉 embedding（0.7）+ 声纹（0.3）混合相似度 │\n│ → 同一人物避免重复解说 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 3 · 叙事选段 │\n│ 叙事完整优先 + 情感峰值驱动 │\n│ 悬疑铺垫 → 剧情高潮 → 情感共鸣 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 4 · 解说生成 + 导出 │\n│ 7 种预设风格 + 角色设定 │\n│ MP4 / 剪映草稿 JSON 双格式输出 │\n└──────────────────────────────────────────────────────────┘\n```\n\n---\n\n## ✨ 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **多视频智能合并** | 批量上传，AI 自动分组选段，避免重复解说 |\n| 👤 **第一人称片段提取** | 逐帧分析，Qwen2.5-VL 判断\"我\"的视角 |\n| 💡 **情感峰值驱动** | 叙事完整优先 + 情感峰值加权排序 |\n| 🎙️ **7 种情感风格** | 治愈/悬疑/励志/怀旧/浪漫/幽默/纪录片 |\n| ✍️ **精准字幕** | TTS word-level，音字同步 50ms 精度 |\n| 📦 **模块化成品** | 合并版（完整叙事）+ 高光片段（单独分发）|\n| 🖥️ **剪映导出** | 原生草稿 JSON，无缝导入剪映精剪 |\n| 🌐 **全本地运行** | 视频永不上传云端 |\n\n---\n\n## 🖥️ 全新 UI（v1.0 新设计）\n\n简约科技风桌面端，基于 **PySide6 + OKLCH Design System**：\n\n```\n项目列表（ProjectsWindow）\n │ 新建 / 打开 / 删除\n ▼\n步骤 1 · 上传 → 拖拽批量上传文件\n步骤 2 · 场景理解 → AI 分析进度 + 场景卡片\n步骤 3 · 配音编辑 → 解说词编辑 + 情感风格 + TTS 进度\n步骤 4 · 导出 → 格式/质量选择 + 导出进度\n```\n\n> 全新 UI 默认**未启用**。编辑 `app/main.py`，取消注释 `launch_new_ui()` 即可体验。\n\n---\n\n## 🚀 快速开始\n\n### 下载安装包\n\n访问 [Releases](https://github.com/Agions/Voxplore/releases/latest) 下载 Windows `.exe` / macOS `.dmg` / Linux `.AppImage`。\n\n### 从源码构建\n\n```bash\ngit clone https://github.com/Agions/Voxplore.git\ncd Voxplore\npip install -r requirements.txt\npython app/main.py\n```\n\n### 配置 AI（最低只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力，推荐）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 通义千问（场景理解，备选）\nexport QWEN_API_KEY=\"...\"\n\n# 不配置时：Edge-TTS 配音合成等基础功能仍可正常使用\n```\n\n---\n\n## 🤖 技术栈（2026 最新模型）\n\n| 模块 | 模型 | 说明 |\n|------|------|------|\n| 智能分组 | **Qwen2.5-VL** + 声纹识别 | 视觉 0.7 + 音频 0.3 混合相似度 |\n| 第一人称提取 | **Qwen2.5-VL** | 逐帧分析，主体视角判断，9–60 秒片段 |\n| 解说生成 | **DeepSeek-V4** | 代入\"我\"视角，7 种预设风格 |\n| 语音识别 | **SenseVoice** | 阿里 FunAudioLLM，中文 ASR + 说话人分离 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕 | TTS word-level timing | 50ms 以内精度 |\n| 云端备选 | GPT-4o / Claude Sonnet | 按需切换 |\n\n---\n\n## 📖 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](docs/guide/quick-start.md) | 5 分钟上手 |\n| [功能详解](docs/features.md) | 全部功能说明 |\n| [AI 模型](docs/ai-models.md) | 各模型配置指南 |\n| [FAQ & 疑难排查](docs/faq.md) | 常见问题 |\n\n---\n\n## 🛠️ 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| UI 框架 | PySide6 (Qt 6.5+) · OKLCH Design System |\n| 编程语言 | Python 3.10+ |\n| 视频处理 | FFmpeg + OpenCV |\n| 本地 ASR | SenseVoice / Faster-Whisper |\n| 云端 AI | OpenAI SDK（多厂商兼容）|\n| 字幕格式 | SRT / ASS（电影级样式）|\n| 导出格式 | MP4（H.264/H.265）/ 剪映草稿 |\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 Voxplore 对你有帮助，请给一个 Star\n\n
"}, "5debe79eca1b1c318816722d0bc19d1ae9f93662": {"t": 1785772758.8407829, "n": 4395, "h": "9d0c92c7e45108c4", "c": "# Voxplore\n\n\n\n\n\n### AI First-Person Video Narrator\n\n**批量上传视频 · AI 自动分组选段 · 一键生成电影感配音解说**\n\n[](https://github.com/Agions/Voxplore/stargazers)\n[](LICENSE)\n[](https://www.python.org/)\n[](https://www.qt.io/)\n[](https://github.com/Agions/Voxplore)\n[](https://github.com/Agions/Voxplore/releases)\n\n**免费 · 开源 · 跨平台**\n\n
\n\n---\n\n## 🎯 一句话定位\n\n> **Voxplore** v1.0 — 多视频智能合并解说专家。批量上传 → AI 视觉+声纹混合分组 → 第一人称片段提取 → 模块化成品输出，让短剧/影视/vlog 一键变成\"我在现场\"的专业叙事视频。\n\n---\n\n## 4 步创作流程\n\n```\n批量上传视频（文件夹 / Ctrl多选）\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 1 · 场景理解 │\n│ AI 逐帧分析，判断\"我\"的主体视角，提取高光片段 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 2 · 智能分组 │\n│ 视觉 embedding（0.7）+ 声纹（0.3）混合相似度 │\n│ → 同一人物避免重复解说 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 3 · 叙事选段 │\n│ 叙事完整优先 + 情感峰值驱动 │\n│ 悬疑铺垫 → 剧情高潮 → 情感共鸣 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 4 · 解说生成 + 导出 │\n│ 7 种预设风格 + 角色设定 │\n│ MP4 / 剪映草稿 JSON 双格式输出 │\n└──────────────────────────────────────────────────────────┘\n```\n\n---\n\n## ✨ 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **多视频智能合并** | 批量上传，AI 自动分组选段，避免重复解说 |\n| 👤 **第一人称片段提取** | 逐帧分析，Qwen2.5-VL 判断\"我\"的视角 |\n| 💡 **情感峰值驱动** | 叙事完整优先 + 情感峰值加权排序 |\n| 🎙️ **7 种情感风格** | 治愈/悬疑/励志/怀旧/浪漫/幽默/纪录片 |\n| ✍️ **精准字幕** | TTS word-level，音字同步 50ms 精度 |\n| 📦 **模块化成品** | 合并版（完整叙事）+ 高光片段（单独分发）|\n| 🖥️ **剪映导出** | 原生草稿 JSON，无缝导入剪映精剪 |\n| 🌐 **全本地运行** | 视频永不上传云端 |\n\n---\n\n## 🖥️ 全新 UI（v1.0 新设计）\n\n简约科技风桌面端，基于 **PySide6 + OKLCH Design System**：\n\n```\n项目列表（ProjectsWindow）\n │ 新建 / 打开 / 删除\n ▼\n步骤 1 · 上传 → 拖拽批量上传文件\n步骤 2 · 场景理解 → AI 分析进度 + 场景卡片\n步骤 3 · 配音编辑 → 解说词编辑 + 情感风格 + TTS 进度\n步骤 4 · 导出 → 格式/质量选择 + 导出进度\n```\n\n> 全新 UI 默认**未启用**。编辑 `app/main.py`，取消注释 `launch_new_ui()` 即可体验。\n\n---\n\n## 🚀 快速开始\n\n### 下载安装包\n\n访问 [Releases](https://github.com/Agions/Voxplore/releases/latest) 下载 Windows `.exe` / macOS `.dmg` / Linux `.AppImage`。\n\n### 从源码构建\n\n```bash\ngit clone https://github.com/Agions/Voxplore.git\ncd Voxplore\npip install -r requirements.txt\npython app/main.py\n```\n\n### 配置 AI（最低只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力，推荐）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 通义千问（场景理解，备选）\nexport QWEN_API_KEY=\"...\"\n\n# 不配置时：Edge-TTS 配音合成等基础功能仍可正常使用\n```\n\n---\n\n## 🤖 技术栈（2026 最新模型）\n\n| 模块 | 模型 | 说明 |\n|------|------|------|\n| 智能分组 | **Qwen2.5-VL** + 声纹识别 | 视觉 0.7 + 音频 0.3 混合相似度 |\n| 第一人称提取 | **Qwen2.5-VL** | 逐帧分析，主体视角判断，9–60 秒片段 |\n| 解说生成 | **DeepSeek-V4** | 代入\"我\"视角，7 种预设风格 |\n| 语音识别 | **SenseVoice** | 阿里 FunAudioLLM，中文 ASR + 说话人分离 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕 | TTS word-level timing | 50ms 以内精度 |\n| 云端备选 | GPT-4o / Claude Sonnet | 按需切换 |\n\n---\n\n## 📖 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](docs/guide/quick-start.md) | 5 分钟上手 |\n| [功能详解](docs/features.md) | 全部功能说明 |\n| [AI 模型](docs/ai-models.md) | 各模型配置指南 |\n| [FAQ & 疑难排查](docs/faq.md) | 常见问题 |\n\n---\n\n## 🛠️ 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| UI 框架 | PySide6 (Qt 6.5+) · OKLCH Design System |\n| 编程语言 | Python 3.10+ |\n| 视频处理 | FFmpeg + OpenCV |\n| 本地 ASR | SenseVoice / Faster-Whisper |\n| 云端 AI | OpenAI SDK（多厂商兼容）|\n| 字幕格式 | SRT / ASS（电影级样式）|\n| 导出格式 | MP4（H.264/H.265）/ 剪映草稿 |\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 Voxplore 对你有帮助，请给一个 Star\n\n
"}, "97925cddfeed6870ae3449829ef4f657117441b3": {"t": 1785772760.295229, "n": 4402, "h": "da2399afde58a4c6", "c": "# Voxplore\n\n\n\n\n\n### AI First-Person Video Narrator\n\n**批量上传视频 · AI 自动分组选段 · 一键生成电影感配音解说**\n\n[](https://github.com/Agions/Voxplore/stargazers)\n[](LICENSE)\n[](https://www.python.org/)\n[](https://www.qt.io/)\n[](https://github.com/Agions/Voxplore)\n[](https://github.com/Agions/Voxplore/releases)\n\n**免费 · 开源 · 跨平台**\n\n
\n\n---\n\n## 🎯 一句话定位\n\n> **Voxplore** v1.0 — 多视频智能合并解说专家。批量上传 → AI 视觉+声纹混合分组 → 第一人称片段提取 → 模块化成品输出，让短剧/影视/vlog 一键变成\"我在现场\"的专业叙事视频。\n\n---\n\n## 4 步创作流程\n\n```\n批量上传视频（文件夹 / Ctrl多选）\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 1 · 场景理解 │\n│ AI 逐帧分析，判断\"我\"的主体视角，提取高光片段 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 2 · 智能分组 │\n│ 视觉 embedding（0.7）+ 声纹（0.3）混合相似度 │\n│ → 同一人物避免重复解说 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 3 · 叙事选段 │\n│ 叙事完整优先 + 情感峰值驱动 │\n│ 悬疑铺垫 → 剧情高潮 → 情感共鸣 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 4 · 解说生成 + 导出 │\n│ 7 种预设风格 + 角色设定 │\n│ MP4 / 剪映草稿 JSON 双格式输出 │\n└──────────────────────────────────────────────────────────┘\n```\n\n---\n\n## ✨ 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **多视频智能合并** | 批量上传，AI 自动分组选段，避免重复解说 |\n| 👤 **第一人称片段提取** | 逐帧分析，Qwen2.5-VL 判断\"我\"的视角 |\n| 💡 **情感峰值驱动** | 叙事完整优先 + 情感峰值加权排序 |\n| 🎙️ **7 种情感风格** | 治愈/悬疑/励志/怀旧/浪漫/幽默/纪录片 |\n| ✍️ **精准字幕** | TTS word-level，音字同步 50ms 精度 |\n| 📦 **模块化成品** | 合并版（完整叙事）+ 高光片段（单独分发）|\n| 🖥️ **剪映导出** | 原生草稿 JSON，无缝导入剪映精剪 |\n| 🌐 **全本地运行** | 视频永不上传云端 |\n\n---\n\n## 🖥️ 全新 UI（v1.0 新设计）\n\n简约科技风桌面端，基于 **PySide6 + OKLCH Design System**：\n\n```\n项目列表（ProjectsWindow）\n │ 新建 / 打开 / 删除\n ▼\n步骤 1 · 上传 → 拖拽批量上传文件\n步骤 2 · 场景理解 → AI 分析进度 + 场景卡片\n步骤 3 · 配音编辑 → 解说词编辑 + 情感风格 + TTS 进度\n步骤 4 · 导出 → 格式/质量选择 + 导出进度\n```\n\n> 全新 UI 默认**未启用**。编辑 `app/main.py`，取消注释 `launch_new_ui()` 即可体验。\n\n---\n\n## 🚀 快速开始\n\n### 下载安装包\n\n访问 [Releases](https://github.com/Agions/Voxplore/releases/latest) 下载 Windows `.exe` / macOS `.dmg` / Linux `.AppImage`。\n\n### 从源码构建\n\n```bash\ngit clone https://github.com/Agions/Voxplore.git\ncd Voxplore\npip install -r requirements.txt\npython app/main.py\n```\n\n### 配置 AI（最低只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力，推荐）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 通义千问（场景理解，备选）\nexport QWEN_API_KEY=\"...\"\n\n# 不配置时：Edge-TTS 配音合成等基础功能仍可正常使用\n```\n\n---\n\n## 🤖 技术栈（2026 最新模型）\n\n| 模块 | 模型 | 说明 |\n|------|------|------|\n| 智能分组 | **Qwen2.5-VL** + 声纹识别 | 视觉 0.7 + 音频 0.3 混合相似度 |\n| 第一人称提取 | **Qwen2.5-VL** | 逐帧分析，主体视角判断，9–60 秒片段 |\n| 解说生成 | **DeepSeek-V4** | 代入\"我\"视角，7 种预设风格 |\n| 语音识别 | **SenseVoice** | 阿里 FunAudioLLM，中文 ASR + 说话人分离 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕 | TTS word-level timing | 50ms 以内精度 |\n| 云端备选 | GPT-4o / Claude Sonnet | 按需切换 |\n\n---\n\n## 📖 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](docs/guide/quick-start.md) | 5 分钟上手 |\n| [功能详解](docs/features.md) | 全部功能说明 |\n| [AI 模型](docs/ai-models.md) | 各模型配置指南 |\n| [FAQ & 疑难排查](docs/faq.md) | 常见问题 |\n\n---\n\n## 🛠️ 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| UI 框架 | PySide6 (Qt 6.5+) · OKLCH Design System |\n| 编程语言 | Python 3.10+ |\n| 视频处理 | FFmpeg + OpenCV |\n| 本地 ASR | SenseVoice / Faster-Whisper |\n| 云端 AI | OpenAI SDK（多厂商兼容）|\n| 字幕格式 | SRT / ASS（电影级样式）|\n| 导出格式 | MP4（H.264/H.265）/ 剪映草稿 |\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 Voxplore 对你有帮助，请给一个 Star\n\n
"}, "1c87f4817371b737b56e66f1c9aed588e748fac4": {"t": 1785772761.485167, "n": 4458, "h": "b7726ed54bc79b7d", "c": "# Voxplore\n\n\n\n\n\n### AI First-Person Video Narrator\n\n**批量上传视频 · AI 自动分组选段 · 一键生成电影感配音解说**\n\n[](https://github.com/Agions/Voxplore/stargazers)\n[](LICENSE)\n[](https://www.python.org/)\n[](https://www.qt.io/)\n[](https://github.com/Agions/Voxplore)\n[](https://github.com/Agions/Voxplore/releases)\n\n**免费 · 开源 · 跨平台**\n\n
\n\n---\n\n## 🎯 一句话定位\n\n> **Voxplore** v1.0 — 多视频智能合并解说专家。批量上传 → AI 视觉+声纹混合分组 → 第一人称片段提取 → 模块化成品输出，让短剧/影视/vlog 一键变成\"我在现场\"的专业叙事视频。\n\n---\n\n## 4 步创作流程\n\n```\n批量上传视频（文件夹 / Ctrl多选）\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 1 · 场景理解 │\n│ AI 逐帧分析，判断\"我\"的主体视角，提取高光片段 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 2 · 智能分组 │\n│ 视觉 embedding（0.7）+ 声纹（0.3）混合相似度 │\n│ → 同一人物避免重复解说 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 3 · 叙事选段 │\n│ 叙事完整优先 + 情感峰值驱动 │\n│ 悬疑铺垫 → 剧情高潮 → 情感共鸣 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 4 · 解说生成 + 导出 │\n│ 7 种预设风格 + 角色设定 │\n│ MP4 / 剪映草稿 JSON 双格式输出 │\n└──────────────────────────────────────────────────────────┘\n```\n\n---\n\n## ✨ 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **多视频智能合并** | 批量上传，AI 自动分组选段，避免重复解说 |\n| 👤 **第一人称片段提取** | 逐帧分析，Qwen2.5-VL 判断\"我\"的视角 |\n| 💡 **情感峰值驱动** | 叙事完整优先 + 情感峰值加权排序 |\n| 🎙️ **7 种情感风格** | 治愈/悬疑/励志/怀旧/浪漫/幽默/纪录片 |\n| ✍️ **精准字幕** | TTS word-level，音字同步 50ms 精度 |\n| 📦 **模块化成品** | 合并版（完整叙事）+ 高光片段（单独分发）|\n| 🖥️ **剪映导出** | 原生草稿 JSON，无缝导入剪映精剪 |\n| 🌐 **全本地运行** | 视频永不上传云端 |\n\n---\n\n## 🖥️ 全新 UI（v1.0 新设计）\n\n简约科技风桌面端，基于 **PySide6 + OKLCH Design System**：\n\n```\n项目列表（ProjectsWindow）\n │ 新建 / 打开 / 删除\n ▼\n步骤 1 · 上传 → 拖拽批量上传文件\n步骤 2 · 场景理解 → AI 分析进度 + 场景卡片\n步骤 3 · 配音编辑 → 解说词编辑 + 情感风格 + TTS 进度\n步骤 4 · 导出 → 格式/质量选择 + 导出进度\n```\n\n> 全新 UI 默认**未启用**。编辑 `app/main.py`，取消注释 `launch_new_ui()` 即可体验。\n\n---\n\n## 🚀 快速开始\n\n### 下载安装包\n\n访问 [Releases](https://github.com/Agions/Voxplore/releases/latest) 下载 Windows `.exe` / macOS `.dmg` / Linux `.AppImage`。\n\n### 从源码构建\n\n```bash\ngit clone https://github.com/Agions/Voxplore.git\ncd Voxplore\npip install -r requirements.txt\npython app/main.py\n```\n\n### 配置 AI（最低只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力，推荐）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 通义千问（场景理解，备选）\nexport QWEN_API_KEY=\"...\"\n\n# 不配置时：Edge-TTS 配音合成等基础功能仍可正常使用\n```\n\n---\n\n## 🤖 技术栈（2026 最新模型）\n\n| 模块 | 模型 | 说明 |\n|------|------|------|\n| 智能分组 | **Qwen2.5-VL** + 声纹识别 | 视觉 0.7 + 音频 0.3 混合相似度 |\n| 第一人称提取 | **Qwen2.5-VL** | 逐帧分析，主体视角判断，9–60 秒片段 |\n| 解说生成 | **DeepSeek-V4** | 代入\"我\"视角，7 种预设风格 |\n| 语音识别 | **SenseVoice** | 阿里 FunAudioLLM，中文 ASR + 说话人分离 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕 | TTS word-level timing | 50ms 以内精度 |\n| 云端备选 | GPT-4o / Claude Sonnet | 按需切换 |\n\n---\n\n## 📖 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](docs/guide/quick-start.md) | 5 分钟上手 |\n| [功能详解](docs/features.md) | 全部功能说明 |\n| [AI 模型](docs/ai-models.md) | 各模型配置指南 |\n| [FAQ & 疑难排查](docs/faq.md) | 常见问题 |\n\n---\n\n## 🛠️ 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| UI 框架 | PySide6 (Qt 6.5+) · OKLCH Design System |\n| 编程语言 | Python 3.10+ |\n| 视频处理 | FFmpeg + OpenCV |\n| 本地 ASR | SenseVoice / Faster-Whisper |\n| 云端 AI | OpenAI SDK（多厂商兼容）|\n| 字幕格式 | SRT / ASS（电影级样式）|\n| 导出格式 | MP4（H.264/H.265）/ 剪映草稿 |\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 Voxplore 对你有帮助，请给一个 Star\n\n
"}, "7ccf7131e9180ee82ba47b2160f525af0b29dcc3": {"t": 1785772762.6918833, "n": 4458, "h": "b00b51fa24514520", "c": "# Voxplore\n\n\n\n\n\n### AI First-Person Video Narrator\n\n**批量上传视频 · AI 自动分组选段 · 一键生成电影感配音解说**\n\n[](https://github.com/Agions/Voxplore/stargazers)\n[](LICENSE)\n[](https://www.python.org/)\n[](https://www.qt.io/)\n[](https://github.com/Agions/Voxplore)\n[](https://github.com/Agions/Voxplore/releases)\n\n**免费 · 开源 · 跨平台**\n\n
\n\n---\n\n## 🎯 一句话定位\n\n> **Voxplore** v4.0 — 多视频智能合并解说专家。批量上传 → AI 视觉+声纹混合分组 → 第一人称片段提取 → 模块化成品输出，让短剧/影视/vlog 一键变成\"我在现场\"的专业叙事视频。\n\n---\n\n## 4 步创作流程\n\n```\n批量上传视频（文件夹 / Ctrl多选）\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 1 · 场景理解 │\n│ AI 逐帧分析，判断\"我\"的主体视角，提取高光片段 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 2 · 智能分组 │\n│ 视觉 embedding（0.7）+ 声纹（0.3）混合相似度 │\n│ → 同一人物避免重复解说 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 3 · 叙事选段 │\n│ 叙事完整优先 + 情感峰值驱动 │\n│ 悬疑铺垫 → 剧情高潮 → 情感共鸣 │\n└──────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────┐\n│ Step 4 · 解说生成 + 导出 │\n│ 7 种预设风格 + 角色设定 │\n│ MP4 / 剪映草稿 JSON 双格式输出 │\n└──────────────────────────────────────────────────────────┘\n```\n\n---\n\n## ✨ 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 🎬 **多视频智能合并** | 批量上传，AI 自动分组选段，避免重复解说 |\n| 👤 **第一人称片段提取** | 逐帧分析，Qwen2.5-VL 判断\"我\"的视角 |\n| 💡 **情感峰值驱动** | 叙事完整优先 + 情感峰值加权排序 |\n| 🎙️ **7 种情感风格** | 治愈/悬疑/励志/怀旧/浪漫/幽默/纪录片 |\n| ✍️ **精准字幕** | TTS word-level，音字同步 50ms 精度 |\n| 📦 **模块化成品** | 合并版（完整叙事）+ 高光片段（单独分发）|\n| 🖥️ **剪映导出** | 原生草稿 JSON，无缝导入剪映精剪 |\n| 🌐 **全本地运行** | 视频永不上传云端 |\n\n---\n\n## 🖥️ 全新 UI（v4.0 新设计）\n\n简约科技风桌面端，基于 **PySide6 + OKLCH Design System**：\n\n```\n项目列表（ProjectsWindow）\n │ 新建 / 打开 / 删除\n ▼\n步骤 1 · 上传 → 拖拽批量上传文件\n步骤 2 · 场景理解 → AI 分析进度 + 场景卡片\n步骤 3 · 配音编辑 → 解说词编辑 + 情感风格 + TTS 进度\n步骤 4 · 导出 → 格式/质量选择 + 导出进度\n```\n\n> 全新 UI 默认**未启用**。编辑 `app/main.py`，取消注释 `launch_new_ui()` 即可体验。\n\n---\n\n## 🚀 快速开始\n\n### 下载安装包\n\n访问 [Releases](https://github.com/Agions/Voxplore/releases/latest) 下载 Windows `.exe` / macOS `.dmg` / Linux `.AppImage`。\n\n### 从源码构建\n\n```bash\ngit clone https://github.com/Agions/Voxplore.git\ncd Voxplore\npip install -r requirements.txt\npython app/main.py\n```\n\n### 配置 AI（最低只需一个 Key）\n\n```bash\n# DeepSeek（解说生成主力，推荐）\nexport DEEPSEEK_API_KEY=\"sk-...\"\n\n# 通义千问（场景理解，备选）\nexport QWEN_API_KEY=\"...\"\n\n# 不配置时：Edge-TTS 配音合成等基础功能仍可正常使用\n```\n\n---\n\n## 🤖 技术栈（2026 最新模型）\n\n| 模块 | 模型 | 说明 |\n|------|------|------|\n| 智能分组 | **Qwen2.5-VL** + 声纹识别 | 视觉 0.7 + 音频 0.3 混合相似度 |\n| 第一人称提取 | **Qwen2.5-VL** | 逐帧分析，主体视角判断，9–60 秒片段 |\n| 解说生成 | **DeepSeek-V4** | 代入\"我\"视角，7 种预设风格 |\n| 语音识别 | **SenseVoice** | 阿里 FunAudioLLM，中文 ASR + 说话人分离 |\n| 配音合成 | **Edge-TTS** · **F5-TTS** | Edge 主流低延迟，F5 零样本音色克隆 |\n| 字幕 | TTS word-level timing | 50ms 以内精度 |\n| 云端备选 | GPT-4o / Claude Sonnet | 按需切换 |\n\n---\n\n## 📖 文档导航\n\n| 文档 | 说明 |\n|------|------|\n| [快速开始](docs/guide/quick-start.md) | 5 分钟上手 |\n| [功能详解](docs/features.md) | 全部功能说明 |\n| [AI 模型](docs/ai-models.md) | 各模型配置指南 |\n| [FAQ & 疑难排查](docs/faq.md) | 常见问题 |\n\n---\n\n## 🛠️ 技术栈\n\n| 类别 | 技术 |\n|------|------|\n| UI 框架 | PySide6 (Qt 6.5+) · OKLCH Design System |\n| 编程语言 | Python 3.10+ |\n| 视频处理 | FFmpeg + OpenCV |\n| 本地 ASR | SenseVoice / Faster-Whisper |\n| 云端 AI | OpenAI SDK（多厂商兼容）|\n| 字幕格式 | SRT / ASS（电影级样式）|\n| 导出格式 | MP4（H.264/H.265）/ 剪映草稿 |\n\n---\n\n## 📄 许可证\n\n[MIT License](LICENSE) · Copyright © 2025-2026 [Agions](https://github.com/Agions)\n\n---\n\n\n\n⭐ 如果 Voxplore 对你有帮助，请给一个 Star\n\n
"}}, "config/llm.yaml": {"2dd89ad8cf59f03c551c82e3c4e9b5e205b6c0b9": {"t": 1785809848.1116924, "n": 4960, "h": "9e5e982df5a8d014", "c": "# SceneFab AI LLM 配置\n#\n# 各家最新可用旗舰大模型：\n# - OpenAI: gpt-5.6 (旗舰 Sol，另有 terra/luna 档, openai.com/index/gpt-5-6)\n# - Anthropic: claude-fable-5 (Mythos-class, 2026-06-09, 1M context)\n# - Google: gemini-3.6-flash / gemini-3.5-flash (2026-07-21 最新 stable)\n# - DeepSeek: deepseek-v4-pro / -flash (官方 api-docs.deepseek.com)\n# - Qwen: qwen3.7-max (阿里云百炼 2026 最新旗舰)\n# - Kimi: kimi-k3 (月之暗面 2026-07-16 发布, 1M context)\n# - 智谱: glm-5.2 (2026 最新旗舰, 1M 无损上下文)\n# - 豆包: doubao-seed-2-1-pro (火山方舟 2026-06-23 发布)\n# - 混元: hy3 (腾讯 Hy3, 295B MoE, 256K context)\n#\n# 切换 provider：把 default_provider 改为你想启用的那家，\n# 并在对应 block 里把 enabled: true。\n\nLLM:\n # 默认提供商 (qwen | kimi | glm5 | openai | deepseek | claude | gemini | local | doubao | hunyuan)\n default_provider: \"kimi\"\n\n # ─── 通义千问 Qwen3.7-Max（阿里云百炼 / DashScope）─────────────────\n # 2026 最新旗舰基座，对位 GPT-5.5 / Claude Opus 4.7，专为 Agent 优化。\n # 备选：qwen3.7-plus（次旗舰）、qwen3-max-2025-09-23（上一代快照）。\n # Token Plan 订阅用户可解锁 qwen3.8-max-preview（更更新但仍在 preview）。\n qwen:\n enabled: false\n api_key: ${QWEN_API_KEY}\n base_url: \"https://dashscope.aliyuncs.com/compatible-mode/v1\"\n model: \"qwen3.7-max\"\n max_tokens: 32768\n temperature: 0.7\n top_p: 0.9\n\n # ─── DeepSeek V4（深度求索，官方 api-docs.deepseek.com）───────────────\n # V4 系列：V4-Pro（旗舰，思考/非思考双模式）+ V4-Flash（轻量快速）。\n deepseek:\n enabled: false\n api_key: ${DEEPSEEK_API_KEY}\n base_url: \"https://api.deepseek.com\"\n model: \"deepseek-v4-pro\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── Kimi K3（Moonshot 月之暗面，2026-07 最新）──────────────────────\n # K3：2.8 万亿参数、1M token 上下文、原生多模态、Tool Calling 增强。\n # 备选：kimi-k2.6（通用上一代）、kimi-k2.7-code（Coding 专用）。\n # 旧 moonshot-v1 / kimi-k2.5 已于 8 月 31 日下线。\n kimi:\n enabled: true\n api_key: ${KIMI_API_KEY}\n base_url: \"https://api.moonshot.cn/v1\"\n model: \"kimi-k3\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── 智谱 GLM-5（BigModel，2026-02-11 旗舰）─────────────────────────\n # GLM-5.2：1M 无损上下文，支撑复杂长程任务；Coding 能力开源 SOTA，\n # 从代码生成走向工程交付（docs.bigmodel.cn 确认 model=\"glm-5.2\"）。\n # 备选：glm-5.1（长程任务可自主工作 8h）、glm-5、glm-5-turbo（轻量）。\n glm5:\n enabled: false\n api_key: ${GLM5_API_KEY}\n base_url: \"https://open.bigmodel.cn/api/paas/v4/\"\n model: \"glm-5.2\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── OpenAI GPT-5.6 ─────────────────────────────────────────────────\n # OpenAI 2026 最新旗舰家族（openai.com/index/gpt-5-6），三档：\n # gpt-5.6-sol（旗舰 $5/$30）、gpt-5.6-terra（均衡 $2.5/$15）、\n # gpt-5.6-luna（快速 $1/$6）。别名 gpt-5.6 路由到 sol。\n # 备选：gpt-5.5 / gpt-5.5-pro（上一代，2026-04）。\n openai:\n enabled: false\n api_key: ${OPENAI_API_KEY}\n base_url: \"https://api.openai.com/v1\"\n model: \"gpt-5.6\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── Anthropic Claude（Anthropic 官方）─────────────────────────────\n # Claude Fable 5（2026-06-09, anthropic.com/news/claude-fable-5-mythos-5），\n # 首个 Mythos-class 广泛可用模型，1M context，$10/M in $50/M out。\n # claude-mythos-5 仅限少量用户。备选：claude-opus-5 / claude-sonnet-5、\n # claude-opus-4-8（上一代）。\n claude:\n enabled: false\n api_key: ${CLAUDE_API_KEY}\n base_url: \"https://api.anthropic.com\"\n model: \"claude-fable-5\"\n max_tokens: 16384\n temperature: 0.7\n\n # ─── Google Gemini 3.6 Flash（Google AI Studio）────────────────────\n # gemini-3.6-flash 是 2026-07-21 最新 stable \"workhorse\" 档（ai.google.dev\n # 模型列表确认），在 coding / agentic / 多模态任务上优于上一代。\n # gemini-3.5-flash 是 stable 中\"最强智能\"档；3.5-flash-lite 最快最省。\n # gemini-3.1-pro-preview 仅为 preview（Pro 暂无 stable GA）。\n # 备选：gemini-flash-latest（永远指向最新 Flash 版的 alias）。\n gemini:\n enabled: false\n api_key: ${GEMINI_API_KEY}\n base_url: \"https://generativelanguage.googleapis.com\"\n model: \"gemini-3.6-flash\"\n max_tokens: 8000\n temperature: 0.7\n\n # ─── 本地模型（Ollama / LM Studio）─────────────────────────────────\n # 推荐 qwen3:32b / deepseek-v4:64b（本地量级）。\n local:\n enabled: false\n api_key: \"\"\n base_url: \"http://localhost:11434\"\n backend: \"ollama\"\n model: \"qwen3:32b\"\n\n # ─── 字节豆包 Doubao（火山方舟 Ark）────────────────────────────────\n # Doubao-Seed-2.1（2026-06-23 FORCE 大会发布）：Coding 进入国际第一\n # 梯队，Agent 可自主运行 18h。API 已全量上线方舟：doubao-seed-2-1-pro /\n # doubao-seed-2-1-turbo。备选：doubao-seed-2-0-pro、doubao-1-5-pro-256k。\n # 视频/图片：Seedance 2.5（视频）、Seedream 5.0 pro（图片）。\n doubao:\n enabled: false\n api_key: ${DOUBAO_API_KEY}\n base_url: \"https://ark.cn-beijing.volces.com/api/v3\"\n model: \"doubao-seed-2-1-pro\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── 腾讯混元 Hunyuan-TurboS（腾讯云）───────────────────────────────\n # Hy3：295B MoE（激活 21B），256K 上下文，强化 Coding/长文/推理/Agent，\n # 盲测优于 GLM-5.1（hy.tencent.com/research/hy3）。model 参数为 \"hy3\"，\n # 走 OpenAI 兼容接口。备选：hunyuan-turbos（上一代旗舰）、\n # hunyuan-standard-256k。\n hunyuan:\n enabled: false\n api_key: ${HUNYUAN_API_KEY}\n base_url: \"https://api.hunyuan.cloud.tencent.com/v1\"\n model: \"hy3\"\n max_tokens: 8000\n temperature: 0.7\n"}, "d367ad1441ef32ac1435291cbacbaa67668ed5e8": {"t": 1785809890.647197, "n": 4960, "h": "9e5e982df5a8d014", "c": "# SceneFab AI LLM 配置\n#\n# 各家最新可用旗舰大模型：\n# - OpenAI: gpt-5.6 (旗舰 Sol，另有 terra/luna 档, openai.com/index/gpt-5-6)\n# - Anthropic: claude-fable-5 (Mythos-class, 2026-06-09, 1M context)\n# - Google: gemini-3.6-flash / gemini-3.5-flash (2026-07-21 最新 stable)\n# - DeepSeek: deepseek-v4-pro / -flash (官方 api-docs.deepseek.com)\n# - Qwen: qwen3.7-max (阿里云百炼 2026 最新旗舰)\n# - Kimi: kimi-k3 (月之暗面 2026-07-16 发布, 1M context)\n# - 智谱: glm-5.2 (2026 最新旗舰, 1M 无损上下文)\n# - 豆包: doubao-seed-2-1-pro (火山方舟 2026-06-23 发布)\n# - 混元: hy3 (腾讯 Hy3, 295B MoE, 256K context)\n#\n# 切换 provider：把 default_provider 改为你想启用的那家，\n# 并在对应 block 里把 enabled: true。\n\nLLM:\n # 默认提供商 (qwen | kimi | glm5 | openai | deepseek | claude | gemini | local | doubao | hunyuan)\n default_provider: \"kimi\"\n\n # ─── 通义千问 Qwen3.7-Max（阿里云百炼 / DashScope）─────────────────\n # 2026 最新旗舰基座，对位 GPT-5.5 / Claude Opus 4.7，专为 Agent 优化。\n # 备选：qwen3.7-plus（次旗舰）、qwen3-max-2025-09-23（上一代快照）。\n # Token Plan 订阅用户可解锁 qwen3.8-max-preview（更更新但仍在 preview）。\n qwen:\n enabled: false\n api_key: ${QWEN_API_KEY}\n base_url: \"https://dashscope.aliyuncs.com/compatible-mode/v1\"\n model: \"qwen3.7-max\"\n max_tokens: 32768\n temperature: 0.7\n top_p: 0.9\n\n # ─── DeepSeek V4（深度求索，官方 api-docs.deepseek.com）───────────────\n # V4 系列：V4-Pro（旗舰，思考/非思考双模式）+ V4-Flash（轻量快速）。\n deepseek:\n enabled: false\n api_key: ${DEEPSEEK_API_KEY}\n base_url: \"https://api.deepseek.com\"\n model: \"deepseek-v4-pro\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── Kimi K3（Moonshot 月之暗面，2026-07 最新）──────────────────────\n # K3：2.8 万亿参数、1M token 上下文、原生多模态、Tool Calling 增强。\n # 备选：kimi-k2.6（通用上一代）、kimi-k2.7-code（Coding 专用）。\n # 旧 moonshot-v1 / kimi-k2.5 已于 8 月 31 日下线。\n kimi:\n enabled: true\n api_key: ${KIMI_API_KEY}\n base_url: \"https://api.moonshot.cn/v1\"\n model: \"kimi-k3\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── 智谱 GLM-5（BigModel，2026-02-11 旗舰）─────────────────────────\n # GLM-5.2：1M 无损上下文，支撑复杂长程任务；Coding 能力开源 SOTA，\n # 从代码生成走向工程交付（docs.bigmodel.cn 确认 model=\"glm-5.2\"）。\n # 备选：glm-5.1（长程任务可自主工作 8h）、glm-5、glm-5-turbo（轻量）。\n glm5:\n enabled: false\n api_key: ${GLM5_API_KEY}\n base_url: \"https://open.bigmodel.cn/api/paas/v4/\"\n model: \"glm-5.2\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── OpenAI GPT-5.6 ─────────────────────────────────────────────────\n # OpenAI 2026 最新旗舰家族（openai.com/index/gpt-5-6），三档：\n # gpt-5.6-sol（旗舰 $5/$30）、gpt-5.6-terra（均衡 $2.5/$15）、\n # gpt-5.6-luna（快速 $1/$6）。别名 gpt-5.6 路由到 sol。\n # 备选：gpt-5.5 / gpt-5.5-pro（上一代，2026-04）。\n openai:\n enabled: false\n api_key: ${OPENAI_API_KEY}\n base_url: \"https://api.openai.com/v1\"\n model: \"gpt-5.6\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── Anthropic Claude（Anthropic 官方）─────────────────────────────\n # Claude Fable 5（2026-06-09, anthropic.com/news/claude-fable-5-mythos-5），\n # 首个 Mythos-class 广泛可用模型，1M context，$10/M in $50/M out。\n # claude-mythos-5 仅限少量用户。备选：claude-opus-5 / claude-sonnet-5、\n # claude-opus-4-8（上一代）。\n claude:\n enabled: false\n api_key: ${CLAUDE_API_KEY}\n base_url: \"https://api.anthropic.com\"\n model: \"claude-fable-5\"\n max_tokens: 16384\n temperature: 0.7\n\n # ─── Google Gemini 3.6 Flash（Google AI Studio）────────────────────\n # gemini-3.6-flash 是 2026-07-21 最新 stable \"workhorse\" 档（ai.google.dev\n # 模型列表确认），在 coding / agentic / 多模态任务上优于上一代。\n # gemini-3.5-flash 是 stable 中\"最强智能\"档；3.5-flash-lite 最快最省。\n # gemini-3.1-pro-preview 仅为 preview（Pro 暂无 stable GA）。\n # 备选：gemini-flash-latest（永远指向最新 Flash 版的 alias）。\n gemini:\n enabled: false\n api_key: ${GEMINI_API_KEY}\n base_url: \"https://generativelanguage.googleapis.com\"\n model: \"gemini-3.6-flash\"\n max_tokens: 8000\n temperature: 0.7\n\n # ─── 本地模型（Ollama / LM Studio）─────────────────────────────────\n # 推荐 qwen3:32b / deepseek-v4:64b（本地量级）。\n local:\n enabled: false\n api_key: \"\"\n base_url: \"http://localhost:11434\"\n backend: \"ollama\"\n model: \"qwen3:32b\"\n\n # ─── 字节豆包 Doubao（火山方舟 Ark）────────────────────────────────\n # Doubao-Seed-2.1（2026-06-23 FORCE 大会发布）：Coding 进入国际第一\n # 梯队，Agent 可自主运行 18h。API 已全量上线方舟：doubao-seed-2-1-pro /\n # doubao-seed-2-1-turbo。备选：doubao-seed-2-0-pro、doubao-1-5-pro-256k。\n # 视频/图片：Seedance 2.5（视频）、Seedream 5.0 pro（图片）。\n doubao:\n enabled: false\n api_key: ${DOUBAO_API_KEY}\n base_url: \"https://ark.cn-beijing.volces.com/api/v3\"\n model: \"doubao-seed-2-1-pro\"\n max_tokens: 32768\n temperature: 0.7\n\n # ─── 腾讯混元 Hunyuan-TurboS（腾讯云）───────────────────────────────\n # Hy3：295B MoE（激活 21B），256K 上下文，强化 Coding/长文/推理/Agent，\n # 盲测优于 GLM-5.1（hy.tencent.com/research/hy3）。model 参数为 \"hy3\"，\n # 走 OpenAI 兼容接口。备选：hunyuan-turbos（上一代旗舰）、\n # hunyuan-standard-256k。\n hunyuan:\n enabled: false\n api_key: ${HUNYUAN_API_KEY}\n base_url: \"https://api.hunyuan.cloud.tencent.com/v1\"\n model: \"hy3\"\n max_tokens: 8000\n temperature: 0.7\n"}}}}