Zotero 插件

概述

Ai4Scholar Zotero 插件让你在 Zotero 内搜索 Semantic Scholar 论文，筛选结果，并将选中的文献信息导入个人文献库或指定分类。

当前版本为 v1.0.3，支持 Zotero 7、8、9 和 10 桌面版。新版使用与网站一致的 Ai4 标志，替换了旧猫图标。插件窗口目前使用英文按钮，下文保留界面中的实际名称，便于对照操作。

安装

步骤

1. 下载 ai4scholar-1.0.3.xpi，保留 .xpi 格式，无需解压。
2. 在 Zotero 主窗口打开 工具（Tools）→ 插件（Plugins）。
3. 点击插件管理器右上角的齿轮，选择 Install Plugin From File…，选中下载的 .xpi。部分版本的菜单文字为 Install Add-on From File…；也可以将 .xpi 拖入插件管理器。
4. 确认 AI4Scholar - Semantic Scholar Search 已启用，然后回到主窗口，打开 工具（Tools）→ AI4Scholar Search。如果菜单暂未出现，再重启 Zotero。

安装方式也可参考 Zotero 官方插件说明。下载入口和兼容范围可随时在 Zotero 集成页查看。

配置 API Key

1. 登录 Ai4Scholar，进入 API 密钥管理，创建或复制一个有效密钥。
2. 首次打开 AI4Scholar Search 时，会弹出 Enter API key 窗口。
3. 粘贴密钥本身，点击 Save。输入框中无需添加 Bearer 前缀。

之后需要更换密钥时，点击搜索窗口右下方的 Settings，修改后保存。插件使用 Ai4Scholar 的 API Key，无需配置对话模型。

核心功能

搜索论文

在 Search papers... 输入关键词，例如 graph neural networks，点击 Search 或按回车。可以使用以下筛选项缩小范围：

界面字段	用法
Year	填写起始年份 From 和结束年份 To，例如 2020–2026；也可只填一端。
Limit	每次最多返回 10、20、50 或 100 条结果，默认 20 条。
Field	选择学科；All 表示不限制学科。
Min cites	设置最低引用次数；留空或填 0 表示不限制。

检索支持输入中英文关键词，实际结果取决于 Semantic Scholar 的收录情况。若结果为空，先减少筛选条件，或尝试论文的英文标题。

批量导入文献

1. 勾选需要的论文，或点击 Select all 选中本次全部结果；Deselect all 可取消全选。
2. 在 Import to 中选择目标分类。默认 My library 导入个人文献库；点击 New 可以新建分类并自动选中它。
3. 点击 Import (数量)。完成后，底部会显示 Imported 成功数/所选数，例如 Imported 3/3。
4. 回到 Zotero 的个人文献库或所选分类，查看导入的标题、作者、年份、摘要、期刊、DOI 和原文链接等信息。某些字段可能因数据源缺失而留空。

当前导入目标为个人文献库及其分类。每次导入会创建新条目；不要重复导入已成功的结果，重复项可在 Zotero 中检查和合并。

更新插件

在 工具（Tools）→ 插件（Plugins） 中打开齿轮菜单，选择 Check for Updates。启用 Update Plugins Automatically 后，Zotero 可自动检查插件更新。

已安装旧版的用户可升级到 v1.0.3；也可以下载本页的 .xpi，通过 Install Plugin From File… 直接覆盖安装，无需先卸载。更新后确认插件版本为 1.0.3，图标为新版 Ai4 标志。

计费

论文搜索通过 API Key 调用 Ai4Scholar 服务，按接口规则消耗账户积分，并受该密钥的额度上限约束。将已经返回的搜索结果导入 Zotero 是本地操作，不会再次发起论文搜索请求。

网页专属免费额度不等同于插件或 API 免费额度。具体规则见 积分与套餐和开放 API。

常见问题

导入后为什么没有 PDF？

当前插件导入论文的文献信息和原文链接，不会自动下载 PDF 附件，也不提供 AI 摘要或推送到写作编辑器的功能。需要全文时，可在 Zotero 中打开原文链接，或使用 Zotero 自身的全文获取、附件管理功能。

搜索提示 API 错误怎么办？

• 401：在 Settings 中重新检查 Ai4Scholar API Key 是否完整、有效，是否误加了 Bearer 前缀。
• 402 或额度不足：检查账户积分，以及这把 API Key 是否达到单独设置的消费上限。
• 429：请求过于频繁，稍后重试。
• 其他错误：核对网络连接及界面返回的错误信息，再决定是否重试。

工具菜单里没有 AI4Scholar Search？

回到 Zotero 的文献库主窗口，检查插件已启用、安装版本正确，且 Zotero 为 7–10 桌面版；必要时重启后再查看工具菜单。

提示只导入了部分论文怎么办？

先核对目标分类中已经保存的条目，再重新选择未成功的结果。若目标分类已被删除，重新选择 My library 或一个有效分类后导入。