Skip to content

预打包版依赖构建问题 + 源码运行体验建议(窗口交互/Python版本限制) #93

Description

@LoveElysia1314

一、预打包版本部署问题

在 Windows 11 环境下使用预打包版本时,遇到以下依赖安装问题:

  1. sacremoses==0.0.53 构建失败

    • 报错:error: invalid command 'bdist_wheel'
    • 现象:安装 argostranslate~=1.9.6 时,其硬编码依赖的 sacremoses==0.0.53 为源码包,在 pip 构建隔离环境下因缺少 wheel 依赖而构建失败
    • 建议:考虑升级 argostranslate 版本以解除对老版 sacremoses 的锁定,或在预打包环境中预置 wheel/setuptools
  2. pix2text 依赖缺失

    • 报错:ModuleNotFoundError: No module named 'cv2'
    • 现象:pix2text 的 CORE 层依赖 opencv-python,但预打包环境未包含该模块
    • 建议:检查 requirements.txt 或依赖安装脚本,确保运行时硬性依赖被完整声明

二、源码运行体验问题

环境:Windows 11 + Python 3.14(系统默认),手动创建虚拟环境运行

Image
  1. 初始化窗口交互问题

    • 现象:定位依赖目录后,程序弹出的初始化小窗口具有"始终置顶 + 无法拖动"特性,会遮挡系统通知弹窗(如图示例),且用户无法移动窗口查看被遮内容
    • 建议:移除"始终置顶"属性,或允许窗口拖动,避免阻塞用户操作
  2. Python 版本限制过于严格

    • 现状:项目硬编码限定 Python 3.11
    • 问题:若用户系统已安装更高版本(如 3.14)且已预装部分依赖,无法复用本地缓存,需重复下载
    • 建议:如无 C 扩展兼容性硬性要求,可将 python_requires 放宽至 >=3.11,并补充 pyproject.toml / setup.py 中的版本说明

三、补充信息

  • 预打包版问题已通过手动安装 wheel + opencv-python 临时解决
  • 源码运行环境依赖已通过虚拟环境正常安装,除上述交互问题外功能可用

感谢维护,期待回复。

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions