给 Zotero 装上“茉莉花”，中文文献管理一次搞定，别再熬夜手填元数据了

【免费下载链接】jasminumA Zotero add-on to retrive CNKI meta data. 一个简单的Zotero 插件，用于识别中文元数据项目地址: https://gitcode.com/gh_mirrors/ja/jasminum

小周在毕业论文季整理中文文献，几十篇知网 PDF 拖进 Zotero 后，标题、作者、期刊全是空的，他对着条目一条条手打，耗了一整个下午。后来我给他安利了茉莉花 Jasminum，一款专门服务中文文献管理的 Zotero 插件——从那以后，他再也没为“填元数据”皱过眉头。

有它没它，差别有多大

先把话挑明：这插件不是锦上添花，是雪中送炭。同样一篇中文 PDF，两种体验摆在你面前：

一句话：它把“整理文献”从体力活变成了确认活。

五分钟，让它先跑起来

不需要折腾什么，前提是你电脑上有 Node.js，然后三步走：

git clone https://gitcode.com/gh_mirrors/ja/jasminum cd jasminum npm install

最后敲下npm start，Zotero 会自动启动，茉莉花已经加载好，菜单栏里能看到“茉莉花”相关的选项。从克隆到跑起来，五分钟绰绰有余。

一次完整的实战：从空白条目到整整齐齐

我拿一篇《在哲学社会科学工作座谈会上的讲话》的 PDF 做实验。拖进 Zotero，右键附件，选“茉莉花抓取 → 抓取期刊元数据”，弹出一个任务窗口，里面列了好几条候选结果——有期刊版、有会议版，日期还不一样。

勾中最贴近的那条，点确认，标题、作者、期刊、年份“哗啦”一下全填好了，全程不到一分钟。

接着处理附件的老毛病。用 Zotero Connector 在知网抓条目时，经常元数据到了、附件却没下来。这时我手动下载 PDF，右键条目选“小工具 → 在下载文件夹中查找附件”，插件会按“期刊标题和文件名的相似度”自动扫描下载目录，找到匹配的文件，搬进备份文件夹（默认是下载目录里的jasminum-backup）。Zotero 里已经存好一份，所以下载目录里的原件可以放心处理。

最后是读论文的体验。打开 PDF，点左侧边栏的茉莉花书签按钮，几万字的论文瞬间变成一棵清晰的目录树：从“空间图式”到“历史街区”，再到具体的更新方案，层级分明，点哪跳哪。

让体验更顺滑的五个小技巧

• 在设置里把“删除匹配成功的附件”打开，下载目录永远干干净净——这是我最推荐的一条。
• 下载目录默认指向系统 Downloads，如果你改了存放位置，记得去设置里同步，否则它找不到附件。
• 大纲视图里熟记几个键：↑↓ 在书签间跳转、←→ 展开或折叠、空格编辑内容、[和]调整层级、\新建节点、Delete 删除。
• 顺手用用“中文姓名拆分/合并”小工具，把“张三”和“Zhang San”对应起来，引用格式不会乱。
• 界面语言支持简体、繁体、英文，切换一次就记住了，不用每次都找。

老用户踩过的坑，提前帮你避一避

• 抓不到元数据？先查网络，再看 PDF 里有没有完整的标题页信息，多试几次比干着急有用。
• 附件匹配不上？文件名和论文标题越像越容易命中；匹配阈值和下载目录都能在设置里调。
• 大纲面板没反应？确认 Zotero 版本支持 PDF 阅读器扩展功能，还不行就卸载重装一次插件。
• 别把期望拉满：目前元数据抓取只支持知网，万方、pubscholar 等数据源还在路上。
• 搜索结果有多条时别手滑：仔细挑最贴近的那条再确认，选错了一篇篇重来不划算。

它凭什么能自动“填表”

说白了，插件背后挂了一组“数据服务”。比如src/modules/services/cnki.ts专门负责和知网对话：拿到 PDF 里的标题，就带着关键词去检索，把结果端回来让你挑；本地附件匹配的逻辑在src/modules/attachments/localMatch.ts，本质是算“标题 vs 文件名”的相似度分数，分数够了就配对；PDF 大纲在src/modules/outline/，书签默认只存成本地配置，你点“保存到 PDF”它才写回文件——像助理先记在便签上，你点头了再誊进正式文档。

今晚，就用一篇 PDF 试试

回到开头那个下午：小周对着空白的元数据栏一条条手打，搭进去整整一下午。而现在的他，把 PDF 拖进 Zotero，右键、抓取、确认、开读，全程不到三分钟。工具的意义，不就是把时间还给更重要的事吗？今晚就装一个茉莉花，拿一篇你最头疼的中文 PDF 试试——你会回来谢谢自己的。

【免费下载链接】jasminumA Zotero add-on to retrive CNKI meta data. 一个简单的Zotero 插件，用于识别中文元数据项目地址: https://gitcode.com/gh_mirrors/ja/jasminum