核心用法
PDF Reader 是一款专为复杂PDF场景设计的文本提取技能,核心价值在于智能双模式处理:
1. 文本层PDF:直接使用 pdftotext 高速提取,保留原始排版质量
2. 扫描/图像PDF:自动降级至 OCR 流程(pdftoppm → tesseract),无需人工判断
用户可通过 bash <skill-dir>/scripts/pdf-extract.sh <pdf路径> 一键执行,支持输出重定向、多语言配置(默认中文简体+英文)、DPI调节等参数。
显著优点
- 零配置启动:自动检测并安装
poppler-utils、tesseract-ocr等依赖,支持 apt/yum/brew 多平台 - 智能降级策略:文本层检测结果稀疏时自动回退 OCR,避免漏检
- 多语言原生支持:默认中英双语,可扩展日、韩等 Tesseract 语言包
- 场景全覆盖:既支持聊天中用户上传的PDF(
/root/.openclaw/media/inbound/),也支持磁盘既有文件
潜在局限
- OCR质量依赖源文件:低分辨率扫描件、手写体、复杂排版识别误差率较高
- 加密PDF不支持:密码保护文件直接失败,无解密模块
- 性能瓶颈:50页以上纯扫描PDF OCR耗时1-2分钟,大文件体验受限
- 图像噪声:纯图片页面(如图表、照片)会产生无效字符输出
适合人群
- 需要批量处理历史扫描档案的档案管理员
- 从PDF论文/报告中提取引用内容的研究人员
- 处理混合类型PDF(文本+扫描)的办公自动化场景
常规风险
- OCR错误可能导致关键信息误读,重要文档建议人工校验
- 临时输出文件(
/tmp/pdf-text.txt)需注意权限管理 - 依赖包的自动安装需要网络连接及系统包管理器权限
---
技术栈:Poppler (pdftotext/pdftoppm) + Tesseract OCR,Shell 封装