支持。

完整上手指南与日常使用的常见问题。

认识 VioRelay

VioRelay 将 iPhone 的麦克风音频传送到 Mac，两端在同一个局域网内即可保持全天候连接。

  • 系统原生输入：通过专属的虚拟音频驱动，iPhone 在 Mac 上显示为一个标准的输入设备。在系统设置、视频会议、播客录制或视频剪辑软件中，都可以直接将其选为麦克风使用。
  • 音频参数调节：提供采样率、声道模式、拾音位置、输入增益、环境降噪、自适应增益以及多段参数均衡器，均可按录音场景单独调整。
  • 按键配置与自动化：iPhone 上的按键可与 Mac 端的动作联动，例如触发系统语音输入、启动指定应用、执行按键组合或调用自动化脚本。

连接与设备管理

VioRelay 通过局域网在 iPhone 与 Mac 之间传输音频。两端处于同一局域网，配对一次之后，后续打开会自动发现对方。

第一次配对

在 Mac 上打开 VioRelay，点击左下角的输入按钮，选择「+」，屏幕上会出现一张二维码与 6 位配对码。

打开 iPhone 上的 VioRelay，在引导页点击「绑定 Mac」，扫描 Mac 屏幕上的二维码，或手动输入 6 位配对码。配对只需一次，之后两端会记住彼此。

开始使用

配对完成后，两台处于同一局域网的设备会自动建立连接。在任何使用麦克风的 Mac 应用里，将输入设备选为「VioRelay」，iPhone 便会向 Mac 传输音频。

首次使用时，iOS 会请求麦克风权限，macOS 会请求局域网访问权限，两者均需允许。

提示：如果两端在同一局域网却找不到对方，先确认没有开启 VPN 或网络隔离模式。部分企业网络会屏蔽设备之间的直连。也可以在 iPhone 端手动尝试重连。

主页状态胶囊

iPhone 主页右上角显示当前连接状态的胶囊支持轻点交互：

  • 连接或推流中：轻点状态胶囊，可停止当前推流并断开连接。
  • 未连接或暂停状态：轻点状态胶囊，会重新发起连接并接入已配对的 Mac。

设备配对管理

  • 在 iPhone 上管理 Mac：进入「设置 → 连接」，可以查看所有已配对的 Mac 设备，并可手动清除不需要的配对记录。
  • 在 Mac 上管理 iPhone：点击圆形窗口左下角的输入按钮，可查看已配对的 iPhone 列表并切换输入源。

多设备协同：一台 iPhone 最多可同时认证并服务多台已配对的 Mac，在工作室或家庭不同房间移动时，音频流转依然平滑从容。

音频与传输设置

你可以在 iPhone 或 Mac 端调节各项音频参数，两端设置会实时同步。

采样率

可选 44.1 kHz 与 48 kHz。44.1 kHz 适合音乐制作，48 kHz 适合视频录制、直播和会议软件。若不确认选择哪项，请保留默认的 48 kHz。

声道

单声道占用带宽更低，适合语音输入、播客和网络会议；立体声能保留空间声场，适合录制现场声音或乐器演奏。

传输模式

音频传输提供「稳定模式」与「低延迟模式」两种选择：

  • 稳定模式：基于 TCP 协议，会校验并保证数据包的完整性与顺序，抗网络抖动的能力更好。网络条件一般，或进行会议、讲课及重要录音时，建议使用稳定模式以保证声音连续。
  • 低延迟模式：优先使用 UDP 协议，可有效降低端到端延迟。UDP 不会重传丢失的数据包，当 Wi-Fi 信号不稳定或存在干扰时，可能出现偶发卡顿。在靠近路由器、网络质量良好的环境中推荐开启。

麦克风来源

可以指定使用 iPhone 上的底部、听筒或后置麦克风。默认的「自动」会根据设备握持朝向自动选择麦克风。

增益、降噪与自适应增益

  • 增益：控制拾音音量。距离麦克风较远或声音偏小时，可以适当调高。
  • 环境降噪：滤除键盘敲击、空调风扇等持续的背景声。
  • 自适应增益（AGC）：根据说话音量自动平抑输出，使忽大忽小的声音趋于平稳。

无声排查：如果下游 App 没有声音，先检查该 App 的输入设备是否已选为「VioRelay」，再确认 iPhone 端是否处于推流状态。

