旧项目安装QtFusion找不到IMcore：补wheel依赖还是迁移VibeFlux
问题背景
很多 QtFusion 旧项目不是代码写错，而是依赖安装阶段卡住了。典型现象是前面一堆库都能正常下载，最后在IMcore这里报错：
终端里最关键的信息是：
Could not find a version that satisfies the requirement IMcore No matching distribution found for IMcore看到这类信息时，不要先急着改业务代码。这个问题通常发生在依赖解析阶段：QtFusion 依赖 IMcore，而 IMcore 当前已经不能通过普通 PyPI 项目索引正常安装。
维护旧项目时，建议先按使用目标判断处理方式：如果只是让旧工程继续运行，可以通过 wheel 补齐依赖；如果后续要交付、部署或继续迭代，则更适合评估迁移到 VibeFlux。
为什么会在 IMcore 这里断掉
QtFusion 当前仍然可用，问题出在它的下游依赖：
| 环节 | 状态 |
|---|---|
| QtFusion | 包本身可用 |
| IMcore | 作为 QtFusion 依赖被 pip 继续解析 |
| PyPI IMcore 索引 | 当前不可用 |
| 安装结果 | 依赖解析失败，QtFusion 安装也跟着失败 |
实际访问IMcore的 PyPI simple 索引，可以看到它已经无法按普通项目页形式返回安装列表：
所以报错看起来像是“QtFusion 安装失败”，但根因应理解为：QtFusion 需要 IMcore，IMcore 取不到，安装链路被依赖阻断。
旧项目最快修复：改依赖文件
如果项目里有requirements.txt，先在文件里找到 IMcore 这一行。常见旧写法如下：
IMcore==0.2.7把它替换成直接 wheel 安装写法：
IMcore @ https://files.pythonhosted.org/packages/90/2e/3a8786ad2e1ae77e7f58fe8e1acb99944ead6c367eb085606633197035d6/IMcore-0.3.1-py3-none-any.whl保存后重新执行：
python-mpipinstall-rrequirements.txt这一步的目的不是升级整个项目，而是绕过已经失效的 IMcore 包名索引，直接安装可用的IMcore 0.3.1wheel。
如果项目需要交付给其他人运行，建议把这个替换写进requirements.txt，不要只在当前机器上手动安装一次。否则换到新环境后，安装过程仍可能在 IMcore 这里失败。
不改 requirements：手动补装 wheel
如果只是临时运行项目，也可以先把 IMcore 单独装好：
python-mpipinstall"IMcore @ https://files.pythonhosted.org/packages/90/2e/3a8786ad2e1ae77e7f58fe8e1acb99944ead6c367eb085606633197035d6/IMcore-0.3.1-py3-none-any.whl"再安装 QtFusion：
python-mpipinstallQtFusion如果网络或项目索引访问不稳定，也可以先下载并保存对应的.whl文件，再从本地文件安装。注意.whl是安装包，不需要解压：
python-mpipinstall.\imcore-0.3.1-py3-none-any.whl python-mpipinstallQtFusion在 Linux 或 macOS 中使用：
python-mpipinstall./imcore-0.3.1-py3-none-any.whl python-mpipinstallQtFusion更推荐的长期做法：迁移 VibeFlux
如果项目不是一次性运行，而是后续还要维护，建议评估把 QtFusion 迁移到VibeFlux。VibeFlux 是可通过 PyPI 安装的计算机视觉桌面应用工具包，PyPI simple 索引中可以看到它有可安装文件：
安装方式：
python-mpipinstallVibeFlux迁移的第一步通常是替换导入路径。原来：
importQtFusion改为：
importVibeFlux原来：
fromQtFusion.xxximportSomeClass改为：
fromVibeFlux.xxximportSomeClass替换后再按项目入口验证窗口、数据处理和识别流程。对于依赖较深的旧项目，不建议只改包名后直接交付，应至少完成一次安装、启动和核心功能检查。
迁移前后检查
切换 VibeFlux 后，可以按下面顺序确认项目状态：
- 先全局搜索
QtFusion，确认导入语句已经替换； - 重新安装依赖，确认安装过程不再停在 IMcore；
- 运行项目入口脚本，确认界面或主流程能启动；
- 如果项目里有截图、识别、绘图等功能，再逐个打开对应页面确认。
这几个检查点比盲目重装环境更有效。只要安装阶段不再解析失败，后续问题通常需要回到项目自身依赖或配置继续排查。
建议处理顺序
先看你的目标是什么：
| 项目状态 | 推荐做法 |
|---|---|
| 只想复现旧项目 | 改requirements.txt中的 IMcore 行 |
| 短期运行旧项目 | 先 pip 安装 IMcore wheel |
| 已有本地 wheel 文件 | 直接从本地.whl安装 |
| 后续还要维护项目 | 迁移到 VibeFlux |
这样处理后，问题就不会停留在“pip 为什么找不到包”上，而是能根据项目用途选择更合适的修复路线。
参考地址
- PyPI simple IMcore：
https://pypi.org/simple/imcore/ - PyPI simple QtFusion：
https://pypi.org/simple/qtfusion/ - PyPI simple VibeFlux：
https://pypi.org/simple/vibeflux/ - IMcore wheel：
https://files.pythonhosted.org/packages/90/2e/3a8786ad2e1ae77e7f58fe8e1acb99944ead6c367eb085606633197035d6/IMcore-0.3.1-py3-none-any.whl