feat: add cross-platform model download scripts
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -20,8 +20,10 @@ ocr-server/
|
|||||||
├── scripts/package-windows.ps1 # Windows exe 打包
|
├── scripts/package-windows.ps1 # Windows exe 打包
|
||||||
├── scripts/packaged_entry.py # PyInstaller 入口
|
├── scripts/packaged_entry.py # PyInstaller 入口
|
||||||
├── scripts/package-ubuntu.sh # Ubuntu ELF 打包
|
├── scripts/package-ubuntu.sh # Ubuntu ELF 打包
|
||||||
├── scripts/download_models.py # 下载或补齐缺少的模型
|
├── scripts/download-models.bat # Windows 下载/补齐模型
|
||||||
└── scripts/benchmark_ocr.py # 测量当前配置的 OCR 耗时
|
├── scripts/download-models.sh # Ubuntu/Linux 下载/补齐模型
|
||||||
|
├── scripts/download_models.py # Python 下载入口
|
||||||
|
└── scripts/benchmark_ocr.py # 测量当前配置的 OCR 耗时
|
||||||
```
|
```
|
||||||
|
|
||||||
## 模型位置和下载策略
|
## 模型位置和下载策略
|
||||||
@@ -50,13 +52,30 @@ model_dir: /opt/ocr-server/models
|
|||||||
|
|
||||||
配置文件中的路径支持绝对路径,也支持相对于项目根目录的路径。服务启动时读取一次配置,修改后需要重启服务。
|
配置文件中的路径支持绝对路径,也支持相对于项目根目录的路径。服务启动时读取一次配置,修改后需要重启服务。
|
||||||
|
|
||||||
也可以手动提前下载或补齐模型:
|
也可以手动提前下载或补齐模型。推荐使用对应平台的快捷脚本:
|
||||||
|
|
||||||
|
Windows(PowerShell / CMD):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
scripts\download-models.bat
|
||||||
|
```
|
||||||
|
|
||||||
|
Ubuntu/Linux:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
chmod +x scripts/download-models.sh
|
||||||
|
./scripts/download-models.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
脚本会读取项目根目录的 `config.yaml`,把当前配置所需的检测模型和识别模型下载到 `model_dir/official_models/`。模型下载需要联网;完整分发包可以直接携带整个 `models/` 目录,从而不依赖首次启动联网。下载时不会覆盖已有完整模型目录。
|
||||||
|
|
||||||
|
也可以直接调用 Python 脚本:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
uv run python scripts/download_models.py
|
uv run python scripts/download_models.py
|
||||||
```
|
```
|
||||||
|
|
||||||
脚本会读取 `config.yaml`,把模型下载到 `model_dir` 指定的目录。模型下载需要联网;完整分发包可以直接携带整个 `models/` 目录,从而不依赖首次启动联网。下载时不会覆盖已有完整模型目录。
|
如果配置切换了模型名称,重新执行下载脚本即可补齐新模型。脚本不会删除或修改已有的其它模型目录。
|
||||||
|
|
||||||
## 不同速度档位和模型选择
|
## 不同速度档位和模型选择
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,28 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal
|
||||||
|
|
||||||
|
cd /d "%~dp0.."
|
||||||
|
|
||||||
|
echo [OCR] 检查并下载缺失模型...
|
||||||
|
|
||||||
|
where uv >nul 2>nul
|
||||||
|
if errorlevel 1 (
|
||||||
|
echo [ERROR] 未找到 uv,请先安装 uv。
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
if not exist "config.yaml" (
|
||||||
|
echo [ERROR] 未找到 config.yaml,请从项目根目录运行此脚本。
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
uv run python scripts\download_models.py
|
||||||
|
if errorlevel 1 (
|
||||||
|
echo [ERROR] 模型下载失败。
|
||||||
|
endlocal
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [OCR] 模型已就绪。
|
||||||
|
endlocal
|
||||||
|
exit /b 0
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
cd "$(dirname "${BASH_SOURCE[0]}")/.."
|
||||||
|
|
||||||
|
if [[ ! -f config.yaml ]]; then
|
||||||
|
printf '%s\n' '[ERROR] 未找到 config.yaml,请从项目根目录运行此脚本。' >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if command -v uv >/dev/null 2>&1; then
|
||||||
|
printf '%s\n' '[OCR] 检查并下载缺失模型...'
|
||||||
|
uv run python scripts/download_models.py
|
||||||
|
elif [[ -x .venv/bin/python ]]; then
|
||||||
|
printf '%s\n' '[OCR] 检查并下载缺失模型(使用 .venv)...'
|
||||||
|
.venv/bin/python scripts/download_models.py
|
||||||
|
else
|
||||||
|
printf '%s\n' '[ERROR] 未找到 uv 或 .venv/bin/python,请先安装依赖。' >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
printf '%s\n' '[OCR] 模型已就绪。'
|
||||||
Reference in New Issue
Block a user