CodeBuddy 插件出现异常时，常见的表现包括图标突然消失、点击无响应、功能按钮呈灰色——这些问题多半是由缓存目录污染或版本不匹配所致。尤其在更新插件或频繁切换模型后，更容易触发此类故障。简单地重启或重装往往无法根治，必须精准定位并彻底清理关键缓存路径，才能从根本上解决问题。
先彻底退出 CodeBuddy 及相关进程
如果缓存文件被进程锁定，即使删除也无法释放空间——下次启动时仍会加载损坏的缓存。这一步绝不能省略：Windows 用户请打开任务管理器，切换到「详细信息」标签页，结束所有 CodeBuddy.exe、Code Helper.exe、node.exe 进程；macOS 用户则打开活动监视器，搜索“CodeBuddy”，强制退出所有相关项目。
【关键前提】 若进程未完全退出就删除缓存，后续重启很可能卡在白屏，或反复提示“Extension host terminated unexpectedly”。
按系统定位并清理核心缓存目录
CodeBuddy 的缓存主要集中在三个位置，缺一不可：
Windows 路径：
%APPDATA%\CodeBuddy CN\Cache
%APPDATA%\CodeBuddy CN\GPUCache
%APPDATA%\CodeBuddy CN\Extensions
macOS 路径：
~/Library/Caches/com.tencent.codebuddy
~/Library/Application Support/CodeBuddy CN/Cache
~/Library/Application Support/CodeBuddy CN/Extensions
Linux 路径：
~/.cache/CodeBuddy CN
~/.config/CodeBuddy CN/Cache
~/.config/CodeBuddy CN/Extensions
进入对应目录后，全选并永久删除（Shift+Delete / Cmd+Option+Delete）。注意：不要仅仅扔进回收站——回收站会保留硬链接，空间不会立即释放，等于白忙一场。
重点处理 WorkspaceStorage 中的插件状态残留
WorkspaceStorage 目录保存了每个工作区的插件激活状态和 UI 布局快照。如果某个工作区曾加载过异常插件，其子目录中会固化错误的配置，导致反复出现故障。
第一步：打开对应路径
Windows → %APPDATA%\CodeBuddy CN\WorkspaceStorage
macOS → ~/Library/Application Support/CodeBuddy CN/WorkspaceStorage
Linux → ~/.config/CodeBuddy CN/WorkspaceStorage
第二步：按“修改日期”排序，找到最近 7 天内创建、体积超过 50MB 的子目录（名称是一长串 GUID），右键选择「移到废纸篓」或「永久删除」。
第三步：特别注意是否存在名为 plugin-state-cache 或 extension-registry 的隐藏文件，如有，一并清除。
重启后验证插件是否恢复
重新启动 CodeBuddy，登录后等待 3 秒再点击左侧的「扩展」图标。如果插件仍显示“已禁用”或“需要重新安装”，右键该插件并选择「重新启用」。若出现“签名无效”提示，说明插件包已被缓存污染，只能前往官网重新下载最新版安装包，手动覆盖安装。