连接手机

在手机上可以做什么

与 PC 连接的手机可以执行以下操作。

• 查看已连接 PC 的项目和会话列表
• 查看并输入应用内的终端
• 阅读 Switcher 对话、发送消息、回复审批请求
• 打开新会话、继续以前的会话、重命名和归档会话
• 修改各项目的工具、连接和模型设置
• 查看多台 PC 的用量统计

为工具创建多个账号以及发起这些账号的登录，只能在 PC 上进行。

选择手机应用

Web 应用

在手机浏览器中打开 https://app.switchboard.twentyoz.kr，无需安装即可使用。通过浏览器菜单中的 添加到主屏幕，可以像应用一样放在主屏幕上。

Android 应用

1. 在下载页面选择 Android 标签页，获取 Agent-Switchboard-Android-<버전>.apk（<버전> 表示版本号）。
2. 打开下载的文件进行安装。如果浏览器或文件应用弹出是否允许安装的提示，请选择允许。

如果之前安装过使用其他签名构建的 APK，新的 APK 无法覆盖安装。此时请卸载现有应用，安装新的 APK，然后重新连接 PC 并重新进行 Google 登录。

在 PC 上开启手机连接

手机连接默认关闭。

1. 在 PC 上打开 환경 설정 › 휴대폰（偏好设置 › 手机）。
2. 打开 휴대폰 연결 켜기（开启手机连接）。

开启后，PC 只向中继服务器发起出站连接，不会在 PC 上开放端口。如果 PC 无法使用操作系统的安全存储，就无法开启手机连接。

连接方法 1：二维码

这是无需 Google 账号的方法。

1. 在 PC 的 환경 설정 › 휴대폰 › 새 휴대폰 연결（偏好设置 › 手机 › 连接新手机）中点击 연결 QR 만들기（生成连接二维码）。只有在连接到中继服务器后才能生成二维码。
2. 在手机应用的 PC 연결（连接 PC）中点击 QR 코드 스캔（扫描二维码），扫描 PC 屏幕上的二维码。如果无法使用相机，请在 PC 上点击 주소 복사（复制地址），然后在手机上使用 연결 링크 붙여넣기（粘贴连接链接）。
3. 手机上会显示 6 位数字。确认与 PC 上弹出的审批窗口中的数字一致后批准。

二维码仅在 5 分钟内有效，且只能使用一次。超时或已使用过的二维码，请重新生成。

连接方法 2：Google 账号

PC 和手机登录同一个 Google 账号后，无需二维码即可连接。

1. 在 PC 上通过左下角的账号菜单或侧栏的 내 컴퓨터（我的电脑）使用 Google 登录。也可以在 偏好设置 › 手机 的 Google 계정 · PC 목록 동기화（Google 账号 · PC 列表同步）中查看状态。
2. 在手机应用中登录同一个 Google 账号。
3. 手机上会显示该账号下的 PC 列表，已关机的 PC 也会显示。点击要连接的 PC，无需二维码即可连接。

设置是否无需审批即可接入

在 환경 설정 › 휴대폰 › 대시보드·세션 접근 권한（偏好设置 › 手机 › 仪表板与会话访问权限）中设置。

• 같은 계정 휴대폰·웹 자동 허용（自动允许同一账号的手机与 Web）：开启后，以同一 Google 账号认证的新手机无需数字确认即可连接。关闭后，首次连接时需要在 PC 上批准。
• 같은 계정 다른 PC 자동 허용（自动允许同一账号的其他 PC）：设置同一账号的其他 PC 在侧栏 我的电脑 中打开本 PC 时，是否省略审批窗口。已连接的 PC 可以向本 PC 的终端输入内容。请仅在只使用自己管理的 PC 时开启。

即使开启了自动允许，以下情况仍需经过 PC 的审批窗口（数字确认）。

• 在本 PC 上断开连接或被登出的设备再次接入时
• 1 小时内试图自动注册超过 3 台不同的设备时

