常见问题 ​

本文汇总了当前使用 WorkBuddy 过程中最常见的问题与处理建议，适用于日常接入、安装登录、工作空间管理、模型配置与性能排查等场景。

使用 WorkBuddy 的过程中遇问题可以在本页查询解决方案。如果没有成功解决，建议向 workbuddy@tencent.com 发送邮件咨询。

安装与登录问题 ​

1） WorkBuddy 升级或隔天重启后，原工作空间文件夹消失 ​

  • 适用系统：Windows。
  • 现象说明：升级重启后，原有工作空间在界面中消失；部分用户可在 C:/Users/用户名/WorkBuddy 目录中找到历史文件夹，但存在文件缺失情况，也有用户整个目录都不见了。
  • 建议处理：
    1. 打开文件管理器(Windows)或 Finder(Mac)，找到 WorkBuddy 大文件夹。
      • Windows：C:/Users/用户名/WorkBuddy
      • Mac: /Users/用户名/WorkBuddy
    2. 通过 WorkBuddy 打开以日期或用户自定义名字命名的文件夹即可找回原有历史记录。
    3. 建议将重要文件同步保存到独立目录。

2）点击 WorkBuddy 无反应，无法登陆或登录失败 ​

  • 常见原因(1)：未设置默认浏览器。

  • 建议处理

    Windows:

    1. 进入系统设置，打开默认应用，将 Chrome 设为默认浏览器后，选择在浏览器中打开尝试再次拉起登录验证窗口。
    2. 选择复制链接后自行打开浏览器，ctrl + v 或右键粘贴链接到浏览器，完成登录验证。

    Mac:

    1. 打开「系统偏好设置」→「通用」。
    2. 设置默认浏览器为 Chrome 或 Safari。
    3. 重启应用后重新登录。

  • 常见原因(2)：用户没有WorkBuddy账号文件夹操作权限。

  • 建议处理

    1. 确认目录权限

      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 命令确认），则需要授权。

      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

      确认 Owner 和 Access 列表中包含当前用户。可通过 whoami 命令确认当前用户名。

    2. 授权当前用户

      Mac 系统在终端中执行：

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

      Windows 系统以管理员身份打开 PowerShell，执行：

      $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

    3. 重新登录

      退出 WorkBuddy 并重新打开，重新登录账号。

  • 常见原因(3)：安全软件拦截。

  • 建议处理

临时退出以下安全软件后重试：

  • 火绒
  • 360 安全卫士
  • 电脑管家
  • Windows 安全中心

TIP

WorkBuddy 常被误拦截，关闭安全软件后重试即可。

3）Windows 11 ARM 64 架构无法安装 ​

  • 问题说明：当前版本暂不支持 ARM 64 架构的 Windows 11。
  • 建议处理：建议改用受支持的设备环境，或等待后续版本支持。

日志与问题排查 ​

1）日志在哪里查看 ​

  • 建议处理：

    • MAC： 打开 WorkBuddy，点击顶部帮助 -> 打开日志文件夹，找到对应的日志 （.zip） 包。

    • Windows： 打开 WorkBuddy，在左上角帮助的下拉框中找到打开日志目录，其中的压缩包就是日志文件。

2）在日志中发现产品问题或使用时出现产品功能异常在哪里反馈 ​

  • 建议处理：
    1. 打开WorkBuddy，在右上角帮助的下拉框中找到helpFeedback，快捷打开意见反馈入口；或在右下角头像处打开设置-帮助与反馈-意见反馈。
    2. 在意见反馈页面中，描述您遇到的问题，上传情况截图并勾选上传日志后提交反馈。

TIP

日志仅于排查问题，可能包含对话记录、设备信息等数据。详情请查阅隐私保护声明

Bot 连接问题 ​

1）已完成接入，但发送消息后没有响应 ​

  • 适用平台：QQ、企业微信、微信、飞书、钉钉。
  • 常见表现： WorkBuddy 端显示已注册或已配置完成，但机器人不回复、偶发断开，或首次可用后再次打开即失联。
  • 建议处理：
    1. 先确认当前连接状态是否仍然在线。
    2. 优先切换模型后再次测试，部分无响应问题可通过切换模型缓解。
    3. 微信场景若长时间无响应，建议断开后重新连接。
    4. 若首次可用、后续失效，请记录复现时间与平台类型，便于进一步排查。

