WorkBuddy

外观

故障排查 ​

按报错代码或报错信息查找解决方案。看不清错误原文时，先在客户端左下角头像 → 帮助与反馈 → 意见反馈提交日志（勾选「上传日志」），再对照下表排查。

5 分钟定位法 ​

不要一上来清缓存、重装或连续点重试。先判断问题属于"服务、网络、账号、模型、任务、文件还是集成"，再做一项可逆操作验证。

  1. 保留原文：复制完整报错，记录发生时间、客户端版本、操作系统、模型和任务入口
  2. 判断范围：同一设备换网络是否正常；同一网络换设备是否正常；换模型是否正常；是否只有一个任务出错
  3. 做最小验证：刷新或重试一次；需要再次执行写文件、发消息、调用外部系统的任务前，先检查任务历史和产物，避免重复副作用
  4. 检查基础状态：客户端是否为最新版、账号是否登录正确企业、Credits/成员额度是否可用、工作空间是否存在
  5. 带证据升级：仍无法恢复时，通过"帮助与反馈"提交截图与日志；企业问题同步管理员

官方错误码速查 ​

腾讯云 FAQ 对 WorkBuddy 明确列出的错误码分为模型状态、网络环境和频率限制三组。错误码只是定位入口，不等于已经确认根因。

错误码官方归类优先处理升级条件
14003 / 11133 / 1001模型侧状态切换一个可用模型，缩短任务后重试一次多个模型持续失败，提交时间、模型与完整报错
3002 / 3003网络环境换网络验证；公司网络交由 IT 核对代理/防火墙多网络、多设备均失败
400 / 401 / 504网络环境按网络问题排查；记录报错出现在哪个页面/任务标准网络仍失败并可稳定复现
6003请求频率受限暂停连续请求，临时切换模型，稍后再试低频操作仍持续出现

HTTP 5xx 服务端错误 ​

503 Service Unavailable ​

现象：客户端与网页版均无法访问，登录界面持续加载失败，提示"503 Service Unavailable"或"服务不可用"。

原因：服务、网关或上游暂不可用，需结合影响范围与官方状态确认。

解决：

  1. 等 5-10 分钟刷新重试。503 多为瞬时故障，服务通常在几分钟内恢复
  2. 关注腾讯云健康看板确认是否有事件公告
  3. 长时间不恢复时，在客户端提交反馈附日志，或通过交流群反馈

502 Bad Gateway / 500 Internal Server Error ​

现象：登录失败、任务中断，提示"502"或"500"或"InternalError"。

原因：后端网关或服务内部错误，通常为瞬时故障。

解决：

  1. 切换网络（如公司网络→手机热点）排除本地网络问题
  2. 间隔 1-2 分钟重试一次，最多 3 次
  3. 若任务执行中断，重新发起前先查看任务历史、产物与 Credits 使用记录，再决定是否重跑

429 频率限制 ​

429 Too Many Requests / Local Agent Error: too many requests ​

现象：客户端弹出"Local Agent Error: too many requests"，或 API 返回 HTTP 429 + FailedOperation.RequestLimitExceeded。

原因：单位时间内请求过多。可能是 WorkBuddy 的 6003 频率限制，也可能是第三方模型/API 的 429。常见于自动化任务、Skill 链式调用、第三方机器人接入等场景。

解决：

  1. 降低并发，把并行任务改为串行
  2. 在自动化流程中加 1-3 秒间隔
  3. 接入第三方机器人时先在桌面端跑通，再开放给远程入口
  4. 持续触发时，WorkBuddy 的 6003 先暂停并切换模型；第三方 API 的 429 按供应商限频规则降低并发

登录与认证 ​

303 See Other 登录跳转失败 ​

现象：登录后页面空白或不停跳转，浏览器地址栏出现 303 重定向。

原因：登录态丢失或浏览器拦截了第三方 Cookie。

解决：

  1. 清除 workbuddy.cn 与 cloud.tencent.com 域名的 Cookie
  2. 关闭浏览器隐私模式或禁用拦截插件
  3. 改用 Chrome 或 Edge 标准模式重新登录

