若WorkBuddy技能包更新后功能异常，需依次执行五步排查：一、重启并强制刷新技能注册；二、清除本地skills缓存目录；三、控制台手动重装技能；四、检查并升级MCP Core至≥v1.8.3；五、回退至稳定版技能包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy技能包更新后发现原有功能无法调用、指令无响应或Skills显示为“未启用”状态，则可能是由于更新过程中本地缓存残留、技能注册冲突或权限配置未同步所致。以下是解决此问题的步骤：
一、重启WorkBuddy并强制刷新技能注册
WorkBuddy在更新技能包后需重新加载插件注册表，旧缓存可能导致Skills元数据未生效，强制刷新可触发全量重载流程。
1、关闭当前运行的WorkBuddy应用，包括菜单栏常驻进程。
2、打开终端（macOS）或命令提示符（Windows），执行：workbuddy --reload-skills。
3、重新启动WorkBuddy，等待底部状态栏显示“Skills已全部注册完毕”后再尝试调用。
二、清除本地Skills缓存目录
更新时若发生中断，可能残留损坏的JSON描述文件或未签名的临时包，导致加载器拒绝加载该技能。
1、退出WorkBuddy进程。
2、定位并删除缓存路径：~/Library/Caches/WorkBuddy/skills/（macOS）或%APPDATA%\WorkBuddy\cache\skills\（Windows）。
3、重新启动WorkBuddy，系统将自动从云端拉取最新签名包并重建本地索引。
三、手动触发技能重安装
当自动更新失败时，部分Skills可能仅下载了新版本但未完成注册绑定，需通过控制台干预重装流程。
1、登录WorkBuddy控制台（https://console.workbuddy.qq.com）。
2、进入「集成管理」→「Skills中心」，找到失效技能名称右侧的「…」按钮。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
3、点击「卸载」，确认后再次点击「安装最新版」。
4、返回客户端，观察技能卡片是否恢复为绿色启用状态。
四、检查MCP协议兼容性版本
WorkBuddy内置Skills依赖MCP（Model Control Protocol）标准接口，若更新后本地MCP Core未同步升级，将导致技能调用链断裂。
1、在WorkBuddy主界面左下角点击「关于」→「系统信息」。
2、核对MCP Core版本号是否 ≥ v1.8.3（当前稳定基线）。
3、若版本过低，点击「立即升级MCP核心」按钮，等待进度条完成并重启应用。
五、回退至前一稳定技能包版本
若上述操作均无效，且确认新版本存在已知兼容缺陷，可临时切换回经验证的稳定版本以保障工作流连续性。
1、访问WorkBuddy官方Skills仓库镜像页：https://skills.workbuddy.qq.com/history。
2、查找对应技能名称，筛选标签为「stable-20260308」的发布版本。
3、复制该版本的安装命令（形如wb-skill install xxx@stable-20260308）。
4、在终端中粘贴执行，完成后重启WorkBuddy。
