CodeBuddy插件异常需彻底退出进程后清理三类缓存路径及WorkspaceStorage中GUID子目录和隐藏文件，否则重启无效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
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
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
进入对应目录后，全选并永久删除（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秒再点击左侧「扩展」图标；若仍有插件显示“已禁用”或“需要重新安装”，右键该插件→「重新启用」；若提示“签名无效”，说明插件包被缓存污染，需前往官网重新下载最新版安装包手动覆盖安装。
