跨设备连接

从另一台设备连接

1. 在执行任务的机器上完成安装与接入，保持机器开机、联网。
2. 打开 Paseo 网页版或支持 Ginit 接入的 Paseo 客户端，使用同一飞书账号登录。
3. 在主机列表中找到这台机器，点击连接，再打开对应工作区查看任务。

每台执行任务的机器都需要分别安装和接入。手机或另一台电脑作为查看端时，不需要复制整个项目。

任务在哪里运行

任务始终运行在你选择的主机上。Ginit 帮助客户端发现账号下的主机，Relay 转发客户端与主机之间的加密连接。

主机会主动连接服务，通常不需要公网 IP、入站端口映射或 SSH。主机仍需要能够访问相关服务；完全离线时无法远程连接。

已有服务重新接入

本机已经安装 Paseo，但还没有接入当前 Ginit 账号时，可在执行任务的机器上运行：

ginit paseo attach
ginit paseo status

ginit paseo attach 用于接入主机；常用命令中的 paseo attach AGENT_ID 则用于打开某个 agent 的交互界面。

需要解绑设备时，先通过 ginit paseo status 确认设备 ID，再运行：

ginit paseo detach --device-id <id>

历史会话与自动归档

安装时会按 workspace 导入 ~/.claude/projects/ 中已有的 Claude 会话；使用 --no-history 可跳过这一步，见可选安装参数。

安装写入的 Claude Stop hook（~/.local/share/paseo-hooks/paseo-auto-import.sh）用于在会话结束时自动归档，方便从其他客户端回看。安装时的历史导入与后续 Stop hook 归档是两个环节。

看不到主机或无法连接

先核对两端是否登录同一飞书账号，再检查执行机器是否开机联网，以及 ginit paseo status 的连接状态。进一步排查见配置与排查。