马一丁

Update README.md

@@ -391,104 +391,11 @@ uv venv --python 3.11 # 创建3.11环境 @@ -391,104 +391,11 @@ uv venv --python 3.11 # 创建3.11环境
391 391
392 ### 2. 安装 PDF 导出所需系统依赖(可选) 392 ### 2. 安装 PDF 导出所需系统依赖(可选)
393 393
394 -> ⚠️ **注意**:如果您需要使用 PDF 导出功能,请按照以下步骤安装系统依赖。如果不需要 PDF 导出功能,可以跳过此步骤,系统其他功能不受影响。  
395 -  
396 -<details>  
397 -<summary><b>📦 macOS 系统安装步骤</b></summary>  
398 -  
399 -> 🔴 **重要提示**:macOS 用户必须完成以下**两个步骤**,缺一不可!仅安装系统依赖而不设置环境变量会导致 `cannot load library 'libgobject-2.0-0'` 错误。  
400 -  
401 -```bash  
402 -# 步骤 1: 安装系统依赖  
403 -brew install pango gdk-pixbuf libffi  
404 -  
405 -# 步骤 2: 设置环境变量(⚠️ 必须执行!)  
406 -# 方法一:临时设置(仅当前终端会话有效)  
407 -# Apple Silicon  
408 -export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH  
409 -# Intel Mac  
410 -export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH  
411 -  
412 -# 方法二:永久设置(推荐)  
413 -echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc  
414 -# Intel 用户请改为:  
415 -# echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc  
416 -source ~/.zshrc  
417 -```  
418 -  
419 -**验证安装**  
420 -  
421 -```bash  
422 -# 测试 PDF 依赖是否正确配置  
423 -python -m ReportEngine.utils.dependency_check  
424 -# 应该显示:✓ Pango 依赖检测通过,PDF 导出功能可用  
425 -```  
426 -  
427 -**常见问题**  
428 -  
429 -- 如果仍然提示找不到库,请确保:  
430 - 1. 已执行 `source ~/.zshrc` 重新加载配置  
431 - 2. 在新终端中运行应用(确保环境变量已生效)  
432 - 3. 使用 `echo $DYLD_LIBRARY_PATH` 验证环境变量已设置  
433 -  
434 -</details>  
435 -  
436 -<details>  
437 -<summary><b>🐧 Ubuntu/Debian 系统安装步骤</b></summary>  
438 -  
439 -```bash  
440 -# 1. 安装系统依赖(在宿主机上执行)  
441 -sudo apt-get update  
442 -sudo apt-get install -y \  
443 - libpango-1.0-0 \  
444 - libpangoft2-1.0-0 \  
445 - libgdk-pixbuf2.0-0 \  
446 - libffi-dev \  
447 - libcairo2  
448 -```  
449 -  
450 -</details>  
451 -  
452 -<details>  
453 -<summary><b>🎩 CentOS/RHEL 系统安装步骤</b></summary>  
454 -  
455 -```bash  
456 -# 1. 安装系统依赖(在宿主机上执行)  
457 -sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo  
458 -```  
459 -  
460 -</details>  
461 -  
462 -<details>  
463 -<summary><b>🪟 Windows 系统安装步骤</b></summary>  
464 -  
465 -```powershell  
466 -# 1. 下载并安装 GTK3 Runtime(在宿主机上执行)  
467 -# 访问:https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases  
468 -# 下载最新版本的 .exe 文件并安装  
469 -  
470 -# 2. 将 GTK 安装目录下的 bin 添加到 PATH(安装后请重新打开终端)  
471 -# 默认路径示例(如果安装在其他目录,请替换成你的实际路径)  
472 -set PATH=C:\Program Files\GTK3-Runtime Win64\bin;%PATH%  
473 -  
474 -# 可选:永久添加到 PATH  
475 -setx PATH "C:\Program Files\GTK3-Runtime Win64\bin;%PATH%"  
476 -  
477 -# 如果安装在自定义目录,请替换为实际路径,或设置环境变量 GTK_BIN_PATH=你的bin路径,再重新打开终端  
478 -  
479 -# 3. 验证(新终端执行)  
480 -python -m ReportEngine.utils.dependency_check  
481 -# 输出包含 “✓ Pango 依赖检测通过” 表示配置正确  
482 -```  
483 -  
484 -</details>  
485 -  
486 -> 💡 **提示**:如果使用 Docker 部署,无需手动安装这些依赖,Docker 镜像已包含所有必要的系统依赖。  
487 - 394 +这部分有详细的配置说明:[配置“导出为PDF“所需的依赖](./static/Partial%20README%20for%20PDF%20Exporting/README.md)
488 395
489 ### 3. 安装依赖包 396 ### 3. 安装依赖包
490 397
491 -> 如果跳过了步骤2,weasyprint库会无法安装,属正常情况 398 +> 如果跳过了步骤2,weasyprint库可能无法安装,PDF功能可能无法正常使用
492 399
493 ```bash 400 ```bash
494 # 基础依赖安装 401 # 基础依赖安装
  1 +
  2 +> ⚠️ **注意**:如果您需要使用 PDF 导出功能,请按照以下步骤安装系统依赖。如果不需要 PDF 导出功能,可以跳过此步骤,系统其他功能不受影响。
  3 +
  4 +<details>
  5 +<summary><b>🪟 Windows 系统安装步骤</b></summary>
  6 +
  7 +```powershell
  8 +# 1. 下载并安装 GTK3 Runtime(在宿主机上执行)
  9 +# 访问:https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
  10 +# 下载最新版本的 .exe 文件并安装
  11 +# 强烈建议安装到默认路径,这可能有助于规避许多未知错误
  12 +
  13 +# 2. 将 GTK 安装目录下的 bin 添加到 PATH(安装后请重新打开终端)
  14 +# 默认路径示例(如果安装在其他目录,请替换成你的实际路径)
  15 +set PATH=C:\Program Files\GTK3-Runtime Win64\bin;%PATH%
  16 +
  17 +# 可选:永久添加到 PATH
  18 +setx PATH "C:\Program Files\GTK3-Runtime Win64\bin;%PATH%"
  19 +
  20 +# 如果安装在自定义目录,请替换为实际路径,或设置环境变量 GTK_BIN_PATH=你的bin路径,再重新打开终端
  21 +
  22 +# 3. 验证(新终端执行)
  23 +python -m ReportEngine.utils.dependency_check
  24 +# 输出包含 “✓ Pango 依赖检测通过” 表示配置正确
  25 +```
  26 +
  27 +</details>
  28 +
  29 +<details>
  30 +<summary><b>📦 macOS 系统安装步骤</b></summary>
  31 +
  32 +> 🔴 **重要提示**:macOS 用户必须完成以下**两个步骤**,缺一不可!仅安装系统依赖而不设置环境变量会导致 `cannot load library 'libgobject-2.0-0'` 错误。
  33 +
  34 +```bash
  35 +# 步骤 1: 安装系统依赖
  36 +brew install pango gdk-pixbuf libffi
  37 +
  38 +# 步骤 2: 设置环境变量(⚠️ 必须执行!)
  39 +# 方法一:临时设置(仅当前终端会话有效)
  40 +# Apple Silicon
  41 +export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
  42 +# Intel Mac
  43 +export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH
  44 +
  45 +# 方法二:永久设置(推荐)
  46 +echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
  47 +# Intel 用户请改为:
  48 +# echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
  49 +source ~/.zshrc
  50 +```
  51 +
  52 +**验证安装**
  53 +
  54 +```bash
  55 +# 测试 PDF 依赖是否正确配置
  56 +python -m ReportEngine.utils.dependency_check
  57 +# 应该显示:✓ Pango 依赖检测通过,PDF 导出功能可用
  58 +```
  59 +
  60 +**常见问题**
  61 +
  62 +- 如果仍然提示找不到库,请确保:
  63 + 1. 已执行 `source ~/.zshrc` 重新加载配置
  64 + 2. 在新终端中运行应用(确保环境变量已生效)
  65 + 3. 使用 `echo $DYLD_LIBRARY_PATH` 验证环境变量已设置
  66 +
  67 +</details>
  68 +
  69 +<details>
  70 +<summary><b>🐧 Ubuntu/Debian 系统安装步骤</b></summary>
  71 +
  72 +```bash
  73 +# 1. 安装系统依赖(在宿主机上执行)
  74 +sudo apt-get update
  75 +sudo apt-get install -y \
  76 + libpango-1.0-0 \
  77 + libpangoft2-1.0-0 \
  78 + libgdk-pixbuf2.0-0 \
  79 + libffi-dev \
  80 + libcairo2
  81 +```
  82 +
  83 +</details>
  84 +
  85 +<details>
  86 +<summary><b>🎩 CentOS/RHEL 系统安装步骤</b></summary>
  87 +
  88 +```bash
  89 +# 1. 安装系统依赖(在宿主机上执行)
  90 +sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo
  91 +```
  92 +
  93 +</details>
  94 +
  95 +> 💡 **提示**:如果使用 Docker 部署,无需手动安装这些依赖,Docker 镜像已包含所有必要的系统依赖。
  96 +