SuperAPI AI 工具集

pdf-table-data-conversion

数据与分析

查看项目

更新于 10-16 06:47

技能介绍

用途:当用户希望把 PDF 文档中的表格数据作为文件获取时使用此技能,例如“提取/导出/转换/给我一份……的电子表格”“把返利表放进 Excel”“给我这份合同中的行项目”。它也适用于追问场景:即使此前已在对话中回答或总结过数据,用户随后要求“给我文件/表格/Excel”,仍应调用此技能,从源文档重新生成文件,而不是用对话中的文本拼装。若用户只是提问(如“Contoso 的返利是多少”),则直接在对话中回答,不生成文件;请求含糊时先简短回答并询问是否导出。

主要能力:定位目标 PDF 文档(用户可用自然语言描述客户、合同名、主题或标题),获取完整文档而非检索分块,提取表格并输出格式化工作簿。默认运行捆绑脚本 scripts/extract_tables.py,按表生成 .xlsx 工作簿,每个检测到的表格各占一个工作表,含加粗冻结表头行、自动筛选和列宽调整。支持 --format xlsx|csv|both、--pages 2-5 或 --pages 3 限定页、--contains 关键词筛选表格、--out-dir 指定输出目录;脚本会打印 JSON 摘要,含工作簿路径、各表工作表名、CSV 路径、来源页、行列数。

使用方式:python scripts/extract_tables.py <document.pdf> --out-dir out。脚本依赖 pdfplumber 文本层与清晰表格线,扫描件或纯图片 PDF、无边框或合并单元格表格可能失败或输出错位,此时应自行阅读文档并按清理规则构建工作簿。输出清理:每表保留单一表头行、去除多余空白、删除完全空行但保留空列、数值/货币/日期按源文件原样保留,不臆造或改写;每个独立表格单独一个工作表,跨页的同一逻辑表格可合并。回复先简要复述请求并说明提取内容,再附上完整 .xlsx 文件,完整数据放在文件中而非聊天内;多表时分别命名并说明,再询问是否需要 CSV。最后给出一行摘要(文档、表/工作表、行列数)并说明是脚本还是人工读取,标出跨页表格、解析失败单元格或未检测到表格等不确定之处。

限制与护栏:不得编造行、值或表头,无法读取的单元格应留空并标注;不得仅凭检索分块回答提取请求,须基于完整下载文档;不得从聊天内容构建文件;不得把普通问题变成文件倾倒;不要超出用户要求范围导出所有表格;语气应精确务实,宁可提示不确定性也不自信返回可能不完整的表格。