Mac Companion
通过 MadoHub Cloud 或加密的本地配对,把 iPhone、iPad 连接到兼容的 Mac。
Companion 可以把 Mac 上的 MadoHub 画布带到 iPhone 或 iPad。离开键盘后,你仍能查看桌面 Agent 状态、阅读终端输出,并发送支持的操作。手机 Agent 工作台也可以独立使用。
Mac 需要运行兼容版本的 MadoHub,并开启 Companion。远程使用期间,请让 Mac 保持唤醒、联网,且应用正在运行。可用操作取决于所连接的 Mac。
通过 MadoHub Cloud 连接
- 在 Mac 和手机上登录同一个 MadoHub 账号。
- 在 Mac 的设置 → 通用中启用 Companion,保持应用打开。
- 在 iOS 的设置 → Mac 连接中启用自动连接同账号 Mac。需要时,从列表选择在线的 Mac。
- 等待状态显示已连接,再使用桌面画布和操作。
这种方式通过 MadoHub Cloud 中继设备状态和操作,两台设备可以使用不同网络,但都需要联网。从 iOS 1.1 开始,未保存偏好的用户默认不自动发现 Mac;已有选择会保留。
在 iOS 1.1.2 中,从设备列表选择要控制的 Mac,应用会为后续云端连接记住选择。所选 Mac 离线时,需要你主动选择另一台在线 Mac,应用不会自动切换控制目标。Mac 重新注册连接后,可能需要再次选择。
在本地网络配对
- 让两台设备连接同一 Wi-Fi,在 Mac 的设置 → 通用中显示 Companion 配对二维码。
- 在 iOS 打开设置 → Mac 连接 → 扫描二维码,或把完整配对链接粘贴到本地连接输入框。
- Mac 如果弹出授权请求,请核对账号和设备信息,再决定是否允许。
- 等待连接状态确认本地加密连接已建立。
请使用 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],提供两端应用版本和错误提示。截图请隐藏私人输出,不要发送密码或配对链接。