WorkBuddy常见问题及解决办法说明大全

用WorkBuddy的过程中，绝大多数问题都能在下面找到对应办法。内容覆盖日常接入、安装登录、工作空间管理、模型配置和性能排查等常见场景。先按目录定位到自己的问题，照着步骤试一遍；如果还是没解决，把错误码、截图和系统版本整理好，发邮件到 workbuddy@tencent.com 找官方支持。

还没安装WorkBuddy？注册送2000积分，最新大模型随便用，办公自动化超强AI工具！

一、装不上、登不进：安装与登录

1. 更新时提示「检测到应用安装目录下存在用户项目目录」

常见原因：更新或重装会清空安装目录并重新写入文件，本地文件可能被覆盖丢失；英伟达芯片用户可能在安装路径下生成NVIDIA Corporation文件，导致更新失败。

处理：前往WorkBuddy官网，手动下载最新版安装包并覆盖安装。

2. 升级或隔天重启后，原工作空间文件夹消失

适用系统：Windows。升级重启后，原有工作空间在界面中消失；部分用户能在 C:\Users\<用户名>\workbuddy 目录中找到历史文件夹（但可能缺文件），也有用户整个目录都不见了。

处理：打开文件管理器（Windows）或Finder（Mac），找WorkBuddy大文件夹。Windows路径是 C:\Users\<用户名>\workbuddy，Mac是 /Users/用户名/WorkBuddy。打开里面以日期或你自定义名字命名的文件夹，就能找回原有历史记录。建议把重要文件同步保存到独立目录。

3. 点击无反应，无法登录或登录失败

三种常见原因分开看：

（1）没设默认浏览器。Windows：进系统设置→默认应用，把Chrome设为默认浏览器，再选「在浏览器中打开」拉起登录验证窗口；或者点「复制链接」后自行打开浏览器，Ctrl+V粘贴完成验证。Mac：系统偏好设置→通用，把默认浏览器设为Chrome或Safari，重启应用后重登。

（2）没有WorkBuddy账号文件夹的操作权限。

Mac在终端确认目录归属：

ls -la ~/Library/Application\ Support/CodeBuddyExtension/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/

如果目录owner不是当前用户（用 whoami 确认），授权：

sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension

Windows以管理员打开PowerShell检查，再授权当前用户：

Get-Acl "$env:APPDATA\CodeBuddyExtension" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public\auth" | Format-List

$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
$path = "$env:APPDATA\CodeBuddyExtension"
takeown /F $path /R /D Y
icacls $path /grant "${user}:(OI)(CI)F" /T

确认Owner和Access列表里有当前用户后，退出WorkBuddy重新打开并登录。

（3）安全软件拦截。WorkBuddy常被误拦截。临时退出火绒、360安全卫士、电脑管家、Windows安全中心后重试即可。

4. Windows 11 ARM 64架构无法安装

当前版本暂不支持ARM 64架构的Windows 11。建议改用受支持的设备环境，或等后续版本支持。

还没安装WorkBuddy？注册送2000积分，最新大模型随便用，办公自动化超强AI工具！

二、先自己查一遍：诊断工具与日志

1. 客户端异常，怎么快速自检

WorkBuddy内置「诊断工具」，可一键检测网络、系统资源、安全软件、环境信息与崩溃日志，结果可视化展示，并自动生成 .txt 诊断报告。遇到无法登录、连接失败、客户端异常，建议先跑一遍。

怎么用：打开WorkBuddy，点顶部「帮助 → 诊断工具」弹出窗口；点「开始检测」逐项执行，实时显示进度与结果；检测中关闭弹窗不影响进行，重开可恢复查看；完成后自动生成报告，存在 logs/self-check/ 下（保留最近10份），可在弹窗底部导出或定位文件，提交反馈时一并提供。

检查项分五类：网络（API连通性、DNS、TCP端口、代理检测、丢包率）、系统资源（磁盘低于1GB报失败、低于3GB告警、内存使用）、安全软件（EDR/杀毒识别、文件读写监控）、环境信息（系统信息、客户端版本、安装日志）、崩溃日志（崩溃历史摘要）。个人账号与海外版只显示「网络」分组；企业账号及内网版/专享版显示全部。

报告已脱敏（IP仅留前两段、用户名替换为 ***），可放心提供给支持团队。检测到安全软件拦截时会给出需加白名单的路径，失败项给方向性修复建议。

2. 日志在哪里看

Mac：打开WorkBuddy，点顶部「帮助 → 打开日志文件夹」，找对应的日志 .zip 包。

Windows：左上角「帮助」下拉框里找「打开日志目录」，里面的压缩包就是日志文件。

3. 发现产品问题或功能异常，去哪反馈

