必须手动替换新版.vsix文件重装，因marketplace不可达且旧版残留会阻断新功能；版本需≥2.6才支持localmode，安装后须重启vs code并验证codegeex.localmode为true及右下角图标出现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在无网络环境或企业内网隔离场景下，VS Code 中的 CodeGeex 插件无法自动检查更新，必须手动替换为新版 .vsix 文件并完成重装——直接点击“更新”按钮会失败，因为 Marketplace 接口不可达，且旧版插件残留可能阻断新功能启用。
确认当前插件版本与适配性
打开 VS Code → 左侧扩展图标（Ctrl+Shift+X）→ 在搜索框输入 CodeGeex → 找到已安装项 → 查看右下角显示的版本号（如 2.6.0）。若版本低于 2.6，则【不支持 localMode 开关，无法启用离线 AI 补全】，必须升级；若已是 2.6 或更高（如 2.22.3），则需核对新包是否兼容当前 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 是否运行在受限组策略环境下。
