Qoder插件Agent模式未显示时，需依次执行五步排查：一、强制刷新缓存并重启IDE；二、检查插件启用状态及IDE版本/架构兼容性；三、终止qoder-cn进程并清理.lingma配置目录；四、以管理员/Root权限重启IDE；五、通过Registry启用快照并重载插件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 JetBrains IDE 中已安装 Qoder 插件，但点击右侧面板或使用快捷键后 Agent 模式未显示，可能是由于插件未正确加载、IDE 缓存异常、权限配置缺失或进程冲突所致。以下是解决此问题的步骤：
一、强制刷新插件状态并重启 IDE
该方法通过清除 IDE 对插件的运行时缓存，促使插件重新注册并初始化 UI 组件，适用于插件已启用但界面未渲染的场景。
1、在 IDE 中依次点击 File → Invalidate Caches and Restart…。
2、在弹出窗口中选择 Invalidate and Restart。
3、等待 IDE 完全关闭并自动重启后，再次尝试触发 Agent 模式（快捷键：Windows 为 Ctrl+Shift+L，macOS 为 ⌘⇧L）。
二、检查插件启用状态与兼容性
该方法用于确认 Qoder 插件是否处于激活状态，并验证其与当前 IDE 版本及系统架构是否匹配，避免因版本不兼容导致 UI 元素不可见。
1、点击 File → Settings → Plugins（macOS 为 IntelliJ IDEA → Preferences → Plugins）。
2、在搜索框中输入 Qoder，确认插件状态为 Enabled；若显示 Disabled，点击右侧开关启用。
3、核对 IDE 版本：确保当前 IDE 版本 ≥ 2020.3；可在 Help → About 中查看完整版本号。
4、确认系统架构：Windows 用户需使用 x64 版 IDE；macOS 用户需确认为 Apple Silicon（arm64）或 Intel（x86_64）对应版本的 Qoder 插件。
三、终止残留进程并清理本地配置
该方法用于消除 Qoder 后台守护进程（qoder-cn）异常挂起导致的 UI 同步失败问题，同时重置可能损坏的本地配置文件。
1、打开系统任务管理器（Windows）或活动监视器（macOS），搜索并结束所有名为 qoder-cn 或 lingma 的进程。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、定位并删除本地配置目录：
Windows 路径：C:\Users\{用户名}\AppData\Local\.lingma\
macOS 路径：~/Library/Application Support/.lingma/
3、重启 IDE，等待插件自动重建配置目录并重新初始化。
四、以管理员/Root 权限重新启动 IDE
该方法可绕过因沙盒策略或文件系统权限限制导致的插件 UI 渲染组件加载失败问题，尤其适用于企业环境或 macOS Gatekeeper 严格策略下。
1、Windows：右键 IDE 快捷方式 → 以管理员身份运行。
2、macOS：在终端执行：sudo /Applications/IntelliJ IDEA.app/Contents/MacOS/idea（路径按实际安装位置调整）。
3、启动后立即打开一个非空项目（不能是 Welcome 界面），再尝试调用 Agent 模式。
五、手动触发 Agent 视图注入
该方法通过 IDE 内置服务命令强制加载 Qoder 的 Agent UI 模块，适用于插件已加载但视图未自动注册的边缘情况。
1、按下快捷键 Ctrl+Shift+A（Windows/Linux）或 ⌘⇧A（macOS）打开 Find Action。
2、输入 Registry，回车进入 Registry 设置页。
3、搜索 ide.plugins.snapshot.on.startup，将其值设为 true。
4、再次按下 Ctrl+Shift+A，输入 Reload plugin，选择 Qoder 并执行重载。
5、最后使用 View → Tool Windows → Qoder 尝试唤出面板。
