环境准备
在配置任一插件前,需满足以下条件:- 已安装 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+/」打开使用窗口
输入

输入

切换模型命令

选择自己要用的模型之后就可以使用了。\

翻译插件zotero-pdf-translate 配置
zotero-pdf-translate 提供 PDF 阅读过程中的实时翻译能力,支持划词翻译、整段翻译、双语对照阅读等模式。该插件原生支持多种翻译引擎。 下载链接:https://github.com/windingwind/zotero-pdf-translate/releases 编辑中找到设置(老版本在编辑中首选项)。找到翻译的设置界面接口地址填写:

工作流场景
科研工作者通常将两款插件协同使用,形成完整的 AI 辅助阅读闭环: 在文献初筛阶段,使用 zotero-gpt 对论文摘要进行结构化提炼,快速判断文献相关性。 在精读阶段,对 PDF 中的难点段落使用 zotero-pdf-translate 进行划词翻译,并使用 zotero-gpt 对关键方法论展开追问。 在笔记整理阶段,使用 zotero-gpt 基于选中文本生成结构化笔记或 Markdown 摘要,自动归档至 Zotero 的笔记系统。结合 3.x 版本的命令标签机制,可将常用的提炼、归纳、术语解释提示词固化为一键触发的标签,进一步缩短重复操作的时间成本。 整套工作流在同一 Zotero 主界面中完成,无需切换至外部浏览器或对话工具,也无需复制粘贴文献内容。常见问题
接口返回 404 Not Foundzotero-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 中已不承担插件安装职能,部分旧版教程描述的路径不再适用。
参考资源
- AIHubMix 官网:aihubmix.com
- Zotero 官网:zotero.org
- zotero-gpt 插件仓库:github.com/MuiseDestiny/zotero-gpt
- zotero-gpt Releases 页面:github.com/MuiseDestiny/zotero-gpt/releases
- zotero-pdf-translate 插件仓库:github.com/windingwind/zotero-pdf-translate