中文文献管理终极指南：用Zotero插件Jasminum自动抓取知网元数据

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

如果你经常和中文文献打交道，Jasminum（茉莉花）这个 Zotero 插件值得认真对待——它专门解决中文 PDF 元数据自动抓取的难题，把"手工录入知网文献信息"这件苦差事，压缩成两次点击。

一、先聊聊那些让科研人血压升高的瞬间

把一篇从知网下载的 PDF 拖进 Zotero，满怀期待地等它自动补全信息，结果标题栏还是一串乱码或刺眼的 "Untitled"——这个画面，凡是整理过中文文献的人应该都不陌生。

接下来的流程往往更折磨人：手动敲作者、翻期刊、找年份卷期、核对页码，一篇文献五分钟，一百篇文献就是一个下午。要是再碰上 Zotero Connector 在浏览器里抓知网时"元数据成功、附件下载失败"的经典翻车，你甚至还得手动去下载文件夹里捞 PDF，再手动关联。

这些痛点不是你的问题，是中文文献的特殊性——数据库接口不开放、文件名千奇百怪、PDF 里连基本信息都不全。而 Jasminum 这个开源的 Zotero 插件，就是专门为这些场景设计的：它只做一件事，把中文文献管理变得简单，尤其是把知网元数据抓取这个环节做得又快又准。

二、先说结论：它帮你解决三件大事

在动手之前，先快速看一下 Jasminum 的三板斧，心里有个全局：

除此之外，它还内置了几个顺手的小工具：中文姓名拆分与合并、语言设置、翻译器与引用样式的自动更新。功能不臃肿，每个都踩在痛点上。

三、三步装好插件，十分钟内开始干活

第一步：拿到插件本体

普通用户最简单：从项目的 Release 页面下载最新的 xpi 文件，然后在 Zotero 里打开"工具 → 附加组件"，点齿轮图标选择"Install Add-on From File"，选中刚才的 xpi 即可，无需重启。

如果你打算折腾源码或者自己改功能，那就克隆仓库：

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

第二步：启动开发模式

npm start

这个命令会在本地拉起一个开发服务器，Zotero 会自动加载插件。看到菜单栏出现"茉莉花"相关选项，就算装好了。

第三步：快速验证

随便拖一篇中文 PDF 进 Zotero，右键附件，菜单里如果能找到"茉莉花抓取"，说明插件已经在正常工作了。整个过程比你想象中快得多。

四、第一次实战：把一篇空白 PDF 变成完整文献条目

装好插件后，最核心的操作来了。假设你刚下载了一篇知网论文，标题还带着一串数字乱码，别急，按下面三步走：

1. 把 PDF 拖入 Zotero，右键附件，选择茉莉花抓取 → 抓取期刊元数据；
2. 插件会以标题为检索词，去知网等数据库搜索，弹出一个任务窗口，列出多个候选结果；
3. 仔细比对期刊名、作者、年份，选中最匹配的那条，点击"确认"，元数据瞬间补全。

上图就是抓取结果的展示窗口。你会发现插件很"实在"——它不会自作主张替你选，而是把所有候选都摆出来，由你把关。多个结果怎么挑？优先看期刊名是否对得上，其次比对作者和年份，通常一眼就能锁定。

这里有个小诀窍：抓取的准确度高度依赖 PDF 的文件名。文件名越接近真实标题，搜索越精准；如果拖进来的 PDF 叫"download.pdf"，插件再聪明也猜不出它是谁，此时可以先把文件重命名再操作。

五、进阶玩法一：附件匹配，救回"下载失败"的 PDF

用 Zotero Connector 在浏览器里抓中文期刊时，元数据抓取成功、附件下载失败是最高频的翻车现场。以往你得手动去下载文件夹里翻 PDF，再拖进 Zotero 手动关联——现在这个步骤可以自动化。

