FluidVoice 中文教程：从本地听写开始，逐项打开权限

FluidVoice 是 macOS 听写应用。按下全局快捷键说话，它用 Apple Speech 或本地语音模型转写，再把文字输入当前应用。它也能调用本地或云端模型整理文本。这里最容易误解的是“本地优先”：语音可以留在电脑上，但模型下载、自动更新、匿名活动和你主动启用的云端后处理仍会联网。

1. 先看机器能不能用

官方要求 macOS 15.0 或更高。Apple Silicon 可以选择 README 列出的全部模型；Intel Mac 从 1.5.1 起只支持 Whisper 路线。常规语音模型约占 1 GB，Whisper 从约 75 MB 到 2.9 GB；可选的 Fluid Intelligence 还要约 3.5 GB。

2. 从官方稳定版安装

brew install --cask fluidvoice

也可以从官方 v1.6.9 release 下载 DMG 或 ZIP。安装后先核对应用版本和签名来源。源码构建需要 Xcode 和 Swift Package Manager；自己编译的 unsigned 构建可能在每次变化后重新要求麦克风、辅助功能和屏幕录制授权。

3. 第一次只用一个本地引擎

想少下载内容，可以先试系统内置的 Apple Speech。Apple Silicon 用户再根据语言选择 Parakeet、Nemotron、Cohere 或 Whisper。不要一口气下载全部模型；用同一批句子比较中文、英文、专有名词、数字、标点和噪声环境，留下准确率和延迟更合适的一个。

4. 麦克风与 Accessibility 分开授权

麦克风权限用于录音。Accessibility 权限让应用向其他程序输入文字，权限范围更大。先完成应用内转写，再在确实需要跨应用输入时开启 Accessibility。设置全局快捷键时避开系统快捷键和常用编辑器组合，防止误触录音。

5. 看清三种数据路径

本地语音模型：音频和转写可留在本机。云端 AI provider：启用 OpenAI、Groq 或自定义 provider 后，文字和相关提示进入相应服务；API key 存在 macOS Keychain。匿名分析：详细分析默认开启，可以关闭，但官方 README 说明基础活动仍按周发送，包括随机安装 ID、日期、版本和 macOS 平台标签。

音频历史也是可选项。首轮测试先关掉，确认确有回听或审计需要后再开启，并设置空间预算和清理周期。共享 Mac 不要把历史目录当成加密保险箱。

6. Fluid Intelligence 的许可证边界

FluidVoice 应用在 2026-02-23 后使用 GPLv3；更早版本是 Apache-2.0。官方 README 同时写明，Fluid Intelligence 是“separate, privately maintained”的本地运行时。也就是说，它可以在本机工作，但其实现不能从这个 GPLv3 仓库完整审计。需要全链路开源时不要启用它。

7. 同类对比：FluidVoice 与 whisper.cpp

相比 whisper.cpp，FluidVoice 已处理全局快捷键、浮层、模型选择、后处理和跨应用输入，更像一款完整 Mac 应用；whisper.cpp 是 C/C++ 推理库、CLI 和 server，平台更广，也更适合嵌入自己的程序。只想在 Mac 各应用听写，可先试 FluidVoice；要做跨平台产品或精确控制推理管线，先看 whisper.cpp。

8. 用自己的语料验收

准备 30 句真实文本，覆盖安静和噪声、短句和长句、中英文夹杂、数字、网址及人名。每个模型记录字错误率、首字延迟、长句丢字、CPU/内存和一小时电量变化。再测试暂停、切换麦克风和睡眠唤醒。不要用项目方“最快”宣传语替代这些数据。

9. 验证状态与商业边界

未验证：DMG 签名/notarization、Homebrew cask、模型 hash、准确率、延迟、内存、耗电、权限行为、云端请求内容、自动更新、Intel Mac 和历史清理。README 有 GitHub Sponsors 与 iOS/Windows waitlist，但没有付费套餐、充值额度或返佣注册链接，因此保留并披露，不做商业隔离。

常见问题