首选方案是升级ide至2025.3或更高版本，确保兼容最新fitten code插件；若需临时适配旧版ide，可降级安装v2024.x历史版本插件；强制加载仅限调试，易导致功能残缺或卡死。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你的 JetBrains IDE（如 IntelliJ IDEA、PyCharm）启动后，Fitten Code 插件在 Plugins 页面显示红色警告“Plugin incompatible with this installation”，点击详情看到提示“Requires IDE version 2025.3 or later”，而你当前用的是 2024.3 ——这不是插件坏了，是编辑器版本卡在旧版，连加载入口都没有。
确认当前 IDE 版本与插件最低要求
打开 Help → About，第一行就显示完整版本号，例如 IntelliJ IDEA 2024.3.4。别只看年份，小版本号（.3.4）决定兼容性。访问 Fitten Code 官方文档或 GitHub Releases 页面，查最新版插件明确标注的最低 IDE 版本要求——2026 年 6 月最新稳定版插件要求 IDE ≥ 2025.3。
如果当前版本低于该值，自动更新或 Marketplace 安装必然失败，强行点 Install 会直接报 incompatible，不给任何重试机会。
方案一：升级 IDE 至兼容版本（推荐）
第一步：打开 Help → Check for Updates → 点击 “Update and Restart”
第二步：若提示“Already up to date”，说明你用的是 EAP 或旧渠道安装包，需手动下载新版安装包。前往 jetbrains.com/idea/download，选择对应系统（Windows/macOS/Linux），下载 2025.3 或更高版本的 .exe/.dmg/.tar.gz。
第三步：运行安装程序。Windows/macOS 用户可勾选“Update PATH variable”和“Associate .idea files”，Linux 用户解压后执行 bin/idea.sh 即可。新版本默认不覆盖旧版安装目录，原有配置、插件、项目缓存全部保留，无需迁移。
第四步：启动新 IDE，进入 Settings → Plugins → Marketplace 搜索 “Fitten Code”，此时应能正常显示安装按钮，点击安装并重启。
Fitten Code 1.0.3是一款由清华博士团队打造的AI编程助手，基于国产计图（Jittor）深度学习框架开发。它支持VS Code、JetBrains系列等主流IDE及80多种编程语言。核心功能包括智能代码补全、注释生成、代码解释、Bug检测、单元测试生成等，旨在全方位提升开发效率。该工具对个人用户免费开放。
方案二：降级插件适配旧 IDE（临时应急）
方法一：去 Fitten Code 官网或 GitHub Releases 页面，筛选 tag 名为 v2024.x 的历史版本（如 v2024.12.0），下载对应 .zip 文件。注意核对发布日期是否在 2024 年底前，且 release note 明确写有 “Compatible with IntelliJ IDEA 2024.2+”。
方法二：打开 Settings → Plugins → ⚙️ → Install Plugin from Disk… → 选择刚下载的 .zip 文件 → 确认安装 → 重启 IDE。
⚠️ 注意：v2024.x 插件不支持 2026 年新增的模型能力（如多轮上下文代码理解、本地 LLM 推理加速），部分功能图标可能灰显或点击无响应。
方案三：绕过版本检查强制加载（仅限调试）
打开 Settings → Plugins → 找到已安装但标红的 Fitten Code → 点击右侧三个点 → “Enable plugin for current session only”。
这会跳过启动时的版本校验，插件进程被拉起，但 UI 元素（侧边栏、右键菜单）大概率无法渲染，控制台报错 java.lang.NoClassDefFoundError: com/intellij/openapi/actionSystem/ActionUpdateThread ——说明底层 API 已变更，强制启用只会导致功能残缺或 IDE 卡死。
不建议长期使用此方式。若只是想验证某段代码生成逻辑，改用 VS Code + Fitten Code 更稳妥。
