Agent Switchboard
下载

语言

所选语言会记录在 Cookie 中。

主题
指南文档

连接手机

手机上能做什么

手机与 PC 连接后,即使人不在电脑前,也可以:

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

为工具新建账号、用新账号发起登录,只能在 PC 上进行。

选择手机应用

应用 状态 获取方式
Web 应用(PWA) 已上线 https://app.switchboard.twentyoz.kr
Android 应用 已上线(APK) 下载页面的 Android 标签页
iPhone 应用 准备中 上线前请先用 Web 应用

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 无法使用系统的安全存储,就不能开启手机连接。

连接方法一:二维码

没有 Google 账号也能用这种方法。

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

二维码 5 分钟内有效,且只能用一次。过期或已用过的二维码,请重新生成。

连接方法二: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 的审批窗口中核对数字:

  • 曾在本机上被断开或登出的设备再次接入时
  • 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 部分,不会发送到服务器。
  • 每次连接,双方都会重新生成会话密钥。中继服务器若从中插手,密钥对不上,连接就会失败。
  • 中继服务器不保存也不积压消息。

处理细节请参阅隐私政策。

管理已连接的设备

在 환경 설정 › 휴대폰 › 연결한 휴대폰(偏好设置 › 手机 › 已连接的手机)中,可以对每台设备进行以下操作。

  • 이름 바꾸기(重命名):只修改本机列表中的名称。
  • 연결 끊기(断开连接):只在本机断开。要重新接入,需要用二维码重新连接,或经过本机的审批窗口。
  • 로그아웃(登出,适用于通过 Google 账号接入的设备):该手机会退出账号,并与同一账号下的所有 PC 断开。
  • 모두 끊기(全部断开):断开所有连接到本机的手机。

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

合并查看多台 PC 的用量

在 환경 설정 › 휴대폰(偏好设置 › 手机)中开启 여러 PC 사용량 합쳐 보기(合并查看多台 PC 的用量)后,按日期、工具、模型、项目统计的 Token 数量会用只有同一账号设备之间知道的密钥加密,保存在账号服务器上。对话内容不会上传。合并结果可以在手机的统计页和 PC 概览的 모든 PC(所有 PC)中查看。

已保存的记录会一直保留,直到您手动删除。要删除,请点击 서버에서 이 PC 기록 지우기(从服务器删除本机记录)或 계정 사용량 기록 모두 지우기(删除账号的全部用量记录)。

自建中继服务器

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

连接不上时,请参阅问题排查。