用途:当文档为图像型内容(扫描 PDF、拍照页、截图、含文字的 JPEG/PNG/TIFF)时,用该技能做 OCR 提取。Xberg 对光栅图片自动 OCR,并自动检测缺少文本层的 PDF;若 PDF“看起来”有文字但提取结果为空或乱码,可强制启用 OCR。
主要能力:支持强制 OCR(--force-ocr=true 会重新栅格化并逐页 OCR)、启用/禁用 OCR(--ocr=true、--disable-ocr=true)、语言包(--ocr-language,ISO 639-2 代码,可用 + 连接,或 all)、后端切换、自动旋转(--ocr-auto-rotate=true)以及 ONNX 加速(--acceleration)。
后端:Tesseract 为默认且随 CLI 提供;PaddleOCR 随附 ONNX Runtime,强于亚洲文字,但 WASM 与 Windows 不可用;Candle VLM 系列(candle-trocr、candle-paddleocr-vl、candle-glm-ocr、candle-deepseek-ocr)为本地视觉 OCR 模型;托管 VLM 通过 --ocr-backend vlm 配合 --vlm-model 与 --vlm-api-key 使用。建议先用 Tesseract,仅在准确率不可接受时切换。
用法示例:xberg extract scan.pdf --force-ocr=true;xberg extract scan.pdf --ocr=true --ocr-language eng;xberg extract bilingual.pdf --ocr-language "eng+jpn"。批量可用 xberg batch *.pdf --ocr=true,并用 --max-concurrent N 限制并发。长参数可写入 xberg.toml(从 cwd 向上自动发现),配置 [ocr] 段后直接运行 xberg extract document.pdf。
限制与注意:语言包需在操作系统层安装(如 macOS 的 brew install tesseract-lang,Debian/Ubuntu 的 apt install tesseract-ocr-<iso639-2>),缺失会报错并提示缺失文件;默认缓存开启,重复提取同一文件与配置会很快;--target-dpi 默认 300,印刷文字 200 通常足够;旋转页需开启自动旋转;CJK 乱码应检查语言包,中文/日文可考虑 paddle-ocr。其余未在资料中提供的收费、价格或效果数据暂未提供。