安装 Voxt 和下载语音识别模型

安装 Voxt 和下载语音识别模型#

English

使用 Apple 芯片的 Mac 需要 macOS 15 或更新版本。第一次安装，选 Voxt 2.0.3 正式版。需要验证最新改动时，选下方的 Beta 路线。

下载 2.0.3 正式版#

一键下载 Voxt 2.0.3（Apple 芯片）

也可以从以下入口找到同一个版本号的安装包。

  • 仓库首页往下到 News，找到 Voxt 2.0，点 Download。 SGLang Omni News

  • 在 Voxt v2.0.3 发布页展开 Assets，点 Voxt-2.0.3-arm64.dmg。 GitHub Releases

  • 在 v2.0.3 条目点 Download。Changelog 可能给这条加上 Beta 标签，选择文件名为 Voxt-2.0.3-arm64.dmg 的包。 Voxt Changelog

下载 Beta#

main 每合入一次 Voxt 的改动，就会自动构建一个 Beta，版本号形如 2.0.3-beta.YYYYMMDD.N（日期加构建序号）。Beta 比正式版新，也可能不稳定。

当前最新的是 Voxt Beta #40：下载 Voxt-2.0.3-beta.20261112.40-arm64（约 33 MB，需要登录 GitHub，2026 年 11 月 26 日过期）。过期后，或者想找更新的构建：

  1. 打开 Voxt Beta 构建列表。最上面一条带绿色对勾、分支是 main 的就是最新的成功构建。黄色圆点表示还在构建，红叉表示失败，都跳过。

  2. 点进这次构建，往下翻到 Artifacts，点 Voxt-…-beta.…-arm64 下载 ZIP。构建产物只保留 14 天。

  3. 双击 ZIP 解压，打开里面的 .dmg。文件名里带 -beta.，可以用它区分每次构建和正式版。

Beta 不会自己更新：想换更新的 Beta，或者回到正式版，重新下载对应的 .dmg 安装即可。

安装并允许权限#

  1. 打开 .dmg，把 Voxt 拖到 Applications（应用程序），再从应用程序打开 Voxt。有旧版时先退出旧版，按需决定是否替换或导入。

  2. 在设置引导点开始设置。在权限一步，麦克风点请求授权，在系统弹窗里点允许；辅助功能点打开系统设置，在“隐私与安全性 → 辅助功能”里打开 Voxt 的开关。两项都显示已允许后点继续。如系统要求重启 Voxt，关闭后从应用程序重新打开。

下载 ASR#

  1. 到模型一步，点下载并继续。推荐的本地 ASR 是 Qwen3-ASR 1.7B (8bit)，约 2.5 GB。模型在后台下载，可以先继续引导，进度条走满就能用了。

  2. 如果已跳过引导，回侧栏语音识别模型，在本机里找到同一个型号并点下载，等它显示已安装。需要重新打开引导时，去设置 → 通用 → 打开设置引导。

  3. 打开一个空白文本框，轻按右 ⌥ Option，说「明天下午三点开会」，再轻按右 ⌥ Option。看到文本出现在光标处，就完成了本地转录的基本设置。

接下来可以配置自己的 API Key，用于翻译、改写和可选的转录润色。

交给 Agent#

按本页在 Apple 芯片 Mac 上安装 Voxt 2.0.3 正式版。只有我明确要求 Beta 时才下载 Actions 的 Beta 包。遇到替换旧版、导入历史或 macOS 权限授权时让我确认。下载推荐的本地语音识别模型，等到显示可用。用空白文本框和一句测试内容确认转录能输出，告诉我安装的版本和结果。