Agent Switchboard
下载

语言

所选语言会记录在 Cookie 中。

主题
指南文档

安装与首次运行

支持的系统

Agent Switchboard 支持以下三种环境。

操作系统 架构 安装文件
Windows x64 Agent-Switchboard-Setup-<버전>-x64.exe, Agent-Switchboard-Portable-<버전>-x64.exe
macOS Apple Silicon (arm64) Agent-Switchboard-<버전>-mac-arm64.dmg, ZIP
Linux x64 Agent-Switchboard-<버전>-linux-x86_64.AppImage, Agent-Switchboard-<버전>-linux-amd64.deb

(文件名中的 <버전> 代表版本号。)

macOS 版仅支持 Apple Silicon,不提供 Intel Mac 版本。

安装文件请到下载页面获取,页面会优先显示您当前所用系统的文件。

Windows

Setup 还是 Portable

  • 推荐 Setup(Agent-Switchboard-Setup-…exe)。安装后,新版本可以直接在应用内下载安装。
  • Portable(Agent-Switchboard-Portable-…exe)免安装即可运行,但无法在应用内安装更新。有新版本时,需要到下载页面重新下载。

SmartScreen 警告

Windows 安装文件目前还没有 Authenticode 代码签名,所以下载或首次运行时,Windows SmartScreen 可能提示“无法识别发布者”。

  1. 确认文件来自官方下载页面(switchboard.twentyoz.kr)。
  2. 在警告窗口中点击 更多信息,再点击 仍要运行。

安装后通过应用内获取的更新会单独校验:应用用内置公钥核对更新策略的签名和安装文件的 SHA-512 哈希,校验通过才会安装。不过,这项校验并不能代替操作系统的代码签名。

macOS

  1. 打开 …-mac-arm64.dmg 文件。
  2. 把 Agent Switchboard 拖进“应用程序”文件夹。
  3. 在“应用程序”文件夹中启动应用。

macOS 版在发布前经过 Developer ID 签名和 Apple 公证(notarization),也通过了 Gatekeeper 校验。只要是从官方下载页面获取的,就能像普通应用一样直接打开。

Linux

AppImage

AppImage 无需安装,添加执行权限即可运行。

chmod +x Agent-Switchboard-<버전>-linux-x86_64.AppImage
./Agent-Switchboard-<버전>-linux-x86_64.AppImage

.deb(Debian、Ubuntu 系)

sudo apt install ./Agent-Switchboard-<버전>-linux-amd64.deb

安全存储(keyring)

API 密钥加密保存在系统的安全存储中,因此 Linux 上需要有 Secret Service 之类的桌面 keyring。keyring 不可用时,应用不会改用明文保存,而是在 API 密钥连接的 저장 후 적용(保存并应用)按钮上方说明无法保存的原因。启用 keyring 后请重启应用。手机连接同样要有安全存储才能开启。

首次运行

第一次打开应用,会看到左侧的侧栏和右侧的工作区。按下面的顺序开始即可。

  1. 添加项目文件夹:点击左侧侧栏底部的 폴더 추가(添加文件夹)图标,选择要工作的文件夹,随后会打开该文件夹的项目首页。
  2. 注册连接:打开侧边栏底部的 환경 설정(偏好设置,快捷键:Windows 和 Linux 为 Ctrl+,,macOS 为 ⌘,),在 연결 · 인증(连接与认证)中注册 API 密钥或网关。如果只用订阅登录(OAuth),可以跳过这一步。
  3. 应用到工具:在项目首页的 도구 설정(工具设置)中选择工具,设定连接和模型。具体方法见连接与按项目设置。
  4. 运行:可以在项目首页的标题栏直接启动工具,也可以在侧栏的项目菜单 ⋯ → 새 세션(新会话)中选择工具。默认在应用内的终端标签页中运行。

应用内的 도움말(帮助)→ 처음 연결하기(首次连接)也按同样的顺序做了说明。

Agent Switchboard 并不取代 Codex、Claude Code 等编程智能体 CLI。它会检查工具是否已安装,未安装的工具会指引您按官方方式安装。

自动更新

何时检查

  • 应用启动约 2.5 秒后检查新版本。
  • 应用运行期间每 15 分钟检查一次。
  • 从睡眠中唤醒 5 秒后再检查一次。
  • 随时可以点击顶部的下载图标手动检查。

更新从官方服务器(https://switchboard.twentyoz.kr/releases)下载,不需要账号或访问令牌。

发现新版本时

  1. 从 업데이트 다운로드(下载更新)、이번 버전 건너뛰기(跳过此版本)、나중에(稍后)中选择一项。
  2. 下载在后台进行,会显示进度、大小和速度,中途也可以取消。
  3. 下载完成后不会立即安装。点击 재시작하여 설치(重启并安装)并再次确认后,应用才会退出并安装。

选择 나중에(稍后)后,本次运行期间 4 小时内不再提醒。手动检查时,暂缓和跳过的版本都会重新显示。在更新窗口中可以查看截至所跳过版本的更新日志。

各系统的更新方式

安装形式 应用内自动安装
Windows Setup 支持
Windows Portable 不支持。请到下载页面获取新文件
macOS(已签名应用) 支持。安装校验完成后退出;出错或超过 120 秒未完成时可以重试
Linux AppImage 支持。旧版退出后启动新版
Linux .deb 支持。安装时会弹出管理员权限窗口

安装失败时,更新窗口和重启确认窗口会显示原因。解决办法见问题排查。