用途：Portal 将本地编码会话移交到已配对的计算机，relay 作为控制面，配对机作为执行驻留地。可用于主笔记本关闭后继续工作、远程 computer-use 测试等场景。Code Agents 聊天列表支持单条本地聊天或符合条件的本地与 worktree 聊天批量移交。
主要能力：将当前工作树（含已跟踪的未提交改动与未跟踪文件）快照为唯一的 portal/<timestamp>-<id> 分支，不切换、重置、stash 或覆盖源检出；把运行排入已配对的活动主机，运行元数据包含主机、handoff id、分支、提交与 envPolicy: "load-local"；在配对主机上以分离的 Portal worktree 拉取指定提交，保留原有脏 worktree 并新建而非覆盖；启动 runner 前加载配对主机当前的本地环境文件。已存在的聊天可用 Move to Portal 单条或批量移交，转移前会停止本地 runner，推送当前 worktree 且不改变源检出，并把完整文本记录导入配对机同一 run id，目标机执行续接轮而非重放原提示。等待本地审批的聊天会被跳过，因为审批状态是本机局部的。二进制附件正文不会被中继，仅保留名称、文本和明确的省略标记；过大或不安全的上下文会显式失败以便重试。
必要用法：选择 Portal 并保持源目录为带 origin 远程的 Git 仓库；按流程快照、排队、在配对主机拉取并加载本地环境；后续跟进与停止须指向同一主机与远程 run。以 metadata.executionResidence 为准判断运行所在（kind: "portal"、主机 id 与标签、handoff id、源提交、远程工作区路径、环境文件名不含值）。
限制与注意：不要将 .env 内容或凭据复制到源分支或 relay；不要把主笔记本的 cwd 或环境当作远程 cwd；不要仅凭本地推送就报告完成，需确认远程执行驻留与 runner 状态。主机存在但 handoff 停滞时，确认 connector 的 relayUrl 与配对部署同源、修复配对后重启 connector（仅启动时读取 remote-device.json）、确认心跳后重试一次受限运行并读取远程结果；排队成功不等于已启动。具体收费与更多细节暂未提供。