【MN插件】Zotero Connector

[Museday (沈士超)]

Marginnote是一个非常适合读论文、整理文献中的关系和思路的软件。
既然说到读论文，怎么能没有Zotero呢？

Zotero Connector可以实现从Zotero到MN再到Zotero的数据流转，同时有诸多提高阅读和整理效率的生活质量改善功能，鼓励大家把Zotero和Marginnote的功能双双实现最大化利用。

v1.0.0更新日志

添加使用说明

v1.0.0-rc1~rc6更新日志

v1.0.0-rc6更新日志：

1. 附件信息存储到卡片，不再依赖本地存储，可以实现跨设备同步
   2.优化加载速度
   3.优化加载显示

1.0.0-rc5版本更新：

1. 修复文献条目附件未加载完成时创建文献卡片会丢失信息的问题
2. 选中卡片时会出现工具条，避免markdown链接失效时无法操作
3. 如果文献导入过pdf，则还会在工具条中显示用于快速定位文献的眼睛按钮

1.0.0-rc4版本更新：
修复推送笔记时的错误提示

1.0.0-rc3版本更新：

1. 文献可以按添加时间从新到旧、从旧到新进行排序
2. 调整文献库工具按钮栏布局

1.0.0-rc2版本更新：

1. 实现库页面中的批量导入功能，支持选择多个条目进行批量操作
2. 添加列表项的选择状态样式和交互逻辑
3. 增加清空选择按钮和批量选项菜单
4. 年份筛选器添加"不限"选项

1.0.0-rc1版本更新：

1. 添加排序、筛选功能
2. 更新新手引导

现已开源至Github：https://github.com/Temsys-Shen/zotero-marginnote
插件下载：zotero-connector-v1.0.0.mnaddon (93.0 KB)

插件截图：

历史更新日志

v1.0.0-beta2更新日志

更新版本至beta2。

新功能

字段显示增强：新增大量字段支持，可切换中文和英文字段显示
字段模板配置升级：改为拖拽配置方式，操作更直观
收藏夹功能：添加收藏夹功能，支持批量导入
标注导入：实现从Zotero导入标注功能
数学公式支持：导出功能现在支持数学公式
标签显示：显示更多标签信息
文件导入：挂载zotero文件夹即可一键导入文件

界面与用户体验优化

侧边栏优化：修复tags面板折叠异常问题
拖拽体验改进：收藏夹拖拽浮动提示改为鼠标/触控位置上方
面板布局优化：优化文献库调整面板布局手感，支持移动端
图标更新：修改下载PDF的图标
新手引导更新：更新新手引导内容
配置页面更新

功能改进

API整合：合并Local API与Cloud API，使用Cloud API的同时打开Zotero可以获得更快的查询速度
侧边栏布局：实现新的侧边栏布局，包含集合树、可过滤标签和可调整/切换功能

问题修复

列表渲染：修复列表渲染问题
标签添加：修复tag添加bug
PDF命名：修复下载PDF命名问题
Local API：修复Local API无法查看文档库文档的问题
空标题：修复空标题问题
笔记推送：修复推送笔记问题

其他更新

创建卡片的位置策略优化；性能优化

v1.0.0-beta更新日志

插件默认宽度调整为400

v1.0.0-alpha更新日志

本次版本为1.0.0Alpha，在1.0.0正式发布前不会有较大的功能更新

新增功能：

1. 新增独立Settings页面，顶部切换改为Library/Selected Cards/Settings三Tab结构.
2. 新增字段模板系统：支持固定字段模板自定义，并支持自定义字段的新增、删除、上下排序与持久化保存。
3. 新增首次使用新手引导弹窗，并支持在设置页手动重新打开引导。
4. 新增Selected页面Refresh刷新按钮，并为无数据状态增加按钮禁用逻辑。
5. 新增LocalAPI模式提示文案，明确需在Zotero开启本机应用通信选项。

优化：

1. 配置注入与读取增强：支持更多配置项注入，并补充默认值与容错归一化逻辑。
2. 页面交互统一优化：Library/Selection/Settings三页导航逻辑统一，优化导航逻辑。
3. 国际化扩充：新增大量字段模板、引导、设置相关中英文文案。

