DeepPaperNote 快速上手教程:3 步把一篇论文变成可长期复用的 Obsidian 知识页

原创2026-10-14 14:45:162,698 阅读
文章标签:AI 技能AI 评测

DeepPaperNote 快速上手教程:3 步把一篇论文变成可长期复用的 Obsidian 知识页

DeepPaperNote 是一个专为 AI Agent 设计的论文精读笔记生成技能:给它一篇论文(标题、DOI、URL、arXiv ID 或本地 PDF),它就能自动完成取证、结构化整理和图表定位,最终产出一篇可长期保留、可搜索、可链接的 Obsidian 论文知识页。本文带你用 3 步完成安装与首次生成。

DeepPaperNote 是什么?

DeepPaperNote 论文精读笔记生成示意图:AI 助手把散乱的论文内容自动整理成结构化的 Obsidian 知识网络

如果你也遇到过这些场景,DeepPaperNote 就是为你准备的:

你可能正遇到…… DeepPaperNote 会帮你……
📄 论文读完了,但笔记还是一堆散乱片段 把研究问题、方法链路、核心实验和局限重组为一篇能再次读懂的笔记
🧠 不想再收藏一篇“看起来很完整”的 AI 摘要 保留关键公式、数字、图表语境和证据边界,让笔记承载真实理解
🗂️ 论文越读越多,却始终没有形成自己的学术 Wiki 把每篇论文沉淀为可搜索、可链接、可复用的 Obsidian 知识页面

简单来说,可以把 DeepPaperNote 看作 LLM 学术 Wiki 的单篇论文入口:它每次深读一篇论文,将研究问题、方法、证据、结果和图表沉淀为一页知识页面;Obsidian 负责承载和链接这些页面,DeepPaperNote 负责把论文可靠地送进去。同一套核心技能可以运行在 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等多种 Agent 上。

开始前的准备

在 3 步之前,先确认两件事:

  1. Python 版本 ≥ 3.10 —— 核心 PDF 抽取脚本依赖此版本,可用 python3 --version 检查;
  2. 一个你常用的 AI Agent —— Claude Code、Codex、Cursor 等均可。

以下都是可选增强,普通数字版 PDF 完全不需要:

可选增强 能解决什么问题
Obsidian Vault 把笔记直接保存到知识库,按领域目录归档
Zotero 桌面库 优先复用本地论文条目和 PDF 附件,免去重复下载
OCR 工具 从扫描版或低质量 PDF 中恢复页面文字

第一步:安装 DeepPaperNote 插件

根据你的 Agent 选择一条安装路径:

使用 Claude Code —— 通过插件市场安装:

claude plugin marketplace add 917Dhj/DeepPaperNote
claude plugin install deeppapernote@deeppapernote

使用任意 Agent —— 通过 skills CLI 安装,可以自由选择要装的技能和目标 Agent:

npx skills add 917Dhj/DeepPaperNote

两条路径安装的是同一组技能。插件路径会一并装上 deeppapernote 和 paper-glossary 两个技能;大多数用户先选核心的 deeppapernote 即可,paper-glossary 只在需要生成可复用的术语笔记时再加。仓库中各技能的规范说明分别位于 skills/deeppapernote/SKILL.md 和 skills/paper-glossary/SKILL.md。

第二步:安装核心 PDF 依赖

python3 -m pip install PyMuPDF

如果你使用 uv 管理环境,把 PyMuPDF 装到 DeepPaperNote 实际使用的那个 Python 环境里:

uv pip install PyMuPDF

PyMuPDF 负责核心的 PDF 文本与图表资产抽取,是整条流水线的地基,其余环节(元数据聚合、证据组织、图表规划、笔记校验)都由技能内置脚本完成。

第三步:把论文交给 Agent

打开你的 Agent,直接用自然语言下达指令即可,支持这些输入形式:

  • 论文标题
  • DOI
  • 论文 URL
  • arXiv ID
  • 本地 PDF 文件路径
  • Zotero 条目(在具备兼容集成时)

常见的触发话术:

