一、预打包版本部署问题
在 Windows 11 环境下使用预打包版本时,遇到以下依赖安装问题:
-
sacremoses==0.0.53 构建失败
- 报错:
error: invalid command 'bdist_wheel'
- 现象:安装
argostranslate~=1.9.6 时,其硬编码依赖的 sacremoses==0.0.53 为源码包,在 pip 构建隔离环境下因缺少 wheel 依赖而构建失败
- 建议:考虑升级
argostranslate 版本以解除对老版 sacremoses 的锁定,或在预打包环境中预置 wheel/setuptools
-
pix2text 依赖缺失
- 报错:
ModuleNotFoundError: No module named 'cv2'
- 现象:
pix2text 的 CORE 层依赖 opencv-python,但预打包环境未包含该模块
- 建议:检查
requirements.txt 或依赖安装脚本,确保运行时硬性依赖被完整声明
二、源码运行体验问题
环境:Windows 11 + Python 3.14(系统默认),手动创建虚拟环境运行
-
初始化窗口交互问题
- 现象:定位依赖目录后,程序弹出的初始化小窗口具有"始终置顶 + 无法拖动"特性,会遮挡系统通知弹窗(如图示例),且用户无法移动窗口查看被遮内容
- 建议:移除"始终置顶"属性,或允许窗口拖动,避免阻塞用户操作
-
Python 版本限制过于严格
- 现状:项目硬编码限定 Python 3.11
- 问题:若用户系统已安装更高版本(如 3.14)且已预装部分依赖,无法复用本地缓存,需重复下载
- 建议:如无 C 扩展兼容性硬性要求,可将
python_requires 放宽至 >=3.11,并补充 pyproject.toml / setup.py 中的版本说明
三、补充信息
- 预打包版问题已通过手动安装
wheel + opencv-python 临时解决
- 源码运行环境依赖已通过虚拟环境正常安装,除上述交互问题外功能可用
感谢维护,期待回复。
一、预打包版本部署问题
在 Windows 11 环境下使用预打包版本时,遇到以下依赖安装问题:
sacremoses==0.0.53 构建失败
error: invalid command 'bdist_wheel'argostranslate~=1.9.6时,其硬编码依赖的sacremoses==0.0.53为源码包,在 pip 构建隔离环境下因缺少wheel依赖而构建失败argostranslate版本以解除对老版sacremoses的锁定,或在预打包环境中预置wheel/setuptoolspix2text 依赖缺失
ModuleNotFoundError: No module named 'cv2'pix2text的 CORE 层依赖opencv-python,但预打包环境未包含该模块requirements.txt或依赖安装脚本,确保运行时硬性依赖被完整声明二、源码运行体验问题
环境:Windows 11 + Python 3.14(系统默认),手动创建虚拟环境运行
初始化窗口交互问题
Python 版本限制过于严格
python_requires放宽至>=3.11,并补充pyproject.toml/setup.py中的版本说明三、补充信息
wheel+opencv-python临时解决感谢维护,期待回复。