常见问题 ​

一、文档说明 ​

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

二、接入与消息无响应 ​

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

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

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

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

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

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

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

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

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

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

三、安装与登录 ​

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

  • 适用系统：Windows。
  • 现象说明：升级重启后，原有工作空间在界面中消失；部分用户可在 C:/Users/用户名/workbuddy 目录中找到历史文件夹，但存在文件缺失情况，也有用户整个目录都不见了。
  • 当前状态：该问题已上报，仍在定位中。
  • 建议处理：
    1. 先到 C:/Users/用户名/workbuddy 路径检查是否存在历史工作目录。
    2. 如发现文件缺失，请先备份现有目录，避免重复覆盖。
    3. 建议将重要文件同步保存到独立目录。

2）安装完成后一直停留在登录中 ​

  • 适用系统：Windows。
  • 常见原因：未设置默认浏览器。
  • 建议处理：进入系统设置，打开默认应用，将 Chrome 设为默认浏览器后，重新打开 IDE 登录。

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

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

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

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

四、文件读取与工作空间 ​

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

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

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

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

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

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

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

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

五、功能能力与模型配置 ​

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

  • 结论：支持。
  • 配置方式：将 CodeBuddy 使用的 models.json 文件复制到 .workbuddy 文件夹即可。

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

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

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

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

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

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

5）Claw 为什么不能修改默认文件夹 ​

  • 当前状态：当前文档未提供明确处理方案。
  • 建议处理：建议记录当前版本、默认路径与修改失败现象，便于后续定位。

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

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

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

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

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

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

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

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

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

4）有哪些适合新手的入门场景 ​

  • 高频场景：
    1. 控制微信，自动发朋友圈或统计群聊信息。
    2. 自动编写并发布小红书内容。
    3. 自动采集指定网页信息并整理成目标文件。
  • 建议做法：优先从单一、结果明确的场景开始，先跑通一次完整流程，再逐步扩展到更复杂任务。

七、常见错误码说明 ​

1）错误码 14003、11133、1001 ​

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

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

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

3）错误码 6003 ​

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

4）开票、用量查询、积分查询 ​

  • 当前状态：本文档暂未展开说明。
  • 建议处理：建议统一收集账号信息与问题截图后，转交对应支持渠道处理。

八、使用建议 ​

  • 优先保留证据：包括错误码、报错截图、系统版本、网络环境与发生时间。
  • 优先做最小化验证：先切换模型、重连平台、拆分任务，再做进一步定位。
  • 重要文件先备份：尤其是桌面整理、批量移动、工作空间迁移等操作。