SuperAPI AI 工具集

pdf

办公与效率

查看项目

更新于 10-16 01:39

技能介绍

用途:在需要读取或审阅 PDF 内容且版式和视觉效果重要时使用;也用于以可靠排版程序化生成 PDF,并在交付前验证最终渲染效果。

主要能力与工作流程:优先采用可视化审阅,把 PDF 页面渲染为 PNG 逐一检查,渲染可用 pdftoppm;若不可用,则安装 Poppler,或请用户在本地审阅输出。新建文档时用 reportlab 生成 PDF;文本提取和快速检查可用 pdfplumber 或 pypdf,但不要依赖它们判断版式保真度。每次实质性更新后重新渲染页面,核对对齐、间距与可读性。

目录约定:中间文件放在 tmp/pdfs/,完成后删除;在本仓库中工作时最终产物写到 output/pdf/ 下;文件名保持稳定且具描述性。

依赖安装:优先用 uv 管理依赖。Python 包:uv pip install reportlab pdfplumber pypdf;若 uv 不可用:python3 -m pip install reportlab pdfplumber pypdf。系统渲染工具:macOS 用 brew install poppler,Ubuntu/Debian 用 sudo apt-get install -y poppler-utils。若环境中无法安装,需告知用户缺少哪个依赖以及如何在本地安装。

渲染命令:pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

环境:无必需环境变量。

质量要求:保持精致视觉设计,字体、间距、页边距与章节层级一致;避免文字被裁切、元素重叠、表格断裂、黑块或字形不可读;图表、表格与图片须清晰、对齐且标签明确;仅使用 ASCII 连字符,避免 U+2011(不断行连字符)等 Unicode 破折号;引用与参考文献须人类可读,不得留下工具标记或占位字符串。

最终检查:在最新一次 PNG 检查显示零视觉或格式缺陷之前不要交付;确认页眉页脚、页码和章节衔接美观;保持中间文件有序或在最终确认后删除。其他细节暂未提供。