技能包更新失败可按五步排查：一、检查SkillHub镜像连通性；二、清除本地skillhub_cache缓存；三、手动切换至腾讯云镜像源并强制验证；四、以管理员/Root权限修复SkillHub运行时；五、临时禁用安全软件及防火墙拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用WorkBuddy过程中发现技能包（Skills）无法更新或提示更新失败，则可能是由于网络连接异常、SkillHub镜像节点不可达、本地缓存冲突或权限限制所致。以下是多种可行的解决办法：
一、检查网络与SkillHub服务状态
WorkBuddy依赖SkillHub官方镜像节点下载技能包，若本地网络无法访问该服务，将导致更新中断。需确认当前是否能正常连通国内高速镜像。
1、打开浏览器，访问 https://skillhub.codebuddy.cn，观察页面是否可加载并显示“精选Top 50 AI Skills榜单”。
2、如页面空白或超时，尝试切换网络环境（例如从公司内网切换至手机热点）。
3、在WorkBuddy主界面右下角点击「设置」→「关于」→「诊断工具」，点击「测试SkillHub连通性」，查看返回结果是否为“OK”。
二、清除SkillHub本地缓存目录
本地缓存文件损坏或版本错乱可能导致更新逻辑校验失败，强制清除后可触发全新拉取流程。
1、关闭WorkBuddy主程序（确保进程已退出，可在任务管理器/活动监视器中确认无workbuddy相关进程）。
2、定位缓存路径：
Windows用户进入 %APPDATA%\WorkBuddy\skillhub_cache；
macOS用户进入 ~/Library/Application Support/WorkBuddy/skillhub_cache。
3、将整个 skillhub_cache 文件夹彻底删除。
4、重新启动WorkBuddy，进入「技能中心」→ 点击右上角刷新按钮，等待重新同步。
三、手动指定镜像源并重试更新
默认镜像源可能因地域或临时策略受限，WorkBuddy支持手动切换为腾讯云专属CDN节点，提升稳定性。
1、点击左上角「文件」→「偏好设置」→「高级」。
2、在“技能包下载源”选项中，从下拉菜单选择 tencent-cn-mainland（腾讯国内主干节点）。
3、勾选「启用镜像源强制验证」，点击「保存并重启」。
4、重启后进入「技能中心」，长按任意技能卡片，选择「强制更新此技能」。
四、以管理员/Root权限重新安装SkillHub运行时
部分系统级权限缺失会导致技能包解压或注册失败，尤其在首次授权后未完整初始化的情况下。
1、Windows用户：右键WorkBuddy快捷方式 →「以管理员身份运行」→ 进入「设置」→「技能中心」→ 点击底部「修复SkillHub运行时」。
2、macOS用户：打开终端，执行以下命令：
sudo /Applications/WorkBuddy.app/Contents/MacOS/skillhub-cli --repair；
输入登录密码后等待提示“Repair completed successfully”。
3、完成后关闭终端，正常启动WorkBuddy，再次尝试更新。
五、禁用第三方安全软件临时干预
某些国产杀毒软件或企业EDR会拦截SkillHub动态下载的zip包或执行临时脚本，造成静默失败。
1、临时退出360安全卫士、火绒、腾讯电脑管家等客户端（非仅关闭托盘图标，需在任务管理器中结束全部相关进程）。
2、检查系统防火墙是否对WorkBuddy.app或skillhub-cli进程设置了出站规则限制。
3、在「系统设置」→「隐私与安全性」→「防火墙选项」中，确认WorkBuddy已被添加至“允许传入连接”白名单。
4、完成上述操作后，重启WorkBuddy并执行更新。
