WorkBuddy依赖问题可通过四步解决：一、运行python -m workbuddy.cli deps --check --verbose识别过时/冲突包；二、按报错类型升降级指定包并验证；三、清理缓存、卸载重装依赖；四、生成constraints.txt锁定版本并校验签名。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行WorkBuddy时遇到模块导入失败、API调用异常或启动报错，很可能是由于依赖包版本过时或与当前版本不匹配所致。以下是识别并修复过时依赖包的具体操作步骤：
一、运行内置依赖健康检查工具
WorkBuddy v1.3.0+ 提供了命令行驱动的依赖扫描功能，可自动比对已安装包与requirements.txt中声明的兼容版本范围，并标记偏离项。
1、关闭WorkBuddy主程序及所有后台进程（包括系统托盘实例）。
2、打开终端（Windows使用PowerShell，macOS/Linux使用bash/zsh），进入WorkBuddy项目根目录。
3、执行命令：python -m workbuddy.cli deps --check --verbose。
4、等待扫描完成，观察输出中以[OUTDATED]或[MISMATCH]前缀标识的包名及当前/期望版本。
二、按需升级或降级指定依赖包
针对被标记为过时或版本冲突的关键依赖，需依据错误上下文选择升级或降级策略，避免引入破坏性变更。
1、若报错提示AttributeError: module 'xxx' has no attribute 'yyy'，说明高版本移除了旧接口，应执行降级：运行pip install fastapi==0.104.1（示例包名与版本需依实际报错替换）。
2、若报错含ImportError: cannot import name 'zzz' from 'aaa'且对应包在官方兼容矩阵中标注为“最低支持v2.8.0”，则执行升级：运行pip install --upgrade pydantic。
3、安装完成后，在同一终端执行python -m workbuddy.cli deps --validate确认所有依赖状态变为[OK]。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、强制重建依赖解析图并清除缓存
pip缓存或本地wheel构建残留可能导致版本解析逻辑失效，尤其在多次升降级后，需彻底清理环境再重建依赖关系。
1、执行pip cache purge清除全部下载缓存。
2、删除项目根目录下__pycache__文件夹及所有.pyc文件。
3、运行pip uninstall -y -r requirements.txt卸载全部依赖（如无requirements.txt，跳过此步）。
4、重新执行pip install -r requirements.txt --force-reinstall --no-deps，禁用依赖传递，仅安装清单所列包。
5、最后运行pip install -e .（若项目含setup.py或pyproject.toml），确保WorkBuddy自身作为可编辑包正确注册。
四、启用依赖版本锁定与签名验证
为防止CI/CD流程或多人协作中出现隐式版本漂移，可通过生成并校验约束文件实现精确控制。
1、在干净虚拟环境中首次安装全部依赖后，运行pip freeze > constraints.txt生成带哈希的锁定文件。
2、后续部署时，改用pip install --constraint constraints.txt -r requirements.txt进行安装。
3、验证关键包签名完整性：对requests等核心包，执行pip show requests | grep "Location"定位路径，再运行python -c "import requests; print(requests.__version__, requests.__file__)"确认加载路径与版本一致。
