workbuddy自动更新需手动开启并重启生效，否则仅启动时比对一次；验证须四步：设置内点击检查更新、命令行执行--check-update、测试auth.codebuddy.cn连通性、清除update-cache或用--force-check-update强制触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy默认启用自动更新检测，但部分用户因网络策略、权限限制或误操作导致该功能实际未运行，表现为点击“检查更新”无响应、版本长期卡在旧版（如v2026.03.12）、新功能图标灰显等现象。必须确认并激活底层检测逻辑，才能让客户端在每次启动时自动比对服务器最新版本号。
通过设置界面启用自动检查更新
这是最直观且适合大多数用户的启用方式，无需编辑文件或调用命令行。
1、启动WorkBuddy并完成腾讯账号（企业微信或QQ）登录；
2、点击右上角头像→进入「设置」→左侧导航栏选择「通用」选项卡；
3、找到「自动检查更新」开关，向右滑动至开启状态（ON），确保其右侧无灰色禁用图标；
4、【必须重启WorkBuddy才能激活定时检测逻辑】——仅开启开关不重启，系统只会执行一次启动时比对，不会持续轮询；
5、重启后，右下角状态栏若出现“正在后台检查更新…”提示，说明机制已就绪。
验证自动更新是否真正生效
很多人看到开关打开就以为万事大吉，其实可能被杀毒软件拦截、代理阻断或DNS污染导致检测静默失败。以下四步验证缺一不可。
第一步：打开「设置」→「关于WorkBuddy」，点击「检查更新」按钮；
第二步：观察弹窗响应——若显示“已是最新版本”或具体新版本号（如v2026.09.15），说明网络通路正常；若卡在“正在检查…”超10秒或报错network timeout，则需排查防火墙；
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第三步：打开终端（Windows PowerShell / macOS Terminal），执行workbuddy --check-update；该命令绕过GUI，直接触发HTTP请求，输出中含available: v2026.09.15即为有效；
第四步：若前三步均失败，立即测试域名连通性——在PowerShell中运行curl -Uri "https://auth.codebuddy.cn/api/v1/version?os=win" -Method Get，返回403或超时，说明【auth.codebuddy.cn被系统级拦截，需加白名单或临时关防火墙】。
强制唤醒沉睡的更新机制（适用于企业内网/代理环境）
当常规设置无效，且确认网络策略允许访问auth.codebuddy.cn时，可清除本地缓存元数据，逼迫客户端重新拉取最新版本清单。
方法一：手动删除update-cache目录
1、关闭所有WorkBuddy进程（含workbuddy-service.exe或helper子进程）；
2、前往%appdata%\WorkBuddy\cache\update-cache（Windows）或~/Library/Application Support/WorkBuddy/cache/update-cache（macOS）；
3、删除整个update-cache文件夹；
4、重启WorkBuddy，首次启动将重建缓存并强制发起一次完整版本比对。
方法二：命令行直触更新端点
以管理员身份运行终端，执行：workbuddy --force-check-update；该指令跳过本地缓存校验，直接向服务器发起GET请求，并在成功后自动唤起更新弹窗——【此命令不下载安装包，只强制触发检测】。
