跳到主要内容
云猴智能体云猴智能体
下载 Kaya
本页内容

跨机协同

同一账号下的两台 Mac / PC 可以互相派活：在 A 机的聊天或 ToDoList 里把任务交给 B 机上正在运行的编程 Agent，B 机的状态、证据与授权请求实时回传。远程实例带设备名徽标出现在侧栏与 @ 菜单里。

开启路径#

  • 两台设备登录同一 yunhou 账号；跨机协同复用远程访问的 relay 连接，各机需要有效订阅。

  • 在执行端打开 ⚙ 设置 → 跨机协同，开启总开关，把发起端设备加入白名单，并可进一步圈定可访问的 Agent。

  • 发起端在 ToDoList 任务上选择远程目标（设备 + Agent）并派发；写入对端终端前仍需授权。

点击远程卡片会选择该 Agent 并绑定当前 Chat，本机终端标签页保持不变。远程卡片不提供任意按键或运行时配置修改。

权限与隐私边界#

  • 执行端准入 fail-closed，默认关：总开关与逐设备白名单共同控制接收任务和执行控制；未准入的执行请求会被拒绝。开启远程访问后，设备发现与状态摘要仍会在同账号设备之间流动，不受此执行准入开关隔离。

  • 白名单存于 ~/.kaya/remote/peers.json（0o600）；文件损坏按默认关闭处理。

  • 授权双端可批，权威在执行端：授权卡两端同时显示，任一端批准即生效，可记住「该设备免再问」。

  • 派发文本作为编程 Agent 的输入提交，控制字符会被拒收。

  • relay 是哑管道：设备帧经同一条 relay 中转，不解析、不落盘 payload；帧内容离机前经过输出脱敏。

  • 功能依赖 yunhou relay 的设备路由与发送方身份盖章；服务端不支持时，设备互相不可见，客户端开关不会自行建立通路。

**当前菜单的一次性答复：**双方版本支持时，可在侧栏或 Chat 待决卡对远端当前菜单选择 1–9。同一请求只能答复一次，只针对本次菜单与当前实例；已过期、已回答或实例更换后不能继续写入，本机回答或已授权写入处理后旧答复同样失效。超时会显示结果未确认，不会自动重发；旧版本会提示升级。此入口不提供任意按键或运行时配置修改。

按需查看远程画面或报告#

执行端允许对话中转、发起设备已获得相应准入且双方版本支持时，可以按需查看圈定 Agent 的远程画面或报告，无需调用对端模型。读取仍受准入范围和当前实例约束；输出经脱敏，单次最多 8 KiB，切换实例后会清除旧输出。

断线语义#

对端离线时条目显示「重连中」。重连后自动对账仍在运行、已退出或授权待决的任务；确认仍在运行的任务不会重复派发。对端任务记录丢失时如实归因，可以手动重试或标记完成。

**页面恢复与迟到状态：**页面重载后会按设备恢复连接；设备当前没有 Agent 时，随后出现的实例也能更新。重连后的状态快照会与实时更新衔接，旧连接或迟到消息不会覆盖当前实例，也不会把已退出、离线或已换代的旧状态重新显示为活动。

在聊天里询问或转达#

接收端还需要在该设备的准入项里单独允许 对话中转，默认关闭。

开启后，发起端可以在聊天里 @ 远程 Agent，由对端 Kaya 查询圈定范围内的 Agent 状态、报告与终端屏尾，或经授权转达指令：

  • 不开放 shell、文件修改、记忆写入或联网搜索工具。

  • 工具执行时重新检查当前运行实例的读取权限，不注入全机 Agent / 任务态势。

  • 两端都显示带设备来源的对话；发起端只接收最终回复，不逐字转播对端思考与工具输出。

  • 离线、拒绝或超时都会显示终态；ToDoList 派发仍走独立的任务与授权流程。

下一步#