ARTICLE · 1003518
Jasminum(茉莉花)保姆级教程:从安装到使用,一篇搞定中文文献管理!
01
2026/09
Jasminum是一款专为Zotero设计的中文文献增强插件，完全免费开源。
它的核心使命只有一件：让Zotero完美处理中文文献——从知网一键抓取元数据、智能匹配本地PDF、为学位论文生成书签目录，彻底解决中文文献管理的所有痛点。
PART 01
下载Jasminum插件
NEWS
👉 Jasminum官方下载地址：https://github.com/l0o0/jasminum/releases
这是Jasminum插件的官方GitHub发布页面，所有版本都在这里发布。
下载插件文件（.xpi格式）
第一步：在Releases页面中，你会看到最新版本的发布信息。找到 jasminum.xpi 文件，点击下载。
特别提醒
如果你使用的是Firefox浏览器，下载.xpi文件时可能会被浏览器拦截或直接尝试安装。此时请右键点击下载链接，选择“另存为” ，将文件保存到电脑上。Chrome、Edge等浏览器一般可以直接下载，不会出现问题。
第二步：打开Zotero的插件管理界面，从文件安装插件
在插件管理界面中，点击右上角的 齿轮图标 ⚙️，
在下拉菜单中选择 “Install Add-on From File…” （从文件安装插件），
在弹出的文件选择对话框中，找到你刚才下载的 jasminum.xpi 文件，选中它，点击 “打开” 。
第三步：Zotero会提示你确认安装
点击 “Install Now” （立即安装），安装完成后，重启Zotero（完全关闭再重新打开），Jasminum插件就成功安装到你的Zotero中了！
PART 02
Jasminum插件使用流程
进入Jasminum设置界面，打开Zotero桌面端
Windows用户：点击顶部菜单 “编辑” → “设置” （Preferences）
Mac用户：点击顶部菜单 “Zotero” → “设置” （Preferences）
在弹出的设置窗口中，找到并点击 “茉莉花” 选项卡
在茉莉花设置界面中，有一个非常实用的功能——添加中文PDF/CAJ时自动抓取元数据。
不过这个功能默认是关闭的，需要手动开启。
找到对应的开关选项，勾选启用即可。
注意
此功能要求添加的PDF文件名需要包含中文字符。如果文件名是全英文的，可能不会自动触发抓取。
核心功能使用教程
功能一
为中文PDF抓取元数据（最常用！）
这是Jasminum最核心、最常用的功能。当你把一篇从知网下载的PDF拖进Zotero后，它只是一个孤零零的文件。用这个功能，可以一键从知网抓取完整的文献信息。
操作步骤： | |
1 | 将中文PDF文件拖入Zotero（或通过“添加文献”导入）； |
2 | 右键点击该PDF附件，在右键菜单中选择 “茉莉花抓取” → “抓取期刊元数据”； |
3 | 插件会自动搜索知网，并在弹出窗口中显示匹配结果； |
4 | 如果有多个搜索结果，手动选择最匹配的那一条； |
5 | 点击 “确认” ，完成元数据抓取。 |
整个过程只需要几秒钟，标题、作者、期刊、年份、摘要等信息就会自动填充完整！
批量操作小技巧：按住 Ctrl 键（Mac用户按住 Command 键）选中多个PDF附件，右键选择 “茉莉花抓取” → “批量抓取元数据” ，可以一次性处理多篇文献！
功能二
本地附件智能匹配
使用Zotero Connector在浏览器上抓取中文期刊时，经常出现元数据抓取成功但PDF附件无法自动下载的情况。当你手动下载了PDF后，可以用这个功能快速将附件与已有的文献条目匹配起来。
操作步骤： | |
1 | 手动将PDF下载到电脑的下载目录（默认是系统的“下载”文件夹） |
2 | 在Zotero中找到对应的文献条目（不是附件，是条目本身） |
3 | 右键点击该条目 |
4 | 选择 “小工具” → “在下载文件夹中查找附件” |
5 | 插件会自动在下载目录中寻找与当前条目匹配的PDF文件（匹配规则是根据期刊标题与文件名的匹配度） |
匹配成功后，PDF会自动添加到该文献条目下，并按照你在设置中配置的方式处理原始文件。
功能三
更新中文转换器（Translators）
Zotero Connector抓取网页文献的能力依赖于“转换器”（Translators）。Jasminum集成了Zotero中文社区维护的转换器库，可以一键更新，让Zotero更好地抓取知网等中文网站的数据。
操作步骤： | |
1 | 进入 “编辑” → “设置” → “茉莉花” 选项卡 |
2 | 找到 “Unofficial Translator Repository” （非官方中文转换器仓库）区域 |
3 | 先点击 “Refresh” （刷新），获取最新的转换器列表 |
4 | 再点击 “Update all” （更新全部），下载所有可用的中文转换器 |
Q
/
A
Jasminum支持哪些Zotero版本？
Jasminum同时支持Zotero 6和Zotero 7版本。下载时请确保选择与你的Zotero版本兼容的.xpi文件。
Q
/
A
为什么抓取元数据时搜索不到结果？
可能有以下原因：
①PDF文件名不包含中文字符；
②网络连接问题，无法访问知网；
③该文献在知网中没有收录。可以尝试手动在知网搜索确认。
Q
/
A
PDF书签功能需要额外安装什么吗？
如果使用Jasminum的书签添加功能，需要提前安装PDFtk server。这是一个第三方PDF工具，可以从 https://www.pdflabs.com/tools/pdftk-server/ 下载安装。安装后需要在茉莉花设置中配置PDFtk的路径。
Q
/
A
知网学位论文的PDF书签功能还能用吗？
这一功能已弃用。因为知网的学位论文现在大多已经自带目录书签，且对PDF进行了加密，无法由茉莉花直接添加书签。不过对于其他PDF文献，书签大纲功能仍然完全可用。
Q
/
A
安装后右键菜单中没有“茉莉花抓取”选项怎么办？
①确认已重启Zotero；
②进入插件管理界面，确认Jasminum已启用（没有灰色或禁用状态）；
③如果还是不行，尝试卸载后重新安装。
💡 小贴士：
养成“即入即抓”的习惯——每添加一篇中文PDF，立即右键抓取元数据，避免遗忘；
建议在茉莉花设置中开启“删除匹配成功的附件”选项，保持下载目录整洁；
定期更新中文转换器，确保Zotero Connector能正常抓取中文网站数据；
如果在使用中遇到问题，可以访问Jasminum的GitHub项目页面（https://github.com/l0o0/jasminum）查看常见问题或提交Issue；
