Companion
把 MadoHub iOS 应用与你的 Mac 配对，通过本地网络镜像你的画布。
Companion 通过你的本地 Wi-Fi 把 MadoHub 画布镜像到 iOS 应用上。离开工位也能在手机上盯着你的 Agent；发个快捷按键或启动一个 Flow，不必回到键盘前。
它是局域网镜像，不是云中继。你的画布、Agent、终端输出都不会经过 MadoHub 服务器。Mac 在本地网络上跑一个小服务器，你的手机直接连它，只要两者在同一 Wi-Fi 上就保持同步。
你能用它做什么
- 从手机查看画布 —— 每个框架、图块、Agent 状态、活动行和最近的终端输出尾部，只读形式。
- 打开图块读完整终端详情 —— 手机显示与桌面相同的图块状态（idle、working、waiting、stopped、completed、failed、exited）。
- 向图块发送按键 —— 自由文本，加上
escape、ctrl-c、enter作为特殊键，发送方式与本地输入一致。 - 从手机创建终端或框架 —— 在桌面视口中心开一个新终端，或按路径打开一个工作空间框架。
- 远程运行 Flow —— 从手机带任务 prompt 实例化一个 Flow，桌面会启动它。
- 重置配对 token —— 手机丢失或想重来时，从 Settings 立即让所有已配对设备失效。
如何使用
- 在 Mac 上打开 Settings → General 并启用 Companion。
- 设置面板显示你的 Mac 本地 IP 和端口（例如
192.168.1.23:9280）、一个配对 token，以及一个可复制到手机的madohub://companion?…链接。 - 在手机上打开链接（或在 iOS 应用里手动输入地址和 token）。
- 手机配对并开始镜像画布。Settings 显示当前已连接的设备数。
- 在手机上点图块读详情、向图块发送输入，或用菜单创建终端、打开框架、运行 Flow。
要全部解绑，在 Settings 点 reset token。所有已配对设备立即失效；若服务器在运行，它会在新 token 下重启。
常见用例
- "在沙发上盯着一个长任务 Agent。" —— 打开手机，看图块状态和最近输出，脱轨时发个
ctrl-c。 - "不回工位就启动一个同行评审 flow。" —— 从手机带任务 prompt 运行 Peer review flow。
- "在房间另一头批准权限 prompt。" —— 点图块，发
y或enter给 Agent 解锁。
提示与最佳实践
- 两台设备需在同一 Wi-Fi 上。Companion 不支持跨互联网或跨子网。
- 画布镜像是只读的——你可以查看图块和发送输入，但不能从手机拖图块或重连连接。
- 配对手机丢失或换网络时重置 token。新 token 会立即让所有之前的配对失效。
- 服务器先试 9280 端口，被占用就往上找直到 9299，所以不同机器的端口可能不同——从 Settings 复制链接，别猜。
安全与隐私
- 仅限局域网，无云中继。 你的画布、Agent 和终端输出都留在本地网络；不经过 MadoHub 服务器。
- 配对用 token + 挑战-应答，而不是每次请求带 bearer token。 token 本身不上网；只有对每次连接的全新挑战的加盐应答才上网，所以截获的应答无法用于之后的连接。
- 没有 token 无人能写入。 同一 Wi-Fi 上的被动观察者可以读取镜像流量（目前没有 TLS），但没有 token 无法开自己的认证会话或注入输入。
- 服务器对恶意局域网有自保 —— 最多 64 个并发连接，认证客户端静默 60 秒会被断开，无法无限占用连接槽。
相关功能
- Flows —— 从手机远程运行 Flow。
- Settings —— 启用 Companion 和重置 token 之处。
- Team Collaboration —— 监控团队成员而非你自己的画布。
局限
- Companion 要求两台设备在同一本地 Wi-Fi。目前不支持局域网外（跨互联网）使用。
- 连接没有 TLS。同一局域网上的被动观察者可读取镜像流量；主动中间人攻击尚未处理。
- 画布镜像是只读的——不能从手机拖图块或重连连接。
- Companion 目前要求 Mac 主机。尚无 Windows 主机支持。