客户端帮助与故障排查
遇到问题时先查看当前页面的状态和提示，再按下面的步骤操作。排查期间不要卸载后清理应用数据，也不要反复提交可能已完成的保存或删除操作。
常见问题
登录后为什么还要验证手机号？
部分账号或服务站点会要求额外的账号保护验证。若客户端显示手机号验证页，按提示获取验证码，并点 验证手机号并继续；这一步完成后才能进入主界面。没有出现该提示的用户，无需另外寻找绑定入口。验证码发送失败时，记录错误和发生时间，使用页面上的帮助入口或下方联系方式，不要清空应用数据重新注册。
关闭客户端后，哪些功能还可以用？
仅关闭窗口时，应用可能仍在后台运行；完全退出 Lumoswitch 后，本机内置网关和大肥鱼 QQ 连接会停止，依赖它们的请求也无法继续。直接使用 Agent 原生配置连接供应商，或直接调用云端 API 的应用，不依赖桌面客户端常驻；它们仍需有效凭证及可用的模型服务。电脑休眠也会影响本机持续运行的连接，恢复后请检查状态；已手动暂停的大肥鱼仍需你主动连接。
换一台电脑登录，会带过来哪些数据？
在线模型配置等账号数据按服务端提供的范围同步。本机模型连接、玩法设置和记忆、桌宠形象与位置保存在原电脑，不会因为在新电脑登录同一账号而自动搬过去。Agent 原生配置、已安装的 Skills 和 MCP 本地库也要在新电脑分别核对；账号同步不等于整台电脑的备份。暂时不要通过删除原电脑数据来尝试同步。
为什么找不到文档里的按钮？
先在 设置 → 关于 查看客户端版本，再核对文档描述的页面、操作系统和所用站点。新功能会分批发布，社区等在线入口还取决于站点是否已开放。可从官方下载页检查适合本机的版本，保留数据正常升级；更新后仍无入口时，记录版本和页面截图联系支持。不要用旧手动命令强行替代尚未提供的功能。
模型请求失败
- 对在线模型，确认客户端和在线服务可连接；使用本机模型服务时，确认服务已启动且本机端点可访问，本机推理本身不要求互联网。随后检查所选连接、Access Key 和模型配置。
- 若页面提供 检查模型，重新检查；然后用不含敏感内容的短请求验证。
- 如果仍失败，记录错误提示、客户端版本和操作系统，联系支持。
确认结果： 模型检查显示成功，且短请求得到预期回复。检查模型成功不保证第三方 Agent、QQ 或其他外部服务也已连接。
配置已保存，但连接仍需处理
保存配置与连接是两个步骤。回到相应页面查看连接状态，按提示补充凭证、选择模型或点 连接。如果状态显示暂停，确认配置后手动恢复；主动暂停不会自动恢复。
确认结果： 状态明确显示已连接，并在目标服务中完成一次小请求或消息验证。只看到「已保存」不代表已经连接。
更新、恢复与本机数据
正常安装更新会保留原电脑上的本机客户端数据，例如玩法和桌宠设置；这类数据的本机恢复不是云同步。在线模型配置等账号同步内容按其各自页面说明处理。更新前后不要清理应用数据。
如果页面提示正在恢复，等待恢复完成后重新打开相关页面核对当前状态。若操作结果显示待确认或「可能已生效」，不要重复点保存、删除或清空；先离开页面再打开，确认当前内容后再决定下一步。若仍显示恢复失败或数据异常，请停止修改并联系支持。
确认结果： 重新打开页面后能看到预期的设置和明确状态。不要为了排查而删除应用数据；本机恢复不等于保证找回主动删除或清空的内容。
联系支持
在客户端的 设置 → 关于 查看版本信息并使用 联系客服，或打开 Lumoswitch 支持页面。提供客户端版本、操作系统、发生时间、复现步骤和错误提示。截图或日志中可能含有敏感信息，发送前请遮盖 Access Key、QQ 机器人密钥、个人消息和账号标识；无需遮盖排查所需的客户端版本号。请勿在公开社区贴凭证、完整个人聊天记录或未经脱敏的日志。