QoderWake插件下载卡顿需切换国内镜像源，可通过修改settings.json配置文件、启用内置镜像切换功能（v2.8.0+）或命令行强制指定--gallery-mirror参数三种方式解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake时遇到插件下载卡顿、进度条停滞或提示“网络连接超时”，则极可能是其默认插件源服务器位于境外，受跨境网络延迟与TLS握手不稳定影响。以下是解决此问题的步骤：
一、修改QoderWake插件源配置文件
该方法通过直接编辑本地配置文件，强制将插件市场请求路由至国内CDN节点，绕过官方海外源的高延迟链路。需定位到QoderWake的用户配置目录并手动替换服务地址。
1、关闭QoderWake主程序，确保后台进程已完全退出。
2、进入用户配置目录：Windows系统下为 %APPDATA%\QoderWake\settings.json；macOS系统下为 ~/Library/Application Support/QoderWake/settings.json；Linux系统下为 ~/.config/QoderWake/settings.json。
3、用文本编辑器打开 settings.json 文件，在根对象内添加或修改以下两个字段：
"extensions.gallery.serviceUrl": "https://qoderwake.cdn.azure.cn/api/gallery"
"extensions.gallery.cacheUrl": "https://qoderwake.cdn.azure.cn/api/gallery/cache"
4、保存文件，注意确认 JSON 格式合法，无多余逗号或引号缺失。
5、重新启动QoderWake，进入插件市场搜索任意插件验证请求域名是否已切换至 qoderwake.cdn.azure.cn。
二、启用内置镜像源切换功能（v2.8.0+版本）
新版QoderWake已集成镜像源智能识别模块，可自动探测当前网络环境并推荐最优国内镜像，无需手动编辑配置。该功能依赖于运行时网络连通性检测与预置镜像列表匹配。
1、点击左下角设置图标，选择“高级设置” → “插件市场配置”。
2、开启“启用国内镜像加速”开关。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在“镜像源偏好”下拉菜单中，依次尝试选择：阿里云镜像、中科大USTC镜像、清华TUNA镜像，每次切换后点击“测试连接”。
4、观察右侧显示的“平均响应时间”与“可用性状态”，选择标记为“稳定可用”且延迟低于120ms的镜像源。
5、点击“应用并重启插件管理器”，等待界面右上角提示“插件源已刷新”。
三、通过命令行强制指定镜像源启动
该方式适用于配置文件被锁定、多用户共用环境或需临时验证特定镜像性能的场景。启动参数优先级高于配置文件，可覆盖已有设置。
1、打开终端（Windows使用PowerShell，macOS/Linux使用bash/zsh）。
2、进入QoderWake安装目录，例如Windows下：cd "C:\Program Files\QoderWake"。
3、执行带镜像参数的启动命令：
Windows PowerShell：.\QoderWake.exe --gallery-mirror https://mirrors.aliyun.com/qoderwake/
macOS：./QoderWake.app/Contents/MacOS/QoderWake --gallery-mirror https://mirrors.ustc.edu.cn/qoderwake/
Linux：./qoderwake --gallery-mirror https://mirrors.tuna.tsinghua.edu.cn/qoderwake/
4、启动后立即打开插件市场，检查网络面板中所有请求是否均指向所指定镜像域名。
