AlphainZ：你的文献调研伙伴。划词问答、寻找文献、帮你标重点、多端同步、全库语义搜索图片/文字。

最新版本 Zotero 7 或更新 许可证：AGPL-3.0

GitHub · 下载 · 作者：Alphainfix

English · 简体中文

开源免费，随你定制。 AlphainZ 是装在 Zotero 里的研究助手，用你自己的模型和 API key 对话，不用注册账号。它的部分前端代码 fork 自 Joscha Legewie 的 Beaver，后端则让你直接和模型厂商对话，中间不经过别人的服务器，方便、安全、省钱。

左边：Zotero 阅读器里的 AlphainZ 侧栏，一句高亮发给了 AlphainZ，回答 Why the underestimate? 时引用了原文，并问要不要存进这条高亮。右边：模拟文献库上的语义搜索准确率（Gemini Embedding 2：按照语义搜，18 个问题全是最佳匹配，Zotero 自带搜索一个也找不到；描述一张图，12 次里有 11 次在前三的匹配里），以及 AlphainZ 怎样把你的 Zotero 文献库和你选的模型直接连起来。

能做什么

问你的整个文献库

AlphainZ 会自己决定怎么找，几种方式一起用：

问你正在读的论文

在 PDF 里选中一段话、一张图或一个表格，直接在弹出框里问；也可以在侧栏里问整篇论文。

答案留在高亮里

从选中文字提的问题会锚定到一条高亮上。回答好以后，侧栏底部会出现一张卡片（见开头的截图），点一下就能把问题和答案存进这条高亮的批注：它们留在 PDF 里、跟着 Zotero 同步，点这条高亮就能重新打开那段对话。

还有

语义的图片/文字搜索准确度

模拟文献库。 6 篇专门写的模拟论文（docs/benchmark）和 36 个问题，直接跑 AlphainZ 的检索，不经过语言模型。按语义搜的问题都刻意不用原文的词，只能靠语义匹配：

问题 AlphainZ +
EmbeddingGemma 2
（本地，免费）		 AlphainZ +
Gemini Embedding 2
（用你自己的 API key）		 Zotero
自带搜索
按语义搜：英文提问（12） 12 个都是最佳匹配 12 个都是最佳匹配 0 个匹配到
按语义搜：中文问英文论文（6） 6 个都是最佳匹配 6 个都是最佳匹配 0 个匹配到
描述一张图（12） 最佳匹配 5 个
前三匹配 8 个		 最佳匹配 6 个
前三匹配 11 个		 做不到
原文关键词（6） 5 个最佳匹配¹ 5 个最佳匹配¹ 6 个都匹配到

¹ 只按语义搜。AlphainZ 也会按关键词搜，第六个就是这样匹配到的。

真实文献库。 在一个有 249 个 PDF（18,986 段）的真实研究文献库上，用 15 个按语义搜的问题（8 个英文、7 个中文）测试：答案所在的论文，用 EmbeddingGemma 2 有 12 次是最佳匹配，用 Gemini Embedding 2 有 11 次（平均倒数排名分别是 0.875 和 0.856，越接近 1 说明正确答案越靠前；OpenAI 的 text-embedding-3-large 是 0.813）。用 EmbeddingGemma 2 时，7 个中文问题的最佳匹配全都是对应的英文段落。给这个库建索引，在 MacBook Air 上本地跑不花钱（每秒约 16 段），用 Gemini 约 1 美元。

和同类工具比

AlphainZ Beaver Zotero GPT PapersGPT
在 Zotero 里用你自己的文献库 ✅ ✅ ✅ ✅
搜索整个库的全文 ✅ ✅¹ ❌² ✅
描述一张图就能匹配到 ✅ ❌ ❌ ❌
引用到句子，点开 PDF 就到那里 ✅ ✅ ❌ 🟡 只到论文
把高亮和笔记写进 Zotero ✅ ✅ 🟡 仅 Pro 🟡 仅笔记
用自己的 API key、任意 OpenAI 兼容接口 ✅ ✅ ✅ ✅
通过 Ollama 用本地模型 ✅ ❌³ – ✅
不用账号、不用订阅 ✅ ❌ – –
开源 ✅ AGPL ✅ AGPL 🟡 只有核心⁴ ✅ AGPL

✅ 有 · 🟡 部分有 · ❌ 按该产品自己的页面没有 · – 没写。2026 年 10 月下旬根据各项目的 README 和 Zotero 论坛帖核对，有错欢迎指正。
¹ 付费版按语义搜全文；免费版只按语义搜标题和摘要。
² 只能问当前打开的 PDF 或你选中的条目。
³ 请求要经过 Beaver 的服务器。
⁴ 核心代码是 AGPL，Pro 功能不开源。

NotebookLM、ChatPDF 这类通用的「和 PDF 对话」服务，处理的是上传到它们云端的文件，不在 Zotero 里。

模型

内置：DeepSeek、OpenRouter、智谱（BigModel）、Google Gemini、OpenAI，以及你电脑上的 Ollama。其他兼容 OpenAI 接口的服务，比如代理、机构网关、本地服务器，都可以手动添加，走 Chat Completions 或 Responses 接口。

每个模型都可以设置：支持哪些思考档位（输入框的 Thinking 菜单就只列这些）、上下文窗口多大（长对话在用到 70% 之前压缩），以及一次回答最多用多少 token。

成本

AlphainZ 本身免费，花的只是付给模型厂商的 token 费用。按 62 个真实问题的平均用量（每个问题读约 8 万 token，其中 83% 命中缓存，写约 3 千 token）和官方标价估算：

模型 每个问题 一天狂聊 100 次
DeepSeek V4.1 Flash 约 $0.004
（高峰时段约 $0.008）		 约 $0.4
OpenAI gpt-6-luna 约 $0.004 约 $0.4

也就是说，一天高强度狂聊 100 次，成本也就 0.4 美元左右，不到 3 块钱。用 Ollama 跑本地模型完全免费。给文献库建语义索引另算：用本地的 EmbeddingGemma 2 免费，用 Gemini Embedding 2 大约每 250 篇论文 1 美元。

价格是 2026 年 10 月底的官方标价。DeepSeek 在工作日北京时间 9–12 点和 14–18 点按高峰价收费，贵一倍。

安装

  1. 从最新版本下载 .xpi 文件。
  2. 在 Zotero 7 或更新版本里：工具 → 插件 → 右上角齿轮 → Install Plugin From File…，选这个文件。
  3. 点工具栏上的 AlphainZ 按钮打开，然后 设置 → Model → Add provider：贴上 key，选一个模型。

之后 Zotero 会自己从这个仓库检查新版本。

隐私

从源码构建

git clone https://github.com/Alphainfix/AlphainZ.git
cd AlphainZ/plugin
npm install
cp .env.production.example .env.production
npm run build        # 生成 .scaffold/build/alphain-z.xpi
npm test

.env.production 里的值只是占位：从 Beaver 继承来的一个组件仍会创建一个用不到的客户端，没有这些值就加载不了。

许可证

AlphainZ 是自由软件，和它所基于的 Beaver 一样，使用 GNU Affero 通用公共许可证 v3.0 或更新版本。截图和测试集用的都是为这个仓库写的模拟论文。

对比表来源：Beaver 及其论坛帖、Zotero GPT、PapersGPT。