voicekey

English

Voice Key

一款开源的桌面语音输入应用

查看演示 · 报告 Bug · 请求功能

1. 主要功能
   • 技术栈
2. 上手指南
   • 环境要求
   • 安装步骤
3. 配置要求
4. macOS 安装指南
5. 开源协议
6. Star History

主要功能

• 本地语音转写: 使用 SenseVoiceSmall int8 在设备上离线识别，音频无需上传。
• 文本润色: 支持基于 OpenAI-compatible 接口的轻量后处理。
• 文本注入: 转写完成后可直接注入到当前焦点输入框。
• 桌面工作流: 提供全局快捷键、HUD、日志和更新检查能力。

技术栈

(back to top)

上手指南

按照以下步骤在本地启动项目。

环境要求

• Node.js
• npm

npm install npm@latest -g

安装步骤

1. 克隆仓库。

git clone https://github.com/BuildWithAIs/voicekey.git

1. 安装依赖。

npm install

1. 启动开发环境。

npm run dev

1. 在设置页下载本地语音识别模型。

(back to top)

配置要求

语音识别仅使用本地 SenseVoiceSmall int8 模型，不需要 ASR API Key。首次使用前请在设置页下载约 240 MB 的模型文件；下载完成后，录音和识别均在本机进行。

macOS 安装指南

由于应用当前未签名，安装后可能需要额外执行以下步骤。

1. 解除安全限制

如果打开应用时提示“文件已损坏”，请在终端运行：

bash xattr -cr /Applications/Voice\ Key.app

1. 授予辅助功能权限

应用需要监听按键并模拟输入。请前往 系统设置 > 隐私与安全性 > 辅助功能，为 Voice Key 打开权限。

开源协议

本项目采用 MIT License。

Star History

(back to top)