操作路径：右键条目 →小工具 → 在下载文件夹中查找附件。插件会扫描你的下载目录，把文件名和条目标题做相似度打分（算法在 src/modules/attachments/localMatch.ts，默认相似度阈值 0.8，只取匹配度最高的前 3 个），命中后自动完成关联。

匹配成功后，插件对下载目录里的原文件有三种处理方式，按你的习惯选：

个人建议选"删除"——既然 Zotero 里已经存了一份，下载目录里再留一份纯属占地方。这个设置在偏好设置里随时可以改，初次使用时就定下来最省心。

六、进阶玩法二：把 PDF 大纲变成你的阅读地图

读那种几十页、带层级章节的长论文时，最痛苦的莫过于没有目录，只能一页页翻。Jasminum 在 PDF 阅读窗口的左侧边栏里集成了一套书签导航系统，帮你把 PDF 变成一本有目录的书。

打开 PDF 阅读窗口，点击左侧边栏的茉莉花书签按钮，大纲窗口就出现了：

顶部五个按钮，功能一目了然：展开全部书签、折叠全部书签、添加书签、删除书签、把书签保存到 PDF。注意最后那个按钮——默认情况下书签只以配置文件形式存在本地，点它才会真正写入 PDF 文件。

更高效的是快捷键，纯键盘操作非常跟手：

这套逻辑的实现在 src/modules/outline/outline.ts，支持多级层级，读书笔记、论文大纲、教材章节都能组织得井井有条。

七、让插件更懂你的几个设置

在 Zotero 的偏好设置里找到 Jasminum 面板，有几个参数值得花两分钟调一调：

• 元数据相似度阈值（默认 0.6）：调高意味着匹配更严格，如果你经常遇到抓错结果，可以往上调；
• 附件匹配相似度阈值（默认 0.8）与匹配数量（默认 3）：决定附件匹配的宽松程度；
• 下载目录：默认是你的系统下载文件夹，改了路径的话记得同步；
• 中文姓名拆分与合并：开启后能把"张三李四"这种连写姓名按规则拆开，也能把拆分后的姓名合并回去；
• 数据源选择：默认组合是 CNKI、万方、Yiigle，此外还支持 PubScholar、ChinaDOI，按你的使用习惯勾选即可（代码在 src/modules/services/）；
• 翻译器与引用样式自动更新：插件会从 Zotero 中文社区同步翻译器和样式文件，保持中文期刊抓取能力在线。

以上设置全部以extensions.jasminum前缀存储在配置里（见 addon/prefs.js），改坏了重置也方便。

八、避坑指南：常见问题速查

问：元数据抓取总是失败，怎么办？先检查网络能否正常访问知网；再看 PDF 文件名是否规范（别叫 "download.pdf"）；如果还不行，可以在偏好设置里调低元数据相似度阈值，让匹配更宽松。

问：附件匹配不准确？匹配逻辑本质是"文件名 vs 标题"的相似度比较。确保下载的文件名和文献标题一致，必要时调高匹配阈值，或手动把文件拖进 Zotero 关联。

问：PDF 大纲按钮没反应？确认你的 Zotero 版本较新（Jasminum 适配 Zotero 8 / 9 系列），并检查插件是否正常加载；若无效，在附加组件里禁用再启用一次插件。

问：身在海外的用户抓取知网有问题？知网对大陆与海外网络的访问策略不同，偏好设置里的相关选项（isMainlandChina）可以按你的网络环境切换。

九、写在最后：现在就去试试

Jasminum 的哲学很简单：把高频、重复、容易出错的动作交给插件，把判断留给用户。它不追求大而全，而是把"中文 PDF 元数据抓取""附件匹配""PDF 大纲导航"这三件事做到位——恰好是中文文献管理最痛的三个环节。

如果你是研究生、科研人员，或者任何需要大量处理中文文献的人，不妨现在就装一个，用一篇知网 PDF 试试这套流程。从空白条目到完整文献，从散落的下载文件到归位的附件，再到带目录的阅读体验，你会明显感觉到：中文文献管理，原来可以这么轻松。

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