前言¶
扫描版 PDF 在 Agent 工作流里有个常见堵点：页面上只有图像，没有文字层，检索、引用、二次编辑都靠不上。手工逐页 OCR 再拼 Markdown，批量教材或资料库时成本很高。下面介绍 SkillHub 上的社区 Skill「本地ocr识别pdf转md」，面向批量把扫描 PDF 做成带文字层的 PDF，并导出 Markdown 或纯文本，便于后续检索与 Agent 消费。
这是什么¶
「本地ocr识别pdf转md」是 SkillHub 坐标 @user_543d2acf/pdf-ocr-zc 上的 Agent Skill（版本 1.0.0，来源 community，分类 office-efficiency）。发布者为 user_543d2acf（SkillHub 页面标注作者为 zhangchong）。它解决的是：对扫描 PDF 做批量 OCR，生成带文字层的 PDF，并可导出为 Markdown 或纯文本。官方简介中举例的场景包括：老师类 Agent 需要将大量扫描教材 PDF 转化为可检索文本。标签 requires_api_key=false，表示按 SkillHub 元数据不需要额外配置 API Key。
SkillHub 页面：https://www.skillhub.cn/skills/user_543d2acf/pdf-ocr-zc
API 入口（元数据）：https://api.skillhub.cn/user_543d2acf/pdf-ocr-zc
核心功能¶
依据官方简介与 SkillHub 元数据，可核实的能力如下：
- 批量 OCR：面向扫描 PDF，而非仅处理单页。
- 带文字层的 PDF：OCR 结果写入 PDF 文字层，便于系统级搜索与复制。
- 导出 Markdown / 纯文本：除 PDF 外，可得到便于编辑与喂给大模型的文本形态。
- 本地 OCR 取向：Skill 名称强调「本地」处理路径，适合对资料不出本机、或希望减少云端 OCR 依赖的场景（具体引擎与依赖以安装后的
SKILL.md为准）。
公开页面未单独列出支持的 PDF 页数上限、语言列表或排版还原精度，使用前建议在目标样例上先试一小批。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。安装方式以 SkillHub 官方说明为准：先具备 skillhub CLI，再用 install 把 Skill 装进当前 Agent 的 skills 目录；装错目录时 Agent 不会加载，需要重启或重新打开会话后才会识别。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（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
说明与优先源策略见：https://skillhub.cn/install/skillhub.md
2. 安装本 Skill¶
安装时必须用 --dir 指向当前环境的 skills 目录。SkillHub 页面给出的坐标为 @user_543d2acf/pdf-ocr-zc。
skillhub install @user_543d2acf/pdf-ocr-zc --dir <skills 目录>
常用 Agent 的 skills 路径（来自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中示例：
skillhub install @user_543d2acf/pdf-ocr-zc --dir ~/.cursor/skills/
经过上面的步骤，重启 Cursor 或新开 Agent 会话后，Skill 应出现在可用技能列表中。公开资料未区分 Codex CLI 与 Claude Code 在本 Skill 上的额外配置差异；若各客户端行为不一致，以安装目录下该 Skill 的 SKILL.md 为准。
典型用法¶
公开 SkillHub 页面未附带逐步命令行示例；可复现的工作流与官方简介一致：
- 将待处理的扫描 PDF 放在 Agent 能访问的路径（本地项目目录或你约定的输入目录）。
- 在已启用本 Skill 的 Agent 对话中，说明需要批量 OCR、输出带文字层的 PDF，并指明是否同时导出 Markdown 或纯文本。
- 按 Agent 引导完成批处理；对教材、讲义类资料，可先选 1～2 个文件试跑，确认文字层与 Markdown 结构是否满足检索与引用需求，再扩大批量。
若安装后目录中存在 SKILL.md，其中的步骤、脚本路径与参数名应优先于本文概括性描述。
适用场景与注意¶
适合谁
- 需要把扫描教材、扫描讲义、历史归档 PDF 变成可检索文本的开发者或 Agent 搭建者。
- 希望 OCR 在本地侧完成、且 SkillHub 标注无需 API Key 的团队或个人。
使用注意
- 扫描质量、倾斜、双栏排版会直接影响 OCR 与 Markdown 结构；复杂版式可能需要人工校对。
- 批量任务耗时会随页数与机器性能增长，建议分批并保留原始 PDF。
- SkillHub 元数据（抓取时）：评分 100000，下载 4736，安装 83；数据会随商店更新变化，以页面实时显示为准。
结尾¶
「本地ocr识别pdf转md」把扫描 PDF 批量 OCR、文字层 PDF 与 Markdown/纯文本导出串成一条 Agent 可用的能力链，适合教材与资料库数字化。安装与坐标以 SkillHub 为准：
- https://www.skillhub.cn/skills/user_543d2acf/pdf-ocr-zc
- https://api.skillhub.cn/user_543d2acf/pdf-ocr-zc
