Logseq Zotero 集成：一篇文献走完全流程-编程实验室

Logseq Zotero 集成：一篇文献走完全流程

【免费下载链接】logseqA privacy-first, open-source platform for knowledge management and collaboration. Download link: http://github.com/logseq/logseq/releases. roadmap: https://logseq.io/p/NX4mc_ggEV项目地址: https://gitcode.com/GitHub_Trending/lo/logseq

这篇使用笔记记录 Logseq Zotero 集成的最小配置和实际用法：把 Zotero 库里的 PDF 在 Logseq 中打开、引用、做笔记并建立链接，解决本地文献管理 Zotero Logseq 两套工具各干各的问题。

上个月读的 PDF 去哪了

科研笔记常见的死法：文献堆在 Zotero，笔记堆在 Logseq，两个月后两边对不上号。查一篇旧文献，要么在 Zotero 的标签树里翻，要么在笔记里搜文件名，翻到的往往还是半截结论，原文早找不着了。

Logseq 自带的 Zotero 扩展做的事很具体：识别zotero://这类链接，按你配置的数据目录解析成本机文件路径，在页面上渲染一个"打开"按钮，点开就是内置 PDF 查看器，笔记和原文在同一个窗口里来回切。不覆盖的部分也要说清楚：抓取文献、写元数据、下载 PDF 这些事还在 Zotero 端做，Logseq 只负责打开和建立链接。链接本身靠 Zotero 侧插件复制出来，或者手敲进笔记。

Zotero 数据目录怎么配

配置写在图目录下logseq/config.edn的:zotero/settings-v2里，按 profile 分组，Logseq 默认读"default"这一个。这份文件一般由 Zotero 侧插件代写，也可以自己手工编辑。跑通只需要两个键：

配置键	作用	应填什么
`zotero-data-directory`	Zotero 数据目录，导入型 PDF 位于其`storage/<item-key>/`子目录下	如`~/Zotero`
`zotero-linked-attachment-base-directory`	链接型附件的相对路径基准目录	如`~/papers`

两个目录的区别值得记一下：前者管 Zotero 下载后存进storage的导入型附件，后者管你自己硬盘上、只是被 Zotero 链接过来的文件。填错其中一个，症状就是只有对应那类附件打不开。仓库测试图里有一份现成配置可以直接抄格式：deps/graph-parser/test/resources/exporter-test-graph/logseq/config.edn。prefer-citekey?、include-attachments?这类键都有默认值，不动也能跑通。

一篇文献的完整路径：收集、引用、笔记、链接

拿仓库测试数据里那篇 zlib 论文当例子。

收集：照常在 Zotero 里做，Logseq 不参与这一步。

引用：在 Logseq 页面里加一个块，两行标记，原文格式来自 deps/graph-parser/test/resources/exporter-test-graph/pages/zlib.md：

- PDF {{zotero-imported-file RX5JS7SY, "zlib.pdf"}}

zotero-imported-file收两个参数：条目 key 和文件名。扩展把两者拼成file://<数据目录>/storage/RX5JS7SY/zlib.pdf，渲染出打开按钮，实现就在 src/main/frontend/extensions/zotero.cljs。文件不在 Zotero 存储里时（链接型附件），换成zotero-linked-file，路径相对基准目录：

- Understanding EXPLAIN.pdf {{zotero-linked-file "it/Understanding EXPLAIN.pdf"}}

做笔记：点"打开"进入内置 PDF 查看器。选中文字可以直接复制成块引用粘回笔记，原文和笔记在同一个窗口里切，不用来回翻文件夹。反过来，从块引用点开也能重新打开 PDF 并定位到标注处，这是代码里db-based-open-block-ref!干的事。

建立链接：用页面引用和块引用把这篇文献挂到已有概念上，比如把某段结论链到方法页。之后做导出时，graph-parser 会解析这些zotero://链接，把本地路径转成zotero-path://和zotero-link://两种内部形式写进产物，逻辑在 deps/graph-parser/src/logseq/graph_parser/exporter.cljs。

标签、模板与块引用

标签分类：给文献页打#论文、#重要引用之类的标签，配属性记录期刊和年份，检索走 Logseq 自己的索引，不依赖 Zotero 的分类树。
文献笔记模板：建一个固定"核心主张 / 方法 / 可引用结论"三段的页面，新文献照抄，格式不飘。
块引用：同一篇 PDF 的多个观点，用块引用指向同一个引用块，避免每个观点都重复写一遍文件名。
多 profile：settings-v2支持多套配置，切换 profile 等于换一组 Zotero 库，适合同时在推进多个课题的人。

打不开 PDF 时查什么

解析入口是 src/main/frontend/extensions/pdf/assets.cljs 里的get-zotero-local-pdf-path，按协议前缀分四条分支走。这些分支都只做字符串拼接，不主动查文件系统，所以配置错的时候不报错，只是路径不对：

现象	原因	处理
标记位置显示警告文字，没有打开按钮	`zotero-data-directory`或链接基准目录为空，拼不出完整路径	在`"default"`profile 下补上目录
旧`zotero://`链接点开后报文件不存在	兜底分支按`storage/<item-key>/<文件名>`拼路径，数据目录搬过家就断	更新`zotero-data-directory`到新位置
`zotero-link://`指向的文件打不开	该分支只去掉前缀再拼基准目录，基准配错则全部错	核对`zotero-linked-attachment-base-directory`
导出后文件路径对不上	导出解析只认`"default"`profile，profile 键名写错取不到配置	检查`:zotero/settings-v2`的键名