相关 Skills
SKILL.md
readonly只读
name
pdftk-server
description
使用命令行工具 pdftk（PDFtk Server）处理 PDF 文件的技能。当需要合并 PDF、拆分 PDF、旋转页面、加密或解密 PDF、填写 PDF 表单、添加水印、加盖印章、提取元数据、将文档拆分为单页、修复损坏的 PDF、附加或提取文件，或执行任何命令行 PDF 操作时使用。
PDFtk Server
PDFtk Server 是一个用于处理 PDF 文档的命令行工具。它可以合并、拆分、旋转、加密、解密、添加水印、加盖印章、填写表单、提取元数据，并以多种方式操作 PDF。
何时使用此技能
- 合并多个 PDF 文件为一个
- 将 PDF 拆分为单页
- 旋转 PDF 页面
- 加密或解密 PDF 文件
- 从 FDF/XFDF 数据填写 PDF 表单字段
- 添加背景水印或前景印章
- 提取 PDF 元数据、书签或表单字段信息
- 修复损坏的 PDF 文件
- 附加或提取 PDF 中嵌入的文件
- 删除 PDF 中的特定页面
- 整理分别扫描的奇偶页
- 压缩或解压缩 PDF 页面流
先决条件
- 系统上必须安装 PDFtk Server
- Windows：
winget install --id PDFLabs.PDFtk.Server - macOS：
brew install pdftk-java - Linux (Debian/Ubuntu)：
sudo apt-get install pdftk - Linux (Red Hat/Fedora)：
sudo dnf install pdftk
- Windows：
- 可以访问终端或命令提示符
- 通过运行
pdftk --version验证安装
分步工作流程
合并多个 PDF
pdftk file1.pdf file2.pdf cat output merged.pdf
使用句柄进行更精细的控制：
pdftk A=file1.pdf B=file2.pdf cat A B output merged.pdf
将 PDF 拆分为单页
pdftk input.pdf burst
提取特定页面
提取第 1-5 页和第 10-15 页：
pdftk input.pdf cat 1-5 10-15 output extracted.pdf
删除特定页面
删除第 13 页：
pdftk input.pdf cat 1-12 14-end output output.pdf
旋转页面
将所有页面顺时针旋转 90 度：
pdftk input.pdf cat 1-endeast output rotated.pdf
加密 PDF
设置所有者密码和用户密码，使用 128 位加密（默认）：
pdftk input.pdf output secured.pdf owner_pw mypassword user_pw userpass
解密 PDF
使用已知密码移除加密：
pdftk secured.pdf input_pw mypassword output unsecured.pdf
填写 PDF 表单
从 FDF 文件填充表单字段并展平以防止进一步编辑：
pdftk form.pdf fill_form data.fdf output filled.pdf flatten
添加背景水印
将单页 PDF 放置在输入的每一页后面（输入应具有透明度）：
pdftk input.pdf background watermark.pdf output watermarked.pdf
加盖印章
将单页 PDF 放置在输入的每一页上面：
pdftk input.pdf stamp overlay.pdf output stamped.pdf
提取元数据
导出书签、页面度量和文档信息：
pdftk input.pdf dump_data output metadata.txt
修复损坏的 PDF
将损坏的 PDF 通过 pdftk 尝试自动修复：
pdftk broken.pdf output fixed.pdf
整理扫描页
交错分别扫描的偶数和奇数页：
pdftk A=even.pdf B=odd.pdf shuffle A B output collated.pdf
故障排除
| 问题 | 解决方案 |
|---|---|
pdftk 命令未找到 |
验证安装；检查 pdftk 是否在系统 PATH 中 |
| 无法解密 PDF | 确保通过 input_pw 提供了正确的所有者或用户密码 |
| 输出文件为空或损坏 | 检查输入文件完整性；先尝试运行 pdftk input.pdf output repaired.pdf |
| 填写后表单字段不可见 | 使用 flatten 标志将字段合并到页面内容中 |
| 水印未显示 | 确保输入 PDF 具有透明区域；对于不透明叠加使用 stamp |
| 权限拒绝错误 | 检查输入和输出路径的文件权限 |
参考资料
references/ 文件夹中的捆绑参考文档：
- pdftk-man-page.md - 包含所有操作、选项和语法的完整手册参考
- pdftk-cli-examples.md - 常见任务的实际命令行示例
- download.md - 所有平台的安装和下载说明
- pdftk-server-license.md - PDFtk Server 许可信息
- third-party-materials.md - 第三方库许可证
