- Removed excessive blank lines from various markdown and Python files to enhance readability and maintainability. - Ensured consistent formatting across documentation and code files, improving overall project clarity.
218 lines
3.8 KiB
Markdown
218 lines
3.8 KiB
Markdown
# 依赖安装指南
|
||
|
||
## 概述
|
||
|
||
本项目需要以下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美化)
|
||
```
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|