需执行插件版本回退操作：一、服务端策略快照回滚；二、IDE插件运行时重置；三、CLI工具链版本对齐；四、离线ZIP包手动回退安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder插件过程中发现新版本（如v1.3.0）与现有JetBrains IDE环境、团队共享的工程模型或CI/CD中预置的/goal解析逻辑发生不兼容，导致任务拆解失败、上下文丢失或面板无响应，则需执行插件版本回退操作。Qoder插件不提供独立的历史版本安装包直链，其回退依赖服务端策略快照切换、本地运行时强制重载及CLI工具链版本对齐三者协同。以下是经实测验证的回退路径：
一、服务端策略快照回滚（管理员权限必需）
Qoder自v1.0起采用声明式策略分发机制，插件行为（如任务状态机、/goal语义解析规则、Subagents调度逻辑）由云端统一推送。回退本质是将租户级策略恢复至已验证稳定的旧版快照，而非修改客户端二进制文件。
1、登录Qoder管理控制台（console.qoder.com），进入「组织设置 > 策略历史」模块。
2、在时间轴中定位标记为“v0.9.8-stable”或“v1.0.0-rc3”的快照条目，核对其变更摘要是否包含“禁用/enforced goal completion”或“回退Quest状态机至单步确认模式”。
3、点击该快照右侧「激活此策略」按钮，系统将自动触发全量Agent实例热重启，并暂停新任务提交队列。
4、等待控制台状态栏显示“策略加载完成，所有Agent已切换至v0.9.8运行时”，约75秒后IDE内Qoder面板右下角将同步更新版本标识。
二、IDE插件运行时重置（开发者可操作）
当服务端策略已切换但本地JetBrains IDE中Qoder插件仍缓存v1.3.0的上下文工程模型或任务拆解规则时，需强制清除运行时缓存并重新加载策略包，避免本地解析器与服务端语义不一致。
1、在IntelliJ IDEA或PyCharm中，依次点击「File > Settings > Plugins」（macOS为「IntelliJ IDEA > Preferences > Plugins」）。
2、在插件列表中找到「Qoder」，点击右侧齿轮图标，选择「Uninstall and Restart」。
3、重启IDE后，不立即启用插件，而是进入「Settings > Tools > Qoder > Advanced」，勾选「Force reload policy on startup」。
4、点击「Apply」并再次重启IDE，插件启动时将主动向服务端请求v0.9.8策略包，加载完成后面板标题栏将显示“已连接策略版 v0.9.8”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、CLI工具链版本对齐（CI/CD流水线必做）
新版Qoder CLI（如v1.3.0）引入了--task指令替代旧版--run，且默认启用增强型上下文注入，若未同步降级，会导致流水线中qodercli init或qodercli run命令解析失败或触发权限越界校验中断。
1、在CI/CD执行节点上执行卸载命令：npm uninstall -g qodercli 或 pip uninstall qodercli。
2、指定安装历史版本：npm install -g qodercli@0.9.8 或 pip install qodercli==0.9.8。
3、验证版本一致性：qodercli --version 输出应为0.9.8，且命令帮助中不再出现--task选项。
4、将流水线脚本中所有qodercli --run 替换为qodercli --run（保持原指令），并移除任何含/enforce或/subagent参数的调用。
四、离线ZIP包手动回退安装（内网环境专用）
适用于无法访问JetBrains插件市场或需绕过自动更新机制的企业内网环境，通过下载并导入已归档的旧版插件ZIP包实现客户端版本锁定，不依赖服务端策略下发时机。
1、访问Qoder历史版本归档页（https://qoder.com/download#legacy），在IDE插件区域查找并下载Qoder-CN-v0.9.8.zip（注意校验SHA256值：e3a8f2b1...）。
2、启动JetBrains IDE，进入Settings → Plugins界面，点击右上角「⚙️」→ 「Install Plugin from Disk…」。
3、选择已下载的ZIP文件，IDE将提示覆盖安装，点击「OK」确认。
4、安装完成后不重启IDE，而是立即进入「Settings > Tools > Qoder > Advanced」，关闭「Auto-update plugin」开关，防止后台静默升级。
