WorkBuddy出现红色感叹号怎么排查

看到那个红色感叹号，确实容易让人心里一紧，感觉像是哪里出了大问题。不过根据我自己的排障经验，这个标记在不同位置代表的含义不太一样，多数情况下不是软件坏了，而是某个环节卡住了。可以按位置来排查。

侧栏任务旁的红色感叹号是最常见的情况，尤其在定时任务旁边看到它。这个叹号本身不是任务坏了这类永久标记，而是一个错误状态提示，意思是这个任务上一次运行失败了，比如被限流、请求被拒或者中断。关键机制在于，这个标记无法通过点击解决或者关闭提示来消除，因为它读取的是本地的last_error错误字段，清除它的唯一方法是让这条任务成功运行一次，新的成功记录会自动覆盖之前的错误状态。解决方法有两个，如果任务支持手动运行，直接点一下，只要跑通了叹号自然就消失；如果是因为模型调用高峰期被限流，可以等一段时间，或者手动调整触发时间，避开拥挤时段再试。

如果叹号出现在与Agent服务相关的状态旁，说明后台干活的agent.exe进程可能没有正常运行，或者通信链路断了。排查步骤分三步。先确认进程是否存活，打开任务管理器，在详细信息里找agent.exe，如果找不到，说明进程已经退出，需要重启WorkBuddy。再检查端口监听，在命令行执行netstat -ano加上端口号18789的过滤命令，如果没有输出，说明服务确实没启动。最后检查防火墙和杀毒软件，Windows Defender或者第三方安全软件有时会拦截Agent的出站连接，可以尝试临时关闭防火墙或者安全软件，再重启WorkBuddy看是否恢复，长期方案是在防火墙的出站规则里为agent.exe添加入站和出站允许规则。

如果叹号出现在网络诊断或者MCP服务器配置的状态灯旁，问题就出在连接上。网络诊断方面，WorkBuddy设置里自带的网络诊断工具会直接告诉你哪一项是红的，常见原因包括代理或者VPN干扰，关掉代理或者把WorkBuddy加入白名单，还有DNS解析失败或者防火墙拦截。MCP配置方面，如果是在配置MCP服务器时状态灯变红，说明配置内容、命令环境或者地址有误，需要回头检查JSON配置里的命令路径和参数是否正确。

如果界面提示任务失败但没给具体原因，可能是底层的权限或者路径问题。最直接的排查方式是打开本地的plans.json配置文件，路径在用户目录下的WorkBuddy配置文件夹里，查看last_error字段的具体值。如果是permission_denied，说明文件系统权限有问题，去系统设置的隐私和安全性里的文件系统，确保WorkBuddy对任务所需路径有读写权限，改完必须重启WorkBuddy才生效。如果是file_not_found，说明路径写错了或者文件被移走了，建议在任务配置里直接通过从资源管理器选取来设定绝对路径，避免手写出错。如果是model_unavailable，说明模型不可用或者积分耗尽，去个人中心查看积分余额，或者临时在任务设置里换一个轻量级模型试试。如果是disk_full，说明暂存盘满了，清理一下C盘AppData下WorkBuddy的Temp目录里的临时文件。