最近做了一个 Zotero 插件 Mktero ，想分享出来找一些真实用户测试。
项目地址：
https://github.com/tenglvjun/mktero
安装包：
https://github.com/tenglvjun/mktero/releases/latest
为什么做这个
我平时在 Zotero 里读论文时，经常遇到多栏排版、公式、表格和图片混在一起，窗口缩小时阅读体验不太好。
所以做了 Mktero：把 Zotero 中的本地 PDF 交给 MinerU 解析，再将返回的 Markdown 、公式、表格和图片放到一个新的 Zotero 标签页中阅读。
它不是要替代原始 PDF ，而是提供一个更适合连续阅读和内容浏览的视图。需要核对版式时，仍然可以随时返回 PDF 。
目前支持
- Zotero 7 、8 和 9
- 从 PDF 阅读器工具栏或文库右键菜单打开
- Markdown 重排阅读
- 公式、表格、图片和代码块渲染
- 自动生成文章目录
- 引用、图表悬停预览和点击跳转
- 图片全屏预览、缩放和拖动
- 显示已有的 Zotero PDF 高亮和下划线
- 从 Markdown 划词创建高亮或笔记
- 将能够可靠定位的标注同步回 Zotero PDF
- 缓存 Markdown 和图片，重复打开时不再上传
- 恢复尚未完成的 MinerU 任务，避免重复上传 PDF
- 英文和简体中文界面
安装和使用
- 从 GitHub Releases 下载
mktero-<version>.xpi - 在 Zotero 中打开“工具 -> 插件”
- 点击右上角齿轮，选择
Install Add-on From File... - 安装后进入“设置 -> Mktero”
- 配置 MinerU API Token
- 打开 PDF ，点击阅读器工具栏中的文件图标
MinerU Token 可以在这里获取：
https://mineru.net/apiManage/token
当前版本是 v0.2.3 。
隐私说明
缓存未命中时，Mktero 会把完整 PDF 上传到 MinerU 解析，因此不建议处理不适合上传第三方服务的敏感或保密文件。
MinerU Token 、转换后的 Markdown 和图片缓存在本地 Zotero 配置目录中，目前都没有加密。
Zotero 标注不会发送给 MinerU ，也不会放入 Markdown 缓存。
更完整的隐私和缓存说明在 README 中。
当前限制
- 只支持已经下载到本机的 PDF 附件
- Markdown 文档本身是只读视图
- OCR 和版面解析质量取决于 MinerU
- PDF 文本层与 MinerU 结果差异较大时，部分标注可能无法匹配
- 暂时不显示图片、区域、手写和独立便签类 PDF 标注
- 文件大小、页数和额度限制由 MinerU 决定
技术实现
插件使用原生 JavaScript 和 ES Modules 开发，通过 esbuild 打包为适用于 Firefox 115/Zotero 环境的 IIFE 。
Markdown 阅读器基于 CodeMirror 6 ，公式使用 KaTeX 渲染。插件包含 Markdown 安全处理、结果压缩包路径检查、资源大小限制、本地缓存以及 Zotero 生命周期清理。
项目采用 MIT License 。
想收集的反馈
目前最想确认的不是继续堆功能，而是首次使用流程是否顺畅：
- XPI 是否能正常安装
- MinerU Token 是否容易配置
- 第一次转换是否能成功
- 哪类 PDF 的解析效果不好
- 公式、表格、图片和引用的阅读体验 -
Select Language