2）鸿蒙微信扫码失败怎么办 ​

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

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

  • 问题说明：企业微信侧会对 Webhook 地址进行域名主体校验。
  • 建议处理：先核对 Webhook 地址是否完整、是否与当前配置要求一致；若仍无法通过，请保留报错截图并提交排查。

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

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

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

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

6）如何连接微信小程序 ​

  • 建议处理：打开WorkBuddy，鼠标悬停左侧小程序图标，扫码打开WorkBuddy小程序完成授权。步骤指引参考WorkBuddy 小程序简介

文件读取与工作空间问题 ​

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

  • 常见原因：当前模型不支持对应文件类型，或未安装相关插件与 Skill。
  • 建议处理：
    1. 切换到支持图片或文档输入的模型，例如支持图片理解的模型。
    2. 分步骤描述需求，让 AI 逐步完成环境安装与文件处理。
    3. 在插件或技能市场安装文档处理类插件与 Skill。

2）整理桌面后出现文件丢失 ​

  • 适用系统：Windows。
  • 现象说明：向 WorkBuddy 下发整理桌面指令后，会生成一个 PS 文件；执行后桌面完成整理，但部分文件疑似丢失。
  • 建议处理：
    1. 执行前先备份桌面重要文件。
    2. 执行后优先检查目标整理目录与回收站。
    3. 若仍有异常，请保留生成脚本与执行结果截图后排查。

3）工作文件夹无法导入 WorkBuddy ​

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

4）WorkBuddy 生成的文件打不开 ​

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

5）更新时提示"检测到应用安装目录下存在用户项目目录" ​

  • 常见原因：WorkBuddy 更新或重装时，安装目录会清空并重新写入文件。
  • 建议处理：
  1. 打开安装目录：在 WorkBuddy 图标上 右键 -> 打开文件所在位置。

提示

常见安装目录路径：

  • windows：C:\Users{用户名}\AppData\Local\Programs\WorkBuddy
  • macOS：/Applications/WorkBuddy.app

安装目录下通常有bin， locales， resources， tools， _ 这些文件夹。

  1. 移除对话产生的文件夹，仅保留文件名为 bin ， locales ， resources 和 tools 的系统文件夹。检查是否有个人文件，如果有也请一并移走防止被安装程序覆盖。

  2. 重新打开客户端，点击上方 WorkBuddy - 检查更新，等待安装包下载完成。

6）助理工作空间的历史会话找不到了怎么办？ ​

  • 常见原因： 助理工作空间中，最近产生对话的任务会在助理中展示，其他任务仅在工作空间列表展示。
  • 建议处理： 助理适用于远程控制，在电脑端新建任务时不建议将助理作为工作空间。

产品功能相关问题 ​

1）是否支持自定义模型 ​

2）是否支持多 Agent 并行工作 ​

  • 问题说明：用户希望不同任务窗口并行执行，或按接入平台分别使用独立会话窗口。
  • 当前状态：当前文档未提供明确配置方案。
  • 建议处理：建议先整理具体使用场景与预期方式，再进一步确认支持边界。

3）除内置市场外，是否支持手动导入插件 ​

  • 当前状态：当前文档未提供明确教程。
  • 建议处理：如需手动导入，建议先确认插件来源、安装方式与版本兼容性，再补充操作文档。

4）配置的机器人如何接入群聊 ​

  • 当前状态：当前文档未给出标准接入流程。
  • 建议处理：建议先确认目标平台、机器人类型与群聊权限要求，再进一步排查。

5）助理功能为什么不能修改默认文件夹 ​

  • 问题说明：助理专门适用于远程任务，不支持修改。

6）是否支持云端部署或服务器安装 ​

  • 当前状态：已有用户在 Windows Server 安装后出现连接失败，也有用户通过 SSH 连接云端失败；测试侧暂无统一环境可复现。
  • 建议处理：当前可先对外说明服务器端能力仍在完善中，正式支持以官方后续版本为准。

性能、异常与移动端限制问题 ​

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

  • 常见原因：模型异常、任务过重或网络不稳定。
  • 建议处理：
    1. 先切换模型测试。
    2. 将复杂任务拆分为更小步骤。
    3. 记录是否伴随错误码、超时或网络波动。

2）在飞书、企业微信、QQ、钉钉或微信移动端要求上传桌面文件时，提示无法完成 ​

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

3）WorkBuddy 运行缓慢，一个任务执行很久 ​

  • 建议处理：
    1. 优先确认网络环境是否稳定。
    2. 尽量减少一次性过长、过大的复合任务。
    3. 必要时切换模型，或拆分为多个独立任务并行处理。

