WorkBuddy安装提示“依赖项缺失”的本质是Python项目级第三方包未安装，需在项目根目录下优先执行pip install -r requirements.txt；若无该文件，则用pip-tools编译requirements.in生成后再安装；强烈推荐先创建并激活venv虚拟环境，再升级pip并安装依赖，以避免全局环境污染。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

办公小浣熊（WorkBuddy）安装时提示“依赖项缺失”，本质是Python环境缺少运行所需的第三方包。它不是系统级底层库缺失，而是项目级Python依赖未就位，补全方式以pip为主、环境隔离为优，不建议直接动全局Python。

确认并进入正确项目目录

安装前必须确保终端已切换到WorkBuddy解压/克隆后的根目录，该目录下应存在requirements.txt或requirements.in文件。可执行ls -l requirements.*验证。若文件不存在，需先从官方源获取或联系技术支持提供标准依赖清单。

优先用 requirements.txt 一键安装

这是最常用也最稳妥的方式，适用于已有完整依赖声明的场景：

• 在项目根目录下运行：pip install -r requirements.txt
• 如提示权限错误（Linux/macOS）：加sudo；Windows请以管理员身份打开命令提示符或PowerShell
• 若报错“pip版本过低”，先升级：python -m pip install --upgrade pip

没有 requirements.txt？用 pip-tools 生成

当只有requirements.in（如开发版或精简包），需先编译出正式依赖列表：

WorkBuddy Visio — Visio 兼容架构图生成器

使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表

下载

• 安装工具：pip install pip-tools
• 生成更新后的requirements.txt：pip-compile requirements.in
• 再执行：pip install -r requirements.txt

该方法能自动解析传递依赖，并锁定兼容版本，避免手动安装引发的冲突。

虚拟环境隔离安装（强烈推荐）

避免污染系统Python环境，尤其当你同时运行多个AI工具时：

• 创建隔离环境：python -m venv venv
• 激活环境：
   • Windows：venv\Scripts\activate
   • macOS/Linux：source venv/bin/activate
• 升级pip并安装依赖：pip install --upgrade pip && pip install -r requirements.txt

后续每次使用WorkBuddy前，都需先激活这个venv环境。

不复杂但容易忽略——关键不在“装什么”，而在“在哪装、用谁装”。只要路径对、环境净、命令准，依赖问题基本都能一次性解决。