Topics

#ai-video-editing #automation #content-creation #desktop-application #ffmpeg #react #rust #short-video #social-media-tools #subtitle-generator #tauri #typescript #video-editing #whisper

Language breakdown

TypeScript 73.0%

Rust 12.8%

Less 12.4%

CSS 0.8%

JavaScript 0.5%

Shell 0.3%

▸ Files click to expand

README

StoryFab

🎬 开源 AI 影视解说创作工坊 · 本地优先 · 隐私安全 · 全链路自动化

📖 在线文档 · 🔄 更新日志

📋 项目概览

| 指标 | 数值 | |------|------| | 前端组件 | 41+ 组件目录 | | Tauri 命令 | 61 个 IPC 命令 | | 业务服务 | 13 个模块 | | Rust 代码 | 27,000+ 行 | | 测试覆盖 | 98%+ | | 构建产物 | 1.3MB | | 支持平台 | Windows / macOS / Linux |

✨ 为什么选择 StoryFab？

StoryFab 是一款革命性的桌面视频创作工具，将 AI 智能分析、自动化解说生成 和 本地化处理 完美结合。无论是直播回放、电影解说还是短视频创作，StoryFab 都能帮助您高效完成。

🎯 核心优势

| 特性 | 传统方案 | StoryFab | |------|----------|----------| | 隐私保护 | 视频上传云端 | ✅ 100% 本地处理 | | AI 解说 | 手动编写脚本 | ✅ 5步Agent Pipeline自动生成 | | 字幕生成 | 在线转写服务 | ✅ 本地Whisper离线转写 | | 配音合成 | 付费配音员 | ✅ Edge TTS + Azure TTS多种音色 | | 工作流 | 多软件切换 | ✅ 一站式完成全链路 | | 成本 | 订阅制收费 | ✅ 完全开源免费 |

🚀 快速开始

📦 下载安装

支持 Windows、macOS、Linux 三大平台，选择对应架构下载即可：

| 平台 | 架构 | 下载链接 | |------|------|----------| | Windows | x64 | 下载安装包 | | macOS | Apple Silicon | 下载DMG | | macOS | Intel | 下载DMG | | Linux | x64 | 下载AppImage |

💡 首次启动会自动下载 FFmpeg 和 Whisper 二进制，请确保网络连接正常。

🔨 从源码构建

适合开发者自定义功能或参与贡献：

# 1️⃣ 克隆仓库
git clone https://github.com/Agions/story-fab.git
cd story-fab
2️⃣ 安装依赖
npm install
3️⃣ 启动开发模式（热重载）
npm run tauri -- dev
4️⃣ 生产构建
npm run tauri -- build

前置要求：

Node.js ≥ 18
npm / pnpm
Rust ≥ 1.77 (安装指南)
FFmpeg

🎬 工作模式

StoryFab 提供两种专业工作流，满足不同创作场景：

📝 剪辑模式

适用场景：直播回放、会议记录、游戏集锦、教学视频

核心能力：

🤖 AI 自动识别高光时刻
✂️ 智能切片和剪辑
📐 多比例导出（9:16 / 1:1 / 16:9 / 4:5 / 21:9）
🎞️ 硬字幕烧录 + 软字幕双轨

典型工作流：

导入视频 → AI高光检测 → 手动微调 → 选择比例 → 导出成片

🎭 解说模式

适用场景：短剧解说、电影影评、综艺节目、游戏剧情

核心能力：

🧠 Director Agent - 多轮对话式节奏策划
📝 Visual Agent - 智能分镜设计
✍️ Narration Agent - 自动生成解说文案
⏱️ Timing Agent - 精准控制节奏和停顿
🎤 TTS 配音 - Edge TTS / Azure TTS 合成
🎬 一键生成完整解说视频

典型工作流：

导入视频 → Director策划 → 5步Agent Pipeline → TTS配音 → 字幕烧录 → 导出

👉 了解更多解说模式 →

🌟 核心特性

🤖 10+ 家 LLM 提供商

支持全球主流 AI 模型，灵活切换：

国际：OpenAI (GPT-4o)、Anthropic (Claude 3.5)、Google (Gemini)
国产：Alibaba (Qwen)、ZhipuAI (GLM)、iFlytek (Spark)、DeepSeek、Moonshot (Kimi)
本地：Ollama 本地部署 + Custom API 自定义接入

🗣️ 专业 TTS 配音

Edge TTS：微软 Edge 免费引擎，几十种音色
Azure TTS：企业级语音服务，高质量输出

🎙️ 本地 Whisper 转写

基于 faster-whisper 的离线字幕生成
6 档模型可选（tiny / base / small / medium / large-v2 / large-v3）
完全离线运行，视频不上传云端

⚡ GPU 加速渲染

FFmpeg NVENC（NVIDIA）/ VideoToolbox（macOS）硬件编码
硬字幕烧录 + 软字幕多语言轨道
支持自定义分辨率、码率、格式

🔒 隐私至上

所有视频处理在本地完成
原始素材、字幕、脚本永不上传
离线也可使用核心功能（TTS 需联网）

🏗️ 技术架构

graph TB
  subgraph Frontend["前端层 — React 18 + TypeScript 5 + Vite 6"]
    F1[Zustand Stores]
    F2[shadcn/ui]
    F3[MultiTrackTimeline]
  end
  subgraph IPC["Tauri 2 IPC — 61 个命令"]
    I1[invoke.ts]
  end
  subgraph Backend["Rust 后端 — tokio + 1.77+"]
    B1[ffmpeg-sidecar]
    B2[whisper-rs]
    B3[llm-providers]
    B4[tts-providers]
    B5[commentary engine]
  end
  F1 --> I1
  F2 --> I1
  F3 --> I1
  I1 --> B1
  I1 --> B2
  I1 --> B3
  I1 --> B4
  I1 --> B5

📊 项目规模：

📁 41+ 前端组件目录
🔧 61 个 Tauri IPC 命令
🧠 13 个业务服务模块
📝 27,000+ 行 Rust 代码

👉 深入架构 →

📚 文档导航

🎓 用户指南

安装指南 - 下载、安装、配置
快速开始 - 5分钟上手
剪辑模式 - AI高光检测与导出
解说模式 - Director Agent深度解析
脚本生成 - AI文案创作
导出设置 - 多格式导出配置
高级配置 - LLM/TTS/Whisper配置
快捷键 - 提升效率

🛠️ 开发者文档

系统架构 - 技术架构深度解析
项目结构 - 代码组织说明
解说工作流 - 5步Pipeline实现细节
AI服务 - LLM/TTS/Whisper集成
Tauri命令 - IPC接口完整列表
构建发布 - CI/CD指南

📖 参考资料

配置参考 - 完整配置项说明
常见问题 - 问题排查与解答

🛠️ 开发命令

# 前端开发
npm run dev                  # Vite开发服务器 (端口 1430)
npm run build                # 生产构建
npm run build:prod           # 生产构建 (详细输出)
npm run test                 # 运行测试
Tauri桌面应用
npm run tauri -- dev         # 启动桌面应用
npm run tauri -- build       # 构建桌面应用
文档站
npm run docs:dev            # VitePress开发模式
npm run docs:build          # 构建静态文档
npm run docs:preview        # 预览文档
代码质量
npm run lint                # ESLint检查
npm run lint:fix            # ESLint自动修复
npm run format              # Prettier格式化
npm run type-check          # TypeScript类型检查