WorkBuddy运行Skill报缺少依赖时,需先从错误日志定位确切包名(如ModuleNotFoundError中的'xxx'),再用pip安装;优先处理首行报错包,可单装、批量装或在Skill目录内执行requirements.txt安装;最后重启WorkBuddy并验证依赖状态与功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy运行Skill时提示缺少依赖,说明脚本已启动但关键Python包未就位,此时报错通常出现在执行中途而非安装阶段,直接补装对应包即可恢复功能。
确认缺失的依赖包名
打开WorkBuddy终端日志或点击技能执行失败后的【查看详细错误】按钮,定位类似ModuleNotFoundError: No module named 'xxx'的报错行,其中xxx就是你要装的包名。不要凭印象猜测——比如看到openpyxl就去装xlrd,两者不兼容且无法替代。
如果错误信息里出现多行ImportError,优先处理第一行报出的包,后续报错往往是前序依赖缺失引发的连锁反应。
手动安装缺失依赖
方法一:使用pip在当前环境安装
打开终端,确保WorkBuddy已关闭,执行:python -m pip install xxx(把xxx替换成上一步确认的包名)。这一步操作起来很简单,直接敲命令回车就行。
方法二:批量安装(适用于多个缺失)
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
若日志中列出3个以上缺失包,如requests、openpyxl、pyyaml,可合并安装:python -m pip install requests openpyxl pyyaml。注意不要加-r requirements.txt,因为Skill自带的requirements.txt未必被WorkBuddy自动读取。
方法三:从Skill目录内安装(最稳妥)
进入该Skill所在文件夹(路径形如%APPDATA%\WorkBuddy\skills\humanizer-zh或~/.workbuddy/skills/visio-export),检查是否存在requirements.txt。若存在,执行:python -m pip install -r requirements.txt。【必须在Skill文件夹内执行,否则可能装到系统全局环境,导致权限或版本冲突】
验证依赖是否生效
第一步:重启WorkBuddy。不重启的话,新装的包不会被加载进运行时上下文。
第二步:在WorkBuddy主界面左下角点击【Skills】→ 找到对应技能 → 点击【详情】→ 查看“依赖状态”栏是否显示绿色对勾。若仍为灰色或感叹号,说明包名拼写错误、安装路径不对,或该包与当前Python版本不兼容。
第三步:触发一次简单指令测试,例如对humanizer-zh技能输入“请把这句话改得更自然:‘用户进行了登录操作’”,观察是否正常返回结果。只要没再弹出ModuleNotFoundError,就说明依赖问题已解决。

















