出问题怎么办：任务失败 / 上传失败 / 执行中断的排查手册

用 AI 工具最怕的不是不会用，是出问题不知道该怎么办。这篇按官方文档整理出一套排查顺序。

先确认两个基本条件（官方环境要求）

官方文档列出的环境要求只有两条：

1. 网络：需要网络连接以调用 AI 模型服务
2. 账号：已注册并登录 WorkBuddy 账号

问题一：文件传不上去

官方给出的排查顺序：

1. 检查文件格式是否不受支持——官方支持 PDF / Word / TXT / Markdown / RTF、Excel / CSV / TSV、PPT、JPG/PNG/GIF/BMP、ZIP/RAR、各类代码文件
2. 大文件可以先压缩拆分
3. 持续失败建议检查网络连接

实操补充：

• 老版本办公文件（.doc/.xls/.ppt、WPS 的 .wps/.et/.dps）建议另存为新格式再传
• 扫描件 PDF 能传但读不出文字，需要先做 OCR（判断方法：用阅读器打开，试试能不能选中文字）
• 一堆同类文件，打成 ZIP 一次传，或者把文件夹设为工作空间让它直接读

问题二：任务失败了

官方说明任务有 6 种状态：进行中、规划中、已完成、待处理、失败、已归档。

看到「失败」时的正确做法（官方明确支持）：

适合继续处理的场景（官方列举）：

• 第一次结果不够完整，想继续细化
• 执行失败后，需要补充信息再试一次
• 基于之前的结果扩展新需求

关键动作：失败后先去看对话区，读它给出的失败原因，针对性地补充信息，而不是原封不动再发一遍。

问题三：任务卡在「待处理」

官方对「待处理」的说明是：任务等待进一步处理或输入。

这不是卡死，是它在等你。去对话区看它问了什么，补上信息就能继续。

问题四：执行中想停下来

官方文档说明：任务正在执行时，输入框区域会显示停止入口，可以随时中断。

中断后仍可：继续补充新说明、调整需求后重新发送、基于已有内容继续推进。

什么时候中断：发现方向跑偏，或者在某一步反复打转。越早中断越省时间。

问题五：找不到生成的结果

官方说明结果区在右侧，提供概览（工作空间文件 / 浏览器 / 变更）和产物两类内容。

如果右边没显示：点对话区顶部第 4 个按钮「显示详情面板」打开。

一套通用排查顺序

什么时候别自己折腾

如果卡在安装、环境配置、权限授权这类问题上，自己反复试往往越试越乱。 这类问题找一个懂电脑的人远程看一眼，通常十几分钟就解决了——比自己折腾两小时划算。