在 Mac 上离线语音输入

开始前的准备

• 使用搭载 Apple Silicon、运行 macOS 14.0 或更高版本的 Mac。
• 首次下载模型需要联网，并为所选模型留出足够的磁盘空间。
• 语音输入需要麦克风权限；向其他应用自动写入文本时，需要辅助功能权限。

配置本地语音输入

1. 打开「设置 → 语音识别」，选择本地 ASR 模型并使用「下载并启用」。等待安装完成，确认选中的是本地模型。
2. 基础配置可在「容错设置」中关闭「超时降级」，让语音识别保持在选中的本地路径。
3. 如果只需要语音输入，保持 AI 增强关闭。如果需要增强，另行下载兼容的本地增强模型，并在「AI 增强」中选择 Local MLX。确认其他已启用的处理功能也使用本地配置。

所需模型已下载并选用后，即可在没有网络连接时，使用已配置的快捷键进行语音输入。

为编辑器或终端输入提示词，请看开发者语音输入指南。若经常使用姓名和技术术语，也可了解自动记忆。

本地 AI 增强需要单独配置

ASR 模型将语音转为文字；AI 增强使用自己的模型处理这些文字。下载 ASR 模型，不等于下载了增强模型，也不会改变云端增强设置。

请检查整个处理流程，包括备用模型。ASR 有独立的「超时降级」设置；AI 增强可能尝试其他已配置、已验证的模型，其中也可能包括云端模型，所以只选择本地主模型不能保证所有处理都在本地。本地处理方案需要增强配置中的各条路径都使用本地模型，并单独配置记忆。云端 API 和订阅模型仍需要联网。

记忆模型与主动导入文档

若启用记忆处理，离线使用时请在「记忆」设置中选择可用的本地「记忆模型」。「跟随 AI 增强」要求 AI 增强已启用，且所选增强模型为本地模型。若要关闭 AI 增强但继续使用记忆，请明确选择可用的本地记忆模型。选择本地 ASR 不会自动改变记忆模型。

要加入自己的文档，打开设置中的「记忆」，选择「导入记忆」，由你选择要导入的文档。这与自动听写上下文是不同的操作，不表示 attunz 会自动扫描项目文件。

也可以选择云端处理

可以使用第三方云端 API 和自备 API Key（BYOK），或受支持的第三方订阅账号。云端处理需要联网，供应商产生的费用由你向该供应商支付。这些配置与可选的 Attunz Cloud 服务不同；Attunz Cloud 已推出。

使用本地模型或 BYOK（自备 API Key），Attunz 完整软件功能终身免费，Attunz 不收取任何费用。第三方模型费用由你向供应商支付。Attunz 托管云服务已推出，为可选云端 ASR 与 AI 增强采用手动额度充值，当前不自动续费。 价格

哪些操作仍需要联网？

首次下载模型、补齐或重新下载模型文件、检查和下载更新，以及发送反馈需要联网。离线语音输入不表示 App 的所有联网功能都已关闭。

本地语音输入尚未就绪时

确认所选本地模型已经安装完成，且模型文件可用。缺失或损坏的文件可能需要联网重新下载。同时检查录音与文本写入所需的权限。可用语言、资源占用与识别结果取决于模型和设备，不保证兼容每一个文本输入区域。

常见问题