电脑端参数均衡器

Mac 端内置了参数均衡器（Parametric EQ）。相较于传统只提供单个滑块的简易均衡器，参数均衡器能针对特定频段单独调整，在修正局部声音问题的同时，不影响其他正常频段。

均衡器面板中，每个频段自上而下包含以下四项参数：

  1. 增益（Gain）：控制所选频段的音量大小，单位为分贝（dB）。向上调节为增加音量，向下调节为衰减音量。
  2. 频率（Frequency）：设定调节所作用的中心频点，范围 20 Hz 至 20 kHz。可以定位需要处理的声音频段，例如低频共振或高频细节。
  3. Q 值（频宽）：控制调节影响的频段宽度。Q 值越大，作用范围越窄，适合消除特定的共振杂音；Q 值越小，作用范围越宽，声音过渡相对平缓。
  4. 类型选择（Filter Type）：选择滤波器的曲线形态：
    • 峰值（Bell）：围绕设定频点以钟形曲线提升或衰减，是塑造人声音色最常用的形态。
    • 低架（Low Shelf）/ 高架（High Shelf）：提升或衰减设定频点以下或以上的整个频段，常用于整体调整声音的厚度或明亮度。
    • 低通（Low Pass）/ 高通（High Pass）：滤除高于或低于设定频点的声音，常用于切除多余的高频噪底或低频风声。
    • 陷波（Notch）：在极窄的频点范围内深幅衰减，用于消除特定频率的固定杂音。

快捷按钮

快捷按钮可将 iPhone 屏幕作为 Mac 的辅助控制面板使用。每个按钮均可在 iPhone 端设置外观，并在 Mac 端绑定对应的动作。

在 iPhone 上设置外观

进入 iPhone 设置中的「快捷按钮」，可为每个按钮选择图标、字符与颜色，并调节长按的判定时长。

在 Mac 上绑定动作

在 Mac 端设置中，可为按钮分配以下两种触发模式：

点击模式

单击与长按可分别绑定不同动作，例如唤起系统语音输入法、打开指定 App 或触发全局快捷键。

按住模式

按住 iPhone 屏幕上的按钮时，Mac 端会持续按下指定按键，松开时同步释放。

部分按键动作需要 macOS 辅助功能权限。首次使用时，请在「系统设置 → 隐私与安全性 → 辅助功能」中允许 VioRelay。

与快捷指令和脚本联动

除了全局快捷键和启动 App，快捷按钮还能触发 macOS 快捷指令、运行本地脚本，或配合 MCP 服务做更复杂的自动化。比如一键静音会议、开始语音转录，或是串联一组多步操作。配合这些系统能力，iPhone 不只是麦克风，也是桌面旁的快捷操作板。

默认预设与初始动作

首次安装后，系统默认生效名为 Default 的配置预设，长按判定阈值默认为 0.5 秒：

槽位 按钮名称 触发模式 单击动作（默认） 长按动作（默认）
Slot 0 主页按钮 单击 / 长按 短按右侧 ⌘ Command（语音输入） 回车 Return（发送）
Slot 1 抽屉按钮 1 单击 / 长按 原生 ⌘ Tab 切换应用 确认并提交选择
Slot 2 抽屉按钮 2 单击 / 长按 激活 Ghostty 并开启语音输入 回车 Return（发送）
Slot 3 抽屉按钮 3 单击 / 长按 激活 Xcode 运行快捷键 ⌘R
Slot 4 抽屉按钮 4 单击 / 长按 激活 ChatGPT 并开启语音输入 回车 Return（发送）

配置文件存储路径：~/Library/Application Support/Mici/Automation/profiles.json。你可以直接备份此文件，或通过 MCP 服务随时读取、导出与恢复完整的自动化 Profile 配置。

小技巧：把唤醒语音输入、切换 App、回车、开始/暂停录音这些常用操作，绑定在最容易点到的位置，连按或长按的动作可以用来做撤销或切换模式。

外观与小组件

外观预设与自定义

App 提供多款外观预设，支持调整背景、刻度与指示灯的颜色。在支持 HDR 的屏幕上，电平指示会以更高动态范围显示。

iOS 桌面小组件与灵动岛

在 iPhone 主屏幕空白处长按进入编辑状态，点击左上角的添加按钮，即可添加 VioRelay 桌面小组件。小组件支持查看当前连接的 Mac、推流状态以及使用时长。

