overview/overview-convert-pdfocr

镜像概述

该镜像用于为PDF文件添加不可见文本层，是Overview项目（https://github.com/overview/overview-server%EF%BC%89%E7%9A%84%E9%85%8D%E5%A5%97%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%8A%A9%E5%8A%9BPDF%E6%96%87%E6%9C%AC%E8%AF%86%E5%88%AB%E7%9B%B8%E5%85%B3%E7%9A%84%E9%A2%84%E5%A4%84%E7%90%86%E5%B7%A5%E4%BD%9C%E3%80%82

核心功能

• 处理PDF文件，生成包含wantOcr:false字段的0.json输出文件
• 生成0.blob文件作为处理后的二进制输出
• 自定义构建PdfOcr组件，可修复已知错误（仅无法处理内存不足导致的非零退出码错误）

使用场景

作为Overview服务器的一部分，用于PDF文本识别的预处理环节，为PDF添加文本层，以便后续进行索引、搜索或分析操作。

配置说明

无特殊配置要求，可通过测试用例验证功能正确性：

1. 测试文件位于test/test-*目录下，包含input.blob、input.json等输入文件及预期输出文件（stdout、0.json、0.blob）
2. 执行docker build .会自动运行测试，若实际输出与预期不符则测试失败

部署示例

bash
# 构建镜像
docker build -t overview/overview-convert-pdfocr .

# 运行测试验证功能
docker build .

测试方法

若需生成测试预期输出文件，可参考以下步骤（以test-embedded-png/0.blob为例）：

1. 编写test/test-embedded-png目录下的input.json、input.blob、0.json、stdout文件
2. 执行docker build .，记录测试失败时的容器ID（如202f38be95c9）
3. 复制容器内生成的0.blob文件到测试目录：docker cp [容器ID]:/tmp/test-do-convert-single-file[随机数]/0.blob test/test-embedded-png/
4. 删除容器：docker rm -f [容器ID]
5. 检查文件行为是否符合预期后，再次执行docker build .验证测试通过