401 Unauthorized ​

现象：客户端出现 401 报错。

原因：WorkBuddy 官方 FAQ 将客户端 401 归入网络环境问题，不是腾讯云 SecretId/SecretKey 错误。只有报错明确来自你配置的第三方 API、MCP 或连接器时，才检查该服务的 API Key、Token、URL 和权限。

解决：

  1. 先按网络问题排查：切换网络、关闭拦截插件、改用标准浏览器模式
  2. 仅当第三方 API 明确返回 401 时，才在第三方平台核对该服务的 Key/Token/权限和配额
  3. 不要把桌面端 401 直接解释为腾讯云 SecretId/SecretKey 错误

登录后看不到企业能力 ​

现象：登录成功但侧边栏没有企业知识库、Skill、智能体。

原因：当前登录的是个人身份而非企业身份，或成员未被分配席位。

解决：

  1. 客户端右上角检查显示的企业名称，如不正确点击切换企业身份
  2. 联系管理员访问 copilot.tencent.com/admin/overview，确认成员已同步到企业通讯录并已分配可用席位

收不到验证码 ​

原因：手机信号弱、被拦截为垃圾短信、账号绑定状态异常。

解决：

  1. 检查手机信号与短信拦截设置
  2. 等 60 秒后重试
  3. 仍失败联系管理员检查成员状态

客户端 ​

macOS 提示"无法打开" ​

现象：双击安装包提示"无法打开'WorkBuddy'，因为无法验证开发者"。

解决：前往"系统设置 → 隐私与安全性"，滚动到底部点击"仍要打开"。不要用不明脚本移除系统安全属性。

Windows 安装被拦截 ​

现象：双击安装包无反应，或提示"被组策略阻止"。

解决：不要绕过组策略；由 IT 校验官方安装包，并按企业制度加入应用与官方网络地址白名单。

客户端启动后白屏 ​

现象：打开客户端只有白屏，无任何 UI。

原因：本地缓存或渲染异常，但官方 FAQ 未给出删除整个缓存目录的通用步骤。

解决：

  1. 先取日志（左下角头像 → 帮助与反馈 → 意见反馈，勾选「上传日志」）
  2. 核对系统版本是否满足最低要求（Windows 10+，macOS 12+）
  3. 更新到最新版本
  4. 从官方安装包覆盖安装或重新安装
  5. 仍失败时提交日志反馈。不要直接删除整个缓存目录，其中可能包含任务、配置或工作空间

更新后无法启动 ​

解决：

  1. 完整卸载旧版本
  2. 从 https://www.workbuddy.cn/ 重新下载安装包
  3. 安装后在「关于」核对版本号

更新提示安装目录有用户项目 ​

解决：先备份并把个人文件移出应用安装目录，只保留应用自身文件后再更新。不要在安装目录保存唯一副本。

重启后看不到工作空间 ​

解决：Windows 默认常见于 C:/Users/用户名/WorkBuddy；macOS 常见于 /Users/用户名/WorkBuddy。通过打开文件夹选择原日期目录或自定义目录，并把重要产物另存。不要反复新建同名目录覆盖原路径。

网络与服务状态 ​

网络隔离测试 ​

现象：仅公司网络失败，手机热点正常。

解决：

  1. 记录原网络：公司有线/公司 Wi-Fi/家庭宽带/手机热点，是否使用 VPN、代理或终端安全软件
  2. 只换一个变量：同一设备切换手机热点；或同一网络换另一台设备
  3. 若公司网络失败而热点正常，由 IT 按腾讯云最新防火墙清单核对域名、IP、代理、TLS 证书和 WebSocket
  4. 若多个网络与设备均失败，查看健康看板、更新历史并带日志反馈

企业 IT 检查清单 ​

  • 官方域名/IP 是否被防火墙、DNS、代理或 SSL 解密策略阻断
  • WebSocket、OAuth 回跳和第三方模型/连接器所需地址是否允许
  • 终端安全软件是否拦截应用启动、写入工作空间、创建子进程或网络访问
  • 变更白名单后，用单一测试账号和无敏感数据的小任务验证，并保留变更记录

