Qoder插件更新失败等问题可由缓存、元数据损坏、策略不同步或环境不兼容导致，需依次执行强制刷新市场、清除本地安装包、手动安装指定版本、同步服务端策略及切换Runtime Profile五种修复路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder插件过程中遇到更新失败、版本卡滞、界面仍显示旧版标识或功能异常等现象，则很可能是由于插件市场缓存未刷新、本地元数据损坏、服务端策略快照未同步，或IDE运行时环境与新版本不兼容所致。以下是多种可独立执行的修复路径：
一、强制刷新插件市场并重载元数据
JetBrains插件市场客户端会缓存插件索引与版本清单，若缓存过期或校验失败，将无法识别可用更新。该操作不依赖网络代理配置，直接触发本地元数据重建。
1、在IntelliJ IDEA或PyCharm中，依次点击「File > Settings > Plugins」（macOS为「IntelliJ IDEA > Preferences > Plugins」）。
2、点击右上角齿轮图标，选择「Manage Plugin Repositories…」。
3、在弹出窗口中，删除全部现有仓库URL，仅保留官方默认地址：https://plugins.jetbrains.com。
4、点击「OK」后，再次点击右上角「⚙️」图标，选择「Reload plugin list」。
5、等待状态栏提示“Plugin list reloaded”，再搜索「Qoder」，检查是否出现「Update」按钮而非「Installed」。
二、清除插件本地安装包与版本锁文件
Qoder插件安装包（.jar）及版本锁定文件（.lock）若因中断写入而损坏，会导致IDE拒绝加载新版本。该方法绕过市场机制，直接清理残留安装态，确保下一次安装为纯净覆盖。
1、关闭IDE，确认后台无jetbrains-agent或qoder-cli进程残留。
2、定位插件安装目录：
Windows：%USERPROFILE%\.cache\JetBrains\IntelliJIdea2023.3\plugins\qoder
macOS：~/Library/Caches/JetBrains/IntelliJIdea2023.3/plugins/qoder
Linux：~/.cache/JetBrains/IntelliJIdea2023.3/plugins/qoder
3、删除整个qoder文件夹及同级目录下的qoder-*.lock文件。
4、重启IDE，在「Plugins」页面重新搜索并安装Qoder，IDE将从服务器拉取最新完整包。
三、禁用自动更新并手动指定版本安装
当自动更新流程因策略冲突（如租户级策略快照未就绪）被服务端拦截时，可通过手动安装已验证稳定版本绕过校验链。此方式适用于企业内网或灰度发布阶段。
1、访问Qoder官方插件发布页：https://plugins.jetbrains.com/plugin/24829-qoder/versions。
2、查找标记为「Stable」且发布时间早于当前日期的版本（例如v1.0.7），点击右侧「Download」获取.jar文件。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、回到IDE「Plugins」页面，点击右上角「⚙️」图标，选择「Install plugin from disk…」。
4、选中下载的qoder-1.0.7.jar文件，点击「OK」完成离线安装。
5、安装完成后，**不重启IDE**，而是进入「Settings > Tools > Qoder > Advanced」，勾选「Skip version compatibility check on startup」。
四、同步服务端策略快照并重置运行时上下文
Qoder插件版本号仅表征客户端外壳，其真实行为由服务端策略快照控制。若插件已更新但策略仍为v0.9.8，则功能表现与旧版一致。该步骤需确保服务端策略与插件版本语义对齐。
1、登录Qoder管理控制台（console.qoder.com），进入「组织设置 > 策略历史」。
2、查找与当前插件版本匹配的策略快照（例如插件v1.0.7对应策略快照v1.0.7-policy），核对其摘要含「/goal指令增强生效」或「Subagents调度协议升级」。
3、点击该快照右侧「激活此策略」，等待状态栏显示「策略加载完成，所有Agent已切换至v1.0.7运行时」。
4、返回IDE，在Qoder面板右下角点击版本号，选择「Force reload policy now」。
五、切换Runtime Profile以适配新版本依赖
Qoder v1.0+引入对Node.js 20+与Python 3.11+的强依赖，若本地Runtime Profile仍绑定旧版解释器，插件启动时将静默降级并阻止更新流程完成。需显式声明兼容运行时。
1、在IDE中打开「Settings > Tools > Qoder > Runtime」。
2、点击「Edit Profiles」，新建Profile并命名为「qoder-v1.0.7-runtime」。
3、在Node.js字段中指定路径：/usr/local/bin/node20（macOS/Linux）或C:\Program Files\nodejs\node-v20.15.0.exe（Windows）。
4、在Python字段中指定路径：/opt/python3.11/bin/python3或C:\Users\用户名\AppData\Local\Programs\Python\Python311\python.exe。
5、勾选「Use this profile for Qoder plugin updates」，点击「Apply」并重启IDE。
