# 连接研究资源

从你的 Zotero 库引用或导入文献，让助手使用 alphaXiv 的论文工具，并设置学术搜索服务。

打开 **设置 → 集成** 来连接研究服务。每个标签页都会显示该服务自己的标志。这些连接会为你的工作流添加资源和工具；你的稿件和参考文献仍是项目文件。

## Zotero

Oleafly 会读取你的 Zotero 库，但绝不会修改它。你可以在写作时从中引用，也可以把整个库导入项目的参考文献。引用方面的内容请参阅[从你的 Zotero 库引用](/docs/citations/#cite-from-your-zotero-library)。

### 本机上的 Zotero

只要同一台电脑上打开着 Zotero 7 或更新版本，Oleafly 会自己找到它。Zotero 需要先打开一项设置：

1. 在 Zotero 中，打开 **设置 → 高级**。
2. 打开 **Allow other applications on this computer to communicate with Zotero**。
3. 在 Oleafly 中，打开 **设置 → 集成 → Zotero**，选择 **测试连接**。

测试会报告 Zotero 的版本、已安装的 Better BibTeX 的版本（如果有），以及每个库中有多少条目。安装了 Better BibTeX 时，引用键由它生成。否则引用键来自 Zotero 的 Citation Key 字段，或 Extra 字段中的 `Citation Key:` 行。

在 **要搜索的库** 下，关闭你不想出现在搜索结果中的库。**立即同步** 会重新读取库，当 Oleafly 的窗口回到前台时，它也会刷新。Zotero 关闭期间，搜索会继续使用上次同步的副本，标签页上会注明这一点。较旧的 Zotero 无法共享它的库，标签页会请你更新到 Zotero 7 或更新版本。

### zotero.org 账号

Zotero 没有在这台电脑上打开时，请使用你的 zotero.org 账号。群组库也会一并带入，而 **导入 Zotero 库** 用的就是这个账号。

1. 打开 **设置 → 集成 → Zotero**。
2. 点击 **API 密钥页面** 的链接，前往你的 [Zotero 账户设置](https://www.zotero.org/settings/security#applications)。
3. 创建一个密钥，并打开 **Allow library access**，同时复制同一页面上显示的数字用户 ID。
4. 在 Oleafly 中输入用户 ID 和 **Zotero API 密钥**，然后选择 **连接**。

保存密钥之前，Oleafly 会先向 Zotero 验证。如果 Zotero 拒绝该密钥、该密钥无法读取你的库，或者它属于另一个用户 ID，Oleafly 会说明是哪种情况，并且不保存任何内容。连接之后，标签页会显示账号名称。**断开连接** 会移除已保存的密钥。

### 导入整个库

连接了你的 zotero.org 账号后：

1. 打开一个项目及其 **参考文献** 面板。
2. 选择 **导入参考文献库**。
3. 在 **Zotero** 卡片上，选择 **导入 Zotero 库**。

Oleafly 最多会以 BibTeX 的形式带入 5,000 个条目，并把它们加入项目的参考文献。与文件导入一样，DOI 已在参考文献中的条目会被跳过，提示信息会说明添加了多少条、有多少条已经存在。如果你的库超过 5,000 个条目，Oleafly 会导入前 5,000 个并告诉你。

连接之前，同一张卡片会提供 **连接 Zotero 账户**，它会打开这个设置标签页。如果想不用 API 密钥进行一次性导入，请从你的文献管理器导出 Zotero RDF、BibTeX、RIS 或 EndNote XML，然后使用[导入整个参考文献库](/docs/citations/#import-a-whole-reference-library)。

## alphaXiv

alphaXiv 以 MCP 服务器的形式连接，因此助手可以搜索论文、阅读论文，并使用你的 alphaXiv 库。

1. 在 [alphaxiv.org](https://www.alphaxiv.org) 登录，打开 **Settings > API Keys**，创建一个密钥。
2. 在 Oleafly 中打开 **设置 → 集成 → alphaXiv**。
3. 把密钥粘贴到 **alphaXiv API 密钥**，然后选择 **连接**。

保存之前，Oleafly 会用该密钥连接 alphaXiv 的服务器。alphaXiv 拒绝的密钥不会被保存。连接之后，这个服务器也会出现在 **AI 助手 → MCP** 下，名为 **alphaXiv**。

助手在每次调用 alphaXiv 之前都会询问你。试着针对一个具体的主题提出请求：

> 查找关于回归问题不确定性估计的论文。比较各方法所度量的内容，并为每条描述附上来源链接。

打开返回的论文来核对依据。不再需要这个连接时，在同一个设置标签页中使用 **断开连接**。

## 引用搜索服务

**引用搜索** 设置标签页存放各个索引所用的凭据，每一项都显示了它的标志：

- 推荐设置 **OpenAlex API 密钥**。OpenAlex 的常规访问需要密钥；没有密钥时，搜索共用一个很小的每日额度。**OpenAlex 联系邮箱** 也会把请求放入 OpenAlex 的礼貌池。保存密钥或邮箱之后，卡片会显示 **已连接**。
- **Semantic Scholar API 密钥** 是可选的。匿名请求使用它的公开限额。
- **Google Scholar（Serper）**：Serper API 密钥会把 Google Scholar 加为来源。没有密钥时，引用搜索会在搜索中略过 Google Scholar，而不是把它列为失败的来源。
- **arXiv、Crossref 和 PubMed** 不需要凭据。

OpenAlex 密钥和联系邮箱同样适用于助手的文献检索。凭据保留在这台设备上，只会发送给它所属的服务。不再希望 Oleafly 使用某个已保存的密钥时，请在同一张设置卡片中移除它。

回到[引用搜索](/docs/literature-search/)，选择你需要的索引，运行主题查询。不必配置每一个可选服务，也可以使用内置的学术索引。

## 查找某一个已知的来源

如果你已经有可靠的标识符，就不需要连接 Zotero 或搜索提供商。[参考文献工具](/docs/tools/#build-references)可以检索 DOI、arXiv 编号、ISBN 或 PubMed ID，然后让你在复制 BibTeX 或格式化的引用之前更正各字段。手动编辑和格式化引用在离线时仍可使用；查询目录则需要联网。

## 更多集成

- [GitHub](/docs/github-sync/) 把项目的源代码管理连接到仓库。
- [外部 MCP 服务器](/docs/mcp/#add-external-tools-to-oleafly)为 Oleafly 的助手添加工具。
- [Oleafly 的 MCP 服务器](/docs/mcp/)让外部客户端可以访问项目工具。
- [模型提供商](/docs/ai-setup/)和 [CLI 代理](/docs/cli-agents/)决定由哪个助手来完成工作。