WorkBuddy AI客户端升级有五种方式：一、启用自动更新并手动检查；二、官网下载安装包覆盖安装；三、企业微信发送/upgrade now指令；四、个人微信发送/update client now；五、命令行执行workbuddy-cli --self-update --force。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用WorkBuddy AI客户端，但界面功能缺失、模型切换不可用或右下角未显示新版标识，则可能是当前版本滞后于最新发布版本。以下是完成客户端版本升级的多种操作路径：
一、启用并触发自动更新机制
WorkBuddy AI默认启用后台自动版本检测，该机制在每次启动时比对服务器最新版本号；启用后可避免手动干预，确保长期保持功能完整性与协议兼容性。
1、确保WorkBuddy AI已登录腾讯账号（推荐使用企业微信或QQ账号）。
2、点击右上角个人头像，进入「设置」菜单。
3、在左侧导航栏选择「通用」选项卡。
4、确认「自动检查更新」开关处于开启状态。
5、点击「立即检查更新」按钮，等待弹窗提示“发现新版本v1.100.0”或“已是最新版本”。
6、若提示有更新，点击「立即更新」，客户端将自动下载并重启完成升级。
二、手动下载安装包覆盖安装
当自动更新失败、网络策略拦截或需强制回退/跳转至特定稳定版本（如v1.100.0）时，可采用离线安装包方式执行覆盖安装；该方式保留全部本地配置、技能包及Claw集成凭证，仅替换核心可执行文件与运行时模块。
1、访问WorkBuddy官方下载地址：https://www.codebuddy.cn/work/。
2、根据操作系统选择对应安装包：Windows用户下载WorkBuddySetup.exe，macOS用户下载WorkBuddy.dmg。
3、下载完成后，通过任务管理器（Windows）或活动监视器（macOS）确认workbuddy进程已完全退出。
4、双击安装包，按向导提示执行安装；安装程序将自动识别已有版本并执行覆盖操作。
5、安装完毕后重新启动客户端，进入「关于WorkBuddy」查看版本号是否已更新为v1.100.0。
三、通过企业微信长链接触发强制同步升级
适用于已配置企业微信集成的用户，该方式绕过本地UI检测逻辑，直接由企微机器人通道向客户端下发最新运行时环境策略与MCP协议模块，特别适配Claw插件兼容性更新与后台自动化任务增强场景。
1、在企业微信中打开已绑定的WorkBuddy机器人对话窗口。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、发送指令：/upgrade now（注意斜杠开头、空格分隔，无引号）。
3、等待机器人返回响应消息，内容包含「正在同步最新运行时环境」及动态进度条标识。
4、回到电脑端WorkBuddy主界面，观察右下角通知栏是否出现「新版功能已就绪」提示。
5、点击该提示或手动进入「关于WorkBuddy」确认版本号变更。
四、通过个人微信直连通道发起远程升级
针对已启用个人微信直连功能的用户，该方式利用微信生态链路发起本地升级指令，所有操作均在用户本机执行，不上传任何配置或文件，保障数据隐私与本地控制权。
1、在已绑定的个人微信对话中，向WorkBuddy专属账号发送文字：/update client now。
2、等待约8–12秒，客户端将自动响应并开始后台拉取v1.100.0安装包。
3、微信端将收到一条含时间戳的确认消息，例如：“【2026-03-21 22:15:03】客户端升级已触发，请勿关闭本地WorkBuddy进程。”
4、WorkBuddy主界面右下角将浮现蓝色脉动提示条，显示“升级中：72%”，完成后自动重启。
5、重启后登录账号，检查左下角状态栏是否显示MCP-enabled标识。
五、使用命令行执行底层版本刷新
适用于高级用户或批量部署场景，该方式调用内置CLI工具绕过图形界面限制，直接校验本地版本哈希值并与云端签名比对，支持强制重载全部运行时组件，适用于修复因权限异常或缓存污染导致的升级卡死问题。
1、打开终端：Windows用户使用PowerShell，macOS/Linux用户使用Terminal。
2、切换至WorkBuddy安装根目录（Windows示例：cd "C:\Program Files\WorkBuddy"；macOS示例：cd /Applications/WorkBuddy.app/Contents/MacOS）。
3、执行命令：workbuddy-cli --self-update --force。
4、观察输出日志中出现[SUCCESS] Client updated to v1.100.0标识。
5、关闭当前终端，手动双击桌面快捷方式重启客户端验证版本。
