MadoHub Docs

Mac Companion

通过 MadoHub Cloud 或加密的本地配对,把 iPhone、iPad 连接到兼容的 Mac。

Companion 可以把 Mac 上的 MadoHub 画布带到 iPhone 或 iPad。离开键盘后,你仍能查看桌面 Agent 状态、阅读终端输出,并发送支持的操作。手机 Agent 工作台也可以独立使用。

Mac 需要运行兼容版本的 MadoHub,并开启 Companion。远程使用期间,请让 Mac 保持唤醒、联网,且应用正在运行。可用操作取决于所连接的 Mac。

通过 MadoHub Cloud 连接

  1. 在 Mac 和手机上登录同一个 MadoHub 账号。
  2. 在 Mac 的设置 → 通用中启用 Companion,保持应用打开。
  3. 在 iOS 的设置 → Mac 连接中启用自动连接同账号 Mac。需要时,从列表选择在线的 Mac。
  4. 等待状态显示已连接,再使用桌面画布和操作。

这种方式通过 MadoHub Cloud 中继设备状态和操作,两台设备可以使用不同网络,但都需要联网。从 iOS 1.1 开始,未保存偏好的用户默认不自动发现 Mac;已有选择会保留。

在 iOS 1.1.2 中,从设备列表选择要控制的 Mac,应用会为后续云端连接记住选择。所选 Mac 离线时,需要你主动选择另一台在线 Mac,应用不会自动切换控制目标。Mac 重新注册连接后,可能需要再次选择。

在本地网络配对

  1. 让两台设备连接同一 Wi-Fi,在 Mac 的设置 → 通用中显示 Companion 配对二维码。
  2. 在 iOS 打开设置 → Mac 连接 → 扫描二维码,或把完整配对链接粘贴到本地连接输入框。
  3. Mac 如果弹出授权请求,请核对账号和设备信息,再决定是否允许。
  4. 等待连接状态确认本地加密连接已建立。

请使用 Mac 生成的完整配对码,其中包含加密连接所需的身份信息,仅填写地址和端口不足以完成配对。旧协议链接需要重新生成。只有选择扫码时才需要摄像头权限。

使用已连接的 Mac

点桌面图块查看终端详情,发送文本或支持的按键操作。批准或停止任务之前,请检查目标及当前提示。所连接 Mac 名称下的操作可以创建桌面终端、打开工作空间或运行可用的桌面 Flow。

手机 Agent 与镜像的桌面图块分别继续各自任务。连接 Mac 不会把整份手机本地对话历史复制到桌面。手机未提供的桌面布局修改,请在 Mac 上完成。

在 iOS 1.1.2 中,宽终端内容可以横向滚动;如果希望长行适应屏幕,可开启自动换行。长时间运行的流式回复在连续更新时自动保持最新内容可见。

排查连接问题

情况建议检查
找不到在线 Mac是否为同一账号、Companion 是否开启、Mac 是否唤醒、应用是否打开、网络是否可用
云连接持续重试确认两端联网,再点重试;处于同一 Wi-Fi 时可尝试本地配对
本地配对失败允许本地网络访问,检查 Wi-Fi 隔离或 VPN 设置,重新扫描完整的新二维码
提示协议或身份不匹配更新两端到兼容版本,再使用当前 Mac 的配对码重新配对
无法使用摄像头为扫码允许摄像头权限,或改为粘贴配对链接

只使用手机工作台时,可以关闭自动连接。旧版如果仍显示发现失败的提示,关闭后重新打开应用。

断开连接与管理可信设备

关闭自动连接会停止云端发现和自动云连接。当前本地连接可使用断开本地连接。忘记这台 Mac只移除当前手机保存的配对,不会撤销 Mac 上的授权。需要撤销可信设备时,在 Mac 的可信设备列表中移除它。

隐私与支持

本地配对使用加密连接,并根据配对码校验 Mac 身份。云连接会通过 MadoHub Cloud 传递桌面状态、终端片段和请求操作。处理及保留规则见隐私政策。

仍无法连接时,联系 [email protected],提供两端应用版本和错误提示。截图请隐藏私人输出,不要发送密码或配对链接。

On this page