SuperAPI AI 工具集

pdf

办公与效率

查看项目

更新于 10-16 09:56

技能介绍

用途:当任务涉及阅读或审查 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(Homebrew)brew install poppler;Ubuntu/Debian sudo apt-get install -y poppler-utils。若当前环境无法安装,告知用户缺少哪个依赖以及如何在本地安装。环境变量:无必需环境变量。渲染命令:pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX。

质量期望:保持精致的视觉设计,包括一致的字体、间距、边距和章节层级。避免渲染问题:文字被裁剪、元素重叠、表格断裂、黑块或字形不可读。图表、表格和图像必须清晰、对齐并标注明确。仅使用 ASCII 连字符,避免 U+2011 及其他 Unicode 破折号。引用和参考必须人类可读,绝不留下工具标记或占位字符串。

最终检查:最新一次 PNG 检查未显示任何视觉或格式缺陷前不得交付。确认页眉页脚、页码和章节过渡看起来精致。整理或删除中间文件。