ETHEREAL PRO加入 Pro，解锁 GPT Pro 完整功能购买后完成验证，即可使用全部 Pro 功能。

1 写在之前

Zotero GPT Pro又名Aweseome GPT Pro，是Zotero的一个AI插件。他的主要功能如下。

加粗部分为Pro功能

AI接入方式： API接入、联动网页接入

五大面板： 浮窗、PDF侧边栏、笔记侧边栏、PDF阅读器浮窗、独立窗口（开发中）

AI应用：文献鸟瞰、AI大纲、AI标注、AI填充笔记

这些名词晦涩难懂，没关系，下面文档将逐个介绍。我会先介绍如何安装插件并接入AI能力，然后介绍这些面板如何使用，最后是进阶的AI应用。

2 开始使用

2.1 安装插件

请参考https://guide.muisedestiny.xyz/

2.2 AI接入

如果插件是一个手机，那么接入AI就相当于接入网络，一个手机是无法上网的，你需要安装流量卡或者链接wifi。同理，只安装插件是无法AI对话的，需要配置API或网页联动。在配置之前，先打开设置界面，安装上插件之后，windows顶栏：编辑-设置；Mac顶栏：Zotero-设置，即可打开设置界面。

2.2.1 配置赠送的API

先介绍最简单的API接入，购买Pro插件后，你会获得一个供测试使用的API，你可以直接配置它。

测试API配置步骤：1. 删除图1API Key；2. 点击Help。测试API仅支持deepseek-v3，无法更换模型，不推荐长期使用。每天会限制额度。

2.2.2 API商店一键配置

API商店为Garden插件提供的服务，本质上是一个类似中转站平台，如果你有自己长期使用的中转站也可以参考2.2.3手动配置。

如果你想配置其他模型，比如GPT的，也很简单，请点击图1 API Store，然后等待安装完成注册登陆，再根据教程自动接入大模型- Garden 插件的2. 插件使用进行配置注入配置即可。注入配置后，请重启Zotero，就可以在图1左侧配置列表看到Magic开头的配置，点击选中后即可使用。

2.2.3 配置其他AI供应商

如果你在使用官方API或其他中转站，配置就稍复杂。

以硅基流动为例：

打开硅基流动官网注册登陆；
打开实名认证实名认证；
见下图2，新建密钥（后称Key），然后根据图3点击密钥进行复制；
打开插件设置先配置对话模型，如图4，Base URl填写https://api.siliconflow.cn，不要勾选Full Url，密钥粘贴步骤3获取的Key，模型点击输入框右侧按钮进行选择，我选择的是zai-org/GLM-5.3；
根据图5切换到向量模型API填写https://api.siliconflow.cn/v1/embeddings，密钥粘贴步骤3的Key，模型填写BAAI/bge-m3；
最后点击Test，如图5显示代表配置成功；
最后可选步骤：点击+保存当前配置（图6）进行保存；

2.2.4 配置网页联动

刚刚说了，插件就像手机，手机可以连接Wifi，插件有类似机制吗？有，那就是网页联动。除插件部分需要并非的功能外，其余功能都可以使用网页联动。

下面我向你介绍网页联动的配置，它同样复杂，但是一旦熟练使用，就爱不释手。

根据图1打开扩展文件夹。然后打开Edge 或 Chrome浏览器，二选一。

打开浏览器，Chrome 输入chrome://extensions/，Edge 输入edge://extensions/，回车，并按图2开启开发者模式。

两个窗口都打开后，如图3，将这个文件夹，拖入浏览器打开页面，即可完成安装。

然后打开Zotero和豆包进行测试（请开启Zotero，然后用你配置联动的浏览器打开豆包），按照图4，找到安装的扩展，点击固定。根据图5，点击扩展图标，再点击连接。

回到Zotero，按Ctrl + / 快捷键或点击图6中的工具栏按钮，打开浮窗面板，即可看到联动状态。设置界面也会同步显示（图7），网页中的回答见图8。此时问答就通过你的网页AI，不消耗API额度。

那么现在你可以打开你想联动的网页AI进行测试了。你可以直接打开你想联动的网页，比如ChatGPT，打开后根据图5进行连接即可。如果你打开了好几个AI网站，也可通过图6中的模型选择位置进行切换。

2.3 面板介绍

2.3.1 浮窗面板

你在任何界面都可以通过快捷键ctrl+/，唤醒这个界面，这个界面适合快问快答，用完就消失。下图展示了它的基本操作。比如按住拖动改变位置，退出界面。

此界面逻辑是，输入问题 + 底部命令标签（负责携带更多上下文，内部可用js获取变量）=> AI => 回答。所以你直接输入问题回车，AI是不知道你选中了哪一篇论文的。输入问题（有些命令标签不需要输入问题，可直接点击使用，比如Translate）后必须搭配底部命令标签使用。下面截图几个案例：

这个面板，你只需要学会使用AskPDF即可，他可以直接对当前PDF或者你选中的多篇PDF进行提问，使用方法是：选中文献（如果是阅读界面，无需选中，默认对阅读PDF提问），输入问题，点击AskPDF Full Text，等待回答。其他命令标签无需了解。如果感兴趣，可以右键标签进入编辑，把里面文字发给任意一AI，问他这个干什么用的，AI会详细回答你。

打开一篇PDF，根据图1、图2即可打开PDF侧边栏。

图3清晰展示了PDF侧边栏的设计逻辑，他不是一堆按钮的繁杂罗列，也不是浮窗面板那种极简。而是介于简洁和易用之间的平衡。

头部（图4）和问答区（见图5）是很常见的设计不做赘述，下面我将重点介绍输入区。PDF侧边栏顾名思义它是和阅读的PDF绑定的，但绑定什么是由你决定的，根据不同使用习惯，设计了下面几种绑定（图6）：

