SuperAPI AI 工具集

oma-pdf

办公与效率

查看项目

更新于 10-15 21:55

技能介绍

用途:将 PDF 转换为结构化 Markdown 或其他提取格式,保留可读的文档结构,便于 LLM 上下文、RAG 或后续审查。适用于转换、解析、读取、提取 PDF;需要提取文本、标题、列表、表格、图片、脚注、超链接等结构化内容;在决定是否用 OCR 前检查 PDF 是否含文本层。

主要能力:基于 opendataloader-pdf 完成标准转换;对扫描或图像型 PDF 可用混合 OCR 模式;可输出 markdown、text、json、html 或组合结果;用 mdformat 规范化 Markdown;提供输出路径、页数和转换问题的简短报告。

用法:输入 input_path,可选 output_dir、format(默认 markdown)、ocr_languages 和 extraction_options。标准转换命令为 uvx opendataloader-pdf "{input_path}" --format markdown --output-dir "{output_dir}",随后用 uvx mdformat "{output_path}" 规范化。文本层探测:uvx opendataloader-pdf "{input_path}" -f text --pages 1-3 --to-stdout -q。OCR 或混合转换需先启动 uvx --from "opendataloader-pdf[hybrid]" opendataloader-pdf-hybrid --port 5002 --force-ocr --ocr-lang "{languages}",再用 uvx opendataloader-pdf --hybrid docling-fast --hybrid-mode full ... 转换。

限制:不生成或创建 PDF,不编辑已有 PDF,不处理 HWP、HWPX、DOCX、XLSX 或幻灯片。加密 PDF 需密码或解锁副本。需通过 uvx 提供所需 CLI;缺少 uv 时应先安装。大文件或内存受限时分页区间输出到不同目录或使用 --to-stdout,避免同名覆盖。提取不完整时不得编造内容,须报告乱码、缺表、OCR 不确定或部分提取。默认配置读取 .agents/oma-config.yaml 的 pdf: 段,未设置项回退到 config/pdf-config.yaml,用户覆盖应写入前者。其他命令细节与配置暂未提供更多说明。