有新的账号设备接入时，会通过 PC 通知和活动记录告知您。

由 PC 直接确认连接

账号服务器只保存 PC 列表，不授权连接。手机发送的 Google 登录凭证由 PC 直接验证。因此，即使账号服务器上的列表被篡改，PC 的终端权限也不会被转移。

接收通知

Android 应用可以接收等待审批、任务完成和错误的通知。在手机应用中注册通知后，在 PC 的 환경 설정 › 휴대폰 › 연결한 휴대폰（偏好设置 › 手机 › 已连接的手机）中按设备开启或关闭 작업 완료 알림（任务完成通知）。审批请求、新设备连接和错误通知会持续发送。

通知内容由 PC 使用手机生成的设备专用密钥加密后发送。中继服务器以及 Apple、Google 的推送服务只能看到推送令牌和密文。如果手机无法解密通知，会显示“有需要确认的事项”这一固定文字。对于已打开应用并处于连接状态的设备，不会发送通知。

中继服务器能看到什么

手机与 PC 之间的内容采用端到端加密。中继服务器只转发密文。

服务器看不到的内容

• 终端的输入和输出
• Switcher 对话内容
• 配对密钥和会话密钥
• API 密钥和 OAuth 令牌
• 电子邮件地址和 Google 令牌（确认登录时会接收，但不保存）

服务器处理的内容

• 访问 IP 地址（用于防止滥用和访问记录）
• PC 房间标识符（由 PC 公钥生成的值）、加密数据的大小和时间
• 使用 Google 账号时：账号标识符、PC 公钥、名称、最后访问时间，手机设备 id、名称、平台，会话哈希
• 开启用量同步时：加密的月度用量数据包

加密方式

• 二维码中的一次性密钥位于地址的 fragment 中，不会发送到服务器。
• 每次连接时，双方都会生成新的会话密钥。如果中继服务器从中介入，密钥将不匹配，连接会失败。
• 中继服务器不存储也不积存消息。

详细的处理内容请参阅隐私政策。

管理已连接的设备

在 偏好设置 › 手机 › 已连接的手机 中，可以对每台设备执行以下操作。

• 이름 바꾸기（重命名）：只在本 PC 的列表中更改。
• 연결 끊기（断开连接）：只在本 PC 上断开。要再次接入，需要通过二维码重新连接，或经过本 PC 的审批窗口。
• 로그아웃（登出，适用于通过 Google 账号接入的设备）：该手机会从账号中登出，并从同一账号的所有 PC 上断开。
• 모두 끊기（全部断开）：断开连接到本 PC 的所有手机。

데스크톱 신원을 새로 만들면（重新生成桌面身份后），所有已连接的手机都会断开，桌面指纹也会改变，同时会从 Google 账号中登出。

合并查看多台 PC 的用量

开启 偏好设置 › 手机 中的 여러 PC 사용량 합쳐 보기（合并查看多台 PC 的用量）后，会将按日期、工具、模型、项目统计的 Token 数量，用只有该账号下设备之间知道的密钥加密后保存在账号服务器上。不会上传对话内容。可以在手机统计和 PC 概览的 모든 PC（所有 PC）中合并查看。

已保存的记录会一直保留，直到被删除。可通过 서버에서 이 PC 기록 지우기（从服务器删除本 PC 的记录）或 계정 사용량 기록 모두 지우기（删除账号的全部用量记录）删除。

自行运营的中继服务器

默认使用官方中继服务器和官方手机应用地址。在 환경 설정 › 휴대폰 › 주소（偏好设置 › 手机 › 地址）中，可以改为自行运营的中继服务器（wss:// 地址）和手机应用（https:// 地址）。清空后保存即可恢复为官方地址。手机应用地址请只填写可信任的来源，因为该地址上的应用将能够向本 PC 的终端输入内容。

如果无法连接，请参阅问题排查。