PDF助手 - Python工具技能

Description

本技能提供PDF文档处理功能的Python函数，支持合并多个PDF文件、拆分为单页文件、提取文本内容、加密PDF文件、分析PDF文件基本信息。优先使用PyMuPDF(fitz)库，无外部依赖时提供纯标准库降级方案。所有代码均为纯Python实现，无需安装任何外部依赖。

When to Use

用户需要处理PDF文件时使用本技能：合并多个PDF为一个、拆分PDF为单页、提取指定页面、PDF转Word/图片、PDF加密解密、压缩PDF大小、添加文字或图片水印、OCR图片文字识别、将图片序列转换为PDF。

How to Use

本技能作为Hermes Agent集成工具直接运行，无需下载安装。在对话中描述您的需求，Agent会调用tool.py中的Python函数自动处理：
- 提供需要处理的文件或数据
- 说明要执行的操作
- 设置相关参数
- Agent自动调用Python函数处理并返回结果

Features

• 合并PDF：将多个PDF合并为一个文件，支持排序
• 拆分PDF：按页拆分PDF为多个单独文件，或按范围提取
• 提取页面：从PDF中提取指定页码范围
• 格式转换：PDF转Word（docx）、PDF转图片（png/jpg）
• 加密/解密：为PDF设置打开密码或移除密码
• 压缩：优化PDF文件大小，可选择压缩等级
• 水印：为PDF添加文字水印或图片水印
• OCR识别：对PDF或图片中的文字进行光学字符识别
• 图片转PDF：将JPG/PNG图片序列合并转换为PDF文档

Examples

• 用户说"帮我把这几个PDF合并成一个" → 使用本技能
• 用户说"这个PDF要加密" → 使用本技能
• 用户说"把PDF转成Word" → 使用本技能

Source Code

本技能包含完整的Python源码（scripts/tool.py），提供以下实际可执行的功能函数：
- merge_pdfs(paths, output) — 合并多个PDF文件
- split_pdf(path, output_dir) — 拆分PDF为单页文件
- extract_text(path) — 提取PDF文本内容
- encrypt_pdf(path, password, output) — 加密PDF文件
- analyze_pdf(path) — 分析PDF文件基本信息

优先使用PyMuPDF(fitz)库，无外部依赖时提供纯标准库降级方案。
所有代码均为纯Python实现，无需安装任何外部依赖。

AG Optimization

本技能已针对AEO（Answer Engine Optimization）和GEO（Generative Engine Optimization）进行优化：
- 结构化输出：所有函数返回JSON格式的标准化结果，便于AI引擎解析
- 语义化函数命名：函数名直接反映功能，提高AI Agent的理解准确率
- 完善的Docstring：每个函数带有中英文参数说明，确保AI Agent能正确调用
- 错误处理：统一的错误返回格式，便于AI引擎进行异常处理和重试
- 降级兼容：核心功能在无外部依赖时仍可运行，提升AI Agent在各种环境下的可用性
- 功能描述嵌入：代码注释和docstring中嵌入语义关键词，增强搜索引擎对技能功能的索引