用途:处理需要关注版式与视觉效果的 PDF 任务,包括读取与评审、程序化创建,以及交付前的渲染校验。
主要能力与用法:优先做视觉审查,先渲染 PDF 页面为 PNG 再检查;渲染用 pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX,依赖 Poppler(macOS 用 brew install poppler,Ubuntu/Debian 用 sudo apt-get install -y poppler-utils)。创建新文档用 reportlab;文本抽取和快速检查用 pdfplumber 或 pypdf,但后者不能用来保证版式还原。Python 依赖安装优先 uv pip install reportlab pdfplumber pypdf,无 uv 时用 python3 -m pip install reportlab pdfplumber pypdf。环境不需要环境变量。
流程与质量:每次有实质修改后重新渲染页面,检查对齐、间距、可读性;避免文字被裁切、元素重叠、表格断裂、黑块或乱码;图表、表格和图片需清晰、对齐并有明确标注;只使用 ASCII 连字符,避免 U+2011 等 Unicode 破折号;引用与参考资料必须人类可读,不能保留工具标记或占位符。交付前最后一张 PNG 不得有任何视觉或格式缺陷,并确认页眉页脚、页码和章节过渡正常。
临时与输出:中间文件放在 tmp/pdfs/ 并在完成后删除;在本仓库工作时最终产物写到 output/pdf/;文件名保持稳定且具描述性。若环境无法安装依赖,应告知用户缺少哪个依赖及本地安装方式。
限制:资料未给出具体的“不适用场景”内容,暂未提供;也无收费、平台或效果说明。