---

🚀 主要功能

关于 GPT 的功能：

• 🔗 与 Zotero 集成：您可以使用该插件，根据选中的文本或 PDF 文件，在文献库中搜索和提问。
• 🧠 使用 GPT 生成回复文本：支持 gpt-3.5-turbo 和 gpt-4
• 🏷️ 命令标签：只需 单击一次，即可加速您的研究。
  • 💬 关于当前 PDF 文件 提问（全文或选中文本）。
  • 💬 关于 选定的论文 提问（摘要）。
  • 📝 将 选定的论文 概括为几句话。
  • 🔍 根据选中文本在文献库中 搜索条目。
  • ... ...
• ⚙️ GPT 高级设置：您可以设置 API 密钥、模型名称、API 地址、温度。
• 📚 与 Better Notes 集成：您可以在使用 Better Notes 时直接打开此插件。

关于 UI 的功能：

• 🎨 回复文本的 实时 Markdown 渲染：支持 Latex 和 MathJax。
• 🔍 可以 放大和缩小 回复文本或插件窗口的大小。
• 🖱️ 可以将插件窗口移动到屏幕上的任意位置。
• 📋 可以将回复文本 复制到剪贴板。
• ⚠️ 请求失败时会显示详细的 错误信息。
• 🔧 兼容 Zotero 6 和 Zotero 7。
• 🎉 还有更多未列出的精彩功能等待您发现。

使用方法

• 获取 .xpi 文件
  • 下载最新版 .xpi 文件
  • 或者构建该项目 [1] 以生成 .xpi 文件
• 在 Zotero 中安装 .xpi 文件 [2]
• 打开 Zotero GPT [3]
• 设置您的 OpenAI 秘密密钥 [4]

[1] 构建项目

以下是如何构建该项目的示例。有关构建的更多信息，请访问该项目：https://github.com/windingwind/zotero-plugin-template

git clone https://github.com/MuiseDestiny/zotero-gpt.git
cd zotero-gpt
npm install
npm run build

在构建目录中生成的 .xpi 文件就是您可以在 Zotero 中安装的扩展程序。

[2] 在 Zotero 中安装扩展程序

打开 Zotero。在顶部菜单栏中，点击“工具 > 附加组件”。 点击窗口右上角的齿轮图标。选择“从文件安装附加组件”，然后打开上一步构建目录中生成的 .xpi 文件。

[3] 打开/退出 Zotero GPT

操作	快捷键
打开
退出	ESC
多行编辑	Shift + Enter

[4] 设置 API 密钥

你好，命令标签。

👻 按照下面的步骤操作，您将对命令标签有全新的认识。

步骤	描述	补充信息
1	打开 Zotero GPT	参见 [3] 打开/退出 Zotero GPT
2	输入 #标签名 并按 Enter
3	输入您的提示或代码
4	运行您的标签	按 Ctrl + R
5	保存您的标签	按 Ctrl + S
6	长按一个命令标签进入编辑界面
7	修改标签的颜色、位置或触发词；记得用 Ctrl + S 保存
8	按 ESC 退出编辑界面	退出前请务必用 Ctrl + S 保存更改
9	长按右键删除标签	注意：内置标签不支持删除

如何运行命令标签

触发词是命令标签的一个属性，颜色和位置也是如此。长按任何标签即可查看或修改其触发词。它既支持纯文本，也支持 JS 正则表达式。

如何编写代码块

您可以在 这里找到一些内置的 API。

一个简单的例子：

帮我概括一下这段话：

${Meet.Zotero.getPDFSelection()}

在这里，帮我概括一下这段话： 是纯文本，而 ${你的代码} 则是一个代码片段。毫无疑问，如果您熟悉 Zotero 的 API，就可以开发自己的代码。代码片段会被执行，代码片段返回的文本会替换掉代码片段本身。最后，被替换后的文本会被输入到 GPT 中。因此，理论上，您可以通过命令标签来 完成 Zotero 和 GPT 之间的所有交互。

如何浏览历史对话

按键盘上的向上（↑）和向下（↓）键即可浏览。

GPT 标签推荐

