SuperAPI AI 工具集

pdf-skill

办公与效率

查看项目

更新于 10-15 08:47

技能介绍

PDF Skill 是一个专注于 PDF 文档程序化处理的技能,旨在提供 PDF 生成、解析和操作方面的专业能力。其核心用途是帮助开发者以代码方式创建 PDF、提取 PDF 内容、合并或拆分文档,以及处理 PDF 表单,主要依赖 PDFKit、PDF.js、Puppeteer 及类似工具。

主要能力

该技能覆盖以下 PDF 操作:以编程方式生成 PDF;从 PDF 中提取文本或数据;合并或拆分 PDF 文档;以编程方式填写 PDF 表单;将 HTML 转换为 PDF;添加水印或注释;解析 PDF 结构与元数据;构建 PDF 报告生成器。

适用场景

当需要从代码或数据生成 PDF、从 PDF 文件提取内容、合并、拆分或操作 PDF、填写或创建 PDF 表单、将 HTML 或网页转换为 PDF 时,可以调用该技能。它不适用于 Word 文档创建(应使用 /docx-skill)、Excel 或电子表格工作(应使用 /xlsx-skill)、PowerPoint 创建(应使用 /pptx-skill)以及一般文件操作(应使用 Bash 或文件工具)。

工具选择框架

该技能提供了一个决策框架:从零生成 PDF 时,简单场景可用 PDFKit(Node)或 ReportLab(Python),复杂布局可用 Puppeteer/Playwright 配合 HTML;解析或提取时,文本提取可用 pdf-parse 或 PyPDF2,表格提取可用 Camelot 或 Tabula;操作文档时,合并、拆分、编辑可用 pdf-lib;处理表单时,填写可用 pdf-lib,高级操作可用 PDFtk。

核心工作流

  1. 使用 PDFKit 生成 PDF:安装 PDFKit(npm install pdfkit),创建新的 PDDocument,添加内容(文本、图像、图形),使用字体和颜色设置样式,按需添加页面,输出到文件或响应流。

  2. HTML 转 PDF:设置 Puppeteer/Playwright,导航到 HTML 内容或 URL,配置页面尺寸和边距,设置打印选项(页眉、页脚),生成 PDF 缓冲区,保存或流式输出结果。

  3. PDF 解析与提取:选择解析器(pdf-parse、PyPDF2、pdfplumber),加载 PDF 文件,提取文本或结构化数据,处理多页文档,清理和规范化提取的文本,以所需格式输出。

最佳实践

尽可能使用矢量图形而非位图;嵌入字体以保证渲染一致;在不同阅读器中测试 PDF 输出;使用流式处理处理大型 PDF;根据任务复杂度选择合适的库;考虑无障碍性(带标签的 PDF)。

反模式

该技能列出了一些应避免的做法:仅含图像的 PDF 不可搜索且不可访问,应使用带字体的文本;不嵌入字体会导致渲染问题,应嵌入所需字体;将大型 PDF 全部加载到内存会导致崩溃,应使用流式处理;忽略加密会带来安全或访问问题,应处理加密 PDF;为任务选择错误的工具会导致过度工程,应让工具匹配复杂度。

限制

资料未提供该技能的具体收费、价格、平台支持范围或实际使用效果等信息。