支持四引擎的PDF OCR识别技能，可从影印版PDF文件和图片文件中提取中英文文字内容 | PDF OCR Skill with quadruple-engine support, capable of extracting Chinese and English text from scanned PDF files and image files

PDF OCR Skill 中文版本 PDF OCR技能用于从影印版PDF文件和图片文件中提取文字内容。该技能支持两种OCR引擎： RapidOCR （本地引擎）：无需API密钥，免费使用，识别速度快硅基流动大模型（云端引擎）：使用AI大模型进行高精度OCR识别功能特性支持影印版PDF文件的文字提取支持多种图片格式的文字识别（JPG、PNG、BMP、GIF、TIFF、WEBP）四引擎支持：RapidOCR（本地）、RapidDoc（增强）、PaddleOCR（本地）和硅基流动API（云端）支持中文和英文文字识别保持文字的顺序和结构自动将PDF页面转换为图片进行识别智能引擎切换：当RapidOCR初始化失败时自动切换到硅基流动API 安装依赖要求可选依赖（推荐）安装RapidOCR以获得本地识别能力：环境变量配置 1. 复制 .env.example 文件并重命名为 .env 2. 根据需要配置以下选项：快速开始使用默认引擎（RapidOCR本地识别）使用硅基流动API引擎识别图片文件命令行使用进阶使用示例批量处理多个PDF文件混合使用两种引擎支持的文件格式 PDF文件 : .pdf 图片文件 : .jpg, .jpeg, .png, .bmp, .gif, .tiff, .webp 输出格式使用场景处理扫描版合同、协议等文档提取影印版书籍、报告中的文字处理无法直接复制文字的PDF文件批量处理扫描版PDF文档识别截图、扫描件等图片中的文字处理手写体或印刷体图片文字识别注意事项 1. RapidOCR引擎：完全免费，无需网络连接首次使用会自动下载模型文件识别速度取决于CPU性能 2. 硅基流动API引擎：需要有效的API密钥可能会产生费用识别速度取决于文件页数、图片大小和网络状况 3. RapidDoc引擎：完全免费，无需网络连接支持版面分析、表格识别、公式识别和阅读顺序恢复提供更结构化的输出，包括Markdown格式处理时间可能比RapidOCR长，因为需要进行额外的分析 4. PaddleOCR引擎：完全免费，无需网络连接使用PP OCRv5模型，具有较高的识别准确率首次使用会自动下载模型文件支持多种语言和场景的文字识别 4. 对于复杂的扫描版PDF或图片，识别准确率可能会有所不同 5. 建议使用高清晰度的扫描版PDF或图片以获得更好的识别效果触发使用不同引擎的提示词在与 AI IDE 中的助手交互时，您可以使用以下提示词来指定使用不同的 OCR 引擎： 📍 触发 RapidOCR（本地引擎）的提示词 "使用本地 OCR 引擎处理这个 PDF" "用 RapidOCR 识别这个文件" "本地处理，不需要 API" "快速识别这个文档" "离线处理这个 PDF" "不使用硅基流动 API，用本地引擎" 📍 触发硅基流动 API（云端引擎）的提示词 "使用硅基流动 API 处理这个 PDF" "用大模型 OCR 识别这个文件" "高精度识别这个文档" "处理复杂的扫描件" "用云端 OCR 引擎" "使用 AI 大模型识别" 📍 触发 RapidDoc（增强引擎）的提示词 "使用 RapidDoc 处理这个 PDF" "用增强 OCR 识别这个文件" "处理带有版面分析的 PDF" "提取带有表格识别的文本" "用 RapidDoc 获得更好的格式" "增强 OCR 与版面分析" 📍 触发 PaddleOCR（本地引擎）的提示词 "使用 PaddleOCR 处理这个 PDF" "用 PaddleOCR 识别这个文件" "使用 PP OCRv5 模型识别" "用 PaddleOCR 进行高精度识别" "PaddleOCR 本地处理" "使用 PaddleOCR 引擎提取文字" 📍 示例对话示例 1：使用本地引擎示例 2：使用云端引擎示例 3：自动选择 🔧 技术实现当 AI 助手接收到这些提示词时，会： 1. 解析用户意图，确定要使用的引擎 2. 调用 PDFOCRProcessor(engine="rapid")、PDFOCRProcessor(engine="rapidoc")、PDFOCRProcessor(engine="paddle") 或 PDFOCRProcessor(engine="siliconflow") 3. 执行 OCR 识别并返回结果 🎯 最佳实践明确指定引擎：如果您对引擎有特定要求，最好在提示词中明确说明提供上下文：说明文档类型（如手写体、复杂格式等）有助于助手选择合适的引擎测试不同引擎：对于重要文档，可以尝试两种引擎并比较结果通过使用这些提示词，您可以在与 AI IDE 交互时灵活控制 OCR 引擎的选择，获得最佳的识别效果故障排除常见问题及解决方案 1. RapidOCR初始化失败问题： ModuleNotFoundError: No module named 'rapidocr onnxruntime' 解决方案：安装RapidOCR依赖： pip install rapidocr onnxruntime 2. 硅基流动API 401错误问题： Unauthorized: 401 Client Error 解决方案：检查API密钥是否正确配置在 .env 文件中 3. PDF转图片失败问题： ImportError: No module named 'fitz' 解决方案：安装PyMuPDF依赖： pip install pymupdf 4. 识别结果为空问题：识别结果文本长度为0 解决方案：检查PDF是否为扫描版（非文本PDF）尝试使用硅基流动API引擎确保PDF或图片清晰可读 English Version PDF OCR Skill PDF OCR Skill is used to extract text content from scanned PDF files and image files. This skill supports two OCR engines: RapidOCR (local engine): No API key required, free to use, fast recognition speed SiliconFlow Large Model (cloud engine): Uses AI large model for high precision OCR recognition Features Support text extraction from scanned PDF files Support text recognition from multiple image formats (JPG, PNG, BMP, GIF, TIFF, WEBP) Quadruple engine support : RapidOCR (local), RapidDoc (enhanced), PaddleOCR (local), and SiliconFlow API (cloud) Support Chinese and English text recognition Maintain text order and structure Automatically convert PDF pages to images for recognition Intelligent engine switching: automatically switch to SiliconFlow API when RapidOCR initialization fails Installation Dependencies Optional Dependencies (Recommended) Install RapidOCR for local recognition capability: Environment Configuration 1. Copy .env.example file and rename it to .env 2. Configure the following options as needed: Quick Start Using Default Engine (RapidOCR Local Recognition) Using SiliconFlow API Engine Recognizing Image Files Command Line Usage Advanced Usage Examples Batch Processing Multiple PDF Files Using Both Engines Supported File Formats PDF files : .pdf Image files : .jpg, .jpeg, .png, .bmp, .gif, .tiff, .webp Output Format Use Cases Processing scanned contracts, agreements and other documents Extracting text from photocopied books and reports Processing PDF files with non copyable text Batch processing scanned PDF documents Recognizing text in screenshots and scanned images Processing handwritten or printed text in images Notes 1. RapidOCR Engine : Completely free, no network connection required Model files will be automatically downloaded on first use Recognition speed depends on CPU performance 2. SiliconFlow API Engine : Requires a valid API key May incur costs Recognition speed depends on number of pages, image size, and network conditions 3. RapidDoc Engine : Completely free, no network connection required Supports layout analysis, table recognition, formula recognition, and reading order recovery Provides more structured output including markdown format Processing time may be longer than RapidOCR due to additional analysis 4. PaddleOCR Engine : Completely free, no network connection required Uses PP OCRv5 model with high recognition accuracy Model files will be automatically downloaded on first use Supports text recognition for multiple languages and scenarios 4. Recognition accuracy may vary for complex scanned PDFs or images 5. It is recommended to use high resolution scanned PDFs or images for better recognition results Prompt Words for Different Engines When interacting with assistants in AI IDEs, you can use the following prompt words to specify different OCR engines: 📍 Prompt Words for RapidOCR (Local Engine) "Use local OCR engine to process this PDF" "Recognize this file with RapidOCR" "Local processing, no API needed" "Quickly recognize this document" "Process this PDF offline" "Don't use SiliconFlow API, use local engine" 📍 Prompt Words for SiliconFlow API (Cloud Engine) "Use SiliconFlow API to process this PDF" "Recognize this file with large model OCR" "High precision recognition for this document" "Process complex scanned documents" "Use cloud OCR engine" "Use AI large model for recognition" 📍 Prompt Words for RapidDoc (Enhanced Engine) "Use RapidDoc to process this PDF" "Recognize this file with enhanced OCR" "Process PDF with layout analysis" "Extract text with table recognition" "Use RapidDoc for better formatting" "Enhanced OCR with layout analysis" 📍 Prompt Words for PaddleOCR (Local Engine) "Use PaddleOCR to process this PDF" "Recognize this file with PaddleOCR" "Use PP OCRv5 model for recognition" "Use PaddleOCR for high precision recognition" "PaddleOCR local processing" "Extract text using PaddleOCR engine" 📍 Example Conversations Example 1: Using Local Engine Example 2: Using Cloud Engine Example 3: Automatic Selection 🔧 Technical Implementation When the AI assistant receives these prompt words, it will: 1. Parse the user's intent to determine the engine to use 2. Call PDFOCRProcessor(engine="rapid"), PDFOCRProcessor(engine="rapidoc"), PDFOCRProcessor(engine="paddle"), or PDFOCRProcessor(engine="siliconflow") 3. Execute OCR recognition and return the result 🎯 Best Practices Clearly specify the engine : If you have specific requirements for the engine, it's best to clearly state it in the prompt Provide context : Explaining the document type (e.g., handwritten, complex format) helps the assistant choose the appropriate engine Test different engines : For important documents, you can try both engines and compare the results By using these prompt words, you can flexibly control the OCR engine selection when interacting with AI IDEs to get the best recognition results Troubleshooting Common Issues and Solutions 1. RapidOCR Initialization Failure Issue: ModuleNotFoundError: No module named 'rapidocr onnxruntime' Solution: Install RapidOCR dependency: pip install rapidocr onnxruntime 2. SiliconFlow API 401 Error Issue: Unauthorized: 401 Client Error Solution: Check if the API key is correctly configured in the .env file 3. PDF to Image Conversion Failure Issue: ImportError: No module named 'fitz' Solution: Install PyMuPDF dependency: pip install pymupdf 4. Empty Recognition Result Issue: Recognition result text length is 0 Solution: Check if the PDF is a scanned version (non text PDF) Try using SiliconFlow API engine Ensure the PDF or image is clear and readable License MIT License See [LICENSE.txt](LICENSE.txt)

pdf-ocr-skill