4）WorkBuddy 任务执行卡住，没有响应 ​

  • 建议处理：
    1. 点击右下角发送任务处的按钮停止任务。
    2. 切换到其他模型。
    3. 重新执行历史任务。

常见错误码说明 ​

1）错误码 14003、11133、1001 ​

  • 常见判断：多与模型侧状态有关。
  • 建议处理：优先切换模型重试，但该方法可能仅能临时缓解。

2）错误码 3002、3003、400、401、504 ​

  • 常见判断：多与网络环境有关。
  • 建议处理：
    1. 先确认当前使用的是公司网络还是家庭网络。
    2. 若为公司网络，建议联系企业 IT 协助排查。
    3. 若为家庭网络，可按官网网络排查流程逐项处理。

3）错误码 6003 ​

  • 含义说明：表示请求频率受限，专业版也可能出现。
  • 建议处理：可先尝试切换模型，作为临时缓解方案。

账户相关问题 ​

1）如何申请退款 ​

  • 建议处理：
    1. 发起工单退货退款前，请先确定是否满足退费说明的条件。
    2. 登录 腾讯云官网，进入提交工单页面，找到腾讯云代码助手，填写退还原因和问题描述后提交工单。
    3. 提交退款工单后，工单将进入审核阶段，腾讯云客服人员将会在两个工作日内处理您提交的申请。
    4. 工单审核通过后，系统将执行退货操作。
    5. 可在订单管理页面查看退货订单，订单状态为已退款，可在费用中心页面查看款项。若审核不通过，可在工单里查看审核结果。

2）如何查询最新套餐价格 ​

  • 建议处理：WorkBuddy 套餐定价可在价格方案查看并下单购买。

3）补偿积分领取 ​

  • 建议处理：登录官网，点击右上角头像账户，前往个人主页-用量管理领取。

4）积分未到账或消耗异常 ​

  • 建议处理
    1. 登录官网，点击右上角头像账户，前往个人主页-用量管理查询积分余额和用量明细。
    2. 将异常截图发送至 workbuddy@tencent.com ，团队将核实后回复。

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

  • 建议处理：前往价格方案查看企业版定价信息和售前渠道。

6）如何注销账号 ​

  • 建议处理：前往官网登录账号，从头像处进入 个人主页-账号管理 注销账号：

7）如何开具发票 ​

  • 建议处理：
    • 个人版：可通过 WorkBuddy 官网 个人主页 查看发票。
      1. 登录 WorkBuddy 官网，进入个人主页；
      2. 在左侧导航栏中，选择 账单与发票；
      3. 点击 查看发票，前往腾讯云控制台发票管理 开发票。
    • SaaS企业版/专有云企业版：企业管理员可以登录 WorkBuddy 企业管理后台查看订单记录。
      1. 登录 WorkBuddy 企业管理后台；
      2. 在左侧导航栏中，选择 订单管理。
      3. 点击 发票管理，前往腾讯云控制台查看发票，注意请使用企业绑定的腾讯云 uin 登录腾讯云控制台。

alt text

alt text

8）升级专业版后仍显示体验版 ​

  • 问题说明：目前已知存在前端显示异常。
  • 当前状态：仍在修复中。
  • 建议处理：如已确认购买成功，可先保留订单与版本信息，等待前端显示修复。

数据安全说明 ​

使用 WorkBuddy 时数据安全可以得到充分保障。WorkBuddy 构建了完善的企业级安全体系，具体保障措施如下:

三层纵深防御安全架构 ​

  1. 技术防御层：沙箱隔离与权限控制

    • Bash 命令沙箱：AI 操作与真实系统严格隔离，防止对系统造成破坏
    • 文件系统隔离:只能访问预先授权的工作空间目录，无法访问系统敏感文件
    • 防沙箱逃逸:阻止对配置文件的写入，防止恶意脚本植入
    • 默认安全设计:启动时仅拥有只读权限，编辑文件、运行命令需显式用户批准
    • 分层权限系统:支持 allow(允许)、ask(询问)、deny(拒绝)三种权限规则

  2. 管理管控层：企业级统一管控

    • SSO 单点登录：统一身份认证，组织架构自动同步
    • Credit 额度控制：差异化 AI 使用额度，按部门/角色设置
    • IP 白名单：限制特定 IP 段设备登录，杜绝外部访问
    • 精细化工具调用权限：严格控制 AI 对文件、命令、网络的访问能力

  3. 合规审计层：数据保护与合规

    • Skill 安全审计：与安全团队联动，分级风险判别
    • skill-scanner 本地安全检查：安装前主动防御潜在风险
    • 数据本地执行不上传：所有数据在用户本地环境执行处理，从根本上杜绝数据泄露风险
    • 服务端仅处理数据片段：用后即弃，不保存，不用于模型训练
    • 完善的用户协议与隐私协议：符合网安法/数安法/个保法

