VS Code离线更新CodeGeex插件操作指南
在完全离线的环境或企业内网隔离的部署场景中，VS Code 的 CodeGeex 插件无法通过市场自动检测更新。唯一可行的方式是用新版 .vsix 文件手动替换并重装——直接点击“更新”按钮必然失败，因为无法访问 Marketplace 接口，且残留的旧插件配置可能阻塞新功能的启用。核心门槛其实就两条：插件版本必须 ≥2.6 才能开启 localMode，安装后必须完全重启 VS Code，确认 codegeex.localMode 设置为 true，同时右下角状态栏图标正常亮起。
确认当前插件版本与适配性
启动 VS Code 后，按 Ctrl+Shift+X 打开扩展面板，搜索 CodeGeex，找到已安装的条目，右下角会显示具体版本号（例如 2.6.0）。如果低于 2.6，说明不支持 localMode 开关，离线 AI 补全完全不可用，必须升级；若已是 2.6 或更高（比如 2.22.3），还需检查新版 .vsix 是否兼容当前 VS Code 版本——例如 VS Code 1.90 要求插件 engines.vscode ≥ "^1.80.0"。在插件详情页点击右上角“⋯”→“Extension Details”，滚动到底部查看 package.json 里的 engines.vscode 字段值，确保版本匹配。
获取新版 .vsix 文件
方法一：通过 Marketplace 官网下载（推荐）
找一台联网机器，打开 CodeGeeX 官方页面，确认发布者是 Zhipu AI、标识符为 aminer.codegeex，然后点击右侧“Download Extension”下载最新版 .vsix（例如 aminer.codegeex-2.22.3.vsix）。
方法二：用直连 URL 下载（适合批量或脚本化操作）
构造直接下载链接：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/aminer/vsextensions/codegeex/2.22.3/vspackage，将末尾版本号换成所需版本即可。该链接不区分操作系统，CodeGeex 插件为通用架构，无需添加 targetPlatform 参数。
⚠️ 注意：避免下载名称中带“Pro”、“Enterprise”或发布者为“CodeGeeX Team”的变体包——这些包不包含 localMode 配置入口，无法在离线模式下使用。
在离线机上执行更新安装
第一步：关闭所有 VS Code 实例（包括托盘中的后台进程），否则插件目录被占用会导致安装失败。
第二步：将新 .vsix 文件复制到离线机的任意路径（例如 /home/user/downloads/），确保路径不含中文、空格或特殊字符。
第三步：启动 VS Code，按 Ctrl+Shift+X 进入扩展面板，点击右上角“⋯”→“Install from VSIX…”，选中刚才的 .vsix 文件，点击 Install。
第四步：安装完成后，VS Code 会提示“已禁用旧版本”，此时必须重启 VS Code 才能激活新版，否则系统仍运行旧逻辑。
操作本身很简单，直接拖入文件即可。但有个易忽略的坑：如果之前装过 Tabby、Continue 或旧版 CodeGeex，系统会自动禁用它们——这是正常行为，无需干预；若未自动禁用，则需手动卸载，否则 Ctrl+Enter 快捷键会被旧插件占用，导致补全功能无法触发。
验证更新是否生效
重启后，按 Ctrl+Shift+P 打开命令面板，输入 Preferences: Open Settings (JSON)，在 settings.json 中查找 "codegeex.localMode" 字段。若存在且值为 true，说明新版加载成功；若字段缺失或值为 false，表明插件未正确识别本地模式，需检查是否安装了非 Zhipu AI 发布的包。
再看右下角状态栏，若出现 CodeGeex 图标（齿轮加闪电组合）表示插件就绪。无图标则说明插件未激活或受策略限制，需确认 VS Code 是否运行在受组策略约束的环境下。