Files
douyin_guaji-main/DEPENDENCY_GUIDE.md
T
Your Name efaa3d3adc fix: Clean up blank lines and enhance readability across multiple files
- Removed excessive blank lines from various markdown and Python files to improve readability and maintainability.
- Ensured consistent formatting across documentation and code files, contributing to overall project clarity.
- Enhanced logging mechanisms for better consistency and debugging support.
2025-12-27 15:19:04 +08:00

248 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 依赖安装指南
## 概述
本项目需要以下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美化)
```