修复 OCR libGL.so.1 缺失：安装 libgl1 等系统依赖。

- 新增 deploy/install-ocr-deps.sh，update.sh 自动检查

- install.sh 预装 OpenGL/Mesa 库

deploy/install-ocr-deps.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# PaddleOCR / OpenCV 在无图形界面服务器上所需的系统库
+set -euo pipefail
+
+if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
+  echo "请使用 root 运行: sudo bash deploy/install-ocr-deps.sh"
+  exit 1
+fi
+
+GREEN='\033[0;32m'
+NC='\033[0m'
+log_info() { echo -e "${GREEN}[INFO]${NC} $*"; }
+
+log_info "安装 OCR 依赖（libGL 等）…"
+apt-get update -qq
+DEBIAN_FRONTEND=noninteractive apt-get install -y -qq \
+  libgl1 \
+  libglx-mesa0 \
+  libgbm1 \
+  libgomp1 \
+  libglib2.0-0 \
+  libsm6 \
+  libxrender1 \
+  libxext6 \
+  libxcb1 \
+  libfontconfig1
+
+log_info "OCR 系统依赖已就绪"

deploy/install.sh

@@ -56,7 +56,8 @@ install_base_packages() {
     python3 python3-venv python3-pip python3-dev \
     build-essential libpq-dev \
     postgresql postgresql-contrib \
-    libgomp1 libglib2.0-0 libsm6 libxrender1 libxext6
+    libgl1 libglx-mesa0 libgbm1 \
+    libgomp1 libglib2.0-0 libsm6 libxrender1 libxext6 libxcb1 libfontconfig1
 }
 
 clone_or_update_repo() {

deploy/start.sh

@@ -16,5 +16,6 @@ fi
 
 export FRONTEND_DIST="${FRONTEND_DIST:-${ROOT}/frontend/dist}"
 export UPLOAD_DIR="${UPLOAD_DIR:-${ROOT}/uploads}"
+export OPENCV_IO_ENABLE_OPENEXR=0
 
 exec python -m uvicorn app.main:app --host 0.0.0.0 --port "${WEB_PORT:-23566}"

deploy/update.sh

@@ -41,6 +41,11 @@ if command -v pm2 &>/dev/null; then
   pm2 delete grade-api grade-web 2>/dev/null || true
 fi
 
+if [[ "${EUID:-$(id -u)}" -eq 0 ]]; then
+  log_info "检查 OCR 系统依赖（libGL）…"
+  bash "${INSTALL_DIR}/deploy/install-ocr-deps.sh"
+fi
+
 log_info "重启 systemd 服务…"
 systemctl restart grade-archive