# 依赖安装指南 ## 概述 本项目需要以下Python库才能正常运行。根据依赖检查结果,当前系统状态如下: ### ✅ 已安装的依赖 - Pillow (图片处理) - opencv-python (计算机视觉) - numpy (数值计算) - paddleocr (OCR识别) - easyocr (OCR识别,可选,已安装) ### ❌ 缺失的依赖 - paddlepaddle (深度学习框架,PaddleOCR的依赖) - ttkbootstrap (GUI框架,可选,有回退机制) ## 快速安装 ### 方法1:使用 requirements.txt(推荐) ```bash # 安装所有依赖 pip install -r requirements.txt # 如果网络较慢,使用国内镜像源 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple ``` ### 方法2:最小化安装 ```bash # 仅安装核心依赖 pip install -r requirements-minimal.txt ``` ### 方法3:手动安装 ```bash # 核心必需依赖 pip install Pillow>=9.0.0 numpy>=1.20.0 opencv-python>=4.5.0 paddleocr>=2.7.0 # PaddleOCR依赖(如果自动安装失败) pip install paddlepaddle>=2.5.0,<3.0.0 # 如果paddlepaddle安装失败,尝试: # CPU版本(推荐) pip install paddlepaddle==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple # 或GPU版本(需要CUDA) pip install paddlepaddle-gpu==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple # GUI依赖(可选) pip install ttkbootstrap>=1.10.0 ``` ## 依赖说明 ### 必需依赖 | 库名 | 用途 | 版本要求 | 说明 | |------|------|----------|------| | Pillow | 图片处理 | >=9.0.0 | Python图像处理标准库 | | numpy | 数值计算 | >=1.20.0 | OCR和图像处理的基础 | | opencv-python | 计算机视觉 | >=4.5.0 | 图像处理、模板匹配 | | paddleocr | OCR识别 | >=2.7.0 | 主要OCR引擎 | | paddlepaddle | 深度学习框架 | >=2.5.0,<3.0.0 | PaddleOCR的依赖 | ### 可选依赖 | 库名 | 用途 | 说明 | |------|------|------| | easyocr | OCR识别(备选) | 比PaddleOCR更快,但需要更多内存。如果安装,会优先使用 | | ttkbootstrap | GUI美化 | 如果不安装,程序会自动使用原生tkinter | ## 依赖冲突解决 ### PaddleOCR 模型源检查警告 如果启动时看到模型源检查警告,这是正常的。项目已通过环境变量禁用检查: ```python os.environ.setdefault("DISABLE_MODEL_SOURCE_CHECK", "True") ``` ### 版本兼容性 - **Python**: 推荐 >= 3.8,当前测试环境为 3.12.4 - **paddlepaddle**: 必须 < 3.0.0(PaddleOCR尚未支持3.0+) - **opencv-python**: >= 4.5.0(支持所有需要的功能) ## 验证安装 运行以下命令检查依赖状态: ```bash python check_dependencies.py ``` ## 常见问题 ### Q1: paddlepaddle 安装失败 **解决方案:** 1. 使用国内镜像源安装 2. 确保Python版本 >= 3.8 3. 对于Windows,可能需要安装Visual C++ Redistributable ```bash pip install paddlepaddle==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple ``` ### Q2: OpenCV 导入失败 **解决方案:** - 确保安装的是 `opencv-python` 而不是 `opencv-contrib-python`(除非需要额外功能) - 如果同时安装了两个,卸载冲突的版本 ### Q3: ttkbootstrap 导入失败 **解决方案:** - 这是可选的,程序会自动回退到原生tkinter - 如需安装:`pip install ttkbootstrap>=1.10.0` ### Q4: EasyOCR vs PaddleOCR 项目优先使用EasyOCR(如果安装),否则回退到PaddleOCR。两者都可以正常工作,选择建议: - **EasyOCR**: 更快,但内存占用较大 - **PaddleOCR**: 更稳定,中文识别效果更好,内存占用较小 ## 依赖树 ``` douyin_guaji ├── Pillow (必需) ├── numpy (必需) ├── opencv-python (必需) ├── paddleocr (必需) │ └── paddlepaddle (必需, 2.5.0 <= version < 3.0.0) ├── easyocr (可选, 优先使用) └── ttkbootstrap (可选, GUI美化) ```