mcpField
O
openai-pdf

openai-pdf

github.com/trailofbits文档处理52279 次安装15 周前更新
代码仓库

关于 openai-pdf

openai-pdf 是用于阅读、创建和检查 PDF 的技能，面向需要处理文档内容与版式的工作。它结合文本提取和页面渲染检查，强调在交付前核验最终排版。

主要功能

  1. 01阅读并审查 PDF 内容与版面
  2. 02使用 reportlab 生成 PDF
  3. 03提取文本进行快速检查
  4. 04渲染页面并检查排版
  5. 05整理临时文件与最终输出

适用场景

  1. 01审阅包含图表或复杂版面的 PDF
  2. 02以程序方式创建格式稳定的文档
  3. 03检查更新后的 PDF 是否有排版问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/trailofbits/skills-curated --skill openai-pdf

安装后在 Claude Code 中输入/openai-pdf确认已加载。

详细介绍

PDF 技能

使用场景

  • 阅读或审阅 PDF 内容，且布局和视觉效果很重要。
  • 以可靠的格式通过编程创建 PDF。
  • 交付前验证最终渲染效果。

工作流

  1. 优先进行视觉审阅：将 PDF 页面渲染为 PNG 并检查。
    • 如果可用，请使用 pdftoppm。
    • 如果不可用，请安装 Poppler，或请用户在本地审阅输出。
  2. 创建新文档时，使用 reportlab 生成 PDF。
  3. 使用 pdfplumber（或 pypdf）提取文本并进行快速检查；不要依赖它来保证布局保真度。
  4. 每次完成重要更新后，重新渲染页面并检查对齐、间距和可读性。

临时文件和输出约定

  • 使用 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 并确认没有任何视觉或格式缺陷后，才能交付。
  • 确认页眉/页脚、页码和章节过渡效果精致美观。
  • 保持中间文件井然有序，或在最终批准后将其删除。

不适用场景

评论

支持 Markdown