安装与升级
当前下载:0.2.0-preview.1,适用于 Zotero 10.0.x。源码、发布页 XPI 和校验文件均已公开,无需 GitHub 账号即可下载。
使用要求
- Zotero 10.0.x。Windows 已进行原生开发验证;macOS 和 Linux 的同等验收仍待完成。
- 需要处理的 PDF 附件已下载到本机。
- 提取 PDF 正文需要受支持的解析服务及其凭据;语义检索还需要受支持的嵌入服务。
安装
- 打开预览版发布页。
- 下载 zotero-knowledge-mcp.xpi。GitHub 的源码 ZIP、tar 压缩包不能作为插件安装。
- 在 Zotero 中打开工具 → 插件,点击齿轮菜单,选择从文件安装插件…,然后选择 XPI。
- 如果 Zotero 要求重启,请按提示操作。打开 Zotero 设置 → Knowledge MCP。
- 按第一篇文献继续操作。新安装默认关闭解析、模型服务和本地 MCP。
校验下载文件
从同一发布页下载 SHA256SUMS,将其中的 XPI 哈希与以下命令的输出比较:
Get-FileHash .\zotero-knowledge-mcp.xpi -Algorithm SHA256
macOS 使用 shasum -a 256 zotero-knowledge-mcp.xpi;Linux 使用 sha256sum zotero-knowledge-mcp.xpi。
安全升级
- 关闭 Zotero,在外部位置备份完整数据目录,包括
knowledgemcp/子目录。 - 阅读目标版本的发行说明,再按照相同步骤安装其 XPI。
- 检查知识库和已处理文献后,再决定何时清理备份。
预览版始终手动安装与升级。自动更新渠道仅提供已验证的正式版;Zotero 自身的自动更新设置控制是否安装可用的正式更新。尚无正式发布时,更新源保持为空。安装旧 XPI 不会降级插件数据库;旧版本可能拒绝较新的结构,恢复需要兼容的外部备份。
禁用或卸载插件会保留已存数据。重置或切换 Zotero 数据目录前,请阅读数据与隐私。