Obsidian Claudian + MinerU PDF解析工具完整部署教程（Windows）

一、整体方案原理

1. 组件分工

1. MinerU：开源PDF解析引擎，可将PDF/扫描件精准转换为带表格、图片、公式的标准Markdown；
2. pdf-converter-mineru：适配Claude Code的Skill技能封装，对接MinerU开放API，让Claude具备PDF解析能力；
3. skills-cli：统一技能管理CLI工具，用于安装、查看、管理.claude/skills下所有AI工具；
4. Claude Code CLI：Anthropic官方命令行程序，Obsidian Claudian插件底层依赖它读取全局用户技能目录；
5. Obsidian Claudian：Obsidian第三方插件，封装Claude对话窗口，读取本地Claude技能实现文件调用。

2. 核心运行逻辑

1. 手动将pdf-converter-mineru放入全局用户技能目录 C:\Users\LMQ\.claude\skills；
2. 配置Claude Code CLI完整路径，开启「加载用户Claude设置」，插件读取全局技能；
3. 在Claudian对话上传Vault内PDF，插件自动调用pdf-converter-mineru，通过MinerU API完成文档解析，返回Markdown内容。

3. 目录区分（关键避坑点）

目录路径	作用	适用场景
C:\Users\LMQ\.claude\skills	全局技能，所有Obsidian库共用	本次部署的pdf转换工具（推荐）
当前Obsidian库\.claude\skills	单库本地技能，仅当前笔记库生效	库专属临时工具，本次不使用

---

二、前置环境安装（全部CMD命令）

1. 全局安装技能管理工具 skills-cli

# 清理npm缓存，规避安装报错
npm cache clean --force
# 全局强制安装skills-cli
npm install -g skills-cli --force
# 验证安装，输出版本0.1.0即成功
skills --version

2. 全局安装 Claude Code CLI（插件底层依赖）

# 全局安装官方Claude命令行程序
npm install -g @anthropic-ai/claude-code
# 查看安装路径，确认安装成功
npm config get prefix
npm list -g @anthropic-ai/claude-code

输出示例：

C:\Users\LMQ\AppData\Roaming\npm
-- @anthropic-ai/claude-code@2.1.191

---

三、PDF转换技能离线部署（规避GitHub网络报错）

1. 下载源码包

从仓库下载pdf-converter-mineru压缩包，解压得到完整文件夹（根目录包含SKILL.md）。
https://github.com/tanis90/pdf-converter-mineru

2. 手动部署至全局技能目录

1. 打开资源管理器，地址栏输入：

C:\Users\LMQ\.claude\skills

安装claude后，在自己的用户目录下找.claude文件夹

2. 将解压后的pdf-converter-mineru完整文件夹粘贴到此目录(创建pdf-converter-mineru文件夹，将SKILL.md放进去即可)；
   

3. CMD验证技能是否被识别：

skills list

成功输出示例：

C:\Users\LMQ\.claude\skills
.green .system (unknown)
.green ctf (unknown)
.green Kali 远程工具调用（CTF专用） (unknown)
.green pdf-converter-mineru (unknown)

(unknown)仅代表无线上注册表元数据，不影响功能调用。

---

四、Obsidian Claudian插件完整配置

步骤1：找到Claude CLI完整路径（手动查找流程）

1. 打开地址：C:\Users\LMQ\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\dist
2. 找到目标文件：cli-wrapper.cjs
3. 完整路径复制：

C:\Users\LMQ\AppData\Roaming\npm\node_modules\@anthropic-ai/claude-code\dist\cli-wrapper.cjs

步骤2：插件参数配置

1. 打开Obsidian → 设置 → 第三方插件 → Claudian；
   

2. 切换顶部Claude标签页；

3. Claude CLI 路径：粘贴上面复制的cli-wrapper.cjs完整路径；
   

4. 打开开关：加载用户Claude设置（核心，用于读取全局.claude/skills技能）；
   

5. 向下滚动至「环境-自定义变量」，填入MinerU鉴权：

MINERU_ACCESS_KEY 对应页面 Access Key ID
MINERU_SECRET_KEY 对应页面 Secret Access Key

官网：https://mineru.net/
个人中心 - API 密钥，创建密钥，复制 Access Key ID、Secret Access Key；
两行密钥全部填入插件环境变量框内保存。

步骤3：生效操作

完全关闭所有Obsidian窗口，重新启动软件加载配置。

---

五、功能测试验证

Obsidian内对话调用

1. 打开侧边Claudian对话面板；
2. 在仓库内放入任意PDF文件；
3. 发送指令：

调用pdf-converter-mineru将这份PDF完整转换为Markdown，保留全部表格、图片与公式

4. 插件自动调用本地技能，返回格式化后的文档内容。
   
   

---

六、全程踩坑问题汇总

坑1：skills 不是内部或外部命令

原因：npm全局路径未写入系统PATH，或安装缓存损坏
解决：

1. npm config get prefix 获取全局路径，添加到系统环境变量Path；
2. 清理缓存重装：npm cache clean --force && npm install -g skills-cli --force；
3. 重启CMD终端重新验证。

坑2：skills add . / skills install . 报 Skill “.” not found

原因：skills-cli add 仅支持GitHub远程仓库地址，不支持本地文件夹路径；
解决：放弃命令安装，采用手动复制文件夹到C:\Users\LMQ\.claude\skills离线部署。

坑3：Claudian插件识别不到pdf-converter-mineru技能

1. 未填写正确cli-wrapper.cjs路径；
2. 「加载用户Claude设置」开关未开启；
3. 技能文件夹嵌套层级错误，根目录缺失SKILL.md；
4. 未完全重启Obsidian，旧配置缓存未刷新。

坑4：转换PDF提示免费额度不足

解决：MinerU官网注册账号，获取Token执行mineru-open-api auth绑定，或在插件环境变量填入Token。

坑5：Windows终端报Assertion failed异步句柄错误

原因：本地目录安装命令存在Windows兼容bug；
解决：全程使用手动复制文件夹离线部署，不使用skills add远程克隆命令。