应先禁用本地代理与防火墙，再刷新模型元数据缓存，接着切换为HTTP/1.1协议并启用腾讯云DNS，最后降级至本地轻量模型验证通道；四步依次执行可定位并解决“网络请求超时”问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中切换模型时反复收到“网络请求超时”提示，说明客户端未能在规定时间内从服务端获取模型路由响应或权重加载结果。该问题通常由本地网络策略、服务端连接池阻塞或模型元数据同步延迟引发。以下是解决此问题的步骤：
一、检查并临时禁用本地代理与防火墙规则
全局代理、企业级防火墙或自定义hosts重定向会干扰WorkBuddy与调度节点之间的TLS握手及长连接复用，导致模型切换请求在建立阶段即被丢弃或延迟超限。
1、打开WorkBuddy设置界面，进入「网络与代理」选项页。
2、关闭「启用系统代理」及「自动配置代理脚本（PAC）」开关。
3、在Windows系统中，以管理员身份运行命令提示符，执行：netsh winhttp reset proxy；macOS用户执行：networksetup -setwebproxystate "Wi-Fi" off。
4、临时关闭Windows Defender防火墙或第三方安全软件的“网络防护”模块，观察切换是否恢复正常。
二、强制刷新模型元数据缓存并重同步
WorkBuddy客户端本地缓存的模型健康状态、版本号及服务端点信息若陈旧或损坏，将导致调度器错误地向已下线或不可达的节点发起连接，从而触发超时。
1、关闭WorkBuddy主程序，确保所有相关进程已退出。
2、定位元数据缓存路径：Windows为%APPDATA%\Tencent\WorkBuddy\Cache\model_meta\；macOS为~/Library/Caches/com.tencent.WorkBuddy/model_meta/。
3、删除该目录下全部文件，但保留空文件夹结构。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
4、重新启动WorkBuddy，首次切换模型时将强制从etcd配置中心拉取最新元数据，并记录同步完成日志。
三、切换模型路由协议并启用备用DNS解析
默认使用HTTP/2 over TLS的模型路由通道在部分网络环境下易受ALPN协商失败影响；同时，DNS解析若返回非最优CDN节点IP，会导致RTT升高并突破默认5秒超时阈值。
1、进入「设置」→「高级网络」→「模型通信协议」，将当前协议由HTTP/2切换为HTTP/1.1 + Keep-Alive。
2、在同一页面中，启用「强制使用腾讯云公共DNS」选项，其地址为119.29.29.29与182.254.116.116。
3、点击「测试路由连通性」按钮，确认新协议下对workbuddy-scheduler.tencent.com的ping与telnet 443均在800ms内返回成功。
四、降级至本地轻量模型并验证通道可用性
当云端模型切换持续超时时，可绕过远程调度链路，直接调用已预置的本地模型完成基础推理，用于快速验证是否为纯网络层故障而非客户端崩溃。
1、在模型选择面板中，查找并点击混元-Local-Tiny或GLM-4-Flash（二者均支持离线CPU推理）。
2、若本地模型可即时激活且响应正常，则说明问题明确指向云端服务连接；反之则需排查本地SSL证书信任链或时间同步偏差。
3、在终端执行：w32tm /resync（Windows）或sudo sntp -sS time.apple.com（macOS），校准系统时钟误差至±100ms以内。