任务、模型与 Credits ​

任务长时间无响应 ​

现象：任务一直执行没有结果。

解决：

  1. 使用任务区停止按钮
  2. 切换模型
  3. 从历史任务重新运行
  4. 把大任务拆成文件盘点、规则确认、生成、验收四步

乱码、答非所问、重复输出 ​

解决：

  1. 切换模型
  2. 缩短上下文
  3. 减少一次性文件
  4. 明确输出格式与停止条件

任务很慢 ​

解决：先排除网络；减少复合任务和超大文件；只启用必要 Skill/连接器；分批执行。

移动端要求上传桌面文件 ​

原因：移动端无法自动获得电脑任意路径。

解决：在电脑侧把文件放入指定工作空间，并在任务中写清路径。

自定义模型失败 ​

现象：内置模型正常，自定义模型失败。

解决：

  1. 设置 → 模型：检查供应商、API Key、模型名、Base URL、协议与余额/配额
  2. 标准协议 URL 可能自动补 /chat/completions；自定义协议按填写 URL 原样发送，需与供应商文档一致
  3. 401/429 只出现在第三方响应时，按第三方文档检查 Key/权限/配额与退避；不要套用 WorkBuddy 客户端错误码解释
  4. 所有模型失败时，回到错误码与网络章节排查，不要只修改模型配置

用量不足或 Credits 异常 ​

解决：

  1. 确认使用的是个人身份还是企业身份，以及当前套餐是否有效
  2. 企业成员让管理员查看成员授权与 Credits 使用/额度分配；不要只根据客户端提示猜测
  3. 自定义模型通常按第三方供应商计费；是否消耗 WorkBuddy 内置 Credits 以官方当前说明为准
  4. 对疑似重复消耗，保留任务时间、模型、任务记录和 Credits 变化截图后反馈

文件与任务 ​

任务完成但产物为空 ​

现象：任务执行完成但工作目录没有文件。

解决：

  1. 在产物区查看文件列表，确认保存路径
  2. 让 WorkBuddy 重新列出文件名和绝对路径
  3. 检查默认权限模式下是否限制了写入；需要写其他目录时在新建任务时切换为"允许完全访问"

文件上传到知识库失败 ​

现象：上传 .pdf / .docx 时提示"索引失败"或一直转圈。

原因：文件格式、大小或编码不符合限制。

解决：

  1. 单文件不超过 30 MB（.md/.docx/.pdf）或 300 MB（.zip/.tar.gz）
  2. 文件编码为 UTF-8 或 GBK
  3. 拆分大文件或转换格式后重新上传
  4. 索引中或索引失败时不能启用，等待索引完成

知识库答案不准 ​

解决：调整检索参数：

  • Top K：建议 3-5，值较小返回更少、更聚焦的片段，值较大增加候选但也可能带入噪声
  • Score threshold：建议 0-0.5，阈值越高越偏向高相关片段，但可能减少召回

用三类问题测试：已知答案、资料冲突、无法回答的问题。要求回答附来源；未命中时明确说"资料中未找到"，不要让模型用常识补齐企业事实。

读不了图片/PDF/Excel/Word ​

解决：切换支持该文件类型的模型；明确分步读取要求；安装并验证所需 Skill。

生成文件打不开 ​

解决：明确要求 Word/Excel/PDF/Markdown 及文件名；先生成一份小样并打开验证。

整理桌面后怀疑文件丢失 ​

解决：立即停止任务；查看目标目录、回收站、任务产物和变更；保留脚本与截图。先恢复副本，再查日志。

无法写入工作空间外目录 ​

原因：默认权限正在保护外部路径。

解决：优先把任务副本放入工作空间；确需外部写入时逐项确认，不要为了省步骤长期启用完全访问。

自动化 ​

定时任务没执行 ​

原因：桌面客户端离线、时间规则配置错误、工作目录被移动。

