青梧字幕安装与配置指南

2025-04-17 14:17:42作者：邵娇湘

1. 项目基础介绍

青梧字幕是一款基于whisper的AI字幕提取工具，旨在帮助用户自动从视频文件中提取字幕。该工具的底层使用C++版本的whisper.cpp进行语音识别，前端界面则是采用了Electron、vite和TypeScript技术栈构建的。青梧字幕的开源版本是一个完全本地化的程序，除了第三方翻译过程外，不需要联网，所有数据都存储在本地，使用sqlite数据库。

2. 项目使用的关键技术和框架

whisper.cpp: 用于语音识别的C++库，是whisper算法的C++实现。
Electron: 一个使用Web技术（HTML、CSS和JavaScript）创建桌面应用程序的框架。
vite: 一个现代化的前端构建工具，用于构建前端项目。
TypeScript: JavaScript的一个超集，添加了静态类型选项。
sqlite: 一个轻量级的数据库，适用于本地数据存储。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装之前，请确保您的系统满足了以下要求：

操作系统: 支持Windows、macOS操作系统。
Node.js和npm: 需要安装Node.js和npm，可以从Node.js官网下载并安装。
cmake: 用于编译whisper.cpp，可以从cmake官网下载并安装。

安装步骤

以下是将青梧字幕安装到您的电脑的步骤：

克隆项目到本地

打开命令行工具，执行以下命令克隆项目：
```
git clone https://github.com/melon/qingwu-zimu.git
cd qingwu-zimu
```
安装npm依赖

在项目目录下，运行以下命令来安装项目所需的npm依赖：
```
npm install
```
编译whisper

根据您的操作系统，选择以下命令之一来编译whisper：
- 对于使用Mac（Arm芯片）的用户：
```
npm run build
```
- 对于使用Mac（Intel芯片）的用户：
```
npm run build-old-mac
```
- 对于Windows用户：
```
npm run build-win
```
注意：编译过程需要依赖cmake程序。如果安装后命令行里找不到cmake，那可能是环境变量没有配置好，需要先配置环境变量。
运行项目

编译完成后，运行以下命令启动项目：
```
npm run dev
```
运行上述命令后，就可以开始使用青梧字幕了。