跳到主要内容
版本:0.4.x

遥控模式下的语音输入

在遥控模式下,MIC 键使用键盘的麦克风录音,并把音频发送到你配置的 Whisper 兼容端点。识别结果会显示在设备屏幕的编辑器里,按 ACCEPT 提交到终端。

必须配置 ASR 服务

遥控模式始终在设备上录音,因此在配置语音转文字服务之前,MIC 键不会有任何反应。"prefer built-in ASR" 开关只对键盘模式有效。

配置语音转文字服务

用 Chrome 或 Edge 打开 VibeKeys setup 页面,连接设备后填写 ASR(语音识别) 字段:

字段填写内容
URIWhisper 兼容的 transcriptions 端点,例如 https://api.groq.com/openai/v1/audio/transcriptions
API key对应服务的 API 密钥(以 bearer token 方式发送)
Model模型名称,例如 whisper-large-v3

Groq、OpenAI,以及自建的 whisper.cppfaster-whisper 服务都可以使用。

选择 MIC 模式

setup 页面为 MIC 键提供两种触发方式:

  • PTT(按住说话):按住 MIC 录音,松开发送。
  • Toggle(点按开关):点一下 MIC 开始录音,再点一下停止并发送。

使用方法

  1. 按下 MIC 说话。屏幕先显示黄框 connecting...,连上后切换为绿框,表示正在听。
  2. 识别完成后,转写文本会显示在设备屏幕的编辑器里。
  3. 用旋钮移动光标进行修改。
  4. ACCEPT 把文本发送到终端,或按 ESC 丢弃。

相关文档