> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zotero

> 在 Zotero 中接入 AIHubMix：文献管理工具通过插件用单个 API key 调用模型，用于文献总结与问答。

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

## 环境准备

在配置任一插件前，需满足以下条件：

* 已安装 Zotero 7 或 Zotero 6（zotero-gpt v3.1.4 同时支持两个主版本，推荐 Zotero 7）
* 已在 [aihubmix.com](http://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](https://github.com/MuiseDestiny/zotero-gpt/releases)

打开 Zotero，进入 `工具` → `附加组件`，将下载完成的 `.xpi` 文件拖入插件管理窗口，按照提示完成安装并重启 Zotero。

下载链接：[https://github.com/MuiseDestiny/zotero-gpt/releases](https://github.com/MuiseDestiny/zotero-gpt/releases)

安装好插件后在编辑中找到设置（老版本在编辑中首选项）。找到GPT的设置界面 <img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero9.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=55f68c34354cf157fd327cc116c74b2d" alt="图片" width="974" height="625" data-path="public/cn/zotero9.png" /> 按照如图所示配置 Base API，并输入[API key](https://aihubmix.com/token)

或者使用以下命令设置

首选使用「ctrl＋/」打开使用窗口\
<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero1.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=3796e5588cb519ab166fd8af25b8066e" alt="图片" width="531" height="227" data-path="public/cn/zotero1.png" />\
输入

```text theme={null}
/api https://aihubmix.com
```

并回车\
<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero2.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=acb75cc3b366a622bd085df51c27e9a0" alt="图片" width="480" height="210" data-path="public/cn/zotero2.png" /> <img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero3.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=54a91f2ae13458edaeb1730665b32b89" alt="图片" width="493" height="278" data-path="public/cn/zotero3.png" />\
输入

```text theme={null}
/secretKey ＋ 密钥 sk-***
```

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero4.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=afb5d471fc2f717af021a32e3b968cd2" alt="图片" width="488" height="277" data-path="public/cn/zotero4.png" /> <img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero8.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=857ee81d00dda3bd5b87907c709433b9" alt="图片" width="599" height="409" data-path="public/cn/zotero8.png" />\
切换模型命令

```text theme={null}
/model gpt-3.5-turbo-0125 
```

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero6.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=ebd23057d56e11fcd7a46bb6a255e68d" alt="图片" width="487" height="278" data-path="public/cn/zotero6.png" />\
选择自己要用的模型之后就可以使用了。\\

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero7.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=13751c79a9996772cf1be2297b67eb0f" alt="图片" width="503" height="376" data-path="public/cn/zotero7.png" />

## 翻译插件zotero-pdf-translate 配置

zotero-pdf-translate 提供 PDF 阅读过程中的实时翻译能力，支持划词翻译、整段翻译、双语对照阅读等模式。该插件原生支持多种翻译引擎。

下载链接：[https://github.com/windingwind/zotero-pdf-translate/releases](https://github.com/windingwind/zotero-pdf-translate/releases)

编辑中找到设置（老版本在编辑中首选项）。找到翻译的设置界面\
接口地址填写:

```text theme={null}
https://aihubmix.com/v1/chat/completions
```

不用管状态是否显示可用 填上之后就可以了。\\

<img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/cn/zotero5.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=6fd926a7dcf239affdd501f299936e27" alt="图片" width="1002" height="790" data-path="public/cn/zotero5.png" />

## 工作流场景

科研工作者通常将两款插件协同使用，形成完整的 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 中已不承担插件安装职能，部分旧版教程描述的路径不再适用。

***

## 参考资源

* AIHubMix 官网：[aihubmix.com](https://aihubmix.com/)
* Zotero 官网：[zotero.org](https://www.zotero.org/)
* zotero-gpt 插件仓库：[github.com/MuiseDestiny/zotero-gpt](https://github.com/MuiseDestiny/zotero-gpt)
* zotero-gpt Releases 页面：[github.com/MuiseDestiny/zotero-gpt/releases](https://github.com/MuiseDestiny/zotero-gpt/releases)
* zotero-pdf-translate 插件仓库：[github.com/windingwind/zotero-pdf-translate](https://github.com/windingwind/zotero-pdf-translate)

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