A.R.I.A.（咏叹调）—— 你的 AI 研究助手

Aria 是一款由大型语言模型（LLMs）驱动的 Zotero 插件。A-R-I-A 是“AI Research Assistant”（AI 研究助手）的反向缩写。

请根据您的 Zotero 版本选择正确的版本：

• Zotero 6：https://github.com/lifan0127/ai-research-assistant/releases/tag/0.8.0
• Zotero 7：https://github.com/lifan0127/ai-research-assistant/releases/latest

快速入门

开始使用 Aria 的最简单方式，就是尝试提示库中的交互式提示。

功能

拖放引用 Zotero 中的条目和收藏集

创作者（作者）、标签、条目等的自动补全

视觉分析（GPT-4 Vision）

如何使用 Zotero 区域标注在 PDF 中创建可拖动区域？

将聊天保存为笔记和标注

Zotero 和 GPT 要求

• 请注意，Zotero 6 和 7 分别有不同的发布版本：
  • Zotero 6：https://github.com/lifan0127/ai-research-assistant/releases/tag/0.8.0
  • Zotero 7：https://github.com/lifan0127/ai-research-assistant/releases/tag/v0.7.4
• Aria 需要 OpenAI 的 GPT-4 模型系列。（我如何访问 GPT-4？）
• 视觉分析功能需要 GPT-4 Vision 模型的预览访问权限。

安装

有关安装过程的详细说明，请参阅：https://twitter.com/MushtaqBilalPhD/status/1735221900584865904（鸣谢：__穆什塔克·比拉尔博士__ - 南丹麦大学）

• 从 GitHub 下载最新版本的 .xpi 文件：https://github.com/lifan0127/ai-research-assistant/releases/latest
• 在 Zotero 中，从顶部菜单栏选择工具,然后点击附加组件。
• 在附加组件管理器面板中，单击右上角的齿轮图标，选择从文件安装附加组件。
• 选择刚刚下载的 .xpi 文件并点击打开,安装过程将开始。

快速入门

默认情况下，可以通过点击 Zotero 工具栏上的 按钮或使用“Shift + R”快捷键来激活 Aria。

在使用 Aria 之前，您需要提供一个 OpenAI API 密钥。按照应用内指示添加密钥，并重启 Zotero。（截图）

重启后，您应该会看到已激活的 Aria 窗口（如上所示），并可通过对话开始使用它。

偏好设置

Aria 可通过编辑 > 偏好设置 > Aria 进行配置。请注意，某些更改需要重启 Zotero。

• 模型选择：在基础 GPT-4 模型和新的 GPT-4 Turbo 模型（预览版）之间进行选择。
• 缩放级别：调整缩放级别以适应您的屏幕分辨率。
• 键盘快捷键：更改键盘快捷键组合，使其更符合您的工作流程。

更新

• 在有互联网连接的情况下，Aria 可以自动更新。要检查是否有可用更新，从顶部菜单栏选择工具,然后点击附加组件。
• 若要手动更新 ARIA，点击 Aria 下方的更多,然后单击右上角的齿轮图标。选择检查更新。（截图）

限制

以下是根据用户反馈已知的限制。

• 目前，Aria 可以通过 Zotero 搜索 API 查询您的 Zotero 库。未来版本将支持查询 Zotero SQLite 数据库以获取文档数量和其他指标。
• Aria 对您的 Zotero 应用程序状态（选中项、当前标签页、高亮文本）的感知有限。不过，您可以使用拖放和自动补全功能，在消息中提供这些上下文信息。

故障排除

与 Zotero 的开放式对话以及基于概率模型的交互，可能会导致许多不同且常常意想不到的结果。如果您遇到任何错误，请在 GitHub 上提交一个问题，并附上 Aria 聊天窗口中错误消息的截图。谢谢！

• “代理因达到最大迭代次数而停止”：对于某些问题，机器人会多次迭代调用 API 来合成回复。有时，在达到最大迭代次数之前，它可能无法生成答案。
• Aria 选项卡未出现在偏好设置面板中：您可以在偏好设置中选择__高级__选项卡，并打开__配置编辑器__。在高级配置中，搜索“aria”，然后双击“extensions.zotero.aria.OPENAI_API_KEY”条目，以添加您的 OpenAI API 密钥。

开发

请参考 Zotero 插件开发指南，了解如何在本地环境中设置插件。

反馈

现在您可以提交反馈并分享您的聊天记录，以帮助改进 Aria。让我们一起让 Aria 更加出色吧！

A.R.I.A. (Aria) 快速上手指南

Aria 是一款基于大语言模型（LLM）的 Zotero 插件，旨在辅助学术研究。它支持拖拽引用文献、自动补全、视觉分析（GPT-4 Vision）以及将对话保存为笔记等功能。

环境准备

在开始之前，请确保满足以下系统和账号要求：

• Zotero 版本：
  • Zotero 6：需下载 0.8.0 版本
  • Zotero 7：需下载 最新版本
• OpenAI 账号：
  • 必须拥有 GPT-4 系列模型的访问权限。
  • 若使用“视觉分析”功能，需具备 GPT-4 Vision 的预览访问权限。
  • 准备好您的 OpenAI API Key。

安装步骤

1. 下载插件： 访问 GitHub Releases 页面，根据您的 Zotero 版本下载对应的 .xpi 文件。

2. 打开插件管理器： 启动 Zotero，点击顶部菜单栏的 Tools，然后选择 Addons。

3. 安装文件： 在插件管理器面板右上角点击齿轮图标 ⚙️，选择 Install Add-on From File...。

4. 确认安装： 在文件选择对话框中找到并选中刚才下载的 .xpi 文件，点击 Open。按照提示完成安装。

5. 配置 API Key：

   • 安装完成后，根据应用内指引输入您的 OpenAI API Key。
   • 重要：配置完成后必须重启 Zotero 才能生效。
   • 备用方案：如果偏好设置中未显示 Aria 选项，可进入 Edit > Preferences > Advanced > Config Editor，搜索 aria，双击 extensions.zotero.aria.OPENAI_API_KEY 手动填入 Key。

基本使用

安装并重启 Zotero 后，即可通过以下方式启动和使用 Aria：

1. 启动 Aria：

   • 点击 Zotero 工具栏上的 Aria 图标。
   • 或使用默认快捷键 Shift + R。

2. 开始对话：

   • 启动后会出现 Aria 对话窗口。
   • 推荐新手操作：点击提示词库（Prompt Library）中的交互式提示，快速体验功能。

3. 核心功能示例：

   • 引用文献：直接将 Zotero 中的条目或合集拖拽（Drag-and-Drop）到对话窗口中作为上下文。
   • 自动补全：输入作者、标签或条目名称时，插件会自动提供补全建议。
   • 视觉分析：利用 GPT-4 Vision，结合 Zotero 的 PDF 区域标注功能，对图表或特定文本区域进行可视化分析。
   • 保存结果：对话内容可直接保存为 Zotero 笔记（Notes）或 PDF 注释（Annotations）。

4. 个性化设置： 进入 Edit > Preferences > Aria，您可以：

   • 切换模型（如 GPT-4 或 GPT-4 Turbo）。
   • 调整窗口缩放比例。
   • 修改启动快捷键。