0.7.0更新日志

新增功能：

1. 支持包含中文简体和英文的i18n

0.6.1更新日志

修复：

1. cloud api下不能创建反向链接的问题已经修复

0.6.0更新日志

新增功能：

1. 文献卡片笔记推送到Zotero：新增从MarginNote文献卡导出笔记树并同步到Zotero子笔记的能力，支持按层级展开内容、保留注释文本，并写入同步元数据标记。
2. 单条与批量推送入口：在选中文献面板新增Push Note和Push All Notes操作，可对单篇文献或当前选中列表一键推送。

修复：

1. 同步冲突与限流处理：完善Cloud API重试与冲突恢复逻辑，覆盖429限流退避、409/412版本冲突重拉后重试，降低同步失败率。
2. 失败反馈与稳定性提升：补齐参数校验与错误提示，并精简噪声日志，提升交互稳定性。

0.5.0更新日志

新增功能：

1. Cloud API可以导入PDF

0.4.1更新日志

新增功能:

1. API KEY可以点击小眼睛显示/隐藏

修复：

1. 保存API KEY时保存错误的文本
2. 无法加载插件

0.4.0更新日志

新增功能：

1. 窗口快捷缩放：增加双击标题栏或大小调整手柄的行为，支持在快捷尺寸与最大化之间一键切换。
2. 自动聚焦功能：在 Web 视图中点击 Zotero 条目时，可快捷定位并在思维导图中聚焦对应的 MarginNote 笔记。创建卡片后，视图将自动聚焦到新生成的笔记，提升整理效率。
   4.UI 处理逻辑重构：网页视图 UI 完全重构，引入模块化架构，优化了加载流程与交互响应。设置输入框增加视觉反馈，配置保存成功时会有即时状态提示。

修复：

1. 窗口边界限制（修复“赛博灯泡”）：优化了窗口拖拽与缩放逻辑，确保窗口始终保持在 MarginNote 的界面可视范围内，防止溢出。
2. 作者姓名兼容性：修复无法获取 Zotero 合并姓名（如中文名、机构名）的问题，现在能正确解析并显示所有类型的作者信息，避免出现“Unknown”。
3. 稳定性提升：改进了网络异常处理机制，增加了详细的错误反馈诊断。

0.3.1更新日志

新增功能：

• 增加双击标题栏和大小调整手柄的行为，可以快捷变换大小

修复

• 修复赛博灯泡，现在窗口被限制在mn的界面范围内

0.3.0更新日志

新增功能：

• 按 tag/collection 搜索：支持按 Zotero 的 tag 或 collection 进行检索。

• 在 Zotero 中选中已选卡片：在 Zotero 中可同步选中当前已选择的卡片。

修复

• 卡片模板：修复卡片模板逻辑，避免将颜色当作标签处理。

[tjia]

导入之后没提示，，不知道咋配置欸

[Museday (沈士超)]

如果用的是Local API，需要在zotero里的高级-允许此计算机上的其他应用程序与 Zotero 通讯。
现在点击加号是只能在脑图里创建卡片，点击链接能跳转，还没有其他功能

[whah (wuhah)]

导入后显示本插件不支持当前marginnote 版本，请先升级marginnote 是为啥呀，我是老版本的marginnote 4 ，可以正常导入其他插件

[linlifei (八级大狂风)]

试了一下，有几个问题比较恼火：

1. 配置似乎没有用原生的方式保存？已经丢了一次配置了
2. 配置保存成功的时候没有提示，好像有时候没真的把配置保存下来
3. 添加卡片的时候，经常看不到卡片到底创建到哪里去了
4. 卡片的富文本信息是通过markdown里的html来实现的，不太建议用px单位，容易导致卡片上太小但卡片编辑器视图又太大的情况，建议用相对单位

另外如果能接受基于MNUtils提供的API来开发的话，我们可以考虑合作一下？（可能通过github pr的方式）有些细节性的东西从头造轮子会有点浪费时间。

[Museday (沈士超)]

谜底就在谜面上，可以手动更改一下最小支持版本，但你那个版本后续更新不一定会继续支持哈

[Museday (沈士超)]

