客户端·环境·故障41 个
#75 WorkBuddy 占用内存很大(达 47GB),是什么原因、怎么处理?▾
标准答案
是客户端内部多个后台组件资源未及时回收导致的累积——多个会话/子进程叠加,加上腾讯文档编辑引擎(editor_sdk)长时间不释放内存。不会造成数据丢失,只是长时间使用会累加占用。优化建议:1. 长时间不用时退出客户端,不要一直挂在后台;2. 出现该现象可关闭重启恢复。
#436 什么是自动备份?▾
标准答案
在安全中心的沙箱安全里开启后,Agent 修改已有文件前会自动生成快照(新建文件不备份),开启后文件修改可直接进行、不再逐个弹窗。同一文件在一次对话轮次内只在首次修改前生成快照,可打开备份目录查看。所有会话共享备份空间,默认上限 3000 MB,空间不足时清理最早的备份。默认开启,建议保持。
#437 客户端异常时如何快速自检?日志在哪里、怎么反馈?▾
标准答案
遇到无法登录、连接失败、客户端异常,先用「帮助 → 诊断工具」一键检测网络、系统资源、安全软件、环境与崩溃日志,报告已脱敏保存在 logs/self-check/ 下可导出。查看日志:帮助 → 打开日志文件夹/目录,取压缩包。反馈:帮助 → helpFeedback 或 设置-帮助与反馈-意见反馈,描述问题、上传截图并勾选「上传日志」后提交。
#438 Mac电脑上安装了WorkBuddy无法打开▾
标准答案
您好,请检查Mac系统的“系统设置”(或“系统偏好设置”)中的“隐私与安全性”(或“安全性与隐私”)部分。在“安全性”区域,如果看到提示“WorkBuddy”已被阻止使用,因为它不是从 App Store下载的,请点击“仍要打开”(或“打开”)按钮,并输入管理员密码,然后再次尝试打开WorkBuddy。建议设置默认浏览器为 Chrome 或 Safari。
#439 Windows版镜像能否预装WorkBuddy▾
标准答案
您好,腾讯云桌面同时提供腾讯系 OpenClaw 镜像,预装WorkBuddy,可按需选择镜像。实例基础配置推荐最低4核8G。
参考:https://cloud.tencent.com/document/product/1291/128042
#440 WorkBuddy APP如何下载▾
标准答案
您好,WorkBuddy APP 已同步上线 iOS、Android、鸿蒙三大版本,您可前往对应应用商店搜索【WorkBuddy】下载安装
**说明**:
WorkBuddy APP仅支持HarmonyOS 5及以上设备通过应用市场下载APP。
#441 WorkBuddy企业版智能体配置了全员可见但个人客户端仍显示不可见▾
标准答案
您好,WorkBuddy企业版智能体配置了全员可见,不等于所有成员自动在客户端可见,需发布并重新登录后才生效。发布完成后退出账号重新登录才能看到最新状态(退出账号入口在客户端左下角,仅重启客户端可能不生效)。
客户端默认可见范围是「个人」,重新登录后若仍显示个人可重新调整可见范围。
#442 WorkBuddy卸载或重新安装是否会丢失数据▾
标准答案
您好,同一台电脑上 WorkBuddy**覆盖安装**一般不会丢失聊天记录、工作内容;卸载有概率连带删除本地数据,不建议直接卸载重装,建议提前备份工作空间。
- Mac:先完整复制 WorkBuddy 文件夹备份再操作
- Windows:原目录直接覆盖安装通常可保留记录,以实际测试为准
**说明:**
保留数据优先用新版安装包直接覆盖原目录安装,不用卸载。
#443 WorkBuddy是否支持历史版本下载或版本回退功能▾
标准答案
您好,WorkBuddy支持历史版本下载或版本回退功能,具体操作可参考 [历史版本下载](https://www.workbuddy.cn/docs/workbuddy/Download-History)。
**说明:**
- WorkBuddy 的资料、记忆、技能、对话等数据保存在本机本地,回退安装旧版本后数据仍然保留,不会因版本回退而丢失
- 回退安装建议采用覆盖安装方式(不卸载旧版直接安装)
- 建议备份 .workbuddy 目录与工作区目录,进一步保障数据安全
#444 WorkBuddy是否支持在统信OS上安装客户端▾
标准答案
您好,WorkBuddy 暂不支持在统信OS(兆芯CPU)上安装客户端。WorkBuddy 目前仅支持以下操作系统:Mac(ARM64 和 x64 架构)、Windows(x64 架构,兼容 ARM64)、iOS、Android、鸿蒙桌面版和鸿蒙移动版。
#445 WorkBuddy是否有离线安装包▾
标准答案
您好,WorkBuddy暂未提供离线安装包。
#446 WorkBuddy能否修改日志文件存储路径▾
标准答案
您好,WorkBuddy暂不支持修改日志文件存储路径。
#447 国际站是否有WorkBuddy▾
标准答案
您好,国际站有WorkBuddy,国际站和国内站的使用存在差异,APP 也不是同一个。您可访问 [Tencent WorkBuddy](https://www.tencentcloud.com/zh/products/workbuddy) 点击【立即下载】使用国际站WorkBuddy。
#448 腾讯云WorkBuddy是什么/如何下载▾
标准答案
WorkBuddy是腾讯旗下全场景AI智能体,它完全兼容OpenClaw的技能,同时还做到了更易用、更安全、更懂办公。
WorkBuddy彻底砍掉了让人头秃的云端部署环节。在官网下载安装后,直接输入指令就能让WorkBuddy帮你干活;如果你想通过企业微信远程“遥控”,最快 1 分钟即可完成配置并连接。
此外,它还能无缝接入QQ、飞书、钉钉等工具。这意味着,哪怕你在外通勤,只需掏出手机发条语音,它就能在你的办公电脑上自动查资料、写推文,直接交付可验收的结果。
WorkBuddy不是一个只会聊天的网页框,而是“能听懂人话、带脑子思考”的桌面智能体。
您可在 [WorkBuddy - AI Agent 办公新范式](https://www.codebuddy.cn/work/) 官网进行下载。
#449 WorkBuddy如何手动检查更新版本▾
标准答案
您好,WorkBuddy手动检查更新版本步骤如下:
1. 打开 WorkBuddy 客户端,点击界面中的【头像】入口
2. 在头像弹出的菜单中找到『检查更新』功能,点击即可检查新版本
#450 WorkBuddy网页端与客户端不同步如何处理▾
标准答案
您好,网页端与客户端功能不同步为产品当前现状,并非故障。WorkBuddy 网页端定位为试用,与桌面客户端的功能不同步(例如企业 Skill、连接器等在各端的显示范围存在差异),历史数据也不同步;实际功能使用建议以桌面客户端为主。
#451 为何有三个WorkBuddy更新日志网站▾
标准答案
您好,WorkBuddy 更新日志会在 CodeBuddy 官网文档、WorkBuddy 官网文档、腾讯云官方文档三处同步发布。CodeBuddy 与 WorkBuddy 是两款不同软件,同属腾讯云,因此多个官方文档站点会分别更新。三处文档均为人工维护,内容同步会存在时间差。如果发现文档内容不一致,建议多入口交叉核对,或联系腾讯云技术顾问反馈。
#452 双击WorkBuddy图标没反应打不开▾
标准答案
您好,该现象常见原因是客户端后台进程仍在运行,但主窗口没有正常显示。此时再次双击图标,程序检测到已有实例运行会直接退出,表现为 “点击图标没反应”。
**建议操作:**
打开任务管理器(Ctrl+Shift+Esc),结束所有 WorkBuddy 相关进程;如果系统托盘存在 WorkBuddy 图标,可先右键退出,操作更彻底。结束进程后,重新双击桌面图标启动。
不方便逐个排查进程时,直接重启电脑再打开客户端也可以。
#453 CodeBuddy IDE更新版本提示冲突▾
标准答案
您好,若CodeBuddy IDE更新版本提示冲突,建议您直接从官网下载最新的安装包直接安装。新版本会自动覆盖旧版本,无需手动卸载。安装路径将与原目录保持一致。如果后续仍无法正常更新,可继续通过官网下载安装包进行更新。
#454 CodeBuddy agents功能和WorkBuddy agents功能有何区别▾
标准答案
您好,您在 CodeBuddy 里看到的"打开 agents"功能,是 CodeBuddy 自身的 Subagents 能力,用于在编码场景中创建专业化 AI 助手。它和 WorkBuddy 的定位完全不同——CodeBuddy 的 Agent 服务于开发工作流,WorkBuddy 的 Agent 服务于办公场景。两者虽然都叫"Agent",但产品边界、使用场景和运行环境是清晰区分的。
#455 CodeBuddy专享版如何获取插件安装包▾
标准答案
您好,CodeBuddy专享版使用的是与企业环境绑定的特定插件,需要按以下方式获取:
**作为企业管理员**
1. 登录企业管理后台,在【基础设置】中配置好企业信息(简称、图标等)
2. 进入 【插件打包下载】 模块
3. 若配置有变更,先点击【打包插件】,等待系统完成打包
4. 打包完成后,即可下载适用于 VS Code 和 JetBrains IDEs 的定制化插件包,分发给企业成员安装
**作为企业成员(使用者)**
需要联系您所在企业的 CodeBuddy 管理员,由管理员从企业管理后台打包并提供定制化的插件安装包给您。
#456 CodeBuddy中Python没有语法高亮且无法跳转定义▾
标准答案
您好,CodeBuddy中Python没有语法高亮且无法跳转定义,是因为`Plance` 校验了微软自己的签名,第三方会有运行不起来的问题,您可按照以下步骤进行操作:
1. 卸载 `Pylance`
2. 安装 `BasedPyright``BasedPyright` 默认的检查比较严格,觉得多余可以在设置的这个位置改成 `standard`:`basedpyright.analysis.typeCheckingMode`即可。
#457 CodeBuddy中插件提示环境已禁用此扩展,怎么解决?▾
标准答案
您好,CodeBuddy中插件提示环境已禁用此扩展,请使用命令面板`Enable Extension`启用所有扩展。
#458 CodeBuddy国际版是否支持ARM64处理器▾
标准答案
您好,CodeBuddy国际版支持ARM64处理器。
#459 CodeBuddy基础体验包是否每天都刷新▾
标准答案
您好,CodeBuddy基础体验包是每天都刷新。
#460 CodeBuddy插件支持哪些主流IDE,如何安装▾
标准答案
CodeBuddy可以通过以下三种插件进行安装:
**一、VSCode**
安装Visual Studio Code:建议安装版本1.84及以上,您可前往 [VSCode官网下载](https://code.visualstudio.com/Download)。
- **快速安装**:如果您已正确安装 VS Code,[单击一键安装CodeBuddy](vscode:extension/Tencent-Cloud.coding-copilot)
- **从IDE插件市场安装**:您也可以在VS Code插件市场手动搜索**CodeBuddy**并下载安装
- **下载安装包**:您也可以 [单击下载最新版本安装包](https://acc.cloud.tencent.com/v2/plugin/download?platform=vscode&version=latest),并前往VS Code手动安装
**二、JetBrains IDEs**
安装JetBrain IDEs:[下载并安装任意JetBrains的IDE产品](https://www.jetbrains.com.cn/idea/),例如Intellij IDEA、WebStrom、PyCharm、PhpStrom、GoLand等IDE。
- **从IDE插件市场安装**:打开插件市场:在右上角的【设置】中,单击【插件】,搜索**CodeBuddy**,点击【安装】
- **下载安装包**:[单击下载最新版本安装包](https://acc.cloud.tencent.com/v2/plugin/download?platform=jetbrains&version=latest),并前往JetBrains IDEs手动安装
**三、Android Studio**
1. **下载 Android Studio**:访问 [Android Studio](https://developer.android.com/) 进行下载
2. **安装插件**:安装插件的方式与 [JetBrains IDEs](https://cloud.tencent.com/document/product/1749/105967#ce4c2c51-8f86-4c1b-9d2a-f3c7617d8739) 一致,可参考进行安装
**四、微信开发者工具IDE**
1. 前往 [微信开发者平台IDE](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) 下载微信开发者工具,注意需要下载最新**开发版 Nightly Build**
2. 在开发者平台上创建自己所需的项目,单击【扩展区域】图标,展开热门或者在搜索栏中输入**CodeBuddy**,单击CodeBuddy右边的【安装】,等待安装完成即可
#461 CodeBuddy打开VSCode无响应▾
标准答案
您好,CodeBuddy打开VSCode无响应,请先禁用CodeBuddy打开项目后再启用。
#462 CodeBuddy找不到models.json 文件▾
标准答案
您好,models.json文件是要自己新建的,可以让CodeBuddy 给你建立,询问 CodeBuddy 如何配置文件,帮你新建。
#463 CodeBuddy插件是否支持WSL▾
标准答案
您好,CodeBuddy IDE插件支持WSL。
#464 CodeBuddy无法打开终端,怎么解决?▾
标准答案
您好,CodeBuddy无法打开终端,请按照以下方式进行解决:
1. 点击顶部CodeBuddy IDE ,查看首选项,选择设置
2. 在设置中所搜 `Shell`,开启 `Terminal › Integrated › Shell Integration: Decorations` 为 `Enabled`即可
#465 CodeBuddy是否支持降配▾
标准答案
您好,CodeBuddy不支持降配,也不支持同版本缩短周期,如包年服务改为包月服务。
#466 CodeBuddy点击更新,提示Hash mismatch如何解决▾
标准答案
您好,CodeBuddy点击更新,提示Hash mismatch问题,建议您清除本地缓存后再点击更新。
#467 CodeBuddy生成commit message时是否支持整个文件去生成▾
标准答案
您好,CodeBuddy生成commit message时支持整个文件去生成。代码结构越清晰、函数拆分越合理、注释越完善,生成的 commit message 就越精准;反之,混乱的代码会让生成结果偏差较大。建议及时更新CodeBuddy插件到最新版本,以获得更好的生成效果和体验优化。
#468 CodeBuddy终端无法复用▾
标准答案
您好,CodeBuddy终端无法复用是因为`zsh` 安装了有慢速组件或者主题会导致获取 `Terminal` 状态失败,您可按照以下方式进行排查:
- 对 `zsh` 没有诉求的用户,可以考虑更换 `bash` 主题
- 对 `zsh` 有诉求的用户,可以排查下 `~/.zshrc` 有没有配置类似的主题
#469 CodeBuddy自定义Agent是什么▾
标准答案
您好,在CodeBuddy IDE中存在两种模式,分别是agentic和manual,他们都会在设置页中 Subagents 名称的后面展示出来。具体可参考 [Subagents 使用指南](https://www.codebuddy.cn/docs/ide/Features/Subagents)。
#470 Codebuddy插件是否支持在Cursor中使用▾
标准答案
您好,Codebuddy插件不支持在Cursor中使用,存在兼容性问题,也无法正常采集效能数据。
#471 为什么在Mac上最小化CodeBuddy没有提示而Windows有提示▾
标准答案
您好,您可通过IDE【设置】 >【通用】> 【系统通知】查看是否打开,检查电脑系统通知。
#472 VSCode使用CodeBuddy插件经常卡在部分回答如何解决▾
标准答案
您好,VSCode使用CodeBuddy插件经常卡在部分回答问题,您可以先关闭VSCode重开再使用。
#473 VSCode安装不了一些闭源插件如何解决▾
标准答案
您好,由于微软禁用非VSCode装闭源插件,无法安装非VSCode版本插件限制导致,暂时无法优化。
#474 macOS运行CodeBuddy弹出对话框"ENOTDIR: not a directory"如何解决▾
标准答案
您好,macOS运行CodeBuddy弹出对话框"ENOTDIR: not a directory",建议您检查项目下是否有创建launch.json文件夹。
#475 如何查看CodeBuddy IDE本地日志▾
标准答案
您好,您可参考如下方式查看CodeBuddy IDE本地日志:
- MAC:打开 CodeBuddy IDE,点击顶部帮助 ,打开日志文件夹,找到对应的日志 (.zip) 包
- Windows:打开 CodeBuddy IDE,点击顶部帮助 ,打开日志文件夹,找到对应的日志 (.zip) 包
- 手动查询路径:`C:\Users\<您的用户名>\AppData\Roaming\CodeBuddy\logs`(将<您的用户名>替换为 Windows 系统用户名)
资料来源:BuddyQ 伙伴加速营(buddyq.cloud.tencent.com),2026-11-20 08:34 全量导出 › 共 2318 条。
商务口径以《WorkBuddy 商务红线权威源》为准。案例均为腾讯官方公开案例,引用须注明来源,不得表述为安畅交付。
整理:许瀚仁 | 18628372328 | xuhr@anchnet.com
商务口径以《WorkBuddy 商务红线权威源》为准。案例均为腾讯官方公开案例,引用须注明来源,不得表述为安畅交付。
整理:许瀚仁 | 18628372328 | xuhr@anchnet.com