Jasminum插件：中文文献管理的终极解决方案指南

在学术研究领域，Jasminum插件作为Zotero生态系统中专为中文文献管理设计的智能工具，彻底解决了知网文献元数据抓取和PDF附件管理的难题。这款免费插件通过简单直观的操作界面，为研究人员提供了完整的中文文献管理解决方案。

🎯 核心功能亮点

智能元数据自动抓取

Jasminum最强大的功能是自动从知网获取文献元数据。当您为PDF文献添加中文引用信息时，插件能够智能识别并填充作者、标题、期刊、出版日期等关键信息，大幅提升文献整理效率。

如上图所示，Jasminum会弹出任务窗口供您选择最匹配的文献来源。通过单选确认机制，确保引用信息的准确性，避免手动输入的错误和遗漏。

本地附件智能匹配

针对Zotero Connector抓取中文期刊时附件下载失败的问题，Jasminum开发了本地匹配功能。该功能能够自动在下载目录中查找匹配的附件文件，显著提升文献管理的成功率。

PDF文档导航增强

Jasminum在PDF阅读窗口左侧边栏中集成了强大的书签大纲功能。通过树形结构的层级化目录，您可以快速导航长文档的各个章节，支持多级折叠和视觉高亮，极大提升了阅读和研究的效率。

🚀 快速安装配置

环境要求准备

• Zotero 7或更高版本
• Node.js开发环境

一键部署步骤

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

💡 实用操作教程

文献元数据抓取流程

1. 在Zotero中添加中文PDF附件
2. 右键点击文献，选择"茉莉花抓取"功能
3. 在弹出的任务窗口中选择最匹配的文献来源
4. 点击确认完成元数据自动填充

附件管理最佳实践

建议启用"删除匹配成功的附件"选项，避免下载目录中积累过多重复文件，保持系统整洁有序。

🔧 进阶使用技巧

批量处理优化

Jasminum提供了稳定的并发机制，能够高效完成大量中文文献的元数据抓取和附件匹配任务。

自定义配置选项

您可以在插件设置中根据个人使用习惯调整各项参数，包括抓取超时时间、重试次数等，实现个性化配置。

📁 技术架构优势

Jasminum基于现代化的插件开发理念，充分利用Zotero ToolKit工具包，实现了模块化、可扩展的架构设计。核心模块包括：

• 服务模块：src/modules/services/cnki.ts - 知网数据抓取核心
• 附件模块：src/modules/attachments/localMatch.ts - 本地文件匹配
• 大纲模块：src/modules/outline/outline.ts - PDF文档导航

通过各模块的协同工作，Jasminum为用户提供了流畅的使用体验，成为中文文献管理不可或缺的专业工具。

无论是学术新手还是资深研究者，Jasminum都能为您的中文文献管理工作带来革命性的提升，让您专注于更重要的研究工作。