跳转到内容
OpenASR

常见问题

这里汇总桌面版最常见的问题。建议先按对应步骤检查；仍然无法解决时，可以直接跳到如何反馈问题。

能录音，但文字没有输入到当前应用

Section titled “能录音，但文字没有输入到当前应用”

最常见的原因是没有开启辅助功能权限。OpenASR 需要它把识别结果填入你正在使用的应用，具体原因见桌面应用的权限说明。

  1. 打开 系统设置 → 隐私与安全性 → 辅助功能。
  2. 找到 OpenASR Desktop 并开启。如果列表中没有，点击 +，从 /Applications 添加应用。
  3. 切回 OpenASR Desktop，等待几秒。应用会自动重新检查权限，通常无需重启。

如果开关原本已经开启，可以关闭后再打开一次。macOS 偶尔会在应用更新、签名状态变化后需要重新确认。

麦克风没有声音

Section titled “麦克风没有声音”
  1. 打开 系统设置 → 隐私与安全性 → 麦克风，确认 OpenASR Desktop 已开启。
  2. 如果列表中完全没有 OpenASR，请退出并重新打开应用，然后启动一次听写或麦克风实时字幕，让系统再次弹出权限请求。
  3. 使用外接麦克风时，检查 macOS 当前的系统输入设备是否正确；OpenASR 会使用系统选中的输入设备。

系统音频字幕无法启动

Section titled “系统音频字幕无法启动”

系统音频和麦克风是两项不同的权限。第一次点击开始系统音频字幕时，macOS 才会请求对应权限。

请确认：

  • 系统版本为 macOS 14.2 或更高版本；
  • 系统设置 → 隐私与安全性 中，与系统音频或屏幕录制相关的 OpenASR Desktop 权限已经开启。

第一次要下载多大的模型

Section titled “第一次要下载多大的模型”

首次使用时推荐模型的下载体积约为 1 GB，具体大小会随模型和量化版本略有不同。可以在模型目录查看，也可以运行 openasr show <model> 获取准确数值。

普通宽带通常需要几分钟，网络较慢时会更久。如果准备尝试多个模型，建议预留数 GB 磁盘空间：已安装的模型会一直保存在本机，直到你主动删除。OpenASR 使用经过校验的 .oasr 模型包，不会把未完整下载或校验失败的文件当作可用模型。

为什么闲置一段时间后，第一次请求感觉变慢了

Section titled “为什么闲置一段时间后，第一次请求感觉变慢了”

为了节省内存，服务端会在模型闲置一段时间（默认 10 分钟）没有任何活动后，把 它的运行时从内存中卸载，但模型包仍然保留在磁盘上。闲置之后的第一次转写或 听写请求需要先付出一次正常的冷加载代价，把运行时重新载入内存才能开始处理 ——根据模型大小不同，这次延迟可能有一秒或更久，这是正常现象，不是故障。之后 的请求会恢复正常速度。

应用打不开

Section titled “应用打不开”

从官方下载页或 GitHub Releases 获取的 OpenASR Desktop 已使用 Developer ID 签名并经过 Apple 公证，正常情况下可以直接通过 Gatekeeper 检查。

如果仍然看到“无法打开”或“无法验证开发者”：

  1. 确认 DMG 来自 dl.openasr.org 或 GitHub，而不是网盘、镜像或他人转发的副本。文件损坏或被重新签名后无法通过校验。
  2. 重新下载 DMG。下载不完整也可能触发 Gatekeeper 提示。
  3. 仍然无法打开时，在 /Applications 中右键或按住 Control 点击应用，选择“打开”，再确认一次。

如果应用能打开但立刻崩溃，请在反馈中附上 macOS 版本和 Mac 芯片信息。目前桌面版要求 Apple Silicon。

应用打不开（Windows）

Section titled “应用打不开（Windows）”

Windows 版 OpenASR Desktop 由 Caelum Inc. 通过 Microsoft Azure Trusted Signing 签名。由于签名身份较新，首次运行安装程序或应用时，Microsoft Defender SmartScreen 可能弹出提示：

Windows 已保护你的电脑 Microsoft Defender SmartScreen 阻止了一个未识别的应用启动。

这是正常现象。SmartScreen 根据已有用户运行记录来判断信任度，新签名身份还没有 积累这些记录。签名本身是有效的，SmartScreen 并不是在报告恶意软件。

放行步骤：

  1. 点击 SmartScreen 对话框中的更多信息。
  2. 确认发布者显示为 Caelum Inc.
  3. 点击仍要运行。

每台电脑只需操作一次。随着更多用户安装和运行 OpenASR，SmartScreen 会逐步建立 对该签名证书的信任，之后不再弹出提示。

如果应用能打开但立刻崩溃，或安装程序报错，请在反馈中附上 Windows 版本以及设备 架构（x64 或 ARM）。

如何彻底卸载

Section titled “如何彻底卸载”
  1. 退出 OpenASR Desktop。
  2. 删除 /Applications/OpenASR Desktop.app。
  3. 如需清空配置、已安装模型和 Hugging Face Token，再删除 ~/.openasr/。普通卸载不需要这一步。
  4. 如果启用过开机启动，请在 系统设置 → 通用 → 登录项 中移除 OpenASR。

更完整的说明见桌面应用：卸载。

仍然无法解决

Section titled “仍然无法解决”

请前往 GitHub Issues 提交，并说明做过哪些尝试、操作系统版本，以及（桌面应用）Mac 芯片，能更快定位问题。