overview/overview-convert-image

overview/overview-convert-image镜像说明

镜像概述

本镜像为Overview平台设计，用于处理图像文件并生成符合平台规范的输出格式，支持OCR文本识别和直接PDF封装两种模式，输出包含结构化元数据、文本内容、PDF文件及缩略图，可直接用于平台展示。

核心功能

1. 图像转PDF：通过img2pdf工具将输入图像封装为PDF文件（0.blob），生成空文本文件（0.txt）及元数据（0.json）
2. OCR识别：当配置wantOcr=true时，使用tesseract工具提取图像文本，生成带OCR内容的PDF（0.blob）和文本文件（0.txt），元数据标记isFromOcr=true
3. 缩略图生成：自动生成图像的缩略图（0-thumbnail.png或0-thumbnail.jpg）
4. 测试验证：内置测试机制，通过docker build .可运行测试用例，验证转换结果正确性

使用场景

1. Overview平台文档处理流程中，对上传的图像文件进行格式转换和内容提取
2. 批量处理图像文件，生成结构化输出（如PDF、文本、元数据）的场景
3. 需要OCR识别图像中文本内容的应用场景

配置说明

• 输入文件：需提供input.blob（待转换图像）和input.json（配置参数）
• 关键参数：input.json中的wantOcr字段控制是否启用OCR功能（取值true/false）
• 输出文件：固定生成0.json（元数据）、0.txt（文本内容）、0.blob（PDF文件）及缩略图

部署示例

Docker Run测试示例

将本地测试目录挂载到容器，运行内置测试：

bash
docker run -v $(pwd)/test:/app/test overview/overview-convert-image

构建镜像并运行测试

bash
# 克隆源码（假设已获取）
git clone https://github.com/overview/overview-convert-image.git
cd overview-convert-image
# 构建镜像并自动运行测试
docker build .