build: CPU/GPU 双环境、产物命名与打包修复

交付:
  · 产物按变体命名:CPU -> dist/ocr-server/,GPU -> dist/ocr-server-gpu/。
    变体由构建环境实际装的 paddle 自动判断,不需要人工声明
  · GPU 包额外加 --collect-binaries nvidia。漏收的后果实测是最难查的那种:
    引擎能正常加载、设备也识别成 GPU,但第一次推理才报
    cudnn64_9.dll error 126
  · --copy-metadata 的发行包名随变体变化(paddlepaddle / paddlepaddle-gpu),
    改由 scripts/paddle_env.py 动态取;写死任何一个在另一种环境下都打不出包
  · 新增 scripts/prepare_release_config.py 按变体覆盖发布配置(用 Python 改写
    以保持 UTF-8,PowerShell 的 Set-Content 会把中文注释写坏)

环境:
  · paddle 从 pyproject 依赖里移除,改用 scripts/install_paddle.py 安装。
    它没法写死:CPU/GPU 互斥,GPU 还得按显卡选 CUDA 通道(RTX 50 系必须 cu129)。
    钉死 CPU 版时,uv sync / uv run / PyCharm 自动同步都会把装好的
    paddlepaddle-gpu 静默挤掉、服务悄悄退回 CPU(实测踩过三次)
  · 新增 scripts/switch_env.py:.venv(CPU)与 .venv-gpu(GPU)两套环境共存,
    切换零成本;所有 uv run 补 --no-sync,打包改用 uv sync --inexact
  · 预置模型扩到 8 套(v4/v5 × 服务端/移动端 × 检测/识别,约 398MB)

其它:
  · scripts/start.* 先找发布包再退回源码环境;入口脚本名固定是 ocr-server
  · benchmark_ocr.py 输出 segments 与 chars,换设备/模型时可直接比对召回
  · .gitignore 覆盖 .venv-gpu/ 与 dist*/

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
zimoyin
2026-10-14 03:53:48 +08:00
parent 09ab14c707
commit 5ab4bef80e
18 changed files with 1366 additions and 306 deletions
+19 -5
View File
@@ -1,15 +1,29 @@
$ErrorActionPreference = "Stop"
$ProjectRoot = Split-Path -Parent $PSScriptRoot
Set-Location $ProjectRoot
$PackagedExe = Join-Path $ProjectRoot "dist\ocr-server\ocr-server.exe"
# 优先跑发布包:CPU 版 dist\ocr-server,GPU 版 dist\ocr-server-gpu。
# 两个都存在时用 CPU 版(GPU 包只有装了 GPU 版 paddle 的机器才能用,见 README)。
# 想直接跑 GPU 包就写全路径:dist\ocr-server-gpu\ocr-server-gpu.exe
foreach ($Candidate in @("dist\ocr-server\ocr-server.exe", "dist\ocr-server-gpu\ocr-server-gpu.exe")) {
$PackagedExe = Join-Path $ProjectRoot $Candidate
if (Test-Path $PackagedExe) {
& $PackagedExe
exit $LASTEXITCODE
}
}
if (Test-Path $PackagedExe) {
& $PackagedExe
# 优先直接跑 .venv 里的入口脚本:直接执行不会触发 uv 的环境同步。
# 必须这样做的原因:uv run 会先按 pyproject.toml 同步环境,而 paddle 不在依赖里,
# 同步会把它整个移除(实测)。入口脚本名固定是 ocr-server,与变体无关。
$VenvExe = Join-Path $ProjectRoot ".venv\Scripts\ocr-server.exe"
if (Test-Path $VenvExe) {
& $VenvExe
exit $LASTEXITCODE
}
if (-not (Get-Command uv -ErrorAction SilentlyContinue)) {
throw "未找到打包程序,也未安装 uv。请先运行 scripts/package-windows.ps1 或安装 uv。"
throw "未找到发布包,也未安装 uv。请先运行 scripts/package-windows.ps1 或 scripts/switch_env.py --cpu。"
}
uv run ocr-server
# --no-sync 是必须的,理由同上。环境尚未建好时,请先运行一次 scripts/switch_env.py --cpu。
uv run --no-sync ocr-server