自动为条目创建标签：打开并复制，然后打开 Zotero，该标签将自动导入到 Zotero 中。

支持本项目

这里

Zotero GPT 快速上手指南

Zotero GPT 是一款强大的 Zotero 插件，旨在将 GPT 大模型能力无缝集成到文献管理工作流中。它支持基于选中文本或 PDF 全文进行提问、总结论文、检索库内条目，并允许用户通过自定义命令标签（Command Tags）扩展功能。

环境准备

在开始之前，请确保满足以下条件：

• 操作系统：Windows, macOS 或 Linux。
• Zotero 版本：兼容 Zotero 6 和 Zotero 7。
• API Key：你需要拥有 OpenAI API Key（或其他兼容 OpenAI 格式的第三方服务 Key）。
• 可选依赖（仅用于源码构建）：
  • Node.js (推荐 LTS 版本)
  • Git

注意：对于普通用户，直接下载安装包即可，无需配置 Node.js 环境。

安装步骤

方法一：直接安装（推荐）

1. 下载插件： 访问 最新发行版页面，下载 zotero-gpt.xpi 文件。

   若下载速度慢，可尝试使用国内加速工具或镜像站获取该文件。

2. 安装插件：

   • 打开 Zotero。
   • 点击顶部菜单栏的 工具 (Tools) > 附加组件 (Add-ons)。
   • 点击右上角的齿轮图标 ⚙️，选择 从文件安装附加组件... (Install Add-on From File...)。
   • 选择刚才下载的 .xpi 文件并确认安装。
   • 根据提示重启 Zotero（如果需要）。

方法二：源码构建（开发者适用）

如果你需要修改源码或体验最新特性，可以通过以下命令构建：

git clone https://github.com/MuiseDestiny/zotero-gpt.git
cd zotero-gpt
npm install
npm run build

构建完成后，生成的 .xpi 文件位于 build 目录中，按“方法一”的步骤进行安装。

基本使用

1. 配置 API Key

安装并重启 Zotero 后：

1. 唤起插件窗口（见下文快捷键）。
2. 在设置界面中输入你的 OpenAI Secret Key。
3. （可选）根据需要修改模型名称（如 gpt-4）、API URL 或温度参数（Temperature）。

2. 唤起与交互

• 打开插件：点击 Zotero 工具栏上的 Zotero GPT 图标，或使用默认快捷键（通常在设置中查看，或通过菜单唤起）。
• 关闭插件：按下 ESC 键。
• 多行输入：在输入框中按 Shift + Enter 换行。

3. 最简单的使用示例

假设你正在阅读一篇 PDF 文献，并希望 AI 总结当前选中的段落：

1. 在 Zotero 中打开 PDF 阅读器，用鼠标选中一段文字。
2. 打开 Zotero GPT 插件窗口。
3. 在输入框中输入内置命令标签（或直接输入自然语言指令，视配置而定），例如输入：

   #Summarize
   

   或者直接输入：

   请总结我选中的这段文字：${Meet.Zotero.getPDFSelection()}
   

   (注：${...} 部分为代码片段，会自动替换为选中的文本内容)
4. 按下 Enter 发送请求。
5. 插件将实时渲染 Markdown 格式的回复，支持数学公式显示。

4. 进阶：使用命令标签 (Command Tags)

命令标签是提升效率的核心功能，允许一键执行复杂操作。

• 运行标签：在输入框输入 #标签名 并回车，或长按标签按钮。
• 创建/编辑标签：
  1. 输入 #新标签名 并回车。
  2. 输入提示词（Prompt）或代码逻辑。
  3. 按 Ctrl + R 运行测试。
  4. 按 Ctrl + S 保存标签。
• 管理标签：长按任意标签按钮可进入编辑界面，修改颜色、位置或触发条件；右键长按可删除自定义标签。

5. 历史记录导航

使用键盘的 ↑ (上箭头) 和 ↓ (下箭头) 键可以快速浏览和复用历史对话内容。

---

更多高级功能（如与 Better Notes 集成、自定义 API 端点等）请参考官方文档或社区讨论区。