解决：

  1. 确认保存该任务的桌面客户端正在运行且账号保持登录
  2. 检查触发规则中的时区与时间
  3. 确认工作目录路径仍然存在
  4. 所需模型、Skill、知识库和连接器仍可用
  5. 先手工运行同一提示词验证能否正常执行

自动化任务报 InternalError ​

现象：自动化执行日志显示 InternalError 或 InternalError.System。

解决：

  1. 不要直接归因后端；更新客户端，手工运行最小任务，验证模型/Skill/授权是否正常
  2. 多次重试仍失败时检查 Skill 是否依赖已下线接口（ActionOffline）
  3. 在自动化流程中加错误处理：失败后等待 30 秒重试 1 次，仍失败则跳过并记录

无人值守任务安全边界 ​

无人值守任务不要直接执行付款、删除唯一文件、批量改名、外部群发或高风险系统操作。先低频试运行，保留日志和人工确认点；完全访问不能代替业务授权与备份。

机器人、连接器与 OAuth ​

通用排查顺序 ​

  1. 先在桌面端用同一账号、模型和提示词跑通；WorkBuddy 本体不正常时，不要先查机器人平台
  2. 确认桌面客户端正在运行，远程/机器人能力已开启，连接方式与当前配置一致
  3. 检查 Bot ID、Secret、Token、AESKey、Webhook、回调 URL 是否完整、无空格且未过期
  4. 重新授权前记录原配置和失败时间；验证第三方平台服务状态、网络与企业安全策略
  5. 更新到最新版后再复现

企业微信无响应 ​

解决：WorkBuddy 需满足官方版本要求；确认桌面端运行、助手开启、连接方式与凭据正确，再检查网络。

企业微信 URL 校验失败 ​

解决：确认服务已开启；Webhook 完整复制；Token/AESKey 与平台一致；长期连接检查 Bot ID/Secret 且无空格，过期则在平台重建。

QQ 频繁掉线/不回复 ​

解决：先切换模型；记录错误码、时间和网络，带日志反馈。

飞书 Webhook 无法校验 ​

解决：重复或失效 Webhook 可能导致校验失败；重新创建并填写，保留平台提示与时间。

微信扫码/鸿蒙兼容 ​

解决：截至 2026-07-20 FAQ 记录了部分鸿蒙 6 扫码兼容问题，可用 Android 完成首次扫码作为临时方案；后续以更新历史为准。

移动端找不到桌面文件 ​

解决：远程入口受设备与路径限制；在电脑端指定本地工作空间与文件路径。

OAuth 过期 / 授权失败 ​

解决：在官方设置入口重新授权；确认回调未被代理/扩展拦截；只授予完成任务所需范围。

API Key / Token 失败 ​

解决：在第三方平台核对状态、权限、有效期和配额；轮换密钥后立即撤销旧密钥。

MCP ActionOffline / 工具不可用 ​

解决：确认服务端可达、工具仍发布、当前模型/账号有权限；先单独测试该工具，再回到自动化。

连接器能读不能写 ​

解决：检查第三方授权范围与目标资源权限；不要通过完全访问绕过第三方权限。

提交反馈 ​

以上方案无法解决问题时，通过以下渠道反馈：

  1. 客户端内置反馈：左下角头像 → 帮助与反馈 → 意见反馈，输入框描述问题，上传截图并勾选「上传日志」
  2. 企业用户：联系企业管理员在 copilot.tencent.com/admin/overview 提交工单
  3. 交流群：扫码加入 WorkBuddy 交流群，附报错原文 + 截图 + 复现步骤

提交时务必包含：

  • 报错原文（不要只写"不能用"）
  • 操作系统版本与芯片类型（Intel/Apple Silicon）
  • 客户端版本号（「关于」中查看）
  • 复现步骤与发生时间
  • 截图或录屏

日志可能包含会话与设备信息。提交前按企业制度确认授权；截图中遮盖手机号、密钥、Cookie、内部网址、客户信息和文件正文。不要在聊天群公开发送 SecretKey、Token、Webhook 密钥或完整日志。