应使用虚拟环境隔离技术解决workbuddy安装时的依赖冲突：一、用python -m venv创建并激活venv；二、用pipenv --python 3.9初始化并安装依赖；三、用conda create -n workbuddy-env python=3.9创建并激活conda环境，再混合安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy时遇到依赖库版本冲突，导致pip报错或模块导入失败，则很可能是系统全局Python环境中已存在不兼容的包版本。以下是使用虚拟环境隔离技术解决该问题的具体步骤：
一、创建独立的venv虚拟环境
通过Python内置的venv模块新建一个与系统环境完全隔离的运行空间，确保WorkBuddy所需依赖仅在此环境中安装，不干扰其他项目。
1、打开终端（Windows用户使用命令提示符或PowerShell，macOS/Linux用户使用Terminal）。
2、执行命令切换至WorkBuddy源码所在目录：cd /path/to/workbuddy。
3、运行以下命令创建名为venv的虚拟环境：python -m venv venv。
4、激活该虚拟环境：Windows下执行venv\Scripts\activate.bat；macOS/Linux下执行source venv/bin/activate。
二、使用pipenv构建带锁定文件的环境
pipenv结合了pip和virtualenv的功能，并通过Pipfile.lock精确固定所有依赖版本，可有效避免因间接依赖引发的冲突。
1、确保已安装pipenv：pip install pipenv。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、在WorkBuddy项目根目录下初始化环境：pipenv --python 3.9（指定与WorkBuddy兼容的Python版本）。
3、将requirements.txt导入依赖清单：pipenv install -r requirements.txt。
4、进入该环境执行安装：pipenv shell，随后运行pip install -e .完成WorkBuddy本地开发安装。
三、基于conda创建专用环境
conda支持跨语言包管理，能同时处理Python包及底层C/C++库依赖，对含编译组件的WorkBuddy扩展模块尤为适用。
1、检查conda是否可用：conda --version。
2、创建名称为workbuddy-env、Python版本为3.9的环境：conda create -n workbuddy-env python=3.9。
3、激活该环境：conda activate workbuddy-env。
4、优先使用conda安装科学计算类依赖（如numpy、pandas），再用pip补装conda仓库中缺失的包：pip install -e .。
