Fitten Code 插件在 VS Code 1.85+ 版本中因 engines.vscode 字段校验被静默禁用，需通过 Marketplace 安装兼容版本或离线修改 .vsix 中的 engines 字段，并同步远程组件版本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
VS Code 更新后 Fitten Code 插件突然消失、右键无响应、命令面板搜不到、状态栏不显示图标——这些不是插件损坏，而是 VS Code 1.85+ 版本强制校验 engines.vscode 字段导致的兼容性拦截，旧版插件因声明版本低于当前 VS Code 而被静默禁用或根本无法安装。
确认插件是否已被自动禁用
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Extensions: Show Installed Extensions；
点击右上角筛选器，选择 Disabled；
若 Fitten Code 出现在该列表中，且详情页顶部明确标注 Disabled，说明它已被引擎校验机制拦截；
此时不要点击“启用”，因为 VS Code 会立即再次禁用——它只认 package.json 中的 engines.vscode 声明值，而非 UI 状态。
从 Marketplace 安装匹配的历史版本
打开 Fitten Code 的 Marketplace 页面，例如：
https://marketplace.visualstudio.com/items?itemName=fitten.fitten-code
在 URL 末尾手动追加参数：?vscodeVersion=1.118.0（将 1.118.0 替换为你本地实际版本，运行 code --version 查看）；
刷新页面，右下角会出现 Install Another Version… 下拉菜单；
从中选择一个带绿色勾号 ✅ 的版本安装——只有标 ✅ 的才是 Marketplace 显式验证过的兼容版本；
注意：若该菜单灰显，说明作者未发布任何与你版本匹配的历史 release，必须转向离线修改方案。
离线修改 .vsix 文件中的 engines 字段
方法一：直接解压改包
从 GitHub Releases 或可信镜像下载 fitten-code-*.vsix 文件；
用 7-Zip（Windows）、Archive Utility（macOS）或 unzip（Linux）解压该文件；
进入 extension/package.json（不是根目录那个），找到 "engines": { "vscode": "^1.103.0" } 这一行；
将其改为宽松范围，例如："vscode": ">=1.75.0" 或精确锁定为 "vscode": "=1.118.0"；
保存后，将整个文件夹重新打包为 ZIP 格式，再把后缀名改为 .vsix；
在 VS Code 中按 Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中该文件。
方法二：跳过校验强制加载（仅限已安装但被禁用的插件）
定位插件目录：
Windows：%USERPROFILE%\.vscode\extensions\fitten.fitten-code-*\
macOS/Linux：~/.vscode/extensions/fitten.fitten-code-*/；
编辑该目录下的 package.json，修改 engines.vscode 字段值；
改完后必须执行 Developer: Reload Window（不能只点「启用」）；
注意：VS Code 每次更新后，该字段会被自动重置回原始值，需重复修改。
检查远程组件是否同步
第一步：确认本地 VS Code 主版本号，运行 code --version；
第二步：连接 Remote-SSH 或 WSL 后，在远端终端执行：rm -rf ~/.vscode-server；
第三步：断开连接，重启 VS Code，重新触发 Remote 扩展部署；
这一步不可跳过——Fitten Code 若依赖 Remote 环境运行（如调用远端模型服务），远端 vscode-server 二进制版本必须与本地主程序严格一致，否则卡在 Starting VS Code Server 且无报错提示。
