前言¶
日常开发或办公里，PDF 往往卡在「格式不对、体积太大、要合并拆分、扫描件要识字」这几类需求上。常见做法是装一堆桌面工具，或在脚本里拼 Poppler、Ghostscript、OCR 引擎，再自己写批处理循环。每一步都要查文档、对路径，批量时还容易漏文件。
下面介绍的是 SkillHub 上的 PDF批处理·全能转换【煋旺智能·出品】（坐标 @org-l7548nxs/pdf-batch-master）。它把格式转换、合并拆分、压缩、水印、表单、OCR、质量检查等能力收进一个 Agent Skill，由模型按你的自然语言意图调用，标签标明 requires_api_key=false，不依赖外部 API Key。简介中强调纯本地、全功能免费（以 Skill 页面说明为准）。
这是什么¶
PDF批处理·全能转换 是长沙煋旺智能科技有限公司在 SkillHub 发布的企业认证 Skill，当前版本 v1.0.7，分类为 office-efficiency，来源类型为 enterprise。
定位可以概括为：面向 Agent 的一站式 PDF 批处理工具集，官方简介列出 20+ 项能力，并说明在百份量级批量场景下「平均约 3 秒/份」的处理预期（具体耗时取决于本机环境与文件复杂度）。当用户需要转换 PDF 格式、合并拆分、压缩体积、加水印、提取文字、处理表单或识别扫描件时，适合启用该 Skill。
- SkillHub 页面：https://www.skillhub.cn/skills/org-l7548nxs/pdf-batch-master
- API 坐标页：https://api.skillhub.cn/org-l7548nxs/pdf-batch-master
核心功能¶
以下能力均来自官方简介与 SkillHub 页面「概述」，未在资料中出现的细节不展开。
| 方向 | 已核实能力 |
|---|---|
| 自 PDF 转出 | PDF 转 Word、图片、文本 |
| 转入 PDF | Word、Excel、PPT 转 PDF |
| 文档结构 | 合并、拆分、批量格式转换 |
| 体积与外观 | 压缩瘦身、添加水印 |
| 安全与表单 | 加密、解密、表单填写 |
| 内容与质量 | OCR 文字识别、质量检查 |
Skill 页面还提供 Zip 包下载、安装到本地 Agent，并标注科恩实验室、云鼎实验室安全扫描为无风险（以页面展示为准）。
安装与启用¶
安装分两条路：让当前 AI 按 SkillHub 通用文档执行，或用 skillhub CLI 装到当前 Agent 的 skills 目录。第二种方式必须带 --dir，否则默认落在 ./skills/，Agent 可能识别不到。
1、用提示词交给 Agent 安装¶
在 Cursor、Claude Code 等支持 Skills 的客户端里，可将官方页面提供的安装提示发给模型：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-l7548nxs/pdf-batch-master`。
模型会按 SkillHub 安装与优先源配置 检查 CLI、选择正确的 skills 目录并完成安装。
2、用 skillhub CLI 安装¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，将 --dir 指向当前环境使用的 skills 目录。常见路径如下（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
示例（请把 <skills 目录> 换成上表对应路径）：
skillhub install @org-l7548nxs/pdf-batch-master --dir <skills 目录>
也可在 SkillHub 技能页使用「下载 Zip 包安装」或「安装到本地 Agent」。安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使 SKILL.md 被加载。
典型用法¶
公开资料未给出固定 CLI 子命令列表，用法以「在对话中说明任务 + 文件路径」为主，与简介中的触发场景一致。下面是可以直接复现的表述方式（需在本机准备好待处理 PDF 或源 Office 文件）。
-
单文件格式转换
说明源路径与目标格式，例如：「把/data/report.pdf转成 Word，输出到同目录。」 -
批量合并或拆分
列出多个 PDF 路径或页码范围，例如：「把invoices/*.pdf按文件名顺序合并为merged.pdf。」或「把manual.pdf按每 10 页拆成一个文件。」 -
压缩与水印
指明体积目标或水印文字/位置，例如：「压缩deck.pdf便于邮件发送」或「给contract.pdf每页加居中文字水印内部资料。」 -
OCR 与提取
针对扫描件：「对scan.pdf做 OCR，导出可搜索 PDF 或纯文本。」 -
Office 转 PDF
提供.docx/.xlsx/.pptx路径，说明输出 PDF 路径。
经过上面的步骤，Agent 会按 Skill 内定义的流程在本地执行相应处理；具体依赖的工具链以 Skill 包内 SKILL.md 为准，本文不臆造脚本名或参数。
适用场景与注意¶
适合谁
- 经常在 IDE 或终端旁处理 PDF，希望用自然语言驱动批处理，而不是反复打开桌面软件。
- 需要 Word/Excel/PPT 与 PDF 互转、合并拆分、压缩、水印、表单、OCR 等组合操作。
- 希望处理留在本机、且不愿配置第三方 PDF API（与
requires_api_key=false及「纯本地」表述一致）。
使用注意
- 批量性能与磁盘 IO、CPU、单文件页数有关；官方给出的「百份约 3 秒/份」是宣传口径，实际请以本机试跑为准。
- OCR、复杂版式转 Word 可能出现版式偏差，重要合同建议人工复核。
- 加密 PDF 需你提供合法权限与密码；Skill 不能绕过文档保护。
- 安装路径错误是最常见坑：务必
skillhub install ... --dir指向当前 Agent 的 skills 目录。 - 版本以 SkillHub 为准，撰写时页面显示为 v1.0.7；升级后功能列表可能变化，以技能页「版本历史」为准。
结尾¶
PDF批处理·全能转换【煋旺智能·出品】 把 PDF 相关的高频操作收敛到一个 Skill，适合在 Agent 对话里完成转换、合并拆分、压缩、水印、表单与 OCR 等任务，并强调本地运行与免 API Key。若你要在 Cursor 或 Claude Code 等环境试用，可从官方页复制安装提示，或用 skillhub install @org-l7548nxs/pdf-batch-master 装到对应 skills 目录。
官方地址：https://www.skillhub.cn/skills/org-l7548nxs/pdf-batch-master
