青梧字幕安装与配置指南

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官网下载并安装。

安装步骤

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

1. 克隆项目到本地

   打开命令行工具，执行以下命令克隆项目：

   git clone https://github.com/melon/qingwu-zimu.git
   cd qingwu-zimu
   

2. 安装npm依赖

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

   npm install
   

3. 编译whisper

   根据您的操作系统，选择以下命令之一来编译whisper：

   • 对于使用Mac（Arm芯片）的用户：

     npm run build
     

   • 对于使用Mac（Intel芯片）的用户：

     npm run build-old-mac
     

   • 对于Windows用户：

     npm run build-win
     

   注意：编译过程需要依赖cmake程序。如果安装后命令行里找不到cmake，那可能是环境变量没有配置好，需要先配置环境变量。

4. 运行项目

   编译完成后，运行以下命令启动项目：

   npm run dev
   

   运行上述命令后，就可以开始使用青梧字幕了。

请按照上述步骤操作，您应该能够成功安装并运行青梧字幕。如果在安装过程中遇到任何问题，请参考项目的README文件或搜索相关问题的解决方案。