打开WorkBuddy，右上角「帮助」下拉找helpFeedback快捷打开意见反馈入口；或右下角头像→设置→帮助与反馈→意见反馈。描述问题、上传截图并勾选「上传日志」后提交。日志仅用于排查，可能含对话记录与设备信息，详情见隐私保护声明。

三、机器人连上了却不回话

1. 接入完成但发消息没响应

适用平台：QQ、企业微信、微信、飞书、钉钉。WorkBuddy端显示已注册或已配置完成，但机器人不回复、偶发断开，或首次可用后再次打开就失联。

处理：先确认当前连接状态是否仍在线；优先切换模型后再测，部分无响应问题靠切模型能缓解；微信场景长时间无响应，建议断开后重新连接；若首次可用、后续失效，记录复现时间与平台类型，便于进一步排查。

2. 鸿蒙微信扫码失败

鸿蒙6的微信扫码当前存在不兼容，已知鸿蒙4可以正常连接。临时方案：先用安卓手机完成首次扫码连接，再切回鸿蒙微信继续使用。

3. 企业微信提示Webhook域名主体校验未通过

企业微信侧会对Webhook地址做域名主体校验。处理：先核对Webhook地址是否完整、是否与当前配置要求一致；仍不通过，保留报错截图提交排查。

4. QQ机器人频繁断开或不回复

机器人显示断开，或能接入但没返回内容。处理：优先切换模型测试；若持续存在，记录错误码、发生时间与网络环境后再排查。

5. 飞书配置Webhook时提示无法检查链接

重复输入同一Webhook地址后，可能出现无法检查链接的提示。处理：建议重新创建或重新填写一次配置，避免重复输入同一地址；仍失败保留提示信息后反馈。

6. 怎么连接微信小程序

打开WorkBuddy，鼠标悬停左侧小程序图标，扫码打开WorkBuddy小程序完成授权，步骤参考小程序简介。

四、文件读不了、工作空间找不到了

1. 无法读取图片、PDF、Excel、Word等文件

常见原因：当前模型不支持对应文件类型，或未安装相关插件与Skill。

处理：切换到支持图片或文档输入的模型（如支持图片理解的模型）；分步骤描述需求，让AI逐步完成环境安装与文件处理；在插件或技能市场安装文档处理类插件与Skill。

2. 整理桌面后文件丢失

适用系统：Windows。向WorkBuddy下发整理桌面指令后，会生成一个PS文件；执行后桌面完成整理，但部分文件疑似丢失。

处理：执行前先备份桌面重要文件；执行后优先检查目标整理目录与回收站；仍有异常，保留生成脚本与执行结果截图后排查。

3. 工作文件夹无法导入WorkBuddy

拖拽文件夹无效，无法导入现有工作目录。当前暂无明确修复方案，建议先记录系统版本、拖拽方式与报错现象，再提交排查。

4. 生成的文件打不开

常见原因：需求里没明确指定输出文件类型。处理：下达任务时说明要生成的格式，例如Word、Excel、PDF或Markdown。

5. 助理工作空间的历史会话找不到了

常见原因：助理工作空间里，最近产生对话的任务会在助理中展示，其他任务仅在工作空间列表展示。

处理：助理适用于远程控制，电脑端新建任务时不建议把助理作为工作空间。

五、几个功能与部署上的疑问

1. 是否支持自定义模型

支持，配置方法参考模型配置。

2. 助理功能为什么不能修改默认文件夹

助理专用于远程任务，不支持修改默认文件夹。

3. 是否支持云端部署或服务器安装

有用户反馈在Windows Server安装后出现连接失败，也有通过SSH连云端失败的；测试侧暂无统一环境可复现。服务器端能力仍在完善中，正式支持以官方后续版本为准。

六、卡顿、乱码、移动端限制

1. 回复乱码、胡乱输出，或长时间无响应

常见原因：模型异常、任务过重或网络不稳定。处理：先切换模型测试；把复杂任务拆成更小步骤；记录是否伴随错误码、超时或网络波动。

2. 移动端要求上传桌面文件时提示无法完成

适用系统：Windows。移动端下发的指令，WorkBuddy无法直接完成本地桌面文件上传，通常受当前设备权限、路径访问方式与平台能力限制。处理：改为在本机侧明确指定文件路径后再执行。

3. 运行缓慢，一个任务执行很久

优先确认网络是否稳定；尽量减少一次性过长、过大的复合任务；必要时切换模型，或拆成多个独立任务并行处理。

4. 任务执行卡住，没有响应

点右下角发送任务处的按钮停止任务；切换到其他模型；重新执行历史任务。

七、账号、退款与套餐

1. 如何申请退款

