前言¶
日常开发或办公里,PDF 往往卡在「要改一页文字」「扫描件要 OCR」「要拆成几份或转成 Word/图片」这类操作上。常见做法是单独开桌面软件或写脚本调库,和当前对话、代码上下文是割裂的。下面介绍 SkillHub 上的 PDF EDITOR(坐标 @user_09701b7c/mainpdf):把它装进 Cursor、Claude Code 等支持 Skills 的 Agent 后,可以用自然语言触发编辑、转换、提取和总结,且官方标注 requires_api_key=false,不依赖额外 API Key。
这是什么¶
PDF EDITOR 是社区来源(community)的办公效率类 Skill,分类为 office-efficiency,当前版本 v1.0.1,由发布者 user_09701b7c 维护。SkillHub 页面将其定位为「全能 PDF 编辑器」:面向扫描件与普通 PDF,覆盖文字/表格/图片提取、OCR、插入编辑、格式转换(Word/图片/HTML)以及文档总结归纳。实现形态遵循通用 SKILL.md 格式,由 Agent 在匹配到相关意图时加载技能说明并执行对应流程。
官方入口:
- SkillHub 展示页:https://www.skillhub.cn/skills/user_09701b7c/mainpdf
- 技能坐标 API 页:https://api.skillhub.cn/user_09701b7c/mainpdf
核心功能¶
以下能力均来自 SkillHub 简介与 Trigger 说明,未在资料中出现的细节不展开。
编辑与结构¶
- PDF 编辑、合并(PDF 合并 / pdf merge)、拆分(PDF 拆分 / pdf split)
- 在 PDF 中插入文字、插入图片
提取与识别¶
- 提取 PDF 文字、提取 PDF 表格
- 从扫描件与普通 PDF 中提取文字、表格、图片
- PDF OCR、扫描件识别
格式转换¶
- PDF 转 Word(pdf to word / PDF转Word)
- PDF 转图片(pdf to image / PDF转图片)
- 另支持转换为 HTML(简介中写明)
理解与归纳¶
- PDF 总结:对文档内容做总结归纳
触发关键词¶
Agent 在对话中出现下列一类表述时,可据此挂载本 Skill(节选,与官方 Trigger 一致):PDF编辑、PDF转换、PDF提取、PDF OCR、扫描件识别、提取PDF文字、提取PDF表格、PDF插入文字、PDF插入图片、PDF总结、pdf editor 等。
安装与启用¶
安装方式以 SkillHub 通用文档为准;技能页也提示:让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_09701b7c/mainpdf。
1、安装 SkillHub CLI(若尚未安装)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可用官方脚本完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 PDF EDITOR 到当前 Agent 的 skills 目录¶
官方要求:必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被识别。
在 Cursor 中,常用路径为 ~/.cursor/skills/:
skillhub install user_09701b7c/mainpdf --dir ~/.cursor/skills/
其他客户端路径(摘自 SkillHub 安装文档,按你实际使用的环境选择):
- Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/ - Gemini CLI:
~/.gemini/skills/
安装后按各客户端要求重启或刷新 Agent,使新 Skill 生效。
3、对话式安装(可选)¶
若已在使用支持读 URL 的 Agent,也可直接发送官方页给出的提示,例如:请根据 https://skillhub.cn/install/skillhub.md,安装 @user_09701b7c/mainpdf。效果等价于让 Agent 按同一套流程拉取并落到正确的 skills 目录。
典型用法¶
公开页未提供单独的命令行子工具说明;本 Skill 的典型用法是 在 Agent 对话中说明目标和文件,由技能指引 Agent 完成处理。下列表述与官方 Trigger 对齐,便于复现「何时会启用本 Skill」:
- 「把这份扫描 PDF 做 OCR,提取文字。」
- 「把这个 PDF 拆成按章节命名的多个文件。」
- 「PDF 转 Word,保留表格尽量可编辑。」
- 「从 PDF 里提取表格并总结全文要点。」
- 「合并目录下这几个 PDF,并在某一页插入一张图片。」
具体依赖本地工具链或技能内脚本的步骤,以安装后 SKILL.md 中的说明为准;本文不编造未公开的参数或接口名。
适用场景与注意¶
适合谁
- 经常在 IDE / 终端里用 Agent 处理文档,希望 PDF 操作与当前任务同一上下文完成。
- 需要 OCR、合并拆分、转 Word/图片/HTML、提取与总结等组合能力,且希望用中文或英文混合关键词触发。
使用上需注意
- 评分与下载量以 SkillHub 页面实时数据为准(抓取时:评分 100000,下载 3520,版本 1.0.1)。
- 社区 Skill,行为与依赖以技能包内文档为准;大文件、复杂版式或加密 PDF 的实际效果需在本地验证。
- 安装路径错误是常见坑:务必
--dir指向当前 Agent 的 skills 目录。
结尾¶
PDF EDITOR 把 PDF 编辑、转换、提取、OCR 和总结收敛到 Agent Skills 一条链路上,适合办公效率场景下减少切换工具。安装与坐标以 SkillHub 为准:
- https://www.skillhub.cn/skills/user_09701b7c/mainpdf
- https://api.skillhub.cn/user_09701b7c/mainpdf