用途：为扫描件、拍照件、证据材料提供 PDF 统一处理入口，可只做单项（预处理、OCR、压缩、解密、去水印、合并、加页码），也可一键完成解密→预处理→合并→OCR 双层 PDF。不做纯文本 PDF 内容编辑、阅读批注、电子签名和非压缩目的的格式转换。
主要能力与用法：一键处理用 python3 scripts/pdf-preprocess-ocr.py --input input.pdf --output output.pdf；只预处理加 --preprocess-only，不压缩再加 --no-compress；只做 OCR 文字层用 python3 scripts/pdf-ocr.py --input input.pdf --output output.pdf。单项工具包括 pdf-rotate.py（--angle 90）、pdf-decrypt.py（--password）、pdf-remove-watermark.py、pdf-compress.py（--level medium）、pdf-add-page-numbers.py、pdf-merge.py（-i 多个文件 -o 输出，可 --add-numbers --continuous）。
后端与默认策略：auto 已配置时优先 PaddleOCR API（PP-OCRv6），再试 MinerU，最后回退本地引擎（有 RapidOCR 优先，否则 ocrmypdf）。禁止外传的材料用 --local-only，敏感中文 OCR 可先 pip install rapidocr。电子或混合 PDF 默认保留文字、矢量、图片和批注层。保护原始文件，输出重名时自动加序号。
质量与限制：可用 pdf-ocr-quality-check.py、pdf-ocr-benchmark.py 做关键词门禁与基准测试。双层 PDF 文字层按行叠层，/ActualText 默认开启，Poppler 可整段复制，PDF Expert 仅启发式改善，macOS 预览等仍按物理行断行；需稳定段落文本时应显式输出独立 Markdown。敏感材料外传前需确认授权。详细参数、依赖与常见问题见对应 references 文档。