FluidVoice:完全本地运行的 macOS 语音输入工具,延迟几乎为零
macOS 语音输入应用,支持设备端 STT 和本地 AI 增强模型,延迟极低且完全离线,作为 Wispr Flow 的开源替代方案。
完整中文译文
macOS 开源语音转文字听写应用,搭配本地 AI 增强功能。
安装方式(Homebrew):
brew install --cask fluidvoice
手动下载:latest release
FluidVoice 目前已登陆 macOS,iOS 和 Windows 版本正在路上——加入等待列表,第一时间获取发布通知:altic.dev/fluid/waitlist
本项目基于 GPLv3 开源免费。如果你觉得 FluidVoice 有用,请给仓库点个 star——这能帮助项目获得更多关注,支持开发持续进行。
如果 FluidVoice 对你有帮助,可以在 GitHub Sponsors 上支持后续开发和 iOS、Windows 的跨平台推进。
核心特性
极速 Parakeet — 重新构建的 Parakeet 实现,说话到文字出现在屏幕上几乎零延迟
Fluid Intelligence — 完全本地的 AI 模型,提供设备端听写增强。不上云、不需要 API Key、数据绝不离开你的 Mac
更佳主题 — 自适应浅色/深色主题,搭配紧凑型工具栏切换器
全新引导流程 — 以语言优先的语音引擎设置、真实听写体验和 AI 增强配置,一次完成
基于早期反馈,Fluid Intelligence 可能让你取消订阅其他听写应用并省钱。忠告已送达。
关于 Fluid Intelligence
FluidVoice 依据 GPLv3 完全开源。Fluid Intelligence 是一个独立、私有维护的本地 AI 运行时,为先进的设备端听写增强提供动力——智能格式化、上下文感知的大小写转换和后处理——全部在你的 Mac 本地运行。
应用本身搭配任意支持的语音模型和可选的云端 AI 提供商已经非常好用。Fluid Intelligence 为需要设备端增强且不想让数据离开设备的用户,提供了一个完全本地化、私密的 AI 层。
我们暂时保持 Fluid Intelligence 私有,以便可持续地免费提供核心听写体验。后续可能会有变化。
Fluid Intelligence 功能预览
Command Mode — 使用 FluidVoice 执行 Mac 上的任意操作
Write Mode — 在任意应用的任意文本框中撰写或重写文本
Fluid Intelligence — 设备端 AI 增强,提供智能格式化、上下文感知的大小写转换和后处理,全部在你的 Mac 本地运行,数据绝不离开机器
功能列表
Command Mode — 语音控制 Mac:启动应用、运行快捷指令、触发系统操作、自动化工作流,全程无需触碰键盘
Write Mode — 在任意应用任意文本域中直接撰写或重写文本。可选中现有内容进行重写,也可直接听写新内容
Live Preview — 实时转写叠加层,支持刘海,话语出口即现
Multiple Speech Models — Nemotron Speech 3.5、Parakeet Flash、Parakeet TDT v3 & v2、Cohere Transcribe、Apple Speech 及 Whisper。选用适合你语言和延迟需求的模型
AI Enhancement — 可选的后处理支持,通过 OpenAI、Groq、自定义提供商或本地 Fluid Intelligence 实现更清晰、更准确的转写
Audio History — 可选的本地录音历史,支持预算控制和 ZIP 导出,无需云端存储即可回顾过往听写
Today-Usage Stats — 每日用量一览,统计头卡和工具栏药丸展示
Adaptive Theming — 跟随系统的浅色/深色主题,搭配紧凑型工具栏切换器
Global Hotkey — 全局热键,从任意位置即时语音捕获,无需切换应用
Smart Typing — 通过无障碍 API 直接插入任意应用,稳定可靠、应用无关的文本输入
Menu Bar Integration — 菜单栏快速访问、状态和设置
Auto-Updates — 无缝更新,可选 Beta 通道获取提前预览
Per-App Configuration — 为不同应用分配不同 prompt 集,让听写适配你当前的工作环境。完全可选
Notch-Aware Overlay — 转写叠加层,自动适配 MacBook 刘海区域,也可为无刘海的 Mac 使用标准叠加层
Local-First — 语音、音频和转写文本绝不离开你的机器,除非你主动选择云端 AI 提供商
Fastest Parakeet on Mac — macOS 上最快的 Parakeet 原生实现之一,几乎瞬时的转写和极低延迟
Configurable Overlay — 从药丸形到大尺寸叠加层,多种尺寸可选显示实时预览,也可保持极简风格。一切皆可选
Everything is Optional — AI 增强、Fluid Intelligence、音频历史、分析数据和 Beta 版本全部可开关。核心听写体验开箱即用,配置仅需设置权限和热key两步
支持语言
Parakeet TDT v3
保加利亚语、克罗地亚语、捷克语、丹麦语、荷兰语、英语、爱沙尼亚语、芬兰语、法语、德语、希腊语、匈牙利语、意大利语、拉脱维亚语、立陶宛语、马耳他语、波兰语、葡萄牙语、罗马尼亚语、俄语、斯洛伐克语、斯洛文尼亚语、西班牙语、瑞典语、乌克兰语
Parakeet TDT v2
Cohere Transcribe
英语、法语、德语、意大利语、西班牙语、葡萄牙语、希腊语、荷兰语、波兰语、普通话、日语、韩语、越南语、阿拉伯语
Apple Speech
系统语言支持取决于机器上 macOS 语音识别语言
Whisper
Whisper 支持多达 99 种语言,具体取决于你选择的模型大小
快速上手
安装 Homebrew:
brew install --cask fluidvoice
或下载最新版本。
授权权限 — FluidVoice 会请求麦克风和无障碍权限,两项均为听写和向其他应用输入文字所必需。
设置热key — 在设置中选取一个全局热key,从任意位置触发语音捕获。
完成引导 — 根据语言和延迟需求选择语音模型。模型选择从无需下载的 Apple Speech 到高精度 Nemotron 和 Whisper 不等。
(可选)启用 Fluid Intelligence — 在引导过程中下载本地 AI 模型,实现设备端听写增强。所有运行均为本地,数据不离开你的 Mac。
(可选)接入你自己的 AI 提供商 — 添加 OpenAI、Groq 或自定义提供商的 API Key 用于云端增强。Key 安全存储在 macOS Keychain 中,访问时选择"始终允许"。
(可选)加入 Beta 版本 — 设置 → 自动更新 → Beta 版本,获取新功能提前体验。
系统要求
- macOS 15.0(Sequoia)或更高版本
- 所有模型均需 Apple Silicon Mac
- Intel Mac 通过 Whisper 模型支持(1.5.1+ 起)
- 语音模型约需 1 GB 磁盘空间
- Fluid Intelligence 模型约需 3.5 GB 磁盘空间(可选)
- 需要无障碍权限以实现文字输入
从源码构建
git clone https://github.com/altic-dev/FluidVoice.git
cd FluidVoice
open Fluid.xcodeproj
在 Xcode 中构建并运行。所有依赖由 Swift Package Manager 管理。
使用脚本运行签名 Debug 构建:
./build.sh
签名构建产物输出至 DerivedData/Build/Products/Debug/FluidVoice Debug.app。每次重新构建后持续运行该产物,以让 macOS 保留其无障碍授权。
对于没有签名身份的个人 CI 或贡献者,使用显式无签名备选方案:
./build.sh unsigned
无签名构建绑定到特定可执行版本,可能需要在重新构建后移除并重新授予无障碍权限。
贡献指南
欢迎贡献!在提交 Pull Request 之前,请先创建 Issue 讨论重大变更。
开发设置
如上所述,克隆并用 Xcode 打开项目。
签名:FluidVoice → Signing & Capabilities → Automatically manage signing → 选择你的 Team(Personal Team 即可)。如果有多团队证书,通过运行 FLUIDVOICE_DEVELOPMENT_TEAM=YOUR_TEAM_ID ./build.sh 来选择而不改变项目。
构建并运行 — SPM 处理依赖。
(可选)Pre-commit 钩子防止意外提交团队 ID:
cp scripts/check-team-id.sh .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit
Pull Request 规范
- 每个 PR 只做一件事(一个功能或一个修复),保持变更集中和原子化
- 先创建 Issue,以便在审查前跟踪工作
- 非trivial变更在开 PR 前先讨论
- 遵循 PR 模板
- 在机器上充分测试
- 绝不提交个人团队 ID 或 API Key
- 提交前检查 git diff
运行集成测试
xcodebuild test -project Fluid.xcodeproj -scheme Fluid -destination 'platform=macOS'
CI 使用无签名构建:
xcodebuild test -project Fluid.xcodeproj -scheme Fluid -destination 'platform=macOS' CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO
隐私
FluidVoice 以本地优先为原则。你的语音、音频和转写文本绝不离开你的机器,除非你主动选择云端 AI 提供商。
收集的内容(需主动选择)
匿名分析数据默认开启,用于追踪应用健康状况和功能使用情况。你随时可以在设置中关闭:设置 → 共享匿名分析数据。
收集内容:
- 应用版本、构建号、macOS 版本
- 低基数的功能/配置标志(如应用模式、主要设置项)
- 近似用量区间(非精确值)
- 高层级的成功/错误结果
不收集内容:
- 语音、原始音频或转写文本
- 选中文本、prompt 或 AI 响应
- 终端命令、窗口标题、文件路径、剪贴板内容或输入内容
- 任何个人或私密信息
社区
加入 Discord:https://discord.gg/VUPHaKSvYV
关注 X 上的开发动态:@ALTIC_DEV
许可
自 2026-02-23 起,本项目依据 GNU General Public License, Version 3.0(GPLv3)授权。
此日期之前发布的版本依据 Apache License 2.0 授权。