快速开始

环境要求

• Node.js 18+
• Rust 1.75+（用于 Tauri 后端）
• FFmpeg（系统安装）

安装运行

git clone https://github.com/Agions/story-fab.git
cd story-fab
npm install
npm run dev

访问 http://localhost:1430

构建桌面应用

npm run tauri build

快速上手流程（5步）

1. 新建项目

打开 StoryFab，点击 新建项目，为项目命名并选择输出目录。

2. 上传视频

拖拽或点击上传长视频文件，支持格式：

• .mp4、.mov、.avi、.mkv、.webm
• 最大文件大小：2GB

上传完成后，视频将自动开始分析。

3. AI 分析视频

StoryFab 并行运行两个 AI 进程：

• Whipser 语音转录 — 完整音频转录，本地存储
• 高光检测 — 基于音频能量、画面变化和语音活动识别精彩片段

进度实时显示，分析时间约为视频时长的 1-2 倍。

4. 根据模式选择操作

剪辑模式：

• 在时间轴上查看检测到的高光片段
• 拖拽边缘调整片段边界
• 删除不需要的片段
• 预览每个片段

解说模式：

• 选择片段后，点击 生成解说词
• AI 自动生成简洁的配音脚本
• 可手动编辑脚本内容
• 预览 TTS 语音合成效果
• 如不满意可重新生成

5. 导出成片

点击 导出，选择目标平台：

平台	比例	分辨率
TikTok / Shorts	9:16	1080×1920
Instagram Reels	9:16	1080×1920
Instagram Feed	1:1	1080×1080
YouTube	16:9	1920×1080
Twitter/X	16:9	1920×1080

开启 烧录字幕 可将字幕直接嵌入视频。点击导出并等待渲染完成。

键盘快捷键

快捷键	功能
空格	播放 / 暂停
I / O	设置入点 / 出点
J / K / L	逐帧控制（后退 / 暂停 / 前进）
⌘Z	撤销

下一步

• AI 分析详解 — 了解高光检测原理
• 脚本生成 — 自定义 AI 生成脚本
• 导出设置 — 高级导出选项
• 快捷键列表 — 提升工作效率