---
title: 快速开始
---

# 快速开始

## 环境要求

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

## 安装运行

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

访问 http://localhost:1430

## 构建桌面应用

```bash
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 分析详解](/guide/ai-analysis) — 了解高光检测原理
- [脚本生成](/guide/script-generation) — 自定义 AI 生成脚本
- [导出设置](/guide/export) — 高级导出选项
- [快捷键列表](/guide/keyboard-shortcuts) — 提升工作效率
