CodeBuddy代码补全灰显说明插件已加载但功能锁定，需依次排查LSP初始化、登录态与网络连通性、本地缓存及索引、插件冲突与语言绑定四类阻塞点，逐一修复后方可恢复实时补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy代码补全提示灰显，说明插件已加载但功能被锁定或服务未就绪，此时无法响应Tab、Ctrl+Space等触发动作，也无法在编辑器中看到任何AI建议框，必须逐层排查状态阻塞点才能恢复实时编码支持。
确认插件是否处于“已启用但未就绪”状态
打开IDE设置→插件管理页，找到“腾讯云代码助手 CodeBuddy”，观察右侧状态栏：若显示Enabled但图标灰显、右下角无用户头像，说明插件进程已启动但语言服务器（LSP）尚未完成初始化。此时不能直接重装，否则会丢失当前会话Token。
点击插件条目→查看详情→检查底部是否标注“LSP: pending”或“Waiting for server start”。若存在该提示，说明codebuddy-lsp进程卡在端口绑定或上下文加载阶段。
执行强制重启LSP：在IDE内置终端中运行命令 codebuddy-lsp --restart，等待终端输出“Server started on port 34567”即表示恢复成功。
检查登录态与服务端连通性
方法一：通过状态栏快速验证
点击IDE右下角CodeBuddy图标，若弹出窗口标题为“未登录”或“连接异常”，则补全必然灰显。此时需用微信扫码重新登录——注意：旧Token可能因7天试用期结束或账户欠费失效，扫码后务必确认页面跳转至codebuddy.tencentcloudapi.com并返回200响应。
方法二：终端直连诊断
在系统终端中执行：curl -I https://codebuddy.tencentcloudapi.com/health。若返回HTTP/2 200且Header含X-CodeBuddy-Status: ok，则网络正常；若超时或返回403，说明企业防火墙或本地代理（如Clash for Windows）拦截了该域名，需临时关闭代理再重试。
这一步操作起来很简单，直接把命令粘贴进终端回车就行，但别跳过——很多用户误以为登录成功就万事大吉，其实后台鉴权接口每15分钟轮询一次，断连后补全会立刻降级为灰显状态。
专为资深工程师设计，用于高效日常使用 GitHub Copilot CLI。适用于在规划、提示、审查或链式调用 gh copilot 命令时，探索代码库、起草变更、调试问题或加速工作流，且不偏离架构意图。
重置本地缓存并重建项目索引
第一步：关闭IDE全部窗口，确保后台java.exe或idea64.exe进程已退出（Windows任务管理器、macOS活动监视器中手动结束残留进程）。
第二步：定位并删除缓存目录：
Windows路径：%USERPROFILE%\.IntelliJIdea\config\plugins\codebuddy
macOS路径：~/Library/Caches/JetBrains/IdeaIC/plugins/codebuddy
Linux路径：~/.cache/JetBrains/IdeaIC/plugins/codebuddy
第三步：重启IDE，打开项目后等待右下角出现“Indexing project context…”提示，**必须等该提示消失且状态栏图标变为彩色并显示用户头像**，才可进行下一步。此过程耗时取决于项目大小，Android项目通常需90–180秒，跳过将导致补全持续灰显。
第四步：在任意.kt或.py文件中输入print(，然后按下Ctrl+Space。若此时弹出带参数提示的补全框，说明恢复成功；若仍灰显，进入下一环节。
禁用冲突插件并校验文件语言绑定
某些AI类插件（如GitHub Copilot、Tabnine）会劫持IDE的补全入口通道，导致CodeBuddy注册的Provider被绕过。打开插件管理页，临时禁用所有名称含“AI”“Copilot”“Code”“Smart”的第三方补全插件，仅保留CodeBuddy一个。
右键当前编辑文件标签页→选择“Reopen with Language Mode”→手动指定为对应语言（如JavaScript、Kotlin、Python），不能依赖自动识别。尤其微信小程序项目中，.wxml文件常被误判为HTML，导致补全引擎加载错误模型。
这一步做完后，立即在文件中输入一个字母（如c），观察是否触发基础符号补全。有反应说明语言绑定成功，灰显问题已解除。
