H1-H10 优化OCR实时体验闭环

docs/trialrun-runbook.md

@@ -104,12 +104,21 @@ LIVE_SMOKE_BASE_URL=https://oa.hyinda.com bash scripts/qa/run-live-smoke-readine
 
 1. 上传接口是否成功返回 invoice id。
 2. 发票是否进入 `pending_ocr`。
-3. OCR job 是否运行。
-4. OCR provider 是否为腾讯而不是 mock。
-5. OCR 是否返回结构化字段。
-6. 查重是否把发票转为不可添加。
-7. 前端状态查询是否轮询并刷新。
-8. 报销详情是否自动添加到明细。
+3. 单票识别任务是否立即入队，周期任务是否只作为兜底。
+4. OCR job 是否运行。
+5. OCR provider 是否为腾讯而不是 mock。
+6. OCR 是否返回结构化字段。
+7. 查重是否把发票转为不可添加。
+8. 前端事件流或轮询兜底是否触发刷新。
+9. 报销详情是否自动添加到明细。
+
+发布前可执行 pending OCR 扫描，定位卡住的票据：
+
+```bash
+node scripts/qa/check-pending-ocr.mjs --thresholds=2,5,10
+```
+
+脚本只输出票据 ID、上传时间、尝试次数和最后错误摘要，不读取票据文件内容。缺少 `DATABASE_URL` 时应输出 `SKIP`，不视为真实数据库健康检查通过。
 
 ## 公网与部署