关于操作按钮与系统限制的说明：iOS 对后台运行的应用限制较严格，因此小组件上的「开始」与「停止」推流按钮可能响应不快：

  • 「停止」按钮通常可用。
  • 「开始」按钮受系统后台启动麦克风的限制，往往无法及时响应。

因此，桌面小组件目前主要用于查看状态与作为桌面装饰。若要稳定开始推流，请打开 App 操作。锁屏实时活动与灵动岛内的「开始」「停止」按钮同样受上述系统限制。

Mac 桌面小组件模式

Mac 端提供小组件模式。开启后，圆形窗口停留在桌面壁纸之上、常规窗口之下，不遮挡工作窗口，仅显示电平环与连接状态。

横屏界面与 HDR 效果

iPhone 横放时，会自动切换到横屏界面，布局更舒展。支持 HDR 的屏幕上，电平的高光会更透亮。把旧 iPhone 架在支架上，既能看音频状态，也像件安静的桌面摆设。

Mai 印记

Mai 记录麦克风拾音的活动时间：每次开口说话的起止时间，会在主页形成胶囊气泡，并在设置中的花朵图案上留下痕迹。

Mai 仅在本地记录时间点，不记录声音内容，也不上传音频数据，用于统计当日与近期的使用时长。

MCP 与 AI

VioRelay 内建了 Model Context Protocol（MCP）服务。MCP 是一个开放标准，作用是让 AI 助手安全地调用 App 的功能——不用你一层层翻设置，把服务地址和凭证发给支持 MCP 的 Agent，它就能直接读取状态、调节参数或定制外观。

目前兼容 Claude Code、Cursor、Grok Code、Antigravity、PI Agent、DeepSeek 等主流 Agent 工具。用日常语言说一声，剩下的交给它。

给 Agent 的提示词
你现在是我的 VioRelay 配置助手。VioRelay 是本机音频与自动化服务。 我会提供 MCP 地址和 Token，或本机 CLI 的 stdio 启动命令。请把它加入你当前 Agent 的持久 MCP 工具配置，后续对话继续复用，不要只调用一次。 请根据你当前版本和工具特性选择接入方式： 1. 支持现代 per-request MCP / Streamable HTTP，优先使用； 2. 只支持 initialize，使用你实际支持的 legacy 版本，不要改写版本号； 3. 需要 legacy HTTP+SSE，使用服务地址建立 GET/SSE，并使用 endpoint 事件给出的消息地址； 4. HTTP 不适用时使用 stdio。配置入口按当前产品实际支持的格式处理，不要假设其他 Agent 的配置格式。 接入后先做一次只读状态或诊断验证，并简短报告连接方式、协议版本和结果。普通的音频、Profile、主题等用户明确要求的调整可以直接执行；解绑、删除、重置、停用服务或其他不可逆操作，先说明影响并请求确认。根据工具 schema 传参，失败时报告原始错误并尝试一个兼容路径，不要扫描无关目录、输出冗长工具清单或虚构结果。使用 stdio 时，stdout 只输出 JSON-RPC，日志写 stderr。

如何开启：在 Mac 端打开 VioRelay 设置，进入「通用 → AI 与自动化」，开启 MCP 服务，将显示的服务地址与 Token 提供给 Agent 即可。

支持的操作

目前可通过 MCP 完成的操作包括：

音频处理 设备管理 快捷动作 外观定制 连接诊断 配置备份

使用示例

用日常语言描述需求即可，例如：

帮我调一下麦克风：增益调到 4，打开降噪并设成低，再把自适应增益打开，目标设成 16 dB。
除了当前正在推流的那台 iPhone，把其他配对过的设备都删掉。
录音时声音有点卡顿，帮我看看现在的丢包和延迟情况。
参考现在的蓝色皮肤，做一套更干净的纯蓝，不要带粉色，名字叫「纯净蓝」，做完直接换上并打开 HDR。

需要调整什么，说一声就好。

软件更新

Mac 端自动更新

Mac 端支持静默自动更新：

  • 后台下载：开启自动更新后，新版本将在后台静默下载，不干扰当前的音频使用。
  • 进度查看：在圆形窗口的设置按钮左侧，会显示下载进度环。
  • 完成更新：下载完成后，该按钮会变为绿色，点击即可重启应用并完成更新。

