workbuddy任务报“缺少依赖”时需先查日志确认缺失程序名（如playwright、ffmpeg），再按类型补装：浏览器类运行npx playwright install chromium；图像/文档类用brew或apt/dnf安装对应工具；音视频类注意fedora须用ffmpeg-free；若已安装则需在workbuddy高级设置中手动配置path并重启生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 执行某项任务时突然提示“缺少依赖”“命令未找到”或“无法启动浏览器”，说明当前操作链中某个环节需要调用外部软件，而该软件尚未安装或未加入系统路径——此时不能跳过，也不能仅靠重试解决。
判断是否真缺软件
第一步：在 WorkBuddy 对话框中输入「显示最近一次失败详情」，回车。查看日志里明确报错的关键词，例如 【playwright】、【ffmpeg】、【libreoffice】 或 【convert】。这些就是它试图调用但找不到的程序名。
第二步：打开终端（macOS/Linux）或 PowerShell（Windows），直接运行该命令，例如输入 playwright --version。如果返回“command not found”或“不是内部或外部命令”，确认缺失；若返回版本号，说明已装但 WorkBuddy 没识别到路径。
按类型补装对应软件
方法一：浏览器自动化类（如 playwright、puppeteer）
执行 npx playwright install chromium。这一步必须运行，否则即使装了 Playwright 包，也缺实际渲染引擎。不装 chromium 会导致所有网页操作卡在“启动浏览器”阶段，且无明确错误提示。
方法二：图像/文档处理类（如 convert、libreoffice、pdftotext）
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
macOS 用户用 Homebrew 安装：brew install imagemagick poppler libreoffice。其中 【poppler 必须装，否则 pdftotext 不可用】；Windows 用户需手动下载 LibreOffice 安装包并勾选“注册为默认 PDF 处理器”，否则 WorkBuddy 调用时会静默失败。
方法三：音视频类（如 ffmpeg）
Ubuntu/Debian：运行 sudo apt update && sudo apt install ffmpeg；Fedora：用 sudo dnf install ffmpeg-free（注意是 ffmpeg-free，非 ffmpeg，否则因编解码许可问题无法调用）。
让 WorkBuddy 找到已装软件
① 打开系统终端，运行 which ffmpeg（macOS/Linux）或 where ffmpeg（Windows PowerShell），复制完整路径，例如 /opt/homebrew/bin/ffmpeg。
② 进入 WorkBuddy 客户端 → 设置 → 高级 → 环境变量配置，点击「添加变量」，变量名填 PATH，值填你刚复制的路径 + 原有 PATH，中间用英文冒号（macOS/Linux）或分号（Windows）连接。例如 macOS 上填：/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin。
③ 重启 WorkBuddy 客户端。不重启，新 PATH 不生效。
