l0o0/jasminum · 上手攻略

  • 仓库：l0o0/jasminum
  • 链接：https://github.com/l0o0/jasminum
  • 分类：academic-writing
  • 作者：Tom
  • 更新：2026-07-14

这是什么

Jasminum（茉莉花）是一个 Zotero 引文管理器的开源插件，专门解决中文期刊（尤其是中国知网 CNKI）文献的元数据抓取难题。国内学术工作者在用 Zotero 管理外文文献时，中文文献往往因为元数据格式不规范而难以自动识别，Jasminum 正是为这个痛点而生。

它集成了三大功能：中文 PDF 元数据抓取（从中国知网获取期刊标题、作者、摘要等信息）、中文引用格式与转换器管理（覆盖 Zotero 中文社区的引用样式），以及本地附件智能匹配（将手动下载的 PDF/CAJ 与已有条目自动关联）。

解决什么问题

Zotero 原生对中文期刊的元数据支持非常有限，主要表现为：

  1. 元数据缺失：从中国知网抓取时，经常出现标题、作者、年份等字段抓不全或乱码的情况。
  2. PDF 附件无法自动下载：知网有防爬限制，Zotero Connector 经常抓得到元数据但下不了附件。
  3. 引用格式不匹配：中文期刊的引用格式与 Zotero 默认样式不同，手动调整费时费力。
  4. PDF 书签管理缺失：Zotero 内置 PDF 阅读器没有书签大纲功能，论文导航不便。

Jasminum 用一个插件把这些问题打包解决，是中文 Zotero 用户几乎是必备的工具。

快速安装

环境要求

  • Zotero 8 或 Zotero 9（插件页面标注支持 8/9，实测 Zotero 7 也能运行但建议使用最新版）
  • Zotero 支持 Windows / macOS / Linux 全平台

安装步骤

方式一（推荐）：下载编译好的 .xpi 文件

  1. 前往 Releases 页面，下载最新的 .xpi 文件
  2. 打开 Zotero → 菜单栏 工具 → 附加组件 → 右上角齿轮图标 → Install Add-on From File
  3. 选择下载的 .xpi 文件，重启 Zotero

方式二：从源码安装（需 Node.js + zotero-plugin-toolkit）

git clone https://github.com/l0o0/jasminum.git
cd jasminum
# 依赖 zotero-plugin-template，需要 Node.js >= 18
npm install
npm run build   # 编译产出 .xpi 到 build/ 目录

⚠️ 注意：插件安装后首次启动会在 Zotero 侧边栏添加"茉莉花"菜单，如未出现请检查 工具 → 附加组件 中插件是否已启用。

核心用法

1. 抓取中文期刊元数据

适用场景：从中国知网手动下载了 PDF/CAJ 附件，需要补全元数据。

操作流程： 1. 在 Zotero 中选中中文期刊条目（或直接拖入 PDF 附件） 2. 右键 → 茉莉花抓取 → 抓取期刊元数据 3. 弹出窗口显示搜索结果列表，手动选择最匹配的一项 4. 点击「确认」，元数据自动写入条目

⚠️ 只支持中国知网（CNKI），暂不支持万方、维普等其他中文数据库。

2. 本地附件自动匹配

适用场景：用 Zotero Connector 抓取中文期刊时附件下载失败，手动下载后希望与已有条目关联。

操作流程： 1. 手动下载 PDF/CAJ 到系统下载目录（Windows 默认 C:\Users\用户名\Downloads，macOS 默认 /Users/用户名/Downloads，Linux 默认 /home/用户名/Downloads） 2. 在 Zotero 中右键目标期刊条目 → 小工具 → 在下载文件夹中查找附件 3. 插件根据期刊标题与文件名的匹配度自动找附件 4. 匹配成功后：默认移动到 下载目录/jasminum-backup/；也可在设置中改为「删除」或「不做处理」

可在 Zotero 设置中修改下载目录路径。

3. PDF 书签大纲

适用场景：阅读带书签的 PDF 论文时，使用书签导航。

操作流程： 1. 在 Zotero 内置 PDF 阅读器中打开论文 2. 左侧边栏点击「茉莉花书签」按钮，打开书签大纲窗口 3. 支持键盘快捷键操作： - ↑ / ↓：上一个/下一个书签 - ← / →：折叠/展开节点 - 空格：编辑书签内容 - [ / ]：调整书签层级 - \：在当前位置新建子节点 - Delete：删除节点 4. 点击「保存到 PDF」将书签写入文件（默认只存本地配置文件）

4. 翻译器与引用格式管理

  • 插件内置了 Zotero 中文社区的中文转换器（translators_CN）和引用格式（styles），可在 小工具 → 语言设置 中下载更新。
  • 支持简体中文 / 繁体中文切换。

典型适用场景

场景 推荐原因
中文硕博论文管理 知网是主要来源，Jasminum 直接补全元数据
批量处理中文期刊附件 手动下载 → 自动匹配，避免重复劳动
团队协作文献管理 统一引用格式，减少后期格式调整
学术写作 配合 Zotero Word 插件，引用格式自动套用

坑与注意

  1. 只支持中国知网（CNKI）：其他中文数据库（万方、维普、超星）暂不支持，需要其他方案。
  2. 知网反爬限制：抓取时建议控制频率，大批量抓取可能被封 IP（建议间歇抓取或使用代理）。
  3. CAJ 格式：知网部分文献是 CAJ 格式（非 PDF），Jasminum 支持匹配但部分功能可能受限。
  4. 下载目录匹配依赖文件名：如果下载的 PDF 文件名与期刊标题差异较大，匹配准确率会下降，建议重命名文件时保留标题关键词。
  5. Zotero 版本兼容性：主要面向 Zotero 8/9，Zotero 7 用户可能遇到个别功能异常。
  6. 备份！：附件匹配后默认会移动文件（到 jasminum-backup），首次使用建议先确认备份逻辑符合预期。

与同类对比

插件 数据源 元数据抓取 附件匹配 PDF 书签 维护状态
Jasminum 仅 CNKI ✅ 专门优化 ✅ ✅ 活跃维护
Zotero Connector 多数据库 ❌ 中文支持差 ❌ ❌ 官方维护
Jasminum（对比） CNKI 专注 专为中文优化 智能匹配 书签管理 GitHub 活跃

对于主要写中文论文、以 CNKI 为主要文献来源的用户，Jasminum 是目前最成熟的一站式方案；外文文献继续用 Zotero Connector 即可，两者可以共存。

一句话推荐结论

如果你在 Zotero 里管理中文文献，Jasminum 是绕不开的必备插件——它把 CNKI 元数据抓取、附件匹配、引用格式三条痛点一次搞定，安装简单，免费开源，值得到收藏夹里吃灰之前先装上。