fix: 修复 GUI.html 完全不可用,并为网页客户端开启 CORS

GUI.html 里有一句硬语法错误:

    progressFill?.style.width = '100%';

可选链不能做赋值目标,整个 <script> 块解析失败——页面加载看着正常,但所有按钮
都没反应,浏览器只在控制台报一条错,极容易被误判成「服务连不上」。
改成 if (progressFill) ...,并用 node --check 加了回归测试。

网页端调接口是跨域请求,而服务端没开 CORS:/api/v1/i2t 发 JSON 会先发预检
OPTIONS,直接失败;上传虽然能发出去,但响应读不到。加了 CORSMiddleware,
来源由 cors_allow_origins 配置(默认 ["*"],[] 可关)。命令行脚本不受影响,
所以这个坑只在网页端暴露。

顺带修掉 GUI 里几处:
  · 安静模式下没有进度条,onProgress 会拿 undefined 赋值
  · 字段渲染用 innerHTML 拼值——OCR 结果来自用户上传的图片,内容不可信,改 textContent
  · 置信度/超时输入框清空时 parseFloat 得到 NaN,会让服务端返回 422,加回退值
  · 处理完重置 fileInput.value,否则再选同一个文件不触发 change
  · 页面经 http(s) 打开时,服务地址默认填 location.origin(同源,免配)

测试:新增 CORS 预检/关闭两条用例,以及 GUI.html 的 JS 语法检查(用 node,
没装 node 则跳过)。101 passed, 1 skipped。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
zimoyin
2026-10-14 12:31:44 +08:00
parent ec6b9c7ae3
commit 3772998137
9 changed files with 624 additions and 75 deletions
+15 -11
View File
@@ -22,7 +22,8 @@ ocr-server/
├── scripts/install_paddle.py # 按显卡安装 CPU/GPU 版 paddlepaddle
├── scripts/download_models.py # 下载/补齐预置模型
├── scripts/benchmark_ocr.py # 测量当前配置的 OCR 耗时与召回
└── scripts/api_client.py # 命令行调用 OCR 接口
├── scripts/api_client.py # 命令行调用 OCR 接口
└── scripts/GUI.html # 网页客户端,浏览器直接打开
```
## 模型位置和下载策略
@@ -931,21 +932,23 @@ extract_include_empty: true
抽取发生在查询时(`/api/v1/i2t`),基于 `min_confidence` 过滤后的文本,因此改预设或调 `min_confidence` 不需要重新识别。`extract_fields` 留空(或删除该配置)即关闭此功能。
### 网页客户端(GUI.html)
`scripts/GUI.html` 是个纯前端的网页客户端:填服务地址、选图片、看进度和识别结果,
双击用浏览器打开即可,不需要装任何东西。
浏览器里调接口属于跨域请求,所以服务端默认开了 CORS(`cors_allow_origins: ["*"]`,
见「配置」一节)。关掉它网页客户端就用不了,命令行脚本不受影响。
### 命令行客户端
不想记接口细节就用现成的客户端,它只用标准库(不依赖 requests),可直接拷到别的机器上跑:
```bat
rem Windows(也可以直接把图片拖到 bat 上)
scripts\api-client.bat 图片.png
scripts\api-client.bat 图片.png --min-confidence 0.6
scripts\api-client.bat --health
```
不想记接口细节就用 `scripts/api_client.py`,它只用标准库(不依赖 requests),
可直接拷到别的机器上跑:
```bash
# Linux / 源码环境,等价
./scripts/api-client.sh 图片.png
python scripts/api_client.py 图片.png
python scripts/api_client.py 图片.png --min-confidence 0.6
python scripts/api_client.py --health
```
常用参数(服务默认在 `http://127.0.0.1:8000`):
@@ -1061,6 +1064,7 @@ log_level: INFO
| `use_tensorrt` | `false` | 是否启用 TensorRT;**只在 `device` 为 GPU 时生效** |
| `precision` | `fp32` | `fp32` / `fp16`;`fp16` 只在 GPU 上生效 |
| `enable_cinn` | `false` | 是否启用 CINN 编译器(面向国产加速卡);普通 CPU/GPU 保持 `false` |
| `cors_allow_origins` | `["*"]` | 允许跨域的来源,只影响网页客户端;`[]` 表示关闭 |
| `log_level` | `INFO` | 日志级别:`DEBUG`、`INFO`、`WARNING`、`ERROR` |
接口文档:启动后访问 <http://127.0.0.1:8000/docs>。