PDF/文档处理专家
面向非技术用户的文档处理助手,让你用最简单的语言完成复杂的文档操作。
🎯 技能使用规范
适用场景
本技能适用于以下场景:
- PDF文档处理: 拆分、合并、加水印、加密、格式转换
- Office文档互转: Word转PDF、PDF转Word/Excel、PPT转图片
- 文档内容提取: 从PDF/Word中提取文字、表格、图片
- 批量文件处理: 一次处理多个文档,自动分类整理
常见用途
- 把PDF第3-5页拆分成新文件
- 把多个PDF合并成一个
- 给PDF加水印(文字/图片)
- PDF加密或解密
- PDF转Word/Excel/图片
- Word转PDF、PDF转Word
- 从PDF中提取所有文字内容
- 批量压缩PDF减小体积
前置条件
使用前请确保:
1. ✅ 首次使用需安装依赖: 运行安装脚本 python3 scripts/install_deps.py(自动完成,约1分钟)
2. ✅ 确认Python环境: python3 --version(Python 3.8+)
3. ✅ 确保技能目录有写权限
📁 路径与入口
- 技能目录:
{baseDir}/pdf-document-expert/ - 统一入口:
python3 scripts/main.py [功能] [参数] - 依赖安装:
python3 scripts/install_deps.py - 输出目录:
{技能目录}/output/(默认输出位置,可通过参数修改)
🔧 执行规范
详细的操作流程、调用规范、错误处理等,请参考以下文档:
使用指南
该文档定义:
- 各功能模块的标准调用格式
- 对话式自然语言参数解析
- 错误处理和友好提示机制
- 批量处理的最佳实践
📋 输出产物
严格按照执行规范执行完成后生成:
- 处理后的文档文件(位于输出目录)
- 处理摘要与统计信息(命令行输出)
- 可选:处理报告文件(output/report.md)
💡 快捷命令速查
依赖安装(首次使用)
python3 scripts/install_deps.py
PDF拆分 - 指定页码
python3 scripts/main.py split \
--input document.pdf \
--pages "3-5" \
--output split_output.pdf
PDF合并
python3 scripts/main.py merge \
--inputs file1.pdf file2.pdf file3.pdf \
--output merged.pdf
PDF转Word
python3 scripts/main.py pdf2word \
--input document.pdf \
--output document.docx
Word转PDF
python3 scripts/main.py word2pdf \
--input document.docx \
--output document.pdf
加水印
python3 scripts/main.py watermark \
--input document.pdf \
--text "机密文件" \
--output watermarked.pdf
PDF加密
python3 scripts/main.py encrypt \
--input document.pdf \
--password "123456" \
--output encrypted.pdf
🗣️ 口语化触发词
当用户提到以下任何说法时,请立即使用本技能:
PDF操作类
- "帮我处理一下PDF"
- "把这个PDF拆开" / "拆分PDF" / "把第X页单独存出来"
- "把几个PDF合在一起" / "合并PDF"
- "给PDF加个水印" / "加水印"
- "给PDF设个密码" / "加密PDF" / "PDF解密"
- "把PDF转成Word" / "PDF转Word" / "PDF转Excel"
- "把PDF转成图片"
Office文档类
- "Word转PDF" / "PDF转Word"
- "Excel转PDF"
- "PPT转PDF" / "PPT转图片"
- "批量转换文档"
内容提取类
- "把PDF里的文字提取出来"
- "从文档中提取表格"
- "把PDF里的图片保存下来"
- "读取PDF内容"
批量处理类
- "批量处理这些文件"
- "把这些文件都转成PDF"
- "整理一下这些文档"
🚨 重要限制(明令禁止)
- 禁止依赖外部API: 所有处理必须纯本地完成,不上传用户文件到云端
- 禁止改变源文件: 所有操作必须生成新文件,绝不能修改原始文档
- 禁止跳过依赖安装: 首次使用必须先安装依赖,不可强行执行
- 禁止技术错误输出: 错误信息必须翻译为用户可理解的语言
- ❌ 错误:
PdfReadError: Encrypted PDF - ✅ 正确: "这个PDF设置了密码保护,请先提供密码"
📚 参考文档
完整操作指南请参考以下文档:
- 使用指南 - 完整功能列表与调用示例
- 错误处理 - 常见问题与友好提示模板
- 依赖说明 - 依赖库说明与手动安装指南