将PDF转换为PPTX幻灯片或可编辑的DOCX文件，支持可配置的图片质量、DPI、文件大小限制以及批量处理。
pdf-converter
功能概述
pdf-converter是一项面向实际任务的技能，主要用于PDF 转 PPTX/Word 转换器 - 将 PDF 文件转换为 PowerPoint 或 Word 格式，支持文件大小限制；✅ PDF → PPTX（每页 PDF 转为幻灯片，图片嵌入）；
核心要点
- ✅ PDF → DOCX（保留文本和图片结构）；
- ✅ 文件大小控制（自动压缩以确保 ≤ 指定大小）；
- ✅ 批量转换支持；
使用与执行
✅ 可配置图片质量和 DPI；注意 : pdf2。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
pdf-converter
PDF 转 PPTX/Word 转换器 - 将 PDF 文件转换为 PowerPoint 或 Word 格式，支持文件大小限制。
功能
- ✅ PDF → PPTX（每页 PDF 转为幻灯片，图片嵌入）
- ✅ PDF → DOCX（保留文本和图片结构）
- ✅ 文件大小控制（自动压缩以确保 ≤ 指定大小）
- ✅ 批量转换支持
- ✅ 可配置图片质量和 DPI
安装依赖
pip3 install --break-system-packages pdf2image python-pptx pdf2docx Pillow
注意: pdf2image 需要系统安装 poppler：
# macOS brew install poppler # Ubuntu/Debian sudo apt-get install poppler-utils
使用方法
基本用法
# 转换为 PPTX（默认） python3 skills/pdf-converter/scripts/convert.py /path/to/file.pdf # 转换为 Word python3 skills/pdf-converter/scripts/convert.py /path/to/file.pdf --format docx # 指定最大文件大小（MB） python3 skills/pdf-converter/scripts/convert.py /path/to/file.pdf --max-size 30 # 指定输出路径 python3 skills/pdf-converter/scripts/convert.py /path/to/file.pdf --output /path/to/output.pptx
高级选项
# 调整 DPI（影响质量和大小，默认 150） python3 skills/pdf-converter/scripts/convert.py file.pdf --dpi 200 # 调整图片质量（1-100，默认 85） python3 skills/pdf-converter/scripts/convert.py file.pdf --quality 75 # 批量转换整个目录 python3 skills/pdf-converter/scripts/convert.py /path/to/pdfs/ --batch # 静默模式（仅输出最终结果） python3 skills/pdf-converter/scripts/convert.py file.pdf --quiet
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
input |
PDF 文件路径或目录（批量模式） | 必需 |
--format |
输出格式：pptx 或 docx |
pptx |
--max-size |
最大文件大小（MB），超过会尝试压缩 | 30 |
--output |
输出文件路径 | 与 PDF 同目录 |
--dpi |
渲染 DPI（影响质量和大小） | 150 |
--quality |
JPEG 图片质量（1-100） | 85 |
--batch |
批量转换目录中的所有 PDF | False |
--quiet |
静默模式，仅输出结果 | False |
示例
示例 1: 转换单个 PDF 为 PPTX
python3 skills/pdf-converter/scripts/convert.py "/Users/admin/Desktop/中金公司 2026 年度公关服务响应方案 -0318.pdf"
输出：
📄 源文件：中金公司 2026 年度公关服务响应方案 -0318.pdf 📊 源大小：21.91 MB 🔄 开始转换... ✓ 共 118 页 📊 创建幻灯片... 已处理 20/118 页 已处理 40/118 页 ... ✅ 转换成功！ 📊 输出大小：22.51 MB ✓ 大小限制：≤30 MB - ✅ 符合 📍 保存位置：/Users/admin/Desktop/中金公司 2026 年度公关服务响应方案 -0318.pptx
示例 2: 转换为 Word 并限制大小
python3 skills/pdf-converter/scripts/convert.py file.pdf --format docx --max-size 20
示例 3: 批量转换
python3 skills/pdf-converter/scripts/convert.py /path/to/pdfs/ --batch --format pptx
输出格式说明
PPTX 格式
- 每页 PDF 转为一张幻灯片
- 幻灯片尺寸：16:9 宽屏（13.333" x 7.5"）
- 图片格式：JPEG（可配置质量）
- 适合：演示文稿、报告展示
DOCX 格式
- 保留 PDF 文本和图片结构
- 可编辑文本内容
- 适合：文档编辑、内容提取
性能参考
| PDF 大小 | 页数 | DPI | 转换时间 | PPTX 大小 |
|---|---|---|---|---|
| 5 MB | 20 | 150 | ~15 秒 | ~8 MB |
| 20 MB | 100 | 150 | ~60 秒 | ~20 MB |
| 50 MB | 200 | 150 | ~120 秒 | ~45 MB |
故障排除
问题 1: pdf2image 报错 "unable to get page count"
原因: 缺少 poppler 工具
解决:
# macOS brew install poppler # Ubuntu/Debian sudo apt-get install poppler-utils
问题 2: 转换后文件太大
解决:
- 降低 DPI：
--dpi 100 - 降低图片质量：
--quality 60 - 启用自动压缩：
--max-size 30
问题 3: 中文文件名乱码
解决: 使用完整路径，确保文件系统支持 UTF-8
文件结构
skills/pdf-converter/ ├── SKILL.md # 本文件 ├── scripts/ │ └── convert.py # 转换脚本 └── README.md # 详细文档（可选）
更新日志
- 2026-03-18: 初始版本，支持 PDF→PPTX 和 PDF→DOCX
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