通信安全保障 ​

  1. HTTPS 全链路加密

    • 所有数据传输采用 HTTPS 全链路加密
    • 支持 TLS 1.2/1.3 加密协议
    • 确保数据在传输过程中不被窃听、篡改或中间人攻击。

  2. IM 内置 Websocket 通道通信

    • 通过主流 IM(企业微信、QQ、钉钉、飞书等)内置的 Websocket 通道通信
    • 非企业内网入侵方式，不需要在企业防火墙上开放额外端口
    • 完全复用已有安全通道

  3. 安全通信网关

    • 内置安全通信网关，支持 Gateway Token 认证与连接鉴权
    • 配合 SSO/企业认证及 Role 权限控制
    • 确保每一次连接都经过严格验证
    • 不依赖 frp/ngrok/Tailscale 等第三方穿透工具

VPC 专享版安全架构 ​

  1. 物理级隔离

    • 后台服务、数据库、向量数据库等所有组件部署在独立 VPC 内
    • 与其他租户实现物理隔离，从根本上杜绝数据泄露或被其他租户访问的风险

  2. 封闭网络环境：

    • 所有服务间通信均在专属 VPC 内网中进行
    • 企业可通过私有链接从办公内网直接访问
    • 避免公网传输的安全隐患

  3. 数据主权与零泄露

    • 企业拥有 VPC 环境的绝对网络控制权和数据主权
    • 实现代码和数据"零泄露"的高级安全要求

与开源方案对比优势 ​

安全维度WorkBuddyOpen助理 开源方案
身份认证SSO 单点登录/组织架构同步/Role 权限控制Gateway Token+基础认证，需自建 SSO/手动配置 Role
网络安全HTTPS 全链路加密/企业级 IP 白名单/安全通信网关SSH/Tailscale 穿透，需自配 HTTPS 和 IP 白名单
权限管控成员授权/Credit 限额/工具调用权限/Skill 安全审计基础的读/写/执行权限，需手动配置限额与审计

合规资质保障 ​

WorkBuddy 作为腾讯云产品，继承了腾讯云的安全合规体系，拥有 400+ 国内外权威认证，包括:

  • ISO27001 信息安全管理体系认证(UKAS 国际认证和 CNAS 国内认证)
  • ISO27018 个人信息保护国际认证
  • ISO27701 隐私安全管理体系
  • CSA STAR 云安全管理体系认证(金牌)
  • 网络安全等级保护 三级/四级
  • PCI-DSS 支付卡行业数据安全标准认证
  • SOC 审计报告
  • 可信云数据安全认证

核心安全优势总结 ​

  1. 开箱即用的企业级安全：无需企业自行搭建 SSO、配置网络、审计 Skill，原生集成全套安全管控能力
  2. 安全团队背书：Skill 安全审计与安全团队深度联动，分级风险判别，非社区自治模式
  3. 合规优先：全面满足国内企业合规要求，数据本地化执行，隐私协议完善，VPC 专享版提供最高级别数据主权保障
  4. 数据零泄露：数据在本地环境执行处理，不上传云端;服务端仅处理数据片段，用后即弃，不保存，不用于模型训练

综上所述，WorkBuddy 通过技术防御、管理管控、合规审计三层纵深防御体系，结合 HTTPS 全链路加密、安全通信网关、VPC 专享版等多重安全措施，以及腾讯云 400+ 权威认证背书，完全可以保障企业数据安全，适合对数据安全有高要求的企业使用。

使用建议 ​

  • 优先保留证据：包括错误码、报错截图、系统版本、网络环境与发生时间。
  • 优先做最小化验证：先切换模型、重连平台、拆分任务，再做进一步定位。
  • 重要文件先备份：尤其是桌面整理、批量移动、工作空间迁移等操作。
  • 适合新手的入门场景：
    • 高频场景：
      1. 控制微信，自动发朋友圈或统计群聊信息。
      2. 自动编写并发布小红书内容。
      3. 自动采集指定网页信息并整理成目标文件。
    • 建议做法：优先从单一、结果明确的场景开始，先跑通一次完整流程，再逐步扩展到更复杂任务。