Files
zimoyin ec6b9c7ae3 feat: 新增 bat/sh 版 API 客户端,修复 bat 吞退出码与 CRLF 问题
新增 scripts/api-client.bat 与 api-client.sh:上传图片 -> 轮询 -> 打印识别文本与
抽取字段。自动挑解释器(优先 .venv,退回系统 Python);api_client.py 只用标准库,
所以一台只装 Python、不装本项目依赖的机器也能当客户端用。

修掉两个 bat 上的真 bug(都是实测出来的,不是看代码看出来的):

1. 退出码被吞。`if exist ... ( ... exit /b %errorlevel% )` 里的 %errorlevel%
   是**解析时**展开的,取到的是启动程序之前的值,于是失败也返回 0。
   start.bat 同样中招(启动失败会被吞成成功)。两处都改成 goto 结构。

2. .bat 必须 CRLF。同一份内容,CRLF 正常跑完;LF 会让 cmd 解析挂住——
   无任何输出、也不退出,看起来像服务卡死。download-models.bat 原本也是 LF,
   一并修正;新增 .gitattributes 钉死 *.bat=eol:crlf、*.sh=eol:lf。

另:参数校验挪到探活之前,参数写错时不会因为连不上服务报出误导性错误;
stdout 加 flush,重定向到文件时输出顺序不再错乱。

测试:新增两条回归用例(bat 必须 CRLF;Windows 上 bat 能被 cmd 跑通,带超时
以免坏掉时把测试卡死)。99 passed。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 12:15:39 +08:00

48 lines
1.9 KiB
Batchfile
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
@echo off
rem 启动 OCR 服务,按下面的顺序找可执行的东西,找到就跑:
rem 1. 发布包 dist\ocr-server\ocr-server.exe (CPU 版)
rem 2. 发布包 dist\ocr-server-gpu\ocr-server-gpu.exe (GPU 版,device: auto 自动选卡)
rem 3. 源码环境 .venv\Scripts\ocr-server.exe
rem 4. uv run --no-sync ocr-server
rem
rem 两个容易踩的点,改动前先看:
rem 1. 本文件必须保持 CRLF 换行。实测 LF 换行的 bat 会让 cmd 解析挂住。
rem .gitattributes 已钉死 eol=crlf。
rem 2. 退出码不要写成 `if exist ... ( ... exit /b %errorlevel% )`:
rem 括号块里的 %errorlevel% 是**解析时**展开的,拿到的是启动程序之前的值,
rem 会把启动失败吞成成功。所以下面用 goto 而不是括号块。
setlocal
cd /d "%~dp0.."
if exist "dist\ocr-server\ocr-server.exe" goto run_cpu_package
if exist "dist\ocr-server-gpu\ocr-server-gpu.exe" goto run_gpu_package
if exist ".venv\Scripts\ocr-server.exe" goto run_venv
goto run_uv
:run_cpu_package
"dist\ocr-server\ocr-server.exe"
exit /b %errorlevel%
:run_gpu_package
"dist\ocr-server-gpu\ocr-server-gpu.exe"
exit /b %errorlevel%
:run_venv
rem 直接跑 .venv 里的入口脚本:不经过 uv,也就不会触发环境同步
rem (uv run 会按 pyproject.toml 同步环境,而 paddle 不在依赖里,会被整个移除)。
rem 入口脚本名固定是 ocr-server,与 CPU/GPU 变体无关。
".venv\Scripts\ocr-server.exe"
exit /b %errorlevel%
:run_uv
where uv >nul 2>nul
if errorlevel 1 goto no_launcher
rem --no-sync 是必须的,理由同上。环境尚未建好时先跑 scripts\switch_env.py --cpu。
uv run --no-sync ocr-server
exit /b %errorlevel%
:no_launcher
echo [错误] 没找到可启动的东西:既没有 dist 下的发布包,也没有 .venv,uv 也没装。
echo 请先运行 scripts\switch_env.py --cpu(源码方式),或 scripts\package-windows.ps1(打包方式)。
exit /b 1