PDF 生成与渲染审阅

要解决的具体问题

PDF 不像 HTML 那样方便逐层检查：文字重叠、表格断裂、页码错位、黑块和占位符，往往只在最终文件里才暴露。只用 pdfplumber 或 pypdf 提取文本，能知道内容存在，但判断不了版式、间距和视觉可读性是否达到交付标准。

技能如何工作

该技能把 PDF 任务拆成 生成、抽取 和 视觉校验 三层：用 reportlab 创建新文档，用 pdfplumber 或 pypdf 做快速文本检查，再用 pdftoppm 将页面渲染成 PNG 进行审阅。每次更新后重新渲染，检查对齐、间距、图表清晰度、页眉页脚、页码和章节过渡。中间文件放在 tmp/pdfs/，最终产物放在 output/pdf/，文件名保持稳定且可读。若环境缺少依赖，它会指出缺失项并建议本地补齐或人工查看输出，而不是静默失败。

适用边界

它适合布局敏感、需要交付级排版的 PDF 场景，例如报告、说明文档、带图表的静态页面。不适合把复杂网页原样转 PDF 后仍期望像素级一致，也不适合只提取文本而完全不检查版式的任务。最终交付前必须以最新渲染图为准，确认没有裁切、重叠、断行或不可读字符。