感谢你的使用和建议，在1.0版本之前不建议用于真实生产环境。
关于保存，我在后续使用发现确实会丢配置，还得用原生，1.0版本前我会改的。添加卡片的时候我应该加一个定位到卡片的设置，这样就知道卡片在哪里了。卡片样式现在也比较简陋，后续我会用相对单位，并压缩html的体积。
MNUtils确实很好，但是缺少一个能检索的文档，draft的性能和交互方式实在太反人类了，也不方便ai编程自动查阅。这个插件我打算会一直用原生，也有避开MNUtils的命名，至少不会冲突。后续我有个MNRails的项目会考虑基于MNUtils，简化开发流程，到时候再和你沟通哈。
总之非常感谢

[Museday (沈士超)]

1.0.0-alpha版本已发布，说明文档正在 快加编 赶来中～
欢迎大家使用以及报告bug

[Qsuni]

在mac打开插件右下角的调整窗口大小的按钮会卡到界面以外

[Museday (沈士超)]

收到，这就调整默认大小。也可以通过双击标题栏来避免赛博灯泡

[tjia]

我觉得很赞！稍微花点时间弄一下，就能给以后省不少时间。使用下来的话，提一点建议和小bug吧算是？我是所有操作都是基于 ipad端mn4+ipad端zotero+win端zotero：
1、文献库这里，"全部"这个选项应该是读取的“我的文库”下面的所有分类，能不能排个序呀（目前似乎我还没看出来什么规律），我的分类很多，有点难找。（当然其实可以直接搜索标题吧，小建议吧算是）
2、作为文献整理，能否将zotero中创建的那个注释，给导入到mn4（因为我一般不会所有文献都丢给mn4，但是一些文献可能某些段落我觉得还不错，我在zotero会把那些地方标记出来，我希望这些注释可以直接导入mn4，我就没必要在mn4中把整个文献下载下来）
3、卡片设置那能否加入一个markdown或者什么语法，把作者，年份，以及其他自定义字段分条列出，比如·作者：XXX ·年份：XXX。不然东西多了看着有点密集有点乱
BUG:
1、从zotero导入文献这个现在是不是还有bug，文件夹是创建了一个zoterodownload，但是文献下载不下来。我看你似乎也标注了一下
2、配置api后，好像没啥反馈，我当时也不知道是连接中呢还是怎么样，一开始那一会我都不敢乱点。然后我去文献库搜索发现文献出来了我才知道弄好了
3、mn4中的笔记虽然可以同步到其他zotero，但是zotero里面显示上有点不太好看，有点凌乱

[tjia]

太赞了这个插件，搞得我想弄个mac了 ，win端调不出mn4。

[Museday (沈士超)]

非常感谢你的反馈，我已经记下来啦！之后的版本里一定会一一实现的

[ProudBenzene]

大佬好！插件真的好强大，但是个人感觉还有很多功能也值得探索一下，目前的使用意见：

1. 希望可以支持对导入元数据的进一步正则处理——例如在Zotero中通过插件翻译的摘要一般和其他信息放在一起，需要通过正则提纯
2. 希望可以一键导入当前文献在Zotero中的所有annotation到脑图并自动上色，MarginNote的脑图可以很大程度上弥补Zotero中侧边栏注释笔记只能线性记录笔记的问题，导入到MarginNote中组织排列成网状结构会是很好的整理思路的过程，要是没有这个特性个人会感觉会非常可惜
3. 不知能否实现通过WebDAV把Zotero中的文献PDF同步到MarginNote中，就算不能通过MarginNote对其进行笔记标注，仅仅只能阅读在Zotero中对pdf做的批注与脑图进行对照也很不错

感谢大佬开发出这款插件！！

[Museday (沈士超)]

内测版本更新：
v1.0.0-i03221827：

1. 修复导出到zotero的时候如果有tag（#开头的文本就算）的错误显示
2. 支持markdown的大部分语法，暂时还不能很好地支持脚注、数学公式、任务列表、代码块的渲染
3. 推送笔记时有明显的等待和成功提示
4. 优化设置界面

欢迎大家加入内测群获取最新的版本更新

[Museday (沈士超)]

插件已更新至beta2，下个版本再加入筛选排序后即将进入rc阶段～

[Museday (沈士超)]

1.0版本发布啦！