llm-for-zotero笔记工作流:把AI科研笔记直接存进Obsidian和Logseq的完整教程
【免费下载链接】llm-for-zoteroAn open-source research agent system for your Zotero library.项目地址: https://gitcode.com/gh_mirrors/ll/llm-for-zotero
llm-for-zotero 是一个开源的 Zotero AI 科研代理插件,它的笔记工作流可以把你读论文时生成的 AI 总结、文献笔记一键存进 Obsidian、Logseq 等本地 Markdown 笔记库,不用手动复制粘贴。本文将带你用 3 个步骤配置好「AI 写笔记 → 自动存进你的笔记库」这条完整链路。📚
llm-for-zotero 是什么?为什么适合做笔记工作流
简单说,llm-for-zotero 把大语言模型装进了 Zotero 的 PDF 阅读器里:你可以针对当前论文提问、总结全文、解释图表、跨论文对比,所有回答都带着可点击回跳原文的引用。而它最被低估的能力,就是文件笔记(File-Based Notes)——把 AI 生成的 Markdown 笔记直接写入你指定的本地目录:
- 指向 Obsidian 的 Vault、Logseq 的 Graph,或任何纯 Markdown 文件夹;
- 笔记自动带 YAML frontmatter(标题、citekey、DOI、年份、期刊、标签);
- 使用 Pandoc 引用语法
[@citekey],可与 Obsidian Zotero Integration、Pandoc 工作流无缝衔接; - 支持把 MinerU 解析出的论文插图自动复制进附件目录并嵌入笔记。
下面是 Zotero 里的 AI 助手界面,总结、问答、写笔记都在这里完成:
第一步:配置笔记目录,指定 Obsidian 或 Logseq 路径
打开Preferences(偏好设置)→llm-for-zotero,滚动到Notes directory(笔记目录)区域,填写 4 个字段:
| 字段 | 作用 | 示例 |
|---|---|---|
| Nickname(昵称) | 你在聊天里称呼这个目录的名字 | Obsidian、Logseq |
| Notes Directory Path | 笔记保存的根目录绝对路径 | /Users/me/MyVault |
| Default Folder | 新笔记的默认子文件夹 | Zotero Notes |
| Attachments Folder | 插图/图片附件文件夹(相对根目录) | Logs/imgs |
配置项在偏好界面中的定义位于 addon/content/preferences.xhtml,底层读写逻辑在 src/utils/notesDirectoryConfig.ts。
💡 小技巧:给每个笔记库起一个独特昵称,比如 Obsidian 库叫
Obsidian、Logseq 库叫Logseq。之后你只要在对话里提到这个昵称,AI 就知道该把笔记写到哪里。
第二步:开启 Agent 模式,一句话让 AI 写笔记并保存
文件笔记由 Agent 模式驱动,所以先开启它:
- 在
Preferences→llm-for-zotero中启用 Agent Mode(默认关闭); - 打开一篇 PDF,点击右侧工具栏的 LLM Assistant 图标;
- 在聊天上下文栏切换
Agent (beta); - 直接对 AI 说:
"总结这篇论文,并把笔记保存到 Obsidian。"
AI 会自动完成一整条流水线:读取论文元数据 → 生成结构化笔记(Summary / Key Findings / Methodology / My Notes / References)→ 复制相关插图 → 按命名模板落盘到默认文件夹。
整个过程你不需要关心文件路径,它由插件内建的write-note技能统一调度:
- 技能定义:src/agent/skills/write-note.md
- 意图识别(判断你是否在请求写笔记):src/agent/skills/noteIntent.ts
- 批量写笔记工具:src/agent/tools/write/writeNotesBatch.ts
如果只想把对话里已有的回答存下来,直接说「把上面的回答保存为笔记到 Logseq」即可,AI 会原样保留内容,不会重新生成。
第三步:查看生成效果,Obsidian 与 Zotero 内部笔记对比
笔记写入 Obsidian 后打开 Vault,你会看到带 frontmatter 的 Markdown 文件,引用、插图、目录全部就位:
如果你希望笔记仍留在 Zotero 内部(用write-note技能但不提外部目录),AI 也可以把它写成 Zotero 内部笔记,效果对比:
两种形态由同一个插件生成,模板字段(title、citekey、doi、year、journal、created、tags 等 7 个字段)在技能文件中严格锁定,保证 frontmatter 结构稳定:
frontmatter 模板原文见 src/agent/skills/write-note.md,图片导出规则在同一文件的 Step 3 中定义。
进阶技巧:自定义笔记模板与批量工作流
1. 修改默认笔记模板
打开独立窗口(Standalone Window)→Skills门户,找到write-note技能:
- 在
MANAGED-END标记下方添加「## Your customizations」小节,即可保留插件升级后的自定义格式偏好; - 直接改模板会被视为自定义文件,插件将停止自动更新该文件,之后可随时「Restore to default」恢复。
2. 批量给多篇论文写笔记
对 AI 说「给我最近的 20 篇论文各写一条总结笔记,存到 Obsidian」。插件会用批量工具逐条生成并展示预览卡片,你可以逐项勾选再统一确认,避免 20 次单独审批:
- 批量写入实现:src/agent/tools/write/writeNotesBatch.ts
- 相关测试:test/writeNoteDestination.test.ts
3. 插图自动归档
启用 MinerU PDF 解析后,AI 写笔记时会自动调用paper_read的 figures 模式裁剪图表,并把图片复制到你配置的附件文件夹(如Logs/imgs),Markdown 里写入相对路径链接——在 Obsidian 里点开就能看到论文原图,无需手动导出。
常见问题 FAQ
Q1:不想用 API Key 也能用吗?可以。llm-for-zotero 支持 WebChat 模式(通过浏览器扩展把问题转发到 ChatGPT、DeepSeek、Gemini 网页端)、Codex App Server(ChatGPT Plus 用户)以及本地 OpenAI 兼容模型,总有一条不需要付费 API 的路径。
Q2:笔记会覆盖我原来的文件吗?默认会写入你配置的默认子文件夹;写操作走「可审查 + 可撤销」机制,写入前有确认卡片,会话内还能撤销最近的写操作。
Q3:可以同时配置 Obsidian 和 Logseq 两个库吗?当前笔记目录为单目录 + 单昵称配置(见 src/utils/notesDirectoryConfig.ts)。实践建议:以 Obsidian 主库为默认目录,Logseq 笔记用临时改昵称的方式写入,或按论文类型分流到不同默认文件夹。
Q4:生成的[@citekey]在 Logseq 里不显示怎么办?这是 Pandoc 引用语法,Logseq 原生不渲染它。Logseq 用户建议在自定义模板中弱化引用行、保留 References 完整引用段;Obsidian 用户则配合 Obsidian Zotero Integration 插件即可完美解析。
总结
llm-for-zotero 的笔记工作流把「读论文 → AI 总结 → 结构化笔记 → 入库」压缩成一句话:
- 配置:Notes directory 指向 Obsidian Vault 或 Logseq 目录,起好昵称;
- 执行:Agent 模式下说「总结这篇论文并保存到 Obsidian」;
- 收获:带 frontmatter、引用和插图的 Markdown 笔记自动落盘,模板和技能还可随时定制。
从此你的 Zotero 文献库和笔记库之间不再需要手动搬运,AI 生成的科研笔记直接长在你每天打开的第二大脑里。
【免费下载链接】llm-for-zoteroAn open-source research agent system for your Zotero library.项目地址: https://gitcode.com/gh_mirrors/ll/llm-for-zotero
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考