更新日志

v2.2.3

2026年11月14日

配套发布 Companion 2.2.3。

从 PDF 撰写文献笔记、新增引导式教程、需要 Obsidian 1.15.1

此版本为 PDF 阅读器带来了文献笔记操作,在文档中添加了引导式教程,并修复了阅读器链接、引文以及弹出框相关的多项问题。随之发布的 Zotero 插件 ZotLit Companion 2.2.3 本身没有变动,因此 Companion 2.2.0 至 2.2.2 版本仍可继续正常使用。

不兼容变更

需要 Obsidian 1.15.1 或更高版本

ZotLit 2.2.3 需要 Obsidian 1.15.1 或更高版本(此前为 1.14.5)。安装程序最低版本仍为 1.13.4。在 Obsidian 1.14.5 至 1.15.0 上,ZotLit 会保持在 2.2.2 版本,直到你更新 Obsidian 才会升级。详见 ZotLit 支持的 Zotero 和 Obsidian 版本。

新增内容

从 PDF 撰写或打开文献笔记

在 Obsidian 中打开属于某篇文献的 Zotero PDF 时,PDF 标签页右上角会出现一个按钮,工具提示显示为 撰写文献笔记(若笔记已存在则显示为 打开文献笔记)。工具提示会在你撰写或删除笔记时同步更新。标签页的“更多选项”(More options)菜单中也包含相同条目,此外还新增了命令 ZotLit: 打开或撰写此 PDF 的文献笔记。

笔记会在 PDF 旁边的分栏中打开;若已有标签页显示该笔记,则会切换至前台。不属于 Zotero 文献的 PDF 不会显示此按钮。详见连接 Zotero 到 Obsidian:你的第一篇文献笔记。

新增引导式教程

文档现以位于 /learn 的六篇简短教程作为起始:连接 Zotero 并撰写第一篇文献笔记、标注 PDF、边写边引用、导出带引文的 Word 文档、制作文献综述表格,以及追踪阅读进度。ZotLit 欢迎视图中的 入门 卡片现可直接打开这些教程,ZotLit 中的帮助链接也指向了这些新页面。部分帮助标签已重命名以契合新页面:在引文设置中,“Pandoc citation tutorial”现为 Pandoc 引文工作流,其按钮“Open tutorial”现为 打开指南;模板工作台中的“Annotation tutorial”链接现为 标注指南。

其他改进

  • 在大型 Zotero 文库中,调整窗口大小或折叠侧边栏时文库视图的响应速度更快,因为它会跳过不可见的行。

问题修复

  • 当关闭 在 Obsidian 中打开 PDF 文件链接 或 在 ZotLit 阅读器中打开标注链接 时,标注上的页码链接在标注视图、查询块、阅读卡片和查询视图中仍会在 Obsidian 中打开 PDF。现已修正为按设置在 Zotero 中打开该标注。详见在 Obsidian 中打开条目的 PDF。
  • 在 Obsidian 1.15.1 中,独立 Obsidian 窗口中的菜单和弹出框会出现内容为空或立即关闭的问题(例如查询视图菜单、筛选弹出框和高亮浮层)。现已恢复正常。
  • 在实时预览(Live Preview)中,相邻的两个引用(如 [@a] [@b])有时会消失。现在它们会保持正常显示。详见插入引用。
  • 在安装了 Better BibTeX 的情况下,若在 Zotero 刚打开后立即导出为 Word,导出可能会无限期等待。ZotLit 现在会在等待 30 秒后停止,并提示你等待 Zotero 准备就绪后再试。详见导出带引文的笔记。
  • 当较窄的文库视图顶部显示设置步骤时,阅读卡片的 打开 PDF 和 撰写文献笔记 按钮可能会超出标签页底部而无法点击。现在标签页支持滚动以显示这些按钮。详见在文库视图中浏览文库。
  • 使用 另存为查询文件… 保存 最近 列表时,文件原先会被命名为 最近。现在会被命名为 未命名。
  • 打开其他标签页时,高亮浮层原先仍会停留在最上层。现在它会随 PDF 一同隐藏并在切回时恢复显示,同时保留你输入的评论。详见如何在 Obsidian 中编辑 PDF 标注。
  • 在打开含有引文的草稿时,若针对 Pandoc 引擎 选择了 卸载,设置项可能会错误显示为 重试 而非 安装。现在会正确显示为 安装。此修复同样适用于 中文分词器。
  • 若在导出为 Word 正在运行时针对 Pandoc 引擎 选择了 卸载,导出可能会失败。现在会等待导出先完成,然后再移除引擎。
在 GitHub 上查看版本