必须切换至国内镜像节点才能解决QoderWake插件下载卡顿问题。v2.8.0+用户可通过设置面板一键启用阿里云/中科大/清华镜像并测试连接；旧版本需手动修改settings.json指定CDN地址；调试可临时命令行覆盖或离线安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
国内用户安装或更新QoderWake插件时频繁卡在“正在下载依赖包”、进度条长期停滞甚至报错“connection timeout”，根本原因是默认源直连境外GitHub Releases与OSS桶，DNS解析慢、TLS握手失败率高、CDN缓存未命中。必须将资源拉取路径强制切换至国内镜像节点才能恢复稳定下载。
通过设置面板一键启用国内镜像
适用于QoderWake v2.8.0及以上版本，无需编辑配置文件，界面操作全程可视化。
第一步：点击左下角齿轮图标→选择“高级设置”→进入“插件市场配置”子页。
第二步：开启【启用国内镜像加速】开关，此时页面会自动加载预置镜像列表。
第三步：在“镜像源偏好”下拉菜单中依次尝试“阿里云镜像”“中科大USTC镜像”“清华TUNA镜像”，每次切换后必须点击右侧“测试连接”按钮——【不点测试就保存会导致后续所有插件请求仍走原始源】。
第四步：观察测试结果中的“平均响应时间”和“可用性状态”，仅当显示“稳定可用”且延迟≤120ms时才可选中该源。
第五步：点击“应用并重启插件管理器”，等待右上角弹出“插件源已刷新”提示后，立即打开插件市场搜索任意关键词验证是否生效。
手动修改settings.json强制指定镜像地址
适用于v2.7.x及更早版本，或设置面板功能异常、被策略禁用的环境。
关闭QoderWake主程序，确保后台进程完全退出。
定位并打开配置文件：Windows为%APPDATA%\QoderWake\settings.json；macOS为~/Library/Application Support/QoderWake/settings.json；Linux为~/.config/QoderWake/settings.json。
在JSON根对象内添加以下两行（若已有同名字段则直接覆盖）：
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
"extensions.gallery.serviceUrl": "https://qoderwake.cdn.azure.cn/api/gallery"
"extensions.gallery.cacheUrl": "https://qoderwake.cdn.azure.cn/api/gallery/cache"
保存文件前务必检查JSON语法：末尾不能有多余逗号，引号必须为英文半角，【缺少任一引号或错用中文标点将导致QoderWake启动失败】。
重新启动QoderWake，在插件市场搜索框输入“test”，观察浏览器开发者工具Network标签页中请求URL是否已变为qoderwake.cdn.azure.cn域名。
命令行临时覆盖镜像源（调试专用）
方法一：启动时指定参数
在终端中执行：qoderwake --gallery-mirror https://ghproxy.net/https://github.com/qoder-ai/qoderwake/releases/download
方法二：针对离线环境预加载
先在联网机器运行：qoderwake download-bundle --version latest --output ./qoderwake-offline.zip
将生成的ZIP包复制到目标机器，再执行：qoderwake install-offline ./qoderwake-offline.zip
这一步操作起来很简单，直接把ZIP包拖进QoderWake窗口即可触发离线安装流程。
