配置 AI 服务 & 其他配置
注册完账号、在 Zotero 插件里登录后，这一步是打开 AI 能力的"总开关"。全部配置都集中在一个页面里：AI、嵌入模型、翻译引擎、PDF 整理、MCP、账户、右键菜单……以后新功能的开关也都加到这里。
一、打开 AI4Paper 设置页
Mac 和 Windows 的入口不一样！
- macOS：屏幕最顶上菜单栏 → Zotero → 设置（快捷键
⌘,） - Windows / Linux：Zotero 窗口 → 编辑（Edit） → 首选项（Preferences）
两边点进去的对话框是一样的。下面所有操作 Windows 用户对着图做就行，只是入口点法不同。
进入 Zotero 设置弹窗后，左侧菜单拉到底点 「AI4Paper」：
这一个页面就是所有配置的集中地。顶部一排分类导航：快速开始 / 账户与会员 / AI与翻译 / 阅读与界面 / 数据与备份 / 期刊订阅 / 联动集成 / 高级与其他，点哪个直接跳到哪个区域。除了「快速开始」和「账户与会员」两张卡默认展开，其余卡片首次打开都是收起的（点开过会记住，下次还是展开的），别觉得功能不见了，点开分类就有。下面逐一说清楚。
二、主 AI（最重要）
主 AI 决定了插件里所有"用嘴写东西"的能力：对话、解读、精读、翻译全走这个模型。
点「账户与会员」卡片下方 「AI 模型与翻译」 卡片里的 「配置 AI 服务」 按钮，弹出配置对话框：
先说清楚我们是什么角色
AI4Paper 是一家软件服务商，不是 AI 大模型的开发方。 你在这个弹窗里看到的默认配置（API 地址填的是 https://ai4paper.pro/api/v1）是我们自己的中转通道——本质是我们把上游 AI 厂商（比如阿里云通义千问）的服务对接好、包装成开箱即用的功能，再按官方原价转发给你用，免去你自己跑去各家平台注册账号、比价、办 Key 的麻烦。所以你会看到两条路可选：
2.1 两种选择：AI4Paper 转接 vs 自己的 Key
| 方式 | 适合谁 | 优缺点 |
|---|---|---|
| ① AI4Paper 转接（默认） | 懒人 / 不想管技术的用户 | ✅ 一行配置不填，注册完自动同步；✅ 和阿里云同价，我们不赚差价；❌ 会占用我们的服务器通道 |
| ② 填自己的 API Key（鼓励） | 重度用户 / 有阿里云、DeepSeek 账号的人 | ✅ 减轻我们服务器压力；✅ 自己账上充了钱更有安全感；✅ 可以选更大模型（比如 qwen-max、gpt-4o、claude-sonnet-4-5）；❌ 要自己去各家平台注册拿 Key |
老实交代：我们希望你用自己的 Key
AI4Paper 转接用的是阿里的 qwen3.5-flash，中等速度 + 中等质量，日常论文处理基本够用，价格就是阿里云官网的原价（我们 0 加价，不是为了赚差价，就是为了让不想折腾的新用户零门槛能用起来）。
但我们自己的服务器也有压力和带宽成本。如果你已经有阿里云 / DeepSeek / OpenAI 账号，强烈建议填你自己的 Key——对我们是减负、对你是可控，同样的体验甚至更好（你可以切 qwen-max、deepseek-reasoner 这种更贵更强的模型）。
2.2 配置步骤（以"用我自己的 Key"为例）
- AI 服务：点下拉框选服务商（通义千问 / DeepSeek / OpenAI / 智谱 / Kimi / Ollama 本地……都支持）
- API Key：粘贴该服务商给你的 Key
- API 地址：选完服务商一般会自动填好。自建服务 / 中转的话手动改
- 模型：点 「测试连接 & 获取模型」（图中红色"点测试连接"）→ 看到绿色"连接成功，获取到 N 个模型"就行，然后从下拉里选一个
- 点 「保存配置」（图中红色"点保存配置"）
几个常用模型推荐：
- 通义千问：
qwen-plus日常 /qwen-max高质量 - DeepSeek：
deepseek-chat日常 /deepseek-reasoner深度推理 - OpenAI：
gpt-4o-mini性价比 /gpt-4o高质量 - 本地离线：Ollama +
llama3/qwen2.5（隐私党）
2.3 AI4Paper 转接的充值与余额
如果懒得配自己的 Key，就用我们转接：
- 注册就送 200 万 token（试用期内用）
- 用完了：官网 我的账号 → AI 额度 充值，充值永不过期，¥1 ≈ 100 篇论文
- API 地址填：
https://ai4paper.pro/api/v1（自动填好） - 模型：
qwen3.5-flash
三、嵌入模型（≠ 主 AI，别搞混）
嵌入模型是专门用来做语义检索 / 知识库 / RAG 的——把文献的文字压缩成"数学向量"，然后做**"按意思找相似论文"**。它和主 AI 做的事完全不一样：
| 主 AI | 嵌入模型 | |
|---|---|---|
| 做啥 | 读懂、回答、生成文字 | 把文字压成一串数字，做相似度比较 |
| 用在哪 | 翻译 / 解读 / 精读 / 对话 / 综述 | 知识库问答 / "找跟这篇相似的论文" |
| 典型模型 | qwen-plus / gpt-4o / deepseek-chat | text-embedding-v3 / bge-large-zh |
默认"跟随主 AI"就行，但下面这两件事要分开看
嵌入模型卡片默认显示 「跟随主 AI」——意思是你配了主 AI 之后自动用同一个服务商的嵌入模型，不用管它。这里有两件事是分开的，别混为一谈：
第一件事（能力）：嵌入模型本来就可以独立于主 AI 单独选供应商。 这是配置弹窗设计上就支持的，跟你用哪家没关系——你随时可以让主 AI 和嵌入模型分别用不同的服务商，弹窗里嵌入模型的选项和主 AI 填在一个对话框里。
第二件事（具体问题）：DeepSeek 不提供嵌入模型，这种情况必须单独配。 如果你主 AI 选的是 DeepSeek，要注意 DeepSeek 官方只提供对话模型，没有嵌入模型，所以「跟随主 AI」在这种情况下行不通，知识库问答会跑不起来。解决办法：把嵌入模型单独换成一家支持 OpenAI 兼容接口的服务商（比如 OpenAI 官方，或者通义千问、硅基流动这类同时提供 OpenAI 兼容嵌入接口的平台），填好地址 + Key + embedding 模型名即可，能覆盖大部分"主 AI 没有嵌入模型"的情况。
四、翻译引擎（划词翻译、标题摘要）
翻译引擎管的是你在 PDF 阅读器里划词出来的那个翻译浮框和文库列表里的"中文标题"列。
- 默认：火山翻译（免费）——不用配置、不占 token、速度快
- 主 AI 启用时：划词/标题优先走主 AI，翻译引擎是回退（主 AI 不可用时才走）
- 自定义翻译密钥：如果你有百度翻译、腾讯翻译、DeepL 的 Key，点「配置翻译密钥」填进去
日常直接用默认火山翻译就行，除非对翻译质量有特殊要求。
五、工具：PDF 文献整理 & 数据同步
5.1 PDF 文献整理（批量导入）
电脑里有一堆散落的 PDF？这个按钮帮你批量导入到 Zotero：
- PDF 文件夹：选包含 PDF 的文件夹（支持扫 3 级子目录）
- 归档文件夹：导入后把 PDF 搬到哪里（防止原位置乱）
- 命名格式：
{%a_}{%y_}{%t}= 作者_年份_标题（也可改成%j带期刊） - 点 「导入 PDF 到 Zotero」——自动识别元数据、打期刊标签，一气呵成
5.2 数据同步
把 AI4Paper 给你生成的笔记、AI 标签、知识库等云备份一份，换设备不用重建。点按钮登录就行。
六、MCP 接入
MCP（Model Context Protocol） 是让外部的 AI 客户端（比如 Claude Desktop、Cursor）直接读到你 Zotero 里的文献、笔记、追踪的协议。
点 「打开 MCP 配置」 弹窗，里面能复制端点、Token、按客户端给配置。用不着就忽略，要用时看详细的 MCP 接入 章节。
七、账户与会员
就是你的 AI4Paper 会员信息：会员类型 / 版本 / 到期 / 设备数 / 验证状态。
图上这个账户是「终身VIP / 最多 3 台 / AI 功能全部解锁 / 已验证」。没登录的人，这里显示「登录 / 注册」按钮，点一下走邮箱密码登录流程（微信登录用户先补绑邮箱，见 注册账号）。系统每 30 分钟会自动验证一次账号状态，旁边的「刷新」按钮可以手动立刻拉一次最新状态。
买完套餐/充完额度"不生效"？退出重新登录！
Zotero 有缓存，账户状态不会实时刷新。如果你刚在官网付了钱但插件里还是"试用版"：
- 先点账户卡片里的 「刷新」 按钮——大概率立刻生效
- 还不行 → 点 「登出」 → 再点 「登录 / 注册」 重新登录 → 好了
- 再不行 → 彻底退出 Zotero（不是最小化，是 ⌘Q / 右上 ×）再重开
90% 的"我充了钱没用"都是这个缓存问题，不是支付失败。
八、右键菜单显示 / 期刊分区显示
- 右键菜单显示：控制 Zotero 文献列表里点右键出现哪些 AI4Paper 选项（比如"AI 解读 / AI 翻译 / 加入知识库"）。太多不用就来这里关
- 期刊分区显示：控制文献列表里显示哪些期刊指标（SCI / 中科院分区 / JCR / CCF / 影响因子……）。点「配置显示指标」勾选
这两个不影响 AI 功能，纯是界面整洁度调整。
九、FAQ
Q1: 点「测试连接」一直失败？
A:
- Key 复制粘贴多了空格？重新复制
- API 地址末尾多/少
/v1？不同服务商要求不一样 - 自建服务 → 检查 URL 能不能 ping 通、有没有 CORS / 白名单限制
- 公司网 / 学校网 → 可能屏蔽了国外 API，试试切换网络
Q2: AI4Paper 转接和我自己买阿里云有啥差别？
A: 价格一分不差（我们不加价）。差别只有两个：
- 付款/充值渠道：走 AI4Paper 官网 vs 走阿里云百炼
- 服务器压力：走我们家占我们资源，走你自己的更独立
大用户强烈建议自己买，我们的服务器也能喘口气。
Q3: 为啥充了钱账号里还是"试用"？
A: 看第 7 节的 warning——点刷新 / 重新登录 / 退 Zotero 再开。Zotero 缓存搞的鬼。
Q4: 嵌入模型要不要单独付费？
A: 嵌入比主 AI 便宜得多（差一个数量级）。用 AI4Paper 转接就用默认的；自己 Key 的话嵌入消耗会单独在对应平台扣，但金额通常可以忽略。
Q5: 本地 Ollama 怎么配？
A: 先在机器上跑起 ollama serve，然后 AI 服务选 Ollama，API 地址填 http://localhost:11434/v1，模型选你本地拉下来的（如 qwen2.5:7b）。完全离线、不走任何网络，适合审稿敏感数据 / 公司代码别传出去的场景。
配置跑通后：
- 返回 Zotero 文库，右上角工具栏按钮应该都能点了
- 双击任意 PDF，阅读器右侧多出翻译 / AI 对话 / 笔记 / 思维导图 tabs
- 右键任意文献，**「AI 解读 / AI 翻译 / 加入知识库」**等菜单出现
后续每个功能怎么用，见 找文献 / 读文献 / 写综述 / 整理文献 章节。