客户端使用指南
Lumoswitch 把模型连接、Agent 配置和常用 AI 工具集中到一个桌面应用中。你可以在工作区完成任务，也可以给已经使用的 Agent 配置模型、Skills 和 MCP。
第一次使用，从完成第一个任务开始。已有 Agent 的用户可以直接看 Agent 管理。
选择你要做的事
| 你的目标 | 打开哪里 | 使用指南 |
|---|---|---|
| 接入自己的模型供应商，或选择平台模型 | 模型 | 本机与在线连接 |
| 给 Codex、Claude Code 等工具配置模型 | Agent | 发现、安装和配置 Agent |
| 在项目里完成一个 AI 任务 | 工作区 | 任务、确认和结果检查 |
| 为工作区或外部 Agent 添加可复用能力 | Skills | 安装与使用 Skills |
| 为 Agent 配置工具服务 | MCP | 配置 MCP |
| 在 QQ 私聊或群聊中使用大肥鱼 | 玩法 | 配对、性格与记忆 |
| 调整桌面上的小伙伴 | 设置 → 桌宠 | 桌宠设置 |
| 更新应用或处理错误 | 对应功能页、帮助入口 | 帮助与更新 |
先分清三个概念
- 本机配置：连接与路由由这台电脑管理。如果选择的是云供应商模型，请求仍会发送给供应商，不等于离线推理。
- 在线配置：使用 Lumoswitch 在线服务管理的连接。平台模型与自带供应商 Key 的费用规则不同，以连接和账单页面为准。
- Agent 配置：把选定连接应用到某个工具。发现了一个 Agent，不代表客户端支持安装它或写入它的全部设置。
使用本机内置网关时，要保持 Lumoswitch 运行。仅关闭窗口和彻底退出应用不是一回事，详见模型连接。
适用范围
本组文档面向桌面客户端，不能替代移动端操作说明。功能入口会受客户端版本、操作系统、部署站点以及目标 Agent 支持情况影响；没有看到相应入口时，先核对版本和页面提示，不要照旧命令强行修改配置。
中文、英文是文档语言；CN 与 GLOBAL 是服务部署版本，两者不是同一概念。登录方式、支付和部分服务是否提供，以当前站点和客户端实际显示为准。
核对版本与功能入口
先在 设置 → 关于 查看版本。下面的入口可用于判断当前客户端是否已经提供相应功能；功能会分批更新，网页端能力还取决于所用站点是否开放。
| 想使用的功能 | 在当前版本中检查 |
|---|---|
| 本机模型路由 | 模型 → 本机 是否有 添加模型 和 已接入的平台；下方直连配置区是另一种接入方式 |
| QQ 大肥鱼 | 玩法 中是否有创建大肥鱼的入口，并能选择可用的对话模型 |
| 社区桌宠 | 社区 → 桌宠 或 设置 → 桌宠 → 发现更多 是否可用；网页发布以站点实际提供的入口为准 |
入口缺失时，按帮助页的版本检查步骤处理。现有配置可以继续保留，不需要为了跟随新指南而清空数据。
已有连接与旧教程
云端 API 仍可使用，相关说明在云端快速开始、配置 API和 API 参考中保留。
旧手动 Agent 接入教程保留原有内容和地址，供维护已有接入使用；新的连接优先在客户端中完成。不要为了跟随新教程而先删除已有配置或应用数据。