用途：为 AI 代理提供本地光学字符识别流水线，可处理扫描 PDF、旋转图像并提取文本，全部在本地完成，不依赖外部 API。
主要能力：生成可搜索 PDF，为扫描 PDF 或图片（.jpg、.png 等）添加可选中的文本层；自动检测并纠正旋转文字、拉直倾斜扫描件；使用 --skip-text 实现幂等的原地处理，避免重复处理已有文本层的 PDF；所有命令输出结构化 JSON，便于代理解析失败状态；支持原始文本提取，可直接在内存中返回文本而不生成 PDF。
使用方式：先运行 bash skills/ocr/scripts/setup.sh 安装系统依赖（tesseract、ocrmypdf、ghostscript）并创建隔离虚拟环境。随后通过 uv run --project ~/.local-ocr scripts/ocr.py <command> 调用。三种命令：pdf 生成可搜索 PDF，可原地覆盖、指定输出文件或用 --force 强制重新处理，默认启用自动旋转和纠偏，可用 --no-rotate 或 --no-deskew 关闭；batch 递归处理目录中的图片和 PDF，跳过已有文本的 PDF；text 仅提取原始文本并以 JSON 字符串返回。
适用场景：需要本地安全处理扫描发票、合同、档案等文档，或在代理流程中即时读取文档文字。
限制：资料未提供具体识别语言、准确率、性能数据及平台兼容性；依赖 tesseract 与 ocrmypdf，若缺失需重新运行 setup.sh；ocrmypdf 对已有文本的文件跳过时返回退出码 6，包装脚本会报告成功状态。