最稳妥的升级方式是先备份再覆盖安装，需关闭所有后台进程、验证版本号、强制重装core模块，并按规范指令触发企微升级，升级后须手动验证关键功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
旧版 WorkBuddy 升级到最新版，最稳妥的方式是「先备份再覆盖」，而不是直接点更新完事。自动更新在部分企业网络、代理环境或磁盘权限受限时容易静默失败，导致界面卡死、微信直连图标灰显、Claw技能加载为空——这些都不是版本没升上去，而是核心模块没换干净。
检查自动更新是否真生效
很多人点了「立即检查更新」和「立即更新」，看到弹窗说“升级成功”，就以为完事了。其实客户端可能只下载了安装包但没执行静默安装，或者安装中途被杀毒软件拦截。
- 打开
设置 → 关于WorkBuddy，确认显示的版本号是v2026.03.12或更高（当前最新为v2026.03.12） - 如果版本号没变，或右下角通知栏没出现「新版功能已就绪」提示，说明更新未真正落地
- 此时不要反复点击「立即更新」，容易堆积未完成的安装任务，应改用覆盖安装或命令行强制重装
覆盖安装前必须关闭所有 workbuddy 进程
Windows 和 macOS 都存在后台服务进程（workbuddy-service），它不随主窗口关闭而退出。若跳过这步直接双击安装包，安装程序会因文件被占用而跳过替换关键模块，表面完成实则旧版照常运行。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- Windows：打开任务管理器 → 结束所有名为
workbuddy.exe和workbuddy-service.exe的进程 - macOS：打开活动监视器 → 搜索
workbuddy→ 强制退出全部匹配项（包括带helper后缀的子进程） - 验证方式：终端执行
ps aux | grep workbuddy，无任何输出即为干净退出
用命令行强制重装 core 模块解决灰显/卡顿
升级后微信直连图标灰显、审批时间轴不渲染、Claw 技能列表为空——这类问题 90% 是本地 AI 运行时（core）没更新到位，而非 UI 版本问题。图形界面的「检查更新」不会触碰底层 runtime。
- 以管理员身份打开终端（Windows 用 PowerShell，macOS 用 Terminal）
- 执行：
workbuddy --force-reinstall-core（注意两个短横线） - 等待输出
Core module reinstalled successfully，再补一句：workbuddy --reset-config - 该命令仅重置运行时配置，不删
skills/、不删历史任务、不碰claw-integrations/
企业微信触发升级要发对指令格式
通过企微机器人触发同步，不是随便打字就行。斜杠位置、空格、大小写都影响解析，发错会返回「指令未识别」且无日志提示。
- 必须在已绑定的 WorkBuddy 机器人对话窗口中发送
- 完整指令是：
/upgrade now（开头一个斜杠，中间一个空格，后面 no 前面没有空格） - 不能加引号、不能写成
/upgrade-now或/upgrade now（末尾多空格） - 发送后等 15 秒内看电脑端右下角是否有进度条弹出，没有就重发一次
真正麻烦的不是升级动作本身，而是升级后那些“看起来正常但实际失效”的模块——比如离线草稿箱同步逻辑变了，旧版缓存结构不兼容；又比如企业通讯录搜索字段扩展了，但本地索引没重建。这些不会报错，只会让你某天突然发现搜不到人、草稿不上传。所以升级完别急着干活，先去「审批详情页」看时间轴、「消息→通讯录」搜个运维组、「我的→草稿箱」点开一条试试同步状态。
