WorkBuddy任务失败需先确认客户端是否真在运行，再查plans.json中last_error字段定位根因：permission_denied（权限缺失）、file_not_found（路径错误）、model_unavailable（模型不可用）或disk_full（暂存盘满），并依类型针对性修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy智能体任务失败时，界面可能只显示“执行失败”或直接卡在“准备中”，根本看不到具体报错原因；任务不会自动重试，也不会主动提示权限缺失、模型不可用或路径错误等底层问题。
先确认任务是否真在运行
任务失败的第一层原因，是WorkBuddy客户端本身没在后台持续工作。哪怕托盘图标还在，进程也可能已被系统静默终止。
按下 Ctrl+Shift+Esc 打开任务管理器 → 切换到“进程”页签 → 在搜索框输入 WorkBuddy.exe 或 claw-agent。
若列表中完全找不到对应进程，说明客户端已彻底退出；双击桌面快捷方式重启后，必须等待右下角托盘图标出现并保持常亮状态，再点击右键 → “显示主界面”，确认登录状态为“在线”。
如果托盘图标存在但右键无响应，或主界面打开后显示“离线”，【必须关闭所有安全软件（360、腾讯电脑管家等）后再重启】，否则后台通信会被拦截。
查 plans.json 看真实失败原因
UI界面上的“失败”只是表象，真正记录错误详情的是本地配置文件 plans.json——它比任何弹窗都诚实，且不被缓存干扰。
第一步：完全退出 WorkBuddy（任务管理器里确认进程消失）
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第二步：打开配置文件
Windows 路径：%APPDATA%\WorkBuddy\config\plans.json
macOS 路径：~/Library/Application Support/WorkBuddy/config/plans.json
第三步：用记事本或 VS Code 打开该文件 → 搜索你刚失败的任务名或 ID → 找到 last_error 字段值
常见值含义：
“permission_denied” → 文件系统权限被撤回；
“file_not_found” → 路径写错、文件被移动或用了相对路径；
“model_unavailable” → 当前绑定的 AI 模型服务中断或配额耗尽；
“disk_full” → 暂存盘（默认是 C:\Users\用户名\AppData\Local\WorkBuddy\Temp）空间不足。
按 last_error 类型针对性修复
方法一：last_error = "permission_denied"
Windows 用户进入“设置 → 隐私和安全性 → 文件系统” → 找到 WorkBuddy 条目 → 把任务实际访问的路径（如 D:\报表、E:\合同）全部手动开启读写开关。
macOS 用户进“系统设置 → 隐私与安全性 → 完全磁盘访问” → 拖入 WorkBuddy.app 并勾选 → 【重启 WorkBuddy 后新权限才生效】。
方法二：last_error = "file_not_found"
不要用“桌面的销售表.xlsx”这种模糊描述；右键任务配置里的文件输入框 → 选择“从资源管理器选取” → 直接拖入 Excel 文件，系统会自动生成绝对路径；或者先让 WorkBuddy 执行“列出D盘根目录下所有xlsx文件”，复制它返回的真实路径粘贴使用。
方法三：last_error = "model_unavailable"
打开 WorkBuddy 主界面 → 点击右上角【模型】面板 → 查看当前模型状态是否为“健康”；若显示“连接超时”或“配额不足”，切换至备用模型（如 GLM-4-Lite），或进入【账户】查看积分余额是否归零。
方法四：last_error = "disk_full"
打开文件资源管理器 → 右键暂存盘（通常是 C 盘）→ “属性” → 查看“可用空间”是否低于 1GB；若不足，手动清空 %LOCALAPPDATA%\WorkBuddy\Temp\ 下所有内容，不要只删部分子文件夹——残留的锁文件会导致后续任务静默失败。
