升级workbuddy需三类路径：一、结构化备份与覆盖安装，确保配置、技能包等完整迁移；二、命令行强制重装核心模块并重置缓存；三、企微指令触发策略同步升级，保障claw插件零中断。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用旧版本WorkBuddy并计划升级至新版本（如v1.100.0或2026.03.12），需确保本地配置、技能包、Claw集成凭证及任务历史完整保留，避免因版本跳跃导致功能异常或数据丢失。以下是实现跨版本平滑升级的三类独立操作路径：
一、结构化备份与覆盖安装流程
该流程通过人工控制备份粒度与安装时机，规避自动更新机制可能跳过关键兼容性校验的问题，适用于对数据完整性要求极高的生产环境。
1、启动WorkBuddy客户端，点击右上角个人头像，进入「设置」→「通用」→「备份与恢复」。
2、点击「立即创建全量快照」，系统将自动打包以下内容：user-config（含SOUL.md、mcp.json）、skills/目录、claw-config.json、credentials/子目录，生成带时间戳的压缩包（如wb-snapshot-20260409-1802.zip）。
3、关闭WorkBuddy所有进程（Windows使用任务管理器结束workbuddy.exe与claw-agent.exe；macOS使用活动监视器终止WorkBuddy与ClawHelper）。
4、访问官网唯一指定下载地址：https://workbuddy.tencent.com/download，确认页面显示版本号为2026.03.12或更高，下载对应操作系统安装包。
5、双击运行安装包，在向导界面勾选「覆盖安装」，**务必取消勾选“清除用户数据”选项**；安装完成后不立即启动，等待终端提示“Installation completed successfully”。
6、手动解压步骤2中生成的快照包，将user-config/下的全部文件覆盖粘贴至新版本配置目录：%APPDATA%\CodeBuddy\WorkBuddy（Windows）或 ~/Library/Application Support/CodeBuddy/WorkBuddy（macOS）。
二、命令行强制核心模块刷新升级
当出现界面卡顿、微信直连图标灰显、Claw插件加载失败等典型协议不兼容症状时，说明旧版AI内核与新版MCP协议存在冲突，需强制重装运行时核心组件。
1、以管理员身份打开终端：Windows使用PowerShell，macOS使用Terminal。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、执行命令：workbuddy --force-reinstall-core，等待输出「Core module reinstalled successfully」。
3、执行命令：workbuddy --reset-config，该操作仅重置运行时配置缓存，保留skills/目录、任务历史数据库及credentials.bin文件。
4、重新启动WorkBuddy，进入「Claw设置」→「企业微信」卡片，点击「重新验证绑定」，系统将自动拉取新版OAuth2.0令牌并激活后台自动化任务模块。
三、企业微信通道触发策略同步升级
该方式绕过客户端本地版本检测逻辑，直接由企微机器人下发最新运行时环境策略与Claw协议栈，适用于已启用企业微信集成且需保障Claw插件零中断的场景。
1、在企业微信中打开已绑定的WorkBuddy机器人对话窗口，确认机器人状态为“在线”。
2、发送指令：/upgrade now（注意斜杠开头、空格分隔，无引号、无换行）。
3、等待机器人返回响应消息，内容包含「正在同步最新运行时环境」及动态进度条标识，持续约45–90秒。
4、回到电脑端WorkBuddy主界面，观察右下角通知栏是否弹出「新版功能已就绪」提示；若未出现，手动点击「设置」→「关于WorkBuddy」→「检查更新」触发二次同步。
5、进入「功能中心」，验证「多模型切换」「后台自动化任务」开关是否可正常启用，且「微信直连」状态栏显示绿色对勾图标。
