codebuddy 升级需按形态选择对应方式：ide 通过界面检查更新或官网重装，插件在编辑器市场更新并重载窗口，cli 执行 --self-update 或包管理器升级；均保留配置且需验证版本号。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

CodeBuddy 版本升级不依赖单一路径，不同形态（IDE、插件、CLI）对应不同更新方式，选对方法才能快速生效、保留配置、避免功能缺失。

CodeBuddy IDE 升级操作

适用于独立安装的桌面版 IDE（如 macOS 的 .dmg 或 Windows 的 .exe 安装包），升级后保留项目设置、主题、快捷键等全部本地数据。

• 启动 IDE 后，点击右上角账户图标 →「检查更新」，系统自动比对服务器版本；有新版本时弹窗提示，点「立即安装」即可完成下载+重启
• 若界面无提示或卡在旧版本，可手动访问官网 https://www.codebuddy.cn/work/，下载最新安装包（Windows 为 WorkBuddySetup.exe，macOS 为 WorkBuddy.dmg）
• 安装前请确保关闭所有 CodeBuddy 进程（任务管理器或活动监视器中确认无 workbuddy 相关进程）
• 双击安装包，按向导执行——安装程序会自动识别已有版本并覆盖核心文件，不删除项目、缓存或登录状态
• 重开 IDE 后，进入「帮助 → 关于 CodeBuddy」查看版本号，确认已更新至当前最新版（如 v2.1.0）

CodeBuddy 插件升级操作

适用于 VS Code、JetBrains 系列（IntelliJ IDEA、PyCharm 等）、微信开发者工具中的插件形态，升级后保留历史对话、自定义指令和模型偏好设置。

WorkBuddy Visio — Visio 兼容架构图生成器

使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表

下载

• 打开对应编辑器的插件市场（如 VS Code 左侧扩展图标），搜索「腾讯云代码助手」
• 若插件页显示「更新」按钮，直接点击即可；若显示「已启用」但功能异常，可先禁用再启用，触发重新加载
• 插件 3.3 及以上版本支持快捷指令（如 /cr 代码审查、/tests 生成单元测试），升级后需在编辑器中重启插件或重载窗口（Ctrl+Shift+P → “Developer: Reload Window”）
• 如遇插件无法更新，可尝试清除插件缓存：VS Code 中执行命令 Preferences: Open Settings (JSON)，删掉与 codebuddy 相关的 cache 路径配置，再重启

CodeBuddy Code（CLI）升级操作

面向终端用户和 DevOps 场景，通过命令行驱动开发流程，升级后保留全局配置、自定义脚本和 MCP 集成凭证。

• 终端中执行 workbuddy-cli --self-update --force，强制拉取最新 CLI 二进制并替换
• 若提示权限不足，加 sudo（macOS/Linux）或以管理员身份运行 PowerShell（Windows）
• 也可通过包管理器更新：如使用 npm，运行 npm update -g @tencent-ai/codebuddy-code；使用 pnpm 则为 pnpm add -g @tencent-ai/codebuddy-code
• 升级完成后执行 workbuddy-cli --version 验证输出是否为最新版（如 v1.5.2）

通用故障处理技巧

当升级后仍显示旧功能、模型切换失效或右下角无新版标识，往往是本地缓存或策略拦截导致，可尝试以下组合操作：

• 清除本地缓存：关闭客户端 → 手动删除缓存目录（Windows 在 %APPDATA%/CodeBuddy/Cache，macOS 在 ~/Library/Caches/CodeBuddy）→ 重启
• 企业微信用户可发送指令 /upgrade now 至绑定的 WorkBuddy 机器人，触发后台策略同步（适用于 Claws 插件兼容性更新）
• 个人微信用户可发送 /update client now 获取轻量级客户端校验响应
• 检查网络代理或防火墙是否拦截了 codebuddy.cn 和 copilot.tencent.com 域名