对话模式你可以根据使用习惯进行选择。但是此时，你可能有这样一个需求，我每次打开PDF都希望AI能根据我编写的提示词进行先回答一遍，或者我每看到一页，都想让AI对这一页进行总结，那每次都要手动切换对话模式然后手动输入提示词发送吗？不，快捷命令可以实现这个需求。

什么是快捷命令？快捷命令 = 携带的上下文类型 + 提示词，如图7，点击总结本页后，本页文本+提示词 => AI => 回答。

见图7，看起来很复杂，但大部分人用不到，内置的快捷命令就够用了。

如果你想要自己定义这些快捷命令请继续往下看。首先快捷命令有哪些怎么编辑，在设置-Prompts里，如图7左侧设置面板。你可以看到prompts表格里和快捷命令弹出菜单里是有对应关系的，比如总结本页，截图翻译。如果想编辑内部提示词，双击对应的提示词即可。如果要完全新建，那就点击底部Add，然后可以看到图7最右侧窗口。有三个需要填写的项目：1. 提示词名字 2. 提示词携带上下文类型 3. 具体提示词。看你想往哪个板块创建新的提示词选择对应的类型即可。图8展示欢迎界面中的提示词按钮。

下表是类型的详解：

Type	输入内容	出现在	备注
abstractPagesText	PDF前两页文本	欢迎界面命令	在一篇PDF刚打开时候，会出现在欢迎界面的按钮中。见图9。
text	你选中的PDF文本	选中文本命令	在你选中PDF文本后。
pageText	你正在阅读的PDF的那一页文本	侧边栏命令
pagesText	PDF从某页到某页的全部文本	侧边栏命令	当你点击该类命令后，侧边栏会询问你从多少页到多少页。
pageImage	你正在阅读的PDF的那一页截图	侧边栏命令	当页面图片较多，可以用它来解释本页图片，你需要联动支持读图的网页，或用gpt-4这样的支持读图的模型才可以正常使用，注意deepseek并不支持读图。
fullText	PDF全部页文本	侧边栏命令	将消耗大量Token，建议联动状态下，上传附件后使用。
quickFill	将输入内容直接填充到侧边栏输入框	侧边栏命令	它不携带任何其它信息，只是简单的将预先编辑的文本写入侧边栏输入框。
noteText	PDF全部页文本+笔记模版HTML格式文本	笔记填充提示词+笔记侧边栏命令	后面会讲。

笔记侧边栏比较简单，因为无非就是处理输入（选中的文本）=> 替换选中文本 / 在光标后插入AI回答。

打开一篇PDF，选中一段文字、标注。就可以快速针对选中文本进行翻译、解释等。

如想添加其他提示词到这里，参考PDF侧边栏的图7，点击Add选择text类型。添加后重启Zotero。

如果你想问过留痕，可以点击图3中的按钮改为标注并生成评论，那么点击回答后，就会创建标注，将AI回答写入标注评论。

2.3.5 独立窗口

正在开发中...

Agent、知识库、AI动作等等

2.4 AI应用

2.4.1 文献鸟瞰

所有AI应用都可以针对单篇PDF生成也可以多篇生成，多篇不支持联动网页，AI大纲不支持联动网页

在使用该功能前，请 （1） 确保你的电脑安装了Obsidian软件（安装教程）， （2） 并打开软件- （3） 配置工作目录（如上图1）- （4） 成功新建一个md文档（图2）。

它有两个入口，图3是打开PDF后快捷命令里的入口，图4为主界面右键菜单入口（可批量生成）。

在任意入口点击后等待生成，生成后可自动跳转Obsidian软件。图5为批量生成界面，点击打开鸟瞰可自动跳转至Obsidian查看鸟瞰结果。鸟瞰里有跳转按钮，点击后可定位参考原文段落。

2.4.2 AI 大纲

AI大纲同样有两个入口：一个是右键菜单入口，另一个是打开PDF后的左侧边入口。详细用法参考图1。

2.4.3 AI 标注

AI标注同样有两个入口：一个是右键菜单入口，另一个是打开PDF后的左侧边入口。详细用法参考图1。

2.4.4 AI 填充笔记

本部分教程选读，如果你不使用Better Notes（或者都没听说过），不必学习此部分，因为这个功能完全可以由一个快捷命令（类型设置为fulltext）替代。

如果你在使用Better Notes插件，你可能会有一个自己常用的笔记模版。比如下图右侧，是我通过Better Notes创建的笔记模版（此模版从Better Notes插件的Github获取）。它反应读者的做笔记的习惯，千人千面，建议你自己编写模版（如果你不会编写可以直接去windingwind/zotero-better-notes · Discussions获取）。

现假设你已经获取并导入了你心仪的模版（如果这一步都很困难，建议不要继续阅读，放弃此功能）。

那么，打开PDF，来到侧边栏，点击快捷命令-填充笔记。

然后会出现图1的面板，它由 提示词 + 笔记模版 组成。

这个功能的原理很简单，就是：插件把 PDF全文 + 笔记模版 + 提示词 => AI => AI回答是html => 写入笔记。所以一般需要很长的上下文支持这个功能，模型太脆弱不适合这个工作。

图2为生成完成状态，打开阅读后显示图3。

前文说“这个功能完全可以由一个快捷命令（类型设置为fulltext）替代”， 如何替代？ 其实完全可以写一个规范格式的fulltext类型的提示词（假设名字叫全文总结），然后通过快捷命令点击全文总结一键生成。但生成效果可能不如AI填充笔记方案，但也够用了。生成结束后右键回答写入笔记即可。

3 最后