Camelot PDF 流解析器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/camelot-pdf-stream-parser。
技能介绍
解决什么问题
复杂 PDF 文档往往无法直接复制出可用的表格数据:扫描版报告、多页年报或多栏版式里,表格边界模糊、跨页断开、边框残缺是常态,规则解析器容易把相邻段落误判为单元格。
这个技能面向的是“结构存在但难以稳定提取”的 PDF:你已经知道表头和数据大致位置,却需要一种可重复、带质量反馈的抽取方式,而不是每次都手工框选。
核心能力与关键步骤
该技能实现了 Camelot 库,围绕两条经典解析路径展开:
- 流解析(Stream):不强依赖完整外框线,更擅长处理缺少显式边框、靠空白与换行分隔的“软表格”。
- 网格解析(Lattice):把 PDF 页面当作版面对象,利用表格线与单元格交点重建结构,适合边框清晰、分隔明确的版式。
在底层预处理上,技能借助 OpenCV 做边缘检测,把页面渲染结果转换为可用于线条与单元格定位的图像特征。这样做的价值在于:当表格线较细、印刷质量参差或存在倾斜时,仍然有机会找回关键结构线索。\n
解析完成后,输出被统一为标准化 DataFrame(例如 pandas.DataFrame 形态),并且带 单元格级置信度分数。这意味着你可以在入库前按阈值过滤、对可疑单元格做人工复核,或在跑批后做质量归因。
适用边界与注意点
- 适合:带有清晰网格线或可推断表格线的文档;跨页表格需要你确认下游是否要求合并、断表续接与重复表头处理策略。
- 不适合:完全没有行列结构、仅靠排版表达“看起来像表”的内容;这类场景更适合先做文档版面理解再抽取。
- 谨慎使用:该技能无法自动提取基于源码的安装或使用说明,材料中也没有给出可直接核验的完整实现细节。在敏感工作流程中运行前,请先审查上游项目与授权信息,再决定是否用于生产环境。
使用场景
- 处理扫描版合同或报告,需要把跨页、边框不完整的表格还原成结构化数据
- 从多页年报 PDF 中抽取财务或经营指标表,并保留单元格置信度用于筛选复核
- 批量解析缺少外框线的表格,希望用流解析算法识别行列边界并导出 DataFrame
- 在文档流水线中做表格检测,需要结合边缘检测处理多栏、多页的复杂版式
适合人员
- 数据工程师:需要把复杂 PDF 中的表格稳定抽取到数据表,供后续清洗和入库
- 财务分析师:要从年报或审计材料中快速获得结构化表格,减少手工复制粘贴
- 文档平台开发者:在现有 OCR 或解析链路中集成表格检测与置信度输出
- 风控与合规人员:需要从大量扫描件中抽取明细表,并对低置信度单元格进行复核