3772998137
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>
514 lines
20 KiB
HTML
514 lines
20 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>OCR 服务 Web 客户端</title>
|
||
<style>
|
||
* { box-sizing: border-box; margin: 0; padding: 0; }
|
||
body {
|
||
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Microsoft YaHei", monospace;
|
||
max-width: 960px;
|
||
margin: 24px auto;
|
||
padding: 0 20px;
|
||
background: #f6f8fa;
|
||
color: #24292f;
|
||
}
|
||
.card {
|
||
background: #ffffff;
|
||
padding: 24px;
|
||
border-radius: 8px;
|
||
box-shadow: 0 1px 3px rgba(0,0,0,0.1);
|
||
margin-bottom: 20px;
|
||
}
|
||
h1 { font-size: 20px; margin-bottom: 20px; color: #1f2328; }
|
||
.config-grid {
|
||
display: grid;
|
||
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
|
||
gap: 16px;
|
||
margin-bottom: 20px;
|
||
padding-bottom: 20px;
|
||
border-bottom: 1px solid #d0d7de;
|
||
}
|
||
.form-item { display: flex; flex-direction: column; gap: 6px; }
|
||
.form-item.check { flex-direction: row; align-items: center; gap: 8px; }
|
||
label { font-size: 14px; color: #57606a; }
|
||
input[type="text"], input[type="number"] {
|
||
padding: 8px 12px;
|
||
border: 1px solid #d0d7de;
|
||
border-radius: 6px;
|
||
font-size: 14px;
|
||
font-family: inherit;
|
||
background: #f6f8fa;
|
||
}
|
||
input[type="text"]:focus, input[type="number"]:focus {
|
||
outline: none;
|
||
border-color: #0969da;
|
||
background: #ffffff;
|
||
}
|
||
.action-bar { display: flex; gap: 12px; flex-wrap: wrap; }
|
||
button {
|
||
padding: 9px 16px;
|
||
border: 1px solid transparent;
|
||
border-radius: 6px;
|
||
cursor: pointer;
|
||
font-size: 14px;
|
||
font-family: inherit;
|
||
transition: all 0.2s;
|
||
}
|
||
.btn-primary { background: #0969da; color: white; }
|
||
.btn-primary:hover { background: #0860c7; }
|
||
.btn-secondary { background: #f6f8fa; color: #24292f; border-color: #d0d7de; }
|
||
.btn-secondary:hover { background: #eaeef2; }
|
||
button:disabled { opacity: 0.5; cursor: not-allowed; }
|
||
#fileInput { display: none; }
|
||
.health-tip {
|
||
padding: 10px 14px;
|
||
border-radius: 6px;
|
||
font-family: monospace;
|
||
font-size: 13px;
|
||
margin-bottom: 16px;
|
||
}
|
||
.health-success { background: #dafbe1; color: #1a7f37; }
|
||
.health-error { background: #ffebe9; color: #cf222e; }
|
||
.result-item {
|
||
padding: 16px;
|
||
border: 1px solid #d0d7de;
|
||
border-radius: 6px;
|
||
margin-bottom: 16px;
|
||
background: #f6f8fa;
|
||
}
|
||
.result-title { font-weight: 600; margin-bottom: 10px; color: #1f2328; }
|
||
.status-line {
|
||
font-family: monospace;
|
||
font-size: 13px;
|
||
color: #57606a;
|
||
margin-bottom: 8px;
|
||
}
|
||
.status-error { color: #cf222e; }
|
||
.status-success { color: #1a7f37; }
|
||
.progress-bar {
|
||
width: 100%;
|
||
height: 8px;
|
||
background: #d0d7de;
|
||
border-radius: 4px;
|
||
overflow: hidden;
|
||
margin-bottom: 12px;
|
||
}
|
||
.progress-fill {
|
||
height: 100%;
|
||
width: 0%;
|
||
background: #0969da;
|
||
transition: width 0.2s linear;
|
||
}
|
||
.result-meta { font-size: 13px; color: #57606a; margin-bottom: 8px; }
|
||
.result-block-title {
|
||
font-weight: 600;
|
||
font-size: 14px;
|
||
margin: 12px 0 6px;
|
||
color: #24292f;
|
||
}
|
||
.text-content {
|
||
white-space: pre-wrap;
|
||
background: #ffffff;
|
||
padding: 12px;
|
||
border-radius: 6px;
|
||
border: 1px solid #d0d7de;
|
||
font-family: monospace;
|
||
font-size: 14px;
|
||
line-height: 1.6;
|
||
}
|
||
.field-list { margin-top: 6px; }
|
||
.field-item { padding: 3px 0; font-size: 14px; }
|
||
.field-key { font-weight: 600; color: #0969da; }
|
||
.json-box {
|
||
background: #0d1117;
|
||
color: #c9d1d9;
|
||
padding: 12px;
|
||
border-radius: 6px;
|
||
font-family: monospace;
|
||
font-size: 13px;
|
||
overflow-x: auto;
|
||
white-space: pre-wrap;
|
||
margin-top: 8px;
|
||
}
|
||
.summary {
|
||
padding: 12px;
|
||
border-radius: 6px;
|
||
font-weight: 600;
|
||
text-align: center;
|
||
margin-top: 8px;
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div class="card">
|
||
<h1>OCR 服务 Web 客户端</h1>
|
||
|
||
<!-- 配置区 -->
|
||
<div class="config-grid">
|
||
<div class="form-item">
|
||
<label for="hostInput">服务地址</label>
|
||
<input type="text" id="hostInput" value="http://127.0.0.1:8000" placeholder="http://127.0.0.1:8000">
|
||
</div>
|
||
<div class="form-item">
|
||
<label for="confidenceInput">最小置信度</label>
|
||
<input type="number" id="confidenceInput" value="0" min="0" max="1" step="0.1">
|
||
</div>
|
||
<div class="form-item">
|
||
<label for="timeoutInput">超时时间(秒)</label>
|
||
<input type="number" id="timeoutInput" value="300" min="1">
|
||
</div>
|
||
<div class="form-item check">
|
||
<input type="checkbox" id="jsonCheck">
|
||
<label for="jsonCheck">显示原始 JSON 响应</label>
|
||
</div>
|
||
<div class="form-item check">
|
||
<input type="checkbox" id="quietCheck">
|
||
<label for="quietCheck">安静模式(隐藏进度)</label>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- 操作按钮 -->
|
||
<div class="action-bar">
|
||
<button id="healthBtn" class="btn-secondary">健康检查</button>
|
||
<button id="selectBtn" class="btn-primary">选择图片</button>
|
||
<button id="startBtn" class="btn-primary" disabled>开始识别</button>
|
||
<input type="file" id="fileInput" accept="image/*" multiple>
|
||
</div>
|
||
|
||
<!-- 健康检查结果 -->
|
||
<div id="healthTip"></div>
|
||
|
||
<!-- 结果容器 -->
|
||
<div id="resultBox"></div>
|
||
</div>
|
||
|
||
<script>
|
||
// 常量对齐原 Python 脚本
|
||
const POLL_INTERVAL = 500; // 轮询间隔 0.5 秒
|
||
const FINISHED_STATUSES = ["completed", "failed"];
|
||
|
||
// DOM 元素
|
||
const hostInput = document.getElementById('hostInput');
|
||
const confidenceInput = document.getElementById('confidenceInput');
|
||
const timeoutInput = document.getElementById('timeoutInput');
|
||
const jsonCheck = document.getElementById('jsonCheck');
|
||
const quietCheck = document.getElementById('quietCheck');
|
||
const healthBtn = document.getElementById('healthBtn');
|
||
const selectBtn = document.getElementById('selectBtn');
|
||
const startBtn = document.getElementById('startBtn');
|
||
const fileInput = document.getElementById('fileInput');
|
||
const healthTip = document.getElementById('healthTip');
|
||
const resultBox = document.getElementById('resultBox');
|
||
|
||
let fileList = [];
|
||
|
||
// 页面如果是通过 http(s) 打开的(比如被服务端托管),默认就用当前站点的地址:
|
||
// 同源调用不需要 CORS,也省得手填。
|
||
if (location.protocol === 'http:' || location.protocol === 'https:') {
|
||
hostInput.value = location.origin;
|
||
}
|
||
|
||
// 标准化 host 地址(去末尾斜杠)
|
||
const getHost = () => hostInput.value.trim().replace(/\/+$/, '');
|
||
|
||
// 数字输入框可能是空的,parseFloat('') 得到 NaN,直接发出去服务端会返回 422
|
||
const readNumber = (input, fallback) => {
|
||
const value = parseFloat(input.value);
|
||
return Number.isFinite(value) ? value : fallback;
|
||
};
|
||
|
||
// 1. 健康检查
|
||
async function doHealthCheck() {
|
||
const host = getHost();
|
||
healthTip.className = 'health-tip';
|
||
healthTip.textContent = '正在检查服务状态...';
|
||
|
||
try {
|
||
const ctrl = new AbortController();
|
||
const timer = setTimeout(() => ctrl.abort(), 10000);
|
||
const resp = await fetch(`${host}/healthz`, { signal: ctrl.signal });
|
||
clearTimeout(timer);
|
||
|
||
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
|
||
const data = await resp.json();
|
||
|
||
healthTip.classList.add('health-success');
|
||
healthTip.textContent = `✅ 服务 ${host} 正常:${JSON.stringify(data)}`;
|
||
} catch (err) {
|
||
healthTip.classList.add('health-error');
|
||
healthTip.textContent = `❌ 连不上服务 ${host}:${err.message}`;
|
||
}
|
||
}
|
||
|
||
// 2. 上传图片
|
||
async function uploadImage(host, file) {
|
||
const formData = new FormData();
|
||
formData.append('file', file);
|
||
|
||
const ctrl = new AbortController();
|
||
const timer = setTimeout(() => ctrl.abort(), parseFloat(timeoutInput.value) * 1000);
|
||
const resp = await fetch(`${host}/api/v1/upload`, {
|
||
method: 'POST',
|
||
body: formData,
|
||
signal: ctrl.signal
|
||
});
|
||
clearTimeout(timer);
|
||
|
||
if (!resp.ok) {
|
||
const errText = await resp.text();
|
||
throw new Error(`上传失败 HTTP ${resp.status}:${errText}`);
|
||
}
|
||
return resp.json();
|
||
}
|
||
|
||
// 3. 轮询等待识别结果
|
||
function waitForResult(host, fileId, minConfidence, timeout, onProgress) {
|
||
const deadline = Date.now() + timeout * 1000;
|
||
let lastProgress = -1;
|
||
|
||
return new Promise((resolve, reject) => {
|
||
const poll = async () => {
|
||
if (Date.now() > deadline) {
|
||
reject(new Error(`等待超过 ${timeout} 秒,任务仍未结束`));
|
||
return;
|
||
}
|
||
|
||
try {
|
||
const ctrl = new AbortController();
|
||
const timer = setTimeout(() => ctrl.abort(), 30000);
|
||
const resp = await fetch(`${host}/api/v1/i2t`, {
|
||
method: 'POST',
|
||
headers: { 'Content-Type': 'application/json' },
|
||
body: JSON.stringify({
|
||
file_id: fileId,
|
||
min_confidence: minConfidence
|
||
}),
|
||
signal: ctrl.signal
|
||
});
|
||
clearTimeout(timer);
|
||
|
||
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
|
||
const payload = await resp.json();
|
||
const data = payload.data || {};
|
||
const status = data.status;
|
||
|
||
if (FINISHED_STATUSES.includes(status)) {
|
||
resolve(data);
|
||
return;
|
||
}
|
||
|
||
// 更新进度
|
||
if (!quietCheck.checked) {
|
||
const progress = data.progress || 0;
|
||
let extra = '';
|
||
if (status === 'queued' && data.queue_position) {
|
||
extra = ` 排队第 ${data.queue_position} 位`;
|
||
}
|
||
if (progress !== lastProgress) {
|
||
onProgress?.(progress, status, extra);
|
||
lastProgress = progress;
|
||
}
|
||
}
|
||
|
||
setTimeout(poll, POLL_INTERVAL);
|
||
} catch (err) {
|
||
reject(err);
|
||
}
|
||
};
|
||
poll();
|
||
});
|
||
}
|
||
|
||
// 4. 渲染识别结果
|
||
function renderResult(container, data) {
|
||
const result = data.result || {};
|
||
const text = result.text || '';
|
||
const polygon = result.polygon || {};
|
||
const fields = data.fields;
|
||
const showJson = jsonCheck.checked;
|
||
|
||
// 元信息
|
||
const meta = document.createElement('div');
|
||
meta.className = 'result-meta';
|
||
meta.textContent = `耗时 ${data.ocr_elapsed_ms} ms,${Object.keys(polygon).length} 个文本片段`;
|
||
container.appendChild(meta);
|
||
|
||
// 识别文本
|
||
if (text) {
|
||
const title = document.createElement('div');
|
||
title.className = 'result-block-title';
|
||
title.textContent = '── 识别文本 ────────────────────────────────';
|
||
container.appendChild(title);
|
||
|
||
const textDiv = document.createElement('div');
|
||
textDiv.className = 'text-content';
|
||
textDiv.textContent = text;
|
||
container.appendChild(textDiv);
|
||
}
|
||
|
||
// 抽取字段
|
||
if (fields && Object.keys(fields).length > 0) {
|
||
const title = document.createElement('div');
|
||
title.className = 'result-block-title';
|
||
title.textContent = '── 抽取字段 ────────────────────────────────';
|
||
container.appendChild(title);
|
||
|
||
const fieldList = document.createElement('div');
|
||
fieldList.className = 'field-list';
|
||
for (const [key, value] of Object.entries(fields)) {
|
||
const item = document.createElement('div');
|
||
item.className = 'field-item';
|
||
// 用 textContent 而不是 innerHTML:字段值来自 OCR 结果,
|
||
// 而 OCR 结果来自用户上传的图片,内容不可信(图片里印一段
|
||
// <img onerror=...> 就会被当 HTML 执行)。
|
||
const keySpan = document.createElement('span');
|
||
keySpan.className = 'field-key';
|
||
keySpan.textContent = `${key}:`;
|
||
item.append(keySpan, ` ${value}`);
|
||
fieldList.appendChild(item);
|
||
}
|
||
container.appendChild(fieldList);
|
||
}
|
||
|
||
// 原始 JSON
|
||
if (showJson) {
|
||
const title = document.createElement('div');
|
||
title.className = 'result-block-title';
|
||
title.textContent = '── 原始 JSON ────────────────────────────────';
|
||
container.appendChild(title);
|
||
|
||
const jsonBox = document.createElement('div');
|
||
jsonBox.className = 'json-box';
|
||
jsonBox.textContent = JSON.stringify(data, null, 2);
|
||
container.appendChild(jsonBox);
|
||
}
|
||
}
|
||
|
||
// 5. 处理单张图片完整流程
|
||
async function processSingle(file) {
|
||
const host = getHost();
|
||
const minConf = readNumber(confidenceInput, 0);
|
||
const timeout = readNumber(timeoutInput, 300);
|
||
|
||
// 创建单张结果卡片
|
||
const item = document.createElement('div');
|
||
item.className = 'result-item';
|
||
|
||
const title = document.createElement('div');
|
||
title.className = 'result-title';
|
||
title.textContent = `[${file.name}]`;
|
||
item.appendChild(title);
|
||
|
||
const statusLine = document.createElement('div');
|
||
statusLine.className = 'status-line';
|
||
statusLine.textContent = '准备上传...';
|
||
item.appendChild(statusLine);
|
||
|
||
let progressBar, progressFill;
|
||
if (!quietCheck.checked) {
|
||
progressBar = document.createElement('div');
|
||
progressBar.className = 'progress-bar';
|
||
progressFill = document.createElement('div');
|
||
progressFill.className = 'progress-fill';
|
||
progressBar.appendChild(progressFill);
|
||
item.appendChild(progressBar);
|
||
}
|
||
|
||
resultBox.appendChild(item);
|
||
|
||
// 进度回调(安静模式没有进度条,progressFill 是 undefined)
|
||
const onProgress = (p, status, extra) => {
|
||
statusLine.textContent = `进度 ${p}% ${status}${extra}`;
|
||
if (progressFill) progressFill.style.width = `${p}%`;
|
||
};
|
||
|
||
try {
|
||
// 上传阶段
|
||
statusLine.textContent = '正在上传图片...';
|
||
const uploadRes = await uploadImage(host, file);
|
||
const fileId = (uploadRes.data || {}).file_id;
|
||
if (!fileId) throw new Error(`上传响应异常:${JSON.stringify(uploadRes)}`);
|
||
|
||
// 识别轮询阶段
|
||
statusLine.textContent = '正在识别...';
|
||
const result = await waitForResult(host, fileId, minConf, timeout, onProgress);
|
||
|
||
if (result.status === 'failed') {
|
||
throw new Error(`识别失败:${result.error}`);
|
||
}
|
||
|
||
// 渲染结果
|
||
statusLine.classList.add('status-success');
|
||
statusLine.textContent = '识别完成';
|
||
// 注意不能写 `progressFill?.style.width = '100%'`:
|
||
// 可选链不能做赋值目标,那是语法错误,会让整个 script 块解析失败。
|
||
if (progressFill) progressFill.style.width = '100%';
|
||
renderResult(item, result);
|
||
|
||
return true;
|
||
} catch (err) {
|
||
statusLine.classList.add('status-error');
|
||
statusLine.textContent = `处理失败:${err.message}`;
|
||
return false;
|
||
}
|
||
}
|
||
|
||
// ========== 事件绑定 ==========
|
||
selectBtn.addEventListener('click', () => fileInput.click());
|
||
|
||
fileInput.addEventListener('change', e => {
|
||
fileList = Array.from(e.target.files);
|
||
if (fileList.length > 0) {
|
||
startBtn.disabled = false;
|
||
startBtn.textContent = `开始识别 (${fileList.length} 张)`;
|
||
} else {
|
||
startBtn.disabled = true;
|
||
startBtn.textContent = '开始识别';
|
||
}
|
||
});
|
||
|
||
healthBtn.addEventListener('click', doHealthCheck);
|
||
|
||
startBtn.addEventListener('click', async () => {
|
||
if (fileList.length === 0) return;
|
||
|
||
// 锁定操作
|
||
startBtn.disabled = true;
|
||
selectBtn.disabled = true;
|
||
healthBtn.disabled = true;
|
||
resultBox.innerHTML = '';
|
||
|
||
// 依次处理所有图片(对齐原脚本多张依次处理逻辑)
|
||
let failCount = 0;
|
||
for (const file of fileList) {
|
||
const ok = await processSingle(file);
|
||
if (!ok) failCount++;
|
||
}
|
||
|
||
// 统计汇总
|
||
const summary = document.createElement('div');
|
||
summary.className = 'summary';
|
||
if (failCount > 0) {
|
||
summary.style.background = '#ffebe9';
|
||
summary.style.color = '#cf222e';
|
||
summary.textContent = `处理完成:${fileList.length - failCount} 张成功,${failCount} 张失败`;
|
||
} else {
|
||
summary.style.background = '#dafbe1';
|
||
summary.style.color = '#1a7f37';
|
||
summary.textContent = `处理完成:全部 ${fileList.length} 张识别成功`;
|
||
}
|
||
resultBox.appendChild(summary);
|
||
|
||
// 恢复操作
|
||
startBtn.disabled = false;
|
||
selectBtn.disabled = false;
|
||
healthBtn.disabled = false;
|
||
// 清空 input,否则再次选同一个文件不会触发 change
|
||
fileInput.value = '';
|
||
});
|
||
</script>
|
||
</body>
|
||
</html>
|