用途：从用户上传的图片或 PDF 中识别并提取文字，支持表格结构化提取、批量目录处理、格式保留与 Markdown 结果生成。触发条件为上传图片或 PDF 并要求提取文字、批量处理文件夹、提取 PDF 表格数据。
主要能力：图片文字检测与提取，保留原有结构和排版；PDF 文字层提取并输出 Markdown 正文；扫描版 PDF 自动检测文字层稀少页面（少于 20 字符）渲染为高清 PNG，交由 read_image（AI 视觉）识别，无需 tesseract/rapidocr 等 OCR 引擎；表格用 pymupdf 内置 find_tables() 提取并输出 Markdown；批量处理目录下 PDF 与图片混合文件。支持图片格式 PNG、JPG、JPEG、GIF、WebP、BMP、TIFF，支持中文、英文等多语言。
必要用法：依赖 pymupdf>=1.23.0 与 requests>=2.28.0，安装命令为 pip install pymupdf>=1.23.0 requests>=2.28.0。需前往指定地址免费注册获取红狐 API Key，配置方式包括在配置文件写入 {"env": {"REDFOX_API_KEY": "ak_xxxx..."}} 或执行 export REDFOX_API_KEY="ak_xxxx..."。每次操作前必须先运行 python3 scripts/record.py 鉴权，非零退出码则立即停止并提示配置 Key；再运行 python3 scripts/changelog.py 做版本提示。PDF 提取命令为 python3 scripts/pdf_text_extractor.py <pdf_file_path>，可选 --no-tables、--no-render、--scan-dir、--dpi 等参数，输出 JSON（含 success、text、page_count、tables_markdown、ocr_images、warnings 等字段）。批量为 python3 scripts/batch_extractor.py <目录路径>，可选 -o、--json、--no-render、--scan-dir。
适用场景：单张图片识别、文字版与扫描版 PDF 提取、表格数据提取、混合目录批量处理。
限制：识别准确性受图片清晰度、字体、背景影响；不支持加密或受密码保护的 PDF；复杂表格（合并单元格、嵌套表格）识别效果可能不佳；数字需按先看形状再判断的规则识别，关键数字串执行两轮校验，存疑字符用 [?] 标注；批量建议单次不超过 100 个文件，文件建议小于 50MB；处理文件不存储，仅当前会话使用。红色 API Key 免费但需配置，其他计费细节暂未提供。