pdf

用途

该技能适用于涉及 PDF 文件读取、创建或审核的任务，尤其是当版式和视觉效果很重要时。典型场景包括：阅读或审核 PDF 内容时关注排版与视觉呈现；以编程方式创建格式可靠的 PDF；在交付前验证最终渲染效果。

主要能力

• PDF 页面渲染与可视化审核：将 PDF 页面渲染为 PNG 图片后进行查看。
• PDF 生成：创建新文档时使用 reportlab。
• 文本提取与快速检查：使用 pdfplumber（或 pypdf），但不依赖其保证版式保真度。
• 渲染验证：每次有实质更新后重新渲染页面，核对对齐、间距与可读性。

使用方式

工作流程：优先进行可视化审核，将 PDF 页面渲染为 PNG 并检查；若可用则使用 pdftoppm；若不可用，则安装 Poppler，或请用户在本地查看输出。生成新文档时使用 reportlab；文本提取与快速检查使用 pdfplumber 或 pypdf。

依赖安装（若缺失）：优先使用 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

临时与输出约定：中间文件使用 tmp/pdfs/，完成后删除；在该仓库中工作时，最终产物写入 output/pdf/；文件名保持稳定且具描述性。

适用场景

需要在阅读、审核或生成 PDF 时把控版式与视觉质量的任务，例如交付前需要确认页面渲染无缺陷、图表表格清晰对齐、页眉页脚与页码排版整齐的情况。

质量与限制

质量要求：保持精致的视觉设计，字体、间距、页边距与章节层级一致；避免渲染问题，如文字被裁切、元素重叠、表格断裂、黑块或字形不可读；图表、表格与图片必须清晰、对齐且有明确标注；仅使用 ASCII 连字符，避免 U+2011（不换行连字符）及其他 Unicode 破折号；引用与参考文献必须人类可读，不得留下工具令牌或占位字符串。

最终检查：在最新一次 PNG 检查显示零视觉或格式缺陷之前不得交付；确认页眉/页脚、页码与章节过渡看起来精致；中间文件保持有序或在最终批准后删除。