WorkBuddy 入门指南
官方常见问题全解

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

• 常见原因(1)：未设置默认浏览器。
• 建议处理Windows:Mac:
  • 进入系统设置，打开默认应用，将 Chrome 设为默认浏览器后，选择在浏览器中打开尝试再次拉起登录验证窗口。
  • 选择复制链接后自行打开浏览器，ctrl + v 或右键粘贴链接到浏览器，完成登录验证。
  • 打开「系统偏好设置」→「通用」。
  • 设置默认浏览器为 Chrome 或 Safari。
  • 重启应用后重新登录。

• 常见原因(2)：用户没有Tencent WorkBuddy账号文件夹操作权限。
• 建议处理
  • 确认目录权限Mac 系统在终端中执行：如果目录 owner 不是当前用户（可通过 whoami 命令确认），则需要授权。Windows 系统在 PowerShell 中执行：确认 Owner 和 Access 列表中包含当前用户。可通过 whoami 命令确认当前用户名。
  • 授权当前用户Mac 系统在终端中执行：Windows 系统以管理员身份打开 PowerShell，执行：
  • 重新登录退出 Tencent WorkBuddy 并重新打开，重新登录账号。

  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/

  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

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

  $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)：安全软件拦截。
• 建议处理

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

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

TIP

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

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

• 建议处理：
  • MAC： 打开 WorkBuddy，点击顶部帮助 -> 打开日志文件夹，找到对应的日志 （.zip） 包。
  • Windows： 打开 WorkBuddy，在左上角帮助的下拉框中找到打开日志目录，其中的压缩包就是日志文件。

  

  

• 建议处理：
  • 打开Tencent WorkBuddy，在右下角头像处打开设置-帮助与反馈-意见反馈。
  • 在意见反馈页面中，描述您遇到的问题，上传情况截图并勾选上传日志后提交反馈。

TIP

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

• 适用系统：Windows、macOS 桌面端。
• 功能说明：WorkBuddy 内置「诊断工具」，可一键检测网络、系统资源、安全软件、环境信息与崩溃日志，结果可视化展示，并自动生成诊断报告。遇到无法登录、连接失败、客户端异常等问题时，建议先运行自检。
• 建议处理：
  • 打开 WorkBuddy，点击顶部帮助 → 诊断工具，弹出诊断窗口；
  • 点击开始检测，逐项执行检查，实时显示进度与结果；
  • 检测过程中关闭弹窗不影响检测进行，重新打开可恢复查看进度与结果；
  • 检测完成后自动生成 .txt 纯文本报告，保存在日志目录 logs/self-check/ 下（保留最近 10 份），可在弹窗底部点击导出报告或定位文件获取，提交反馈时一并提供。
• 检查项说明：

TIP

• 个人账号与海外版仅展示「网络」分组；企业账号及内网版 / iOA 版 / 专享版展示全部检查项。
• 报告已脱敏（IP 仅保留前两段、用户名替换为 ***），可安全提供给支持团队。
• 检测到安全软件拦截时，会展示需要加入白名单的路径；失败项会给出方向性修复建议。

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

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

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

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

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

• 建议处理：打开Tencent WorkBuddy，鼠标悬停左侧小程序图标，扫码打开Tencent WorkBuddy小程序完成授权。

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

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

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

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

• 常见原因：Tencent WorkBuddy 更新或重装时，安装目录会清空并重新写入文件。
• 建议处理：

1. 打开安装目录：在 Tencent WorkBuddy 图标上 右键 -> 打开文件所在位置。

提示

常见安装目录路径：

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

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

1. 移除对话产生的文件夹，仅保留文件名为 bin ， locales ， resources 和 tools 的系统文件夹。检查是否有个人文件，如果有也请一并移走防止被安装程序覆盖。
2. 重新打开客户端，点击上方 Tencent WorkBuddy - 检查更新，等待安装包下载完成。

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

• 结论：支持，配置方法参考模型配置。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 建议处理：
  • 个人版：可通过 Tencent WorkBuddy 官网 个人主页 查看发票。
  • SaaS企业版/专有云企业版：企业管理员可以登录 Tencent 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 等第三方穿透工具

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

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

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