功能: - 基于 ONNX 的语音识别引擎 - 多语言支持(中文、英文、日语、韩语) - 模型加载器(支持 SenseVoice/Whisper/Paraformer) - 音频采集和处理模块(VAD、重采样、归一化) - 文本输出模块(剪贴板) - CLI 命令行工具 - Electron GUI 界面 - Windows x64 打包配置 文档: - PRD 产品需求文档 - README 项目说明 - 开发指南 - Windows 构建指南 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Windows 构建指南
构建说明
由于网络问题,在 Linux 环境下构建 Windows 版本可能需要多次尝试。建议在 Windows 系统上直接构建,或使用以下方法。
方法一:在 Windows 上构建(推荐)
1. 环境准备
# 安装 Node.js 20+
# 从 https://nodejs.org 下载安装
# 克隆项目
git clone <repository-url>
cd impress-asr-input
# 安装依赖
npm install
2. 放入模型文件
将 ONNX 模型放入 models/ 目录:
sensevoice.onnxwhisper.onnxparaformer.onnx
3. 构建
# 构建 ZIP 包(无需签名)
npm run build:win:zip
# 构建 NSIS 安装程序
npm run build:win
输出目录:release/
方法二:在 Linux 上构建(需要良好网络)
# 设置 Electron 镜像
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
# 构建解压目录版本(用于测试)
npm run build:win:dir
# 构建 ZIP 包
npm run build:win:zip
构建输出
release/
├── win-unpacked/ # 未打包版本(用于测试)
│ ├── Impress ASR Input.exe
│ ├── resources/
│ └── ...
├── Impress ASR Input-0.1.0-win-x64.zip # ZIP 压缩包
└── Impress ASR Input-0.1.0-win-x64-setup.exe # NSIS 安装程序
常见问题
1. Electron 下载失败
# 使用国内镜像
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
export npm_config_electron_mirror="https://npmmirror.com/mirrors/electron/"
2. winCodeSign 下载失败
这是 electron-builder 依赖的签名工具,可以:
- 添加
"sign": null到package.json的build字段禁用签名 - 或手动下载:https://github.com/electron-userland/electron-builder-binaries/releases
3. 图标文件缺失
构建时会使用默认图标,如需自定义:
- 准备
icon.ico(256x256) - 放入
build/目录 - 在
package.json中添加"icon": "build/icon.ico"
手动分发(无打包工具)
如果 electron-builder 无法使用,可以手动创建分发包:
# 1. 编译 TypeScript
npm run build
# 2. 复制 Electron 和资源文件
cp -r dist/ release/my-app/
cp -r node_modules/ release/my-app/node_modules/
cp -r src/ui/ release/my-app/src/ui/
cp -r models/ release/my-app/models/
# 3. 下载 Electron 并放入
# https://npmmirror.com/mirrors/electron/
# 4. 压缩
cd release/
zip -r impress-asr-input-win-x64.zip my-app/
运行应用
解压后运行:
Impress ASR Input.exe
或命令行模式:
node dist/main.js start