Mac 听写没反应、不出字？先查语言包

Mac 听写不出字，先找出故障发生在哪一步：快捷键 → 收音 → 识别 → 清稿 → 插入。缺少语言模型可能让本机识别失败，但声纹在动，并不能单独证明「下载语言包」就是答案。

Apple 系统听写先查系统设置 → 键盘 → 听写。Ducduc 显示听写语言不可用时，按卡片操作；经典引擎与 macOS 26 新引擎的下载入口不同。本文由 Ducduc 产品方发布，分开说明这两条路径，不把所有空白输入都归为模型问题。

重装之前，先对照症状

现象	优先检查	能说明什么
按键后没有听音界面	快捷键、App 是否运行、按键冲突	录音可能根本没启动
开始听音，但电平不动	输入设备、音量、麦克风权限	没有足够可用声音
声纹在动，没有原稿，提示语言不可用	语音识别权限、语言、本机模型、引擎可用性	收音正常时识别也可能失败
历史有文字，提示清稿失败	网络、供应商配置、额度或本地模型	这次识别已经成功
历史有文字，光标处没字	焦点、辅助功能权限、安全输入、复制卡	插入可以独立失败

声纹随声音变化，只说明有音频进来，不代表语音识别权限已经通过，更不代表能向目标输入框插字。

Apple 系统听写失效时

按 Apple 排查指南，检查听写已开启、语言和地区正确、快捷键无误，并选中可用且音量足够的麦克风。在备忘录正文中放好光标再测试。

语音控制开启时，标准听写不可用，Apple 听写指南说明了区别。键盘设置中听写下方的文字会提示当前配置是否需要联网，不要假设每种语言、输入位置和硬件组合都能离线运行。

按键启动了另一个工具或 Siri 时，先看 fn／地球键冲突指南。确认麦克风、快捷键和语言设置，本身不需要安装另一个 App。

Ducduc：核对实际请求的语言与权限

设置 → 听写 → 识别语言里的「中文（含中英混说）」请求 zh-CN，「English」请求 en-US。要准备的是 Ducduc 请求的语言模型，不一定是系统显示语言或当前键盘语言。繁体输出是独立的字形设置。

在系统设置 → 隐私与安全性检查 Ducduc 的麦克风和语音识别权限。辅助功能是另一项用于操作目标 App 的权限。收不到声音时，检查声音 → 输入，选择预期设备并观察系统电平；重新连接或切换外置麦克风后再测。

诊断时一次用一个听写工具。暂时关闭语音控制可以减少变量，但它与 Apple 系统听写的文档冲突，不直接证明它就是 Ducduc 失败的原因。

macOS 14–15 或经典引擎：检查听写语言

点击 Ducduc 卡片上的打开听写设置，或进入系统设置 → 键盘 → 听写。
在语言中添加或选择匹配的语言与地区；这些版本可点语言列表旁的编辑。
保持网络可用，让 macOS 准备所需语言资源。回到 App 不代表后台下载已经结束。
在 Ducduc 开始一次新的短句听写。卡片还在时，记下完整详情、所选语言、机型和 macOS 版本。

经典引擎请求本机识别。Apple 文档说明了要求本机识别与识别器支持本机运行之间的关系。locale 可选，不代表这台 Mac 已准备好本机识别。

检查语言下载有用，但不是万能修法。临时识别服务错误、硬件和语言支持也可能影响结果。「Speech recognizer unavailable (en-US)」、反复识别错误，与未检测到语音需要分别判断。

macOS 26 新引擎：使用模型下载入口

在设置 → 听写 → 识别启用新引擎后，Ducduc 可以提供下载语音模型。点击后观察进度。本次核对的实现会在卡片仍打开、安装成功后重试那次听写；已经关闭卡片时，下次自己开始新会话即可。

新引擎使用系统管理的资源。Apple AssetInventory 文档说明 SpeechAnalyzer 模块需要对应的下载模型，与经典听写设置的资源路径分开。

Ducduc 也会在适当时机于后台请求资源。新引擎未准备好时，可以使用经典引擎，但经典路径也有自己的要求。安装失败或不支持该语言时，卡片说明错误，并提供打开听写设置。反复点击下载不能让不支持的 locale 获得支持。

怎样断网验证，又不下过度结论？

联网准备模型后，选不敏感短句，例如“This is a local recognition test”或「这是一次本机识别测试。」这是建议输入，不是已有实测输出。

保存工作，暂时断开 Mac 的网络连接。
在 Ducduc 向备忘录普通正文口述。
分别检查历史里的识别文字与清稿状态。
测完恢复网络。

断网后出现原稿，能说明这次会话的识别离线成功，不能证明准确率或所有功能都在本机。历史已有字、只是云端清稿失败时，这次应查的已不是识别模型安装。历史完全空白时，先对照音频、权限、模型和引擎错误，再确定原因。

Apple 系统听写能离线是有用的对照，但不证明第三方 App 所选引擎也已准备好。App 支持 Intel Mac，也不代表每个请求语言都有可用的本机模型。反馈时注明处理器类型。

识别正常，清稿或插入失败

没有网络时，云端清稿不能完成。Ducduc 会保留识别文字并标注降级；混合模式配置了本地备用模型时，也可能由它完成清稿。离线模式跳过 Ducduc 的云端清稿路由，但不会关闭 Ollama 的云功能。清稿要留在同一台 Mac，需使用回环地址、已下载的本地模型，并关闭 Ollama 云功能。Ollama 配置指南介绍这个独立模型。

历史已有结果时，应检查目标输入框，而不是重新下载语音资源。出现复制卡时先手动粘贴，再查辅助功能权限、焦点变化或终端安全键盘输入。

如果本机识别和可核对文字的流程适合你，可以下载 Ducduc。仍无法使用时，通过反馈提供 App 和构建号、macOS 版本、处理器、所选语言与引擎、完整错误、声纹是否变化、历史是否有字。用短小脱敏示例说明故障阶段即可，不需要为了反馈提交私密音频。