给这篇论文生成深度笔记:<论文标题 / DOI / arXiv ID / 本地 PDF>
把这篇论文整理成 Obsidian 笔记:<论文>

首次使用时,DeepPaperNote 会引导你设置两个偏好(只问一次,之后自动沿用):

  • 📝 默认笔记语言:简体中文(zh-CN)或英文(en);
  • 📁 默认保存位置:当前 workspace,或你的 Obsidian Vault(指定 Vault 路径和论文目录)。

这些偏好保存在本机 ~/.deeppapernote/config.json,单次任务仍可以临时指定不同语言或保存位置。高级配置详见 user-configuration.md。

值得一提的是它的本地优先策略:解析论文身份时,会先查本地 PDF、Zotero 附件和已归档的 Obsidian PDF,最后才联网查找,既省流量也避免论文错配。完整来源优先级规则见 SKILL.md。

生成的 Obsidian 知识页长什么样?

DeepPaperNote 使用示例:复杂的 Research Paper 被自动提炼成包含研究问题、方法概览、关键公式和实验发现的 Structured Obsidian Note

一次完整运行后,你会得到这样一个“一纸一目录”的结构:

<领域>/<paper_slug>/
├── <paper_slug>.zh-CN.md   # 深度精读笔记
├── images/                 # 论文图表(插入成功时落盘到此处)
└── .deeppapernote.json     # 目录身份记录,防止覆盖冲突

笔记本身遵循固定的 12 个一级章节(中文模式):

  1. 核心信息(元数据块)
  2. 原文摘要翻译
  3. 创新点
  4. 一句话总结
  5. 研究问题
  6. 数据与任务定义
  7. 方法主线
  8. 关键结果
  9. 深度分析
  10. 局限
  11. 我的笔记
  12. 引用

每篇笔记开头都会带 Obsidian YAML frontmatter(tags、aliases、date、doi 等字段),因此天然支持 Vault 内的标签检索和双链。章节与命名规范见 obsidian-format.md。

更重要的是质量底线——它明确拒绝“摘要改写”式的浅笔记:

  • 关键方法要解释机制(输入 → 操作 → 输出去向),而不是只列模型名;
  • 关键结果要写清评测设置和最值得注意的数字,而不是只贴最好看的结果;
  • 必须包含至少一条真实的局限和明确的贡献判断;
  • 如果证据不足以支撑真正的深度精读,流程会停下来向你索要更好的材料,而不是假装完成。

完整的评分标准见 note-quality.md 和 evals/note-quality-rubric.md。

进阶玩法:让论文工作流更顺滑

  • Zotero 深度集成:内置只读 Zotero Local API,支持 auto(默认,优先唯一本地条目并保留联网回退)、off、required 三种模式;本地匹配有歧义时会明确失败,绝不任意挑选条目。
  • 术语沉淀:装好 paper-glossary 后,可以从已生成的论文材料中筛选术语,创建可复用的 Obsidian 术语笔记并链接回论文笔记,详见 paper-glossary 说明。
  • 浏览器收藏:配套的 DeepPaperNote Connector 浏览器扩展(目前支持 macOS 上的 Chrome)可以把论文 PDF 直接存进 Obsidian 论文库,精读时在同一目录生成笔记,让原文与理解放在一起积累。

常见问题

不装 Obsidian 能用吗? 能。保存模式可选 workspace,笔记会直接写入当前工作区;之后想迁移到 Vault 也没问题。

Zotero 里没有这篇论文,会报错吗? 不会。默认 auto 模式下本地找不到就自动回退到 DOI、arXiv、开放获取等联网路径。

已有同名笔记会被覆盖吗? 不会静默覆盖。检测到同语言同名笔记时,流程会停下来询问是否覆盖;保存受阻时也不会擅自切换保存位置。


至此你已经完成全部 3 步:装插件 → 装 PyMuPDF → 把论文丢给 Agent。之后每读完一篇重要论文,DeepPaperNote 都会把它变成你学术 Wiki 里新的一页——论文读得越多,知识库长得越快。更多背景与更新历史可查阅 README.zh-CN.md 和 CHANGELOG.md。

登录后查看全文
DeepPaperNote