批量识别
文件队列
- 支持 PDF、PNG、JPEG、TIFF；拖入窗口或通过「添加文件」选择。
- 队列按文件路径去重，重复拖入不会产生重复任务。
- 每个任务显示状态：等待、识别中、完成、失败、已取消。
- 失败任务保留错误原因，可单独重试，不影响其他任务。
批次参数
批次参数作用于整个队列，是「应用默认 → 引擎默认 → 批次参数」合并后的结果。
| 参数 | 默认 | 可选值 |
|---|---|---|
| 批次引擎 | 跟随应用默认 | 应用默认 / 已安装的引擎 |
| 识别语言 | 自动检测 | 自动检测 / 中文（简体）/ English |
| 并发数 | 1 | 1 / 2 / 3 |
| 保留版面结构 | 开 | 开 / 关 |
并发度默认为 1，避免端侧资源争抢；macOS 与 Windows 允许调到 3，低配 Linux 默认建议 1。展开参数面板后还会显示当前引擎的推理参数。
推理参数
参数面板按引擎适配器显示不同内容：
- llama.cpp 系（MiniCPM-OCR、Xiaomi-OCR-0、PaddleOCR-VL）：
prompt、temperature、topP、topK、repeatPenalty、maxTokens、layoutThreshold。 - PP-OCR ONNX：
detBoxThreshold、layoutThreshold。
留空表示沿用引擎或模型默认值；填写非法数值时该项被忽略并记录一条警告，其余项仍然生效。面板提供「填入官方推荐值」，可一键恢复 MiniCPM-OCR 官方推荐的采样参数。
layoutThreshold 是版面检测的置信度阈值，仅在开启「保留版面结构」时生效。印章、图表等区域级开关只出现在支持对应能力的引擎上。
单任务覆盖
双击队列中的任务（或在任务菜单中选择「参数覆盖」）打开覆盖面板：
- 覆盖项与批次参数的键一致，只需填写要改动的项，其余继续沿用批次值；
- 覆盖仅对该任务生效，不写回批次参数；
- 面板会标明每一项当前取值来自哪一层，避免「改了却没生效」的困惑。
合并顺序固定为：应用默认 → 引擎默认 → 批次参数 → 单任务覆盖。
执行、取消与重试
- 「开始」后按队列顺序执行，并发度由批次参数决定。
- 「取消」会取消整个批次，状态复位并清理临时输出，不留下半成品。
- 单个任务失败不会中断批次；可对失败项单独重试。
- 进度按阶段上报（预处理、版面、识别、后处理），界面同时显示整体进度与当前任务。
- 长任务过程写入任务日志，可在日志页筛选、复制与清空。
性能建议
- 低配设备把并发保持在 1，优先升级量化档位而不是并发。
- 大量小图可以先用 PP-OCRv6，确认版面后再切换到 VLM 引擎。
- 扫描件优先使用中档模型；拍照件与弯曲页面交给 MiniCPM-OCR。
- 关闭「保留版面结构」可以显著降低 VLM 引擎的耗时，但会失去阅读顺序与块类型。