跳转到主要内容
本文档基于 zotero-gpt v3.1.4 与 zotero-pdf-translate 最新发布版本,介绍两款插件分别接入 AIHubMix 的完整配置流程。

环境准备

在配置任一插件前,需满足以下条件:
  • 已安装 Zotero 7 或 Zotero 6(zotero-gpt v3.1.4 同时支持两个主版本,推荐 Zotero 7)
  • 已在 aihubmix.com 完成账号注册,并在控制台创建 API 凭据(以 sk- 开头)

zotero-gpt v3.1.4 配置

zotero-gpt 提供基于文献内容的对话式阅读体验,支持选中文本提问、文献摘要生成、AI 标注、AI 大纲生成等高频操作。3.x 版本在保留传统对话能力的基础上,引入了命令标签(Command Tag)体系,使用户可将自定义提示词与 Zotero API 代码片段组合为一键触发的工作单元。

插件安装

访问插件项目的 GitHub Releases 页面,下载最新版本的 .xpi 文件: https://github.com/MuiseDestiny/zotero-gpt/releases 打开 Zotero,进入 工具附加组件,将下载完成的 .xpi 文件拖入插件管理窗口,按照提示完成安装并重启 Zotero。 下载链接:https://github.com/MuiseDestiny/zotero-gpt/releases 安装好插件后在编辑中找到设置(老版本在编辑中首选项)。找到GPT的设置界面 图片 按照如图所示配置 Base API,并输入API key 或者使用以下命令设置 首选使用「ctrl+/」打开使用窗口
图片
输入
/api https://aihubmix.com
并回车
图片 图片
输入
/secretKey + 密钥 sk-***
图片 图片
切换模型命令
/model gpt-3.5-turbo-0125 
图片
选择自己要用的模型之后就可以使用了。\
图片

翻译插件zotero-pdf-translate 配置

zotero-pdf-translate 提供 PDF 阅读过程中的实时翻译能力,支持划词翻译、整段翻译、双语对照阅读等模式。该插件原生支持多种翻译引擎。 下载链接:https://github.com/windingwind/zotero-pdf-translate/releases 编辑中找到设置(老版本在编辑中首选项)。找到翻译的设置界面
接口地址填写:
https://aihubmix.com/v1/chat/completions
不用管状态是否显示可用 填上之后就可以了。\ 图片

工作流场景

科研工作者通常将两款插件协同使用,形成完整的 AI 辅助阅读闭环: 在文献初筛阶段,使用 zotero-gpt 对论文摘要进行结构化提炼,快速判断文献相关性。 在精读阶段,对 PDF 中的难点段落使用 zotero-pdf-translate 进行划词翻译,并使用 zotero-gpt 对关键方法论展开追问。 在笔记整理阶段,使用 zotero-gpt 基于选中文本生成结构化笔记或 Markdown 摘要,自动归档至 Zotero 的笔记系统。结合 3.x 版本的命令标签机制,可将常用的提炼、归纳、术语解释提示词固化为一键触发的标签,进一步缩短重复操作的时间成本。 整套工作流在同一 Zotero 主界面中完成,无需切换至外部浏览器或对话工具,也无需复制粘贴文献内容。

常见问题

接口返回 404 Not Found
zotero-gpt 中 API URL 字段应填入 https://aihubmix.com/v1。zotero-pdf-translate 中接口地址应填入完整路径 https://aihubmix.com/v1/chat/completions。两者填写规则不同,混用是常见的配置错误。
旧版斜杠命令(/api、/secretKey、/model)失效
该组命令为 zotero-gpt 2.x 及更早版本的快速配置方式,在 3.x 版本中已不再作为官方推荐做法记录。如使用 3.x 版本,请通过插件设置面板完成 API URL、API Key 与 Model 字段的填写。
zotero-pdf-translate 状态栏显示”未知”
该状态显示并不代表配置失败,可直接进行实际翻译验证。若翻译可正常返回结果,则配置已生效。
zotero-gpt 安装路径找不到 编辑 → 设置
3.x 版本的安装入口为 工具 → 附加组件编辑 → 设置 在 Zotero 7 中已不承担插件安装职能,部分旧版教程描述的路径不再适用。

参考资源

最新更新日期:2026年5月13日