workbuddy技能市场打不开是因本地网络未就绪或前端缓存污染所致；需依次验证skillhub.codebuddy.cn连通性、清除skillhub_cache目录、硬刷新界面、切换至tencent-cn-mainland镜像源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy技能市场打不开，页面空白、转圈或提示“加载失败”，基本可判定是本地网络未就绪或前端缓存污染所致——当前（2026年6月12日）WorkBuddy服务端运行稳定，官方健康页 https://workbuddy.qq.com/status 持续显示绿色，技能市场本身无大规模中断。
第一步：验证技能市场服务连通性
浏览器直接访问技能市场官网是最快速的判断方式，绕过客户端代理和本地重定向逻辑。
打开 Chrome 或 Edge 浏览器，直接输入地址：https://skillhub.codebuddy.cn，观察是否能正常加载「精选Top 50 AI Skills榜单」页面。
若页面空白、超时或返回403/502错误，说明本地网络无法抵达SkillHub镜像节点；此时请立即切换网络环境（例如关闭公司内网，改用手机热点），再重试访问。
若网页可正常打开，但WorkBuddy客户端内仍打不开技能市场，问题一定出在客户端自身——继续执行下一步。
第二步：清除SkillHub本地缓存目录
缓存文件损坏会导致客户端解析失败，即使服务可达，也会卡在白屏或无限加载状态。
方法一：Windows用户操作路径
关闭WorkBuddy主程序，确保任务管理器中无workbuddy.exe进程残留 → 按 Win+R 输入 %APPDATA%\WorkBuddy\skillhub_cache → 回车进入文件夹 → 全选并永久删除该目录下所有内容。
方法二：macOS用户操作路径
退出WorkBuddy（右键托盘图标→「退出」）→ 打开访达 → 按 Cmd+Shift+G → 输入 ~/Library/Application Support/WorkBuddy/skillhub_cache → 删除整个 skillhub_cache 文件夹。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
⚠️注意：不要误删同级的 claw_cache 或 search_index 目录，它们不属于SkillHub模块，删错会导致技能功能异常。
第三步：强制刷新客户端技能市场界面
1、重新启动WorkBuddy，完成登录后，不要点击左侧「技能中心」图标。
2、直接按快捷键 Ctrl+Shift+R（Windows）或 Cmd+Shift+R（macOS），强制硬刷新当前窗口。
3、若仍无响应，右键点击主界面任意空白处 → 选择「检查」→ 切换到 Console 面板 → 查看是否有红色报错，重点识别 Failed to fetch skillhub 或 net::ERR_CONNECTION_REFUSED 类错误。
这一步操作起来很简单，直接把文件拖进去就行。但硬刷新必须在客户端已完全初始化（即顶部状态栏显示“在线”）后再执行，否则无效。
第四步：切换至腾讯云专属镜像源
默认镜像源可能因地域策略临时不可达，手动指定国内主干节点可绕过路由异常。
第一步：点击左上角「文件」→「偏好设置」→「高级」。
第二步：在“技能包下载源”下拉菜单中，选择 tencent-cn-mainland（腾讯国内主干节点）。
第三步：勾选「启用镜像源强制验证」，点击「保存并重启」。
重启后，WorkBuddy会主动向该镜像发起 HTTPS 探测，若返回状态码为200且响应体含 "status":"ok"，技能市场即可恢复加载。