常见问题

iPhone 如何连接 Mac？

确认两端处于同一局域网。在 Mac 端点击输入按钮的「+」生成二维码，使用 iPhone 扫描二维码或手动输入 6 位配对码即可。配对一次后，后续会自动连接。

稳定模式与低延迟模式该如何选择？

网络环境一般，或进行重要的会议与长时间录音时，建议保持默认的稳定模式（TCP）；在靠近路由器的良好 Wi-Fi 环境下，若追求更实时的响应，可开启低延迟模式（UDP）。

Mac 应用中找不到 VioRelay 麦克风？

打开 Mac 的「系统设置 → 声音 → 输入」，检查 VioRelay 是否存在。如果没有出现，可在 Mac 端设置中重新安装音频驱动，并重启 Mac。

小组件上的推流按钮点击没有反应？

iOS 对后台应用禁用麦克风有严格限制，小组件上的「开始」按钮可能无法直接启动录音。请直接打开 iPhone App 进行推流操作。

iPhone 找不到 Mac？

先确认两端处于同一局域网。Mac 端保持圆形窗口打开，iPhone 端轻点「开启连接」。如果两端此前未配对过，需要先在 iPhone 上输入 Mac 显示的配对码，完成初次配对。

如果 Wi-Fi 环境不可用，也可以将 iPhone 用数据线连接到 Mac，并开启个人热点，建立有线直连。

快捷按键功能无法触发怎么办？

请先确认 Mac 端的辅助功能权限已正常授予：打开「系统设置 → 隐私与安全性 → 辅助功能」，检查 VioRelay 是否已在列表中并处于开启状态。如果权限配置无误但仍无法触发，可以尝试重启 Mac 端应用，让服务重新加载。

延迟怎么样？

音频走局域网直连，不经过云端，实际延迟取决于 Wi-Fi 质量。靠近路由器、或切换到干扰更少的频段，都会有明显改善。你也可以在设置中开启低延迟模式——音质会有轻微下降，但延迟更低，适合实时交互场景。

它是按住录音，还是持续推流？

VioRelay 的核心模式是持续推流：连接建立后，iPhone 会持续向已配对的 Mac 提供音频，不需要一直按住按钮。这更适合语音输入、会议、录音、直播和视频制作。经过深度优化，持续推流的资源开销极低。你也可以为快捷按钮设置按住触发、松开停止的模式，按需使用。

适合录音和直播吗？

VioRelay 支持 44.1 / 48 kHz、16-bit PCM，单声道与立体声，并在 Mac 上提供系统级虚拟麦克风。iPhone 本身的麦克风素质出色，配合降噪、自适应增益等音频处理，能够满足专业录音和直播的需求。后续还会加入更多专业音频处理效果。最终效果也会受设备摆放、网络环境和所使用软件的影响。

费电吗？

VioRelay 经过深度优化，推流本身的效率很高。大部分资源消耗来自屏幕和可视化效果，不使用时熄灭屏幕，可以有效减少发热和耗电。需要停止时，从锁屏的 Live Activity 卡片按停，或在 App 内断开连接即可。MAI 印记是旁路检测，几乎不增加耗电。

支持哪些设备？

iPhone 需要 iOS 16.2 或更高版本，Mac 需要 macOS 14 或更高版本。支持多台 Mac 与 iPhone 灵活配对，随时切换使用。

声音会被保存下来吗？

不会。音频实时转发，两端都不写入磁盘。MAI 只记录每次拾音的开始与结束时间，保存在 iPhone 本地。详见隐私政策。

还有别的问题？

请发送邮件至 apoptosise@outlook.com。提交诊断信息前，请删除不必要的录音和敏感内容。

更新日志

1.7 (build 19)
  • 进一步降低了低延迟模式下的传输延迟。
  • 针对弱网环境引入新的稳定传输模式，提升传输稳定性。
  • 降低窗口渲染的 CPU 占用，让应用运行更轻量。
1.6 (build 18)
  • 优化了推流时的 CPU 占用，体验更轻量。
  • 修复通过 MCP 切换颜色预设时存在的不同步问题。
1.5 (build 17)
  • 解决了部分内存泄露的问题。

查看完整开源动态与代码提交，请前往 GitHub 仓库。