IPHONE
undervoice for iPhone
在 iPhone 上打开 App Store，下载并安装 undervoice。首次打开时，按引导允许相机、麦克风和本地网络访问。
需要 iOS 18 或更高版本在 App Store 下载01 / 下载两端 App
iPhone 负责近距离收音，Mac 负责识别和输入。
两端都需要安装。建议先装 Mac 版并完成准备，再打开 iPhone 版扫码。
MACOS
undervoice for Mac
从本站下载 DMG。打开安装包，把 undervoice 拖到“应用程序”，再从“应用程序”文件夹打开。
需要 macOS 14 或更高版本下载 Mac 版02 / 准备 Mac
第一次打开 Mac 版，完成这四件事。
语音识别在 Mac 上运行，因此需要先准备模型和用于写入文字的系统权限。
- 01
打开 undervoice
从“应用程序”文件夹启动。Mac 版会留在菜单栏，关闭主窗口后仍可继续运行。
- 02
下载语音包
打开“设置”，选择听写语言，确认并下载语音包。等状态显示准备就绪后再继续。
- 03
允许所需权限
允许本地网络和辅助功能。辅助功能只用于把结果写入当前输入框；只有使用 Mac 自带麦克风时才需要麦克风权限。
- 04
显示配对码
在左侧选择“设备”。页面会显示供 iPhone 扫描的配对二维码。
03 / 扫码配对
Mac 显示二维码，iPhone 来扫描。
首次配对时，把两台设备放在同一个 Wi‑Fi 上最简单。
在 Mac 上
打开“设备”
保持二维码显示在屏幕上。如果页面显示“iPhone 已配对”而没有二维码，需要先重置配对。
在 iPhone 上
扫描 Mac 配对码
按首次使用引导中的扫描按钮；如果已经进入 App，请打开“设置 → Mac 配对 → 扫描 Mac 二维码”。允许本地网络访问后，连接会自动继续。
两端显示已连接，就可以开始使用。
04 / 开始输入
光标放好，按住说话，松开完成。
不需要把文字从另一个 App 复制回来。
先在 Mac 上放好光标
点击 Codex、Claude Code、Xcode、Terminal、浏览器或其他 App 的可编辑输入框。
把 iPhone 拿到嘴边
距离约 5–10 厘米即可。近距离收音让你不必对着整间办公室大声说话。
按住“按住说话”
说话时保持按住，说完松开。加密音频会传到已配对的 Mac，Mac 完成识别后把最终文字写到当前光标。
密码框和系统安全输入不会被写入。如果焦点已经移动，undervoice 会停止写入，避免文字落到错误位置。
简单了解工作方式
手机收音，Mac 本地转成文字。
整个流程可以用四步理解，不需要了解网络协议或模型细节。
01
→iPhone 麦克风近距离收音
02
→音频在 iPhone 上加密
03M
→已配对的 Mac 用本地语音识别模型处理
04
结果写入当前输入框
这不是把声音交给聊天机器人。Mac 上的语音识别模型只负责把声音转成文字；undervoice 不运营语音中转或云端转写服务，录音也不会保存成音频文件。
常见问题
如果没有一次成功，先检查这里。
01Mac 上没有二维码
Mac 已经记住一台 iPhone 时会隐藏二维码。在“设备”中重置配对，然后扫描新码。
02扫码后一直无法连接
确认两端允许本地网络访问并先连接同一 Wi‑Fi。企业 Wi‑Fi 可能阻止设备互访，可改用 iPhone 个人热点；跨网络使用可另行配置 Tailscale。
03iPhone 提示 Mac 模型未准备好
回到 Mac 的“设置 → 语音模型”，下载并等待所选语音包显示准备就绪。配对识别需要 Apple Silicon Mac。
04能识别，但文字没有进入 App
确认 Mac 已给 undervoice 辅助功能权限，并把光标放在普通可编辑输入框中。授权后可返回 App 再检查一次。
仍然需要帮助？
告诉我们你卡在哪一步、两端显示什么状态即可。请不要发送配对二维码、录音或私人转写内容。