发起工单退货退款前，先确认是否满足退费说明的条件。登录腾讯云官网→提交工单页面→找腾讯云代码助手，填退还原因和问题描述后提交。工单进入审核，客服两个工作日内处理；审核通过后系统执行退货，可在订单管理页看退货订单（状态为已退款），费用中心看款项；审核不通过可在工单看结果。

2. 如何查询最新套餐价格

WorkBuddy套餐定价在价格方案页查看并下单购买。

3. 补偿积分领取

登录官网，点右上角头像账户→个人中心→套餐与用量领取。

4. 积分未到账或消耗异常

个人中心→套餐与用量查余额和用量明细；把异常截图发到 workbuddy@tencent.com，团队核实后回复。

5. 企业用户售前咨询、商务对接

前往价格方案查看企业版定价信息和售前渠道。

6. 升级专业版后仍显示体验版

已知存在前端显示异常，仍在修复中。已确认购买成功可先保留订单与版本信息，等前端显示修复。

八、数据安全，可以放心吗

使用WorkBuddy时数据安全有充分保障，它构建了多层防护体系，下面分三块说清楚。

1. 三层纵深防御安全架构

技术防御层：Bash命令沙箱把AI操作与真实系统严格隔离，防止破坏；文件系统隔离，只能访问预授权的工作空间目录，碰不到系统敏感文件；防沙箱逃逸，阻止写配置文件、防恶意脚本植入；默认安全设计，启动时仅只读权限，编辑文件、运行命令需显式批准；分层权限支持allow（允许）、ask（询问）、deny（拒绝）三种规则。

管理管控层：统一账号登录，支持客户端、移动端多端；第三方平台授权可在设置里绑定，扩展AI访问代码与协作能力；积分与额度控制，余额不足时暂停对应AI能力；精细化工具调用权限，用allow/ask/deny严格控制AI对文件、命令、网络的访问。

合规审计层：Skill安全审计与安全团队联动、分级风险判别；skill-scanner本地安全检查，安装前主动防御风险；任务本地执行，文件操作与代码运行均在本地完成；数据处理方式：用端内默认模型时，输入输出上传云端处理，用自定义模型时内容仅透传给自定义模型侧，服务端不留存；数据是否用于模型训练由设置→通用里的体验优化计划开关控制，关闭后不用于训练；配套完善的用户协议与隐私协议，符合网安法/数安法/个保法。可配置项见默认权限与安全沙箱或系统设置。

2. 通信安全保障

HTTPS全链路加密，所有数据传输采用HTTPS，支持TLS 1.2/1.3，传输中不被窃听、篡改或中间人攻击。IM内置Websocket通道通信，通过企业微信、QQ、钉钉、飞书等主流IM内置通道，不是企业内网入侵方式，不需在防火墙上开额外端口，完全复用已有安全通道。安全通信网关内置，支持Gateway Token认证与连接鉴权，配合SSO/企业认证及Role权限控制，每次连接都经过严格验证，不依赖frp/ngrok/Tailscale等第三方穿透工具。

3. VPC专享版安全架构

物理级隔离：后台服务、数据库、向量数据库等所有组件部署在独立VPC内，与其他租户物理隔离，从根本上杜绝数据泄露或被其他租户访问。封闭网络环境：所有服务间通信均在专属VPC内网中进行，企业可通过私有链接从办公内网直接访问，避免公网传输隐患。数据主权与零泄露：企业拥有VPC环境的完全的网络控制权与数据主权，实现代码和数据「零泄露」的高级安全要求。

4. 和开源方案比，强在哪

核心优势总结：开箱即用的企业级安全，无需企业自建SSO、配网络、审Skill，原生集成全套管控；安全团队背书，Skill安全审计与安全团队深度联动、分级判别，不是社区自治模式；合规优先，全面满足国内企业合规要求，数据本地化执行、隐私协议完善，VPC专享版提供最高级别数据主权；数据零泄露，数据在本地环境执行处理不上传云端，服务端仅处理数据片段、用后即弃不保存不训练。配合腾讯云400+ 权威认证背书，适合对数据安全有高要求的企业。

九、几个能少走弯路的习惯

• 优先保留证据：错误码、报错截图、系统版本、网络环境与发生时间，排查时省一半力气。
• 优先做最小化验证：先切换模型、重连平台、拆分任务，再做进一步定位，别一上来就大改配置。
• 重要文件先备份：尤其桌面整理、批量移动、工作空间迁移这类操作，动手前先拷一份。
• 新手入门别贪多：先从单一、结果明确的场景跑通一次完整流程，再逐步扩展。高频起点比如：控制微信自动发朋友圈或统计群聊信息；自动编写并发布小红书内容；自动采集指定网页信息并整理成目标文件。建议做法是从一个明确场景先跑通，再往上加复杂度。

还没安装WorkBuddy？注册送2000积分，最新大模型随便用，办公自动化超强AI工具！