需升级 github copilot 至 v2.14.0+，分离 qoderwake（端口 3002）与 copilot 的 lsp 端口，禁用 copilot chat 监听，分域登录认证，并通过快捷键（alt+enter/ctrl+shift+i）隔离触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 JetBrains IDE 中同时启用 QoderWake 与 GitHub Copilot，实现双 AI 引擎协同工作，但发现二者存在插件冲突、上下文覆盖或响应优先级混乱等问题，则可能是由于插件加载顺序、语言服务器端口占用或认证会话互斥所致。以下是解决此问题的步骤：
一、验证插件兼容性与版本约束
QoderWake 作为 Qoder 平台的轻量级唤醒模块，仅支持与 GitHub Copilot v2.14.0 及以上版本共存；低于该版本的 Copilot 插件会因 LSP 协议不一致导致初始化失败。需确认两插件均满足最低 IDE 版本要求（IntelliJ IDEA 2023.3+）且未启用实验性代理模式叠加。
1、打开 JetBrains IDE，进入【Help】→【About】，确认 IDE 版本号不低于 2023.3。
2、点击【File】→【Settings】→【Plugins】，分别搜索 “QoderWake” 和 “GitHub Copilot”，查看已安装版本号。
3、若 Copilot 显示版本低于 2.14.0，必须卸载当前插件并从 JetBrains Marketplace 安装最新正式版，不可使用本地 ZIP 手动安装旧包。
4、检查 QoderWake 插件详情页中标注的 “Compatible with Copilot SDK v2.14+”，如无此项说明，该 QoderWake 版本不支持与 Copilot 同时运行。
二、分离语言服务器端口与上下文域
QoderWake 默认使用 3001 端口启动本地 LSP 服务，而 GitHub Copilot CLI 在启用 Agent Mode 时默认尝试绑定同一端口，引发地址已被占用错误。需为二者分配独立通信通道，并禁用 Copilot 的自动端口探测行为。
1、在【Settings】→【Tools】→【QoderWake】中，将 “Language Server Port” 修改为 3002，点击 Apply。
2、进入【Settings】→【Other Settings】→【GitHub Copilot】，取消勾选 “Enable automatic port detection for agent mode”。
3、手动指定 Copilot CLI 路径：点击 “Configure CLI Path”，输入已全局安装的 copilot-cli v2.14.0+ 可执行文件绝对路径（如 Windows 下为 C:\Users\XXX\AppData\Roaming\npm\copilot.cmd）。
4、重启 IDE 后，在终端执行 copilot --version 验证 CLI 可被正确调用，且输出中包含 “agent-mode: disabled” 字样。
三、配置响应优先级与触发域隔离
QoderWake 设计为高频轻量补全（如变量命名、单行逻辑推导），而 GitHub Copilot 更适合整函数生成与跨文件重构。需通过快捷键绑定与上下文关键词前缀明确区分二者职责边界，避免编辑器同时向两个服务发送请求。
1、进入【Settings】→【Keymap】，搜索 “QoderWake Complete”，将其快捷键设为 Alt+Enter（默认为 Ctrl+Space，易与 Copilot 冲突）。
2、搜索 “GitHub Copilot: Generate”，将其快捷键设为 Ctrl+Shift+I，确保与 QoderWake 触发键完全不重叠。
3、在【Settings】→【Editor】→【General】→【Code Completion】中，关闭 “Autopopup code completion” 选项，禁止自动弹出任何补全框，强制所有 AI 补全必须由显式快捷键触发。
4、打开任意 .java 文件，在光标处输入 //qoder: 后按 Alt+Enter，验证仅 QoderWake 响应；输入 //copilot: 后按 Ctrl+Shift+I，验证仅 GitHub Copilot 响应。
四、禁用 Copilot 内置聊天与 QoderWake 的语义监听冲突
GitHub Copilot Chat 功能默认启用实时编辑器内容监听，会持续向 Copilot 后端发送当前文件快照；QoderWake 的 Wake 模块同样采用类似机制捕获光标附近上下文。二者并发监听将导致 CPU 占用飙升及光标跳变。必须停用其中一方的后台监听能力。
1、进入【Settings】→【Other Settings】→【GitHub Copilot】，取消勾选 “Enable Copilot Chat in editor”。
2、在【Settings】→【Tools】→【QoderWake】中，勾选 “Enable semantic wake on cursor movement”，保持其监听能力启用。
3、关闭所有已打开的 Copilot Chat 窗口（右下角悬浮按钮或侧边栏 Tab），确保状态栏 Copilot 图标显示为灰色静默状态，而非蓝色呼吸动画。
4、打开一个含 500 行以上代码的文件，快速移动光标并观察 CPU 使用率：若仍持续高于 40%，需在任务管理器中结束所有名为 copilot-agent 的进程。
五、重置认证会话并分域登录
QoderWake 使用 Qoder 平台 OAuth 2.0 Token，GitHub Copilot 使用 GitHub Personal Access Token 或 SSO 会话。当两者共用同一浏览器内核（如 JetBrains 内置 WebView）进行登录时，Cookie 冲突会导致一方令牌被另一方覆盖失效。需强制分离认证上下文。
1、在【Settings】→【Tools】→【QoderWake】中，点击 “Sign out”，确认退出后状态显示 “Not signed in”。
2、在【Settings】→【Other Settings】→【GitHub Copilot】中，点击 “Sign out”，等待状态变为 “Not signed in”。
3、先点击 QoderWake 的 “Sign in”，在弹出窗口中完成 Qoder 账户授权，关闭该窗口后勿切换至其他标签页。
4、再点击 GitHub Copilot 的 “Sign in”，此时系统将自动启用独立沙箱 WebView，确保登录过程中不出现“Session expired”或“Invalid state”提示。
