fix: 修复Python 3.13环境下PyInstaller构建崩溃问题

问题:
- PyInstaller在分析阶段尝试导入torch/transformers等ML库
- 这些库与Python 3.13不兼容,导致"Windows fatal exception: access violation"
- 构建过程无法完成,无法生成exe文件

解决方案:
1. 添加pyi_hooks/pyi_rth_ignore_torch.py运行时hook
   - 在PyInstaller分析阶段阻止torch等模块的导入
   - 这些模块将在运行时动态安装

2. 添加pyi_hooks/hook-exclude-ml.py和hook-paddleocr.py
   - 明确告诉PyInstaller不收集这些ML库

3. 更新build.bat和build.sh
   - 使用--runtime-hook和--additional-hooks-dir
   - 添加--exclude-module参数排除所有ML库

测试:
- 验证所有hook文件语法正确
- 验证项目核心功能可以在不导入torch的情况下正常工作

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
congsh
2026-02-12 13:31:49 +08:00
parent bb27db586d
commit 4589289635
6 changed files with 164 additions and 0 deletions

View File

@@ -0,0 +1,29 @@
"""
PyInstaller hook for PaddleOCR
Prevents PyInstaller from trying to bundle PaddleOCR and its dependencies.
These will be installed dynamically at runtime.
"""
from PyInstaller.utils.hooks import is_module_satisfies
# Tell PyInstaller to NOT collect these modules
# They will be installed at runtime via ensure_paddleocr()
hiddenimports = []
# Explicitly exclude heavy ML dependencies
excludedimports = [
'torch',
'transformers',
'tensorflow',
'onnx',
'onnxruntime',
'sentencepiece',
'tokenizers',
'diffusers',
'accelerate',
'datasets',
'huggingface_hub',
'safetensors',
]