fitten code插件在ubuntu中需按ide区分安装：pycharm须通过settings→plugins搜索安装并重启，且必须配置含jcef的jdk运行时；vs code需版本≥1.68.0、node.js≥18.x及npm≥9.0，安装后须登录账号方可启用ai功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Ubuntu 系统中为 PyCharm 或 VS Code 安装 Fitten Code 插件，需根据所用 IDE 类型分别处理——PyCharm 依赖 JetBrains 插件生态与 JCEF 运行时支持，VS Code 则要求版本 ≥1.68.0 并启用 Node.js 支持；两者均需登录账号才能调用 AI 功能，且首次启动前必须确认 Java 或 Node.js 环境可用。
PyCharm 版安装与运行修复
打开 PyCharm → 点击左上角 File → Settings（或按 Ctrl+Alt+S）。
在设置窗口左侧选择 Plugins → 右侧切换到 Marketplace 标签页。
在搜索框输入 FittenCode（注意无空格、无横线），找到官方插件后点击 Install。
安装完成后必须重启 PyCharm，否则插件图标不显示、AI 功能完全不可用。
若重启后出现 “请安装 JCEF” 错误：说明当前 IDE 启动的 JVM 不含浏览器渲染引擎，无法加载插件 UI。此时需手动切换 Boot Runtime：
→ 点击菜单栏 Help → Find Action（或按 Ctrl+Shift+A）→ 输入 Choose Boot Java Runtime for the IDE → 在弹出窗口中选择带 JCEF 标识的 JDK（通常为 JetBrains Runtime 或 OpenJDK 17+ with JCEF）→ 点击 OK 并等待自动重启。
【关键前提】 若未联网或代理不通，JCEF 运行时无法下载，此步将失败；请提前配置系统级代理或确保网络直连。
VS Code 版安装与基础验证
确认 VS Code 版本 ≥1.68.0：打开终端执行 code --version，输出第一行数字如 1.90.2 即满足要求。
若版本过低，卸载旧版后前往 code.visualstudio.com 下载最新 .deb 包，双击安装或执行：sudo apt install ./code_*.deb
启动 VS Code → 点击左侧扩展图标（或按 Ctrl+Shift+X）→ 在搜索框输入 Fitten Code → 找到后点击 Install。
安装完毕后右下角会弹出登录提示，点击即可跳转网页完成账号绑定；未登录状态下所有 AI 功能（生成/解释/补全）均被禁用。
通用环境校验与故障响应
PyCharm 用户执行：java -version，确认输出含 openjdk version "17" 或更高版本；低于 11 的 JDK 会导致插件无法加载。
VS Code 用户执行：node -v && npm -v，必须同时返回 Node.js ≥18.x 和 npm ≥9.0；若 npm 版本过低（如 8.x），运行 sudo npm install -g npm@latest 升级。
若 Fitten Code 侧边栏空白或反复崩溃，打开 VS Code 命令面板（Ctrl+Shift+P）→ 输入 Developer: Toggle Developer Tools → 查看 Console 是否报 GPU process crashed；若是，需关闭沙箱机制：
→ 打开命令面板 → 输入 Preferences: Open Settings (JSON) → 在配置末尾添加："fittencode.enableSandbox": false → 保存并重启。
PyCharm 中若插件图标显示但点击无响应，检查 Help → Diagnostic Tools → Debug Log Settings，勾选 com.fittencode 后复现操作，日志中出现 Failed to load native library 表示 JCEF 加载失败，需重做 Boot Runtime 切换步骤。
