最可靠的方式是直接查看日志文件——WorkBuddy 的部署异常（如启动失败、Claw连接中断、技能执行卡死）几乎都会在日志中留下明确痕迹，而非仅依赖界面提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
直接看日志文件是最可靠的方式——WorkBuddy 的部署异常（比如启动失败、Claw 连接中断、技能执行卡死）几乎都会在日志里留下明确痕迹，而不是只靠界面提示猜。
定位默认日志路径，别先急着翻配置
WorkBuddy 不会强制你配日志路径，它有默认落盘位置，找对地方就能省掉 80% 的排查时间：
- Windows 用户：打开文件资源管理器，在地址栏粘贴
%APPDATA%\WorkBuddy\logs\，找最近的main.log或按日期命名的2026-04-14.log - macOS 用户：访达 →「前往」→「前往文件夹」→ 粘贴
~/Library/Logs/WorkBuddy/，同理找main.log - 如果用命令行启动过（比如
./WorkBuddy），日志就在你执行命令时所在的当前目录，文件名通常是RemoteAgentDeployerUpdater_Log.txt
别一上来就改配置或重装——先确认这个路径下有没有日志、有没有内容、最后几行是否含 ERROR 或 failed to bind port 这类关键词。
查端口冲突日志，重点盯 Address already in use
部署失败最常见的原因是端口被占，而错误信息往往藏在日志开头几行，不是弹窗提示：
WorkBuddy Visio — Visio 兼容架构图生成器
下载
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 用文本编辑器打开
main.log，搜索Address already in use或bind EADDRINUSE - 如果命中，日志里通常紧跟着端口号，例如
:3000或:8080——这就是你要查的冲突端口 - 别只信“端口 3000 被占”，实际可能是
lsof -i :3000查不到进程，因为 WorkBuddy 启动时尝试了多个 fallback 端口，得顺着日志里报错的那条找
识别技能执行失败的关键错误类型
日志里出现技能卡住、无响应、返回空结果，大概率不是模型问题，而是底层执行环境出错。以下三类错误要优先过滤：
-
FileNotFoundError：说明 WorkBuddy 找不到输入文件路径，常见于相对路径没转绝对路径，或 macOS 隐私权限没开（完全磁盘访问里没勾选 WorkBuddy.app） -
TimeoutError：不是网络超时，而是本地沙箱（file-sandbox）执行指令耗时过长，比如 PDF 合并卡在某个大附件上，日志里会带sandbox timeout after 30s -
JSONDecodeError：多发生在技能包加载阶段，说明你手动改过skill.json但格式错了，日志里会标出具体哪一行解析失败
这些错误不会触发红色弹窗，只会静默失败，必须主动搜关键词。
用 CLI 快速筛日志，避免手动滚动
等不及打开大文件？WorkBuddy 自带的 CLI 可以快速聚焦问题段：
- 运行
workbuddy log tail --level error，实时捕获新发生的错误（适合重启后立刻观察） - 想查历史：用
workbuddy log show --lines 200 | grep -i "claw\|bind\|timeout"，把关键线索一次性捞出来 - 如果连
workbuddy命令都报“command not found”，说明 CLI 没注册进系统 PATH，此时退回用文件系统方式查日志更稳
日志本身不解决问题，但它会告诉你问题不在哪——比如没看到 Claw connected，就不用再调企业微信 Webhook；看到 permission denied 却没开隐私权限，那重装毫无意义。
