pdf-form-filler
一个用于编程式填写PDF表单的Python工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pdf-form-filler。 它的用途是：一个用于编程式填写PDF表单的Python工具。 完整的 Skill 内容见：https://321skill.com/skills/pdf-form-filler/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把这个用户信息列表批量填到对应的申请表PDF里，每个用户生成一个独立的已填写文件。’ 它会引导你使用`fill_pdf_form`函数，遍历用户数据字典，为每个用户调用一次填充函数，并自动命名输出文件。或者，你可以直接说：‘列出这个PDF表单里所有可以填的字段。’ 它会调用`list_pdf_fields`函数并返回字段清单。
介绍
pdf-form-filler 解决了需要批量、自动化填写PDF表单（如政府表格、申请表、调查问卷等）的难题。它允许开发者通过编写Python代码，将文本数据和布尔值（复选框）准确地填充到PDF表单的指定字段中，并生成新的、已填写的PDF文件，同时确保表单状态在不同PDF阅读器中能正确渲染。
使用方式非常直接。开发者只需导入库中的fill_pdf_form函数，提供输入PDF路径、输出路径以及一个包含字段名和对应值的字典即可。该工具还提供了列出所有表单字段、批量处理、交互式填写等多种实用功能，并支持通过命令行直接调用。
这个技能非常适合需要处理大量格式固定但内容不同的PDF表单的开发者、数据分析师或办公自动化人员。例如，为成百上千的用户生成个性化的申请表，或批量处理来自不同部门的调查问卷数据。
在使用时，需要注意部分PDF阅读器可能不会自动重新生成复选框的视觉外观（尽管数据已正确设置），建议使用Adobe Reader或Firefox等浏览器进行查看。同时，务必使用list_pdf_fields函数确认PDF中表单字段的确切名称，以确保数据能正确匹配和填充。
核心特点
核心区别在于其轻量化和纯粹的Python实现，仅依赖pdfrw库，无需安装庞大的Adobe Acrobat或复杂的Java环境；同时，它专门处理了复选框的`/On`/`Off`状态，确保数据正确性，并提供了批量处理和字段探测等实用功能，更适合集成到自动化工作流中。
注意事项
不适合需要编辑PDF内容（如添加文本、图片）或处理非表单PDF（如扫描件）的场景，其功能聚焦于填充已有表单字段。
常见问题
为什么填好的PDF里复选框打勾看不到？
数据已正确设置，但部分PDF阅读器不自动刷新外观。请用Adobe Reader或Firefox打开查看。
如何知道PDF里有哪些字段可以填？
使用`list_pdf_fields('your.pdf')`函数，可以列出所有可填字段的名称和类型。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pdf-form-filler/raw/index.md 读取 pdf-form-filler 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pdf-form-filler/raw/index.md（查看排版版本）