指南文档
Switcher 是什么
有了 Switcher,就可以在对话界面里而不是终端里与编程智能体协作。智能体的计划、工具执行、改动的文件、审批请求和用量都显示在对话中,发生了什么一看便知。
Switcher 对话可用的引擎有 Claude Code、Codex、Antigravity(agy)、OpenCode 和 GitHub Copilot CLI,其中 Claude Code、Codex、Antigravity 带有 추천(推荐)标记。撤销、目标、附件、响应过程中输入等功能,各引擎支持情况不同;不支持的功能会注明原因。
新建对话
- 在左侧侧栏中打开项目行的
⋯菜单。 - 在 새 세션(新会话)中选择工具。
- 支持 Switcher 的工具分为 CLI 会话和 Switcher 会话两种。选择 Switcher,就会以该工具为引擎,在此项目中新开一个对话。
新对话使用文件夹的默认值;文件夹没有设定时,使用全局默认值。默认值的设定方法见连接与按项目设置中的“Switcher 新对话的默认值”。
对话中的功能
更换模型和推理强度
在输入框上方选择模型和推理强度(Effort)。模型可以在列表中搜索,也可以直接输入 ID。改动从下一条消息开始生效;正在处理响应或审批时不能修改。
推理强度只能在已确认所选模型和执行工具都支持的范围内选择。如果无法确认是否支持,就按工具默认值发送,并给出提示。
更换执行工具
对话可以继续,只把执行工具换成另一个。会话及其关系保持不变,必要时借助原工具的压缩和任务摘要来传递上下文。切换失败或上下文空间不够时,原有会话不受影响。
在手机上,于 대화 모델 바꾸기(更换对话模型)中依次选择供应商 → 工具 → 模型。所选供应商只对此对话生效,项目设置保持不变。
命令菜单
对话中按 Ctrl+/ 打开命令菜单,可以使用 /help、/new、/stop、/model、/status、/search、/copy、/export、/retry、/clear。当前无法执行的命令会附上原因。
对话信息
打开标题栏中的 대화 정보(对话信息),可以在一处查看环境、上下文用量、分支、待办、改动的文件与 diff、子智能体和后台任务。
接着之前的对话
重新打开应用后,Switcher 对话列表和窗口布局会原样恢复。在要继续的对话中点击 재연결(重新连接),即可接着聊。只加载列表时不会启动 CLI。
AI 代码审查
提交之前,可以在 Switcher 的 ⋯ 更多 → AI 코드리뷰(AI 代码审查)中让 AI 审查改动。只有在选好保存了 API 密钥的连接和模型、并点击 리뷰 실행(运行审查)之后,改动内容才会发送到该连接。仅打开或刷新界面不会调用模型。
语音对话
开启 환경 설정 › 음성 대화(偏好设置 › 语音对话)并选择 OpenAI API 连接后,就能用 Switcher 标题栏中的 음성 대화(语音对话)与当前会话语音交流。此功能默认关闭。语音会用您自己的 OpenAI API 密钥直接发送到 OpenAI,费用也由该密钥承担。停止任务和审批操作需要在界面上再次确认才会执行。
编排
使用编排后,一个 Switcher 对话会成为指挥会话(coordinator),创建其他会话作为工作会话(worker)并分派工作。大任务可以拆给多个会话,再在一处统一跟进。工作会话可以汇报结果,也可以向指挥会话提问。
指定指挥会话
- 打开要担任指挥的 Switcher 对话。
- 点击 오케스트레이션 세션으로 지정(指定为编排会话)。
- 在 오케스트레이션 권한 선택(选择编排权限)中选择方式:
- 사용자 승인 후 위임(经用户批准后委派):创建工作会话或发送指令前,先由用户确认。
- 전체 자율 위임 승인(批准完全自主委派):明确委派的输入无需另行审批即可发送。
权限的选择、批准和撤销只能在用户界面中操作。引擎原有的审批规则和工作文件夹限制照常生效,策略加密保存在本机。
工作会话与任务
- 指挥会话可以在已注册的项目中新建工作会话,也可以把以前的会话重新打开作为工作会话。创建时可以指定模型和推理强度。
- 新的工作会话会在侧栏的项目下显示为一行,并以后台 Switcher 标签页打开,不会遮挡当前界面。
- 工作会话忙碌时,发给它的指令和回复会先进入队列,再按顺序送达。
- 指挥会话把用户请求记为 지휘 할 일(指挥待办),并与工作会话的任务关联。工作会话汇报的进度,与指挥会话核实结果后的“完成”分开显示。
仪表板与关系图
在指挥会话中打开 오케스트레이션 대시보드(编排仪表板),可以看到指挥、组长、工作会话的关系图,任务与投递状态,以及决策记录。投递状态只显示到实际确认过的阶段,例如“승인 대기”(等待审批)、“전달 중”(投递中)、“입력 접수 · 완료 미확인”(已接收输入 · 未确认完成)、“실행 여부 불명”(是否执行不明)、“완료”(完成)。无法确定是否已执行的请求,不会自动重发。
编排仪表板和待办在 PWA 和 Android 应用中也能查看和操作。
组长权限
指挥会话可以给直属的工作会话授予组长权限。组长在指定的项目和并发上限内管理自己下属的工作会话。收回权限后,下属会话的对话和运行仍会保留。
委派给其他 PC
也可以在通过侧栏 내 컴퓨터(我的电脑)连接的同一账号其他 PC 上创建工作会话。这时,接收方 PC 也需要设定编排权限。
- 接收方 PC 设为 위임마다 승인(每次委派都需批准)时,要在那台 PC 上批准后才会执行;期限内没有回应则视为拒绝。
- 接收方 PC 设为 자율 위임(自主委派)时,会立即执行。
同一请求只执行一次。即使中途丢失了响应,也会对照那台 PC 的记录确认是否已送达。其他 PC 的版本也需要相同或更高。
清理规则
- 종료(停止)只停掉 Switchboard 启动的进程,对话、恢复信息和关系都会保留。
- 空闲的工作会话默认 15 分钟后结束进程。汇报结果后被自动停止的工作会话,默认 60 分钟后移入归档。
- 正在等待审批、提问或确认的任务不会被自动清理。
- 탭 닫기(关闭标签页)不会结束会话。归档中的会话恢复后也能继续。
在监督方式(经用户批准后委派)下,这些清理操作同样需要用户批准。