Jasminum插件配置文件详解：manifest.json与prefs.js深度解析

想要充分发挥Jasminum插件的强大功能，理解其配置文件是关键所在！作为一款优秀的Zotero中文元数据抓取插件，Jasminum通过manifest.json和prefs.js两个核心配置文件来管理插件行为和用户偏好设置。本文将为你提供完整的配置文件指南，帮助你深度掌握Jasminum插件的配置精髓。

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

🎯 manifest.json：插件身份证明

manifest.json文件位于addon/manifest.json，这是Zotero插件的标准配置文件，定义了插件的基本信息和兼容性要求。

核心配置项解析

插件基本信息：

• name: 插件名称，使用变量__addonName__动态定义
• version: 版本号，通过__buildVersion__动态设置
• description: 插件描述，说明插件的核心功能
• author: 作者信息，显示插件开发者

图标设置：

• 48: 48x48像素图标路径 addon/chrome/content/icons/icon@0.5x.png
• 96: 96x96像素图标路径 addon/chrome/content/icons/icon.png

Zotero兼容性：

• id: 插件唯一标识符
• strict_min_version: 最低兼容版本"6.999"
• strict_max_version: 最高兼容版本"8.."

⚙️ prefs.js：用户偏好设置

prefs.js文件位于addon/prefs.js，这是Jasminum插件的用户配置核心，包含了所有可自定义的功能选项。

基础工具配置

pref("firstRun", true);           // 首次运行标记
pref("translatorsMended", false); // 转换器修复状态
pref("autoSplitName", false);     // 自动拆分姓名
pref("splitEnName", false);       // 拆分英文姓名
pref("language", "zh");           // 默认语言设置

元数据抓取配置

核心抓取设置：

• autoUpdateMetadata: 自动更新元数据开关
• namePattern: 文件名模式模板"{%t}_{%g}"
• namePatternCustom: 自定义文件名模式
• metadataSource: 元数据来源"CNKI"
• cnkiAttachmentCookie: 知网附件Cookie配置

PDF匹配功能

本地附件匹配：

• pdfMatchFolder: PDF匹配文件夹路径
• actionAfterAttachmentImport: 导入后操作"backup"
• similarityThreshold: 相似度阈值"0.8"
• topMatchCount: 最大匹配数量3

转换器更新配置

自动更新机制：

• autoUpdateTranslators: 自动更新转换器开关
• translatorUpdateTime: 转换器更新时间戳
• translatorSource: 转换器来源设置

书签功能配置

PDF书签管理：

• enableBookmark: 书签功能开关
• newNodeAsChild: 新节点作为子节点
• disableZoteroOutline: 禁用Zotero原生大纲

🔧 配置文件使用技巧

个性化设置建议

1. 文件名模板定制：根据个人习惯调整namePattern，实现智能文件命名

2. 相似度阈值优化：根据实际匹配效果调整similarityThreshold，提高附件匹配准确率

3. 自动更新配置：开启autoUpdateMetadata和autoUpdateTranslators，享受持续优化体验

💡 高级配置提示

通过合理配置这些参数，你可以：

• 提升元数据抓取效率：优化CNKI访问设置
• 增强附件匹配精度：调整相似度参数
• 个性化工作流程：定制文件名和操作行为

掌握Jasminum插件的配置文件，就等于掌握了中文文献管理的核心工具！通过深度理解manifest.json和prefs.js的每一个配置项，你将能够充分发挥这款插件的全部潜力，打造高效的中文文献管理工作流。

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