pdf-lecture-notes

Claude Code Skill：将图片型 PDF（教材、讲义、扫描文档）提取为结构化 Markdown 笔记。

这是什么

一个 Claude Code Skill，自动化完成 PDF → Markdown 笔记 的完整流程：

• 分析 PDF 目录结构，建立页码映射
• 采样识别内容元素（定义/定理/例题/习题等）
• 与用户交互制定通用笔记方案
• 并行 OCR（PaddleOCR-VL + 后台 Agent）高速提取
• 生成结构化 Markdown 笔记

适用场景

• 扫描版/图片型 PDF 教材或讲义
• PDF 过大无法直接读取（>100MB）
• 包含公式、表格等需要保留格式的内容
• 多章节文档需要批量处理

安装

方式一：skills.sh（推荐，跨平台通用）

npx skills add 960web/pdf-lecture-notes

方式二：npm

npm install -g @960web/pdf-lecture-notes

方式三：OSM（Open Skills Manager）

osm install 960web/pdf-lecture-notes

方式四：手动安装

# 安装到用户级（所有项目可用）
mkdir -p ~/.claude/skills/pdf-lecture-notes
cp skills/pdf-lecture-notes/SKILL.md ~/.claude/skills/pdf-lecture-notes/

# 或安装到项目级（仅当前项目）
mkdir -p .claude/skills/pdf-lecture-notes
cp skills/pdf-lecture-notes/SKILL.md .claude/skills/pdf-lecture-notes/

方式五：Cursor

Settings → Rules → 导入 GitHub 仓库 URL：

https://github.com/960web/pdf-lecture-notes

前置依赖

依赖	用途	安装
uv	Python 包管理器 + MCP 启动器	pip install uv 或参见 uv 文档
PyMuPDF (fitz)	PDF 页面提取为 PNG	uv add pymupdf
PaddleOCR-VL MCP	OCR 识别	需注册 百度 AI Studio 获取 Access Token
百度 AI Studio	OCR 云端服务	注册后按 skill 引导配置 .mcp.json

快速开始

1. 在 Claude Code 中打开你的项目
2. 说："把这个 PDF 转成笔记"
3. 按 Skill 引导完成：环境配置 → 方案制定 → Pilot 章节 → 批量制作

目录结构

pdf-lecture-notes/
├── skills/
│   └── pdf-lecture-notes/
│       └── SKILL.md        # 核心 skill 文件（skills.sh 格式）
├── SKILL.md                # 核心 skill 文件（根目录入口，兼容 OSM 等注册中心）
├── package.json            # npm 包清单
├── README.md               # 本文件
├── LICENSE                 # MIT
├── CONTRIBUTING.md         # 贡献指南
├── CHANGELOG.md            # 版本记录
└── .github/                # Issue/PR 模板

分发渠道

渠道	安装命令
skills.sh	npx skills add 960web/pdf-lecture-notes
npm	npm install @960web/pdf-lecture-notes
OSM	osm install 960web/pdf-lecture-notes
SkillsMP	自动收录
SkillsGate	自动收录
GitHub	git clone + 手动安装

贡献

欢迎提 Issue 和 PR。详见 CONTRIBUTING.md。

许可

MIT