跳转至

安装与升级

下载 XPI 插件 SHA-256 校验文件

发行说明与全部版本

当前下载:0.2.0-preview.1,适用于 Zotero 10.0.x。源码、发布页 XPI 和校验文件均已公开,无需 GitHub 账号即可下载。

使用要求

  • Zotero 10.0.x。Windows 已进行原生开发验证;macOS 和 Linux 的同等验收仍待完成。
  • 需要处理的 PDF 附件已下载到本机。
  • 提取 PDF 正文需要受支持的解析服务及其凭据;语义检索还需要受支持的嵌入服务。

安装

  1. 打开预览版发布页。
  2. 下载 zotero-knowledge-mcp.xpi。GitHub 的源码 ZIP、tar 压缩包不能作为插件安装。
  3. 在 Zotero 中打开工具 → 插件,点击齿轮菜单,选择从文件安装插件…,然后选择 XPI。
  4. 如果 Zotero 要求重启,请按提示操作。打开 Zotero 设置 → Knowledge MCP。
  5. 按第一篇文献继续操作。新安装默认关闭解析、模型服务和本地 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。

安全升级

  1. 关闭 Zotero,在外部位置备份完整数据目录,包括 knowledgemcp/ 子目录。
  2. 阅读目标版本的发行说明,再按照相同步骤安装其 XPI。
  3. 检查知识库和已处理文献后,再决定何时清理备份。

预览版始终手动安装与升级。自动更新渠道仅提供已验证的正式版;Zotero 自身的自动更新设置控制是否安装可用的正式更新。尚无正式发布时,更新源保持为空。安装旧 XPI 不会降级插件数据库;旧版本可能拒绝较新的结构,恢复需要兼容的外部备份。

禁用或卸载插件会保留已存数据。重置或切换 Zotero 数据目录前,请阅读数据与隐私。