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