WorkBuddy专家团任务中断时需三步排查：先确认Agent进程是否存活，再通过plans.json定位last_error错误类型，最后按permission_denied、model_unavailable、frame_anchor_lost或disk_full四类错误分别修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy专家团执行中某个Agent失败，会导致整条任务链卡在中间、输出不全或直接中断，但系统不会自动跳过或重试该节点——它会原地挂起，等待人工干预，而日志里往往只显示“Task failed”这种无意义提示。
第一步：确认失败Agent是否真在运行
很多所谓“失败”，其实是Agent进程已静默退出，而非逻辑报错。按下Ctrl+Shift+Esc打开任务管理器 → 切换到“详细信息”页签 → 搜索workbuddy-agent.exe和对应Agent名称（如root-cause-analyzer、inventory-checker）→ 若完全找不到，说明该Agent根本没加载成功。
此时不要点“重试”，先彻底退出WorkBuddy（任务管理器中确认所有workbuddy*进程消失），再重新启动客户端，等托盘图标常亮、右键显示“在线”后，再手动触发一次专家团任务。
【必须等托盘图标稳定亮起3秒以上再操作，否则HyperFrames沙盒未初始化完成，Agent会立即崩溃】
第二步：查plans.json定位真实错误类型
UI上看到的“失败”只是表层信号，真正根因藏在本地配置文件plans.json里。这个文件记录了每个Agent最后一次执行的完整上下文和错误码，比任何弹窗都准。
第一步：完全退出WorkBuddy（任务管理器确认无残留进程）
第二步：打开配置文件
Windows路径：%APPDATA%\WorkBuddy\config\plans.json
macOS路径：~/Library/Application Support/WorkBuddy/config/plans.json
第三步：用VS Code打开该文件 → 搜索你刚失败的任务ID（形如task_7a2f9d）→ 找到对应Agent区块下的last_error字段
常见错误值含义：
“permission_denied”→ 该Agent被分配的沙盒权限不足，比如尝试写入C:\Program Files下受保护目录；
“model_unavailable”→ 该Agent绑定的专属模型（如Qwen-Max-for-root-cause）当前不可用，可能配额耗尽或服务端下线；
“frame_anchor_lost”→ HyperFrames状态树断连，通常是上级Agent提前退出导致子Agent失去父节点引用；
“disk_full”→ 该Agent专用暂存区（默认在%TEMP%\wb_agent_XXX）已满，无法写入中间快照。
第三步：针对性修复
方法一：权限类失败（permission_denied）
进入WorkBuddy设置 → 【安全与权限】→ 找到该Agent名称 → 开启“允许沙盒写入临时目录”并勾选“继承父级文件访问权限”。别碰“完全磁盘访问”开关，那会触发系统二次授权弹窗，反而阻塞流程。
方法二：模型类失败（model_unavailable）
打开该Agent配置页（自动化→专家团→点击对应Agent→编辑）→ 在【模型绑定】下拉菜单中，把当前模型切换为同能力等级但更稳定的备选模型（如Qwen-Max → Qwen-Max-v2-stable）→ 勾选【强制启用降级兼容模式】→ 保存。
方法三：帧锚点丢失（frame_anchor_lost）
这是HyperFrames层最典型的协同断裂。必须重置整个专家团状态树：在主界面输入指令 /reset-hyperframes → 等待终端返回“Frame Anchor rebuilt: 4 nodes synced” → 再重新提交任务。这一步会清空所有Agent的环形内存缓冲区，但保留技能绑定表和.env变量。
方法四：暂存盘满（disk_full）
找到该Agent对应的暂存路径（从plans.json中last_error旁的temp_path字段复制）→ 手动删除该目录下所有以“.tmp”和“.snapshot”结尾的文件 → 不要删空整个文件夹，否则Agent重启时会因缺失初始化文件而拒绝加载。
