用途:将 PDF 及文档图片解析为结构化 Markdown/JSON,适合含表格(发票、财报、表格)、数学公式(学术论文、科研文档)、图表、多栏版式(报纸、杂志、手册)以及需要版面分析的复杂文档。简单纯文本快速 OCR、屏幕截图等清晰简单图片不建议使用。
主要能力:输出文本、表格、公式(LaTeX)、图片、印章、页眉页脚及阅读顺序;text 为跨页全文,result.result.layoutParsingResults[n].markdown.text 为页级 Markdown,.prunedResult 含版面元素位置与置信度。
使用方式(脚本,默认路径):在技能根目录执行 uv run scripts/layout_caller.py --file-url "URL" --pretty,或 --file-path "路径" --pretty;可选 --file-type 0(PDF)/1(图片),未指定时按扩展名自动识别。默认将原始 JSON 保存到系统临时目录并在 stderr 打印路径;加 --stdout 直接输出 JSON,--output 自定义保存位置。依赖由 PEP 723 内联声明,无需单独安装。
替代方式(官方 CLI,需 paddleocr>=3.7.0):paddleocr api --model_type doc_parsing --file_path "./document.pdf",仅需 PADDLEOCR_ACCESS_TOKEN 环境变量;支持 --page_ranges "1-5,10,15-20"、--output、--save_resources、--prettify_markdown 等选项,输出格式为 {jobId, pages:[...]},与脚本信封不同。
限制:需配置 PADDLEOCR_DOC_PARSING_API_URL 与 PADDLEOCR_ACCESS_TOKEN,未配置返回 CONFIG_ERROR;PDF 单次最多 100 页,大文件建议先压缩或按页拆分;解析耗时随复杂度增加,大型 PDF 可能需数分钟;出错时返回 ok:false,应显示 error.message 而非自行用视觉能力兜底。