本教程面向科研用户，完整讲解将DeepSeek接入Zotero的安装、API配置、插件对接与文献问答流程，兼顾成本、隐私与常见故障排查。 Zotero是广泛使用的文献管理工具，DeepSeek则提供OpenAI兼容的高性价比大模型接口。将二者连接后，研究者可以在本地文献库中直接完成摘要、翻译、提问和跨文献比较，而不必反复复制PDF文本到网页端。下面按环境准备、插件安装、接口调优和实战工作流四个环节展开，并标注容易出错的参数与排查方法。
1. 环境准备与DeepSeek API开通
Zotero 7是目前插件兼容性较好的桌面版本，建议从官方站点下载对应Windows、macOS或Linux的安装包，并完成基础文献库同步。DeepSeek侧需要先注册开放平台账号，进入API密钥管理页面创建密钥。创建时系统通常只完整显示一次密钥，因此要立即复制到密码管理器或本地加密文本中，不要直接粘贴到聊天窗口或公开仓库里。DeepSeek采用预付费或按量计费模式，账户余额不足时接口会返回余额错误，所以开通后应确认可用额度，并了解deepseek-chat与deepseek-reasoner的计费差异。国内网络通常可以直接访问DeepSeek API，若所在机构网络限制外发请求，则需要配置代理或申请白名单。
API密钥的安全管理直接影响文献数据与账户资金。密钥泄露后他人可以消耗余额，甚至通过接口发送请求，因此不要把密钥写入Zotero笔记、共享群组或截图。若多人共用一台电脑，建议为Zotero建立独立系统账户，或在使用后清除插件配置中的密钥。对于需要长期使用的实验室，可以在DeepSeek平台设置子密钥、限额和告警，将文献问答流量与个人实验流量分开。网络层面还要确认DNS与HTTPS证书正常，因为Zotero GPT插件最终通过HTTPS调用api.deepseek.com，证书错误会表现为连接失败而不是密钥错误。
在正式接入前，可以用命令行或API调试工具做一次最小化验证。向OpenAI兼容的chat completions端点发送一条简短消息，模型名填写deepseek-chat，请求头携带Bearer密钥，若返回结构化JSON且包含choices字段，说明账户、网络和模型均可用。这个测试能提前区分401鉴权失败、404路径错误和429限流问题。测试通过后再打开Zotero，可减少在插件界面反复试错的成本。需要留意的是，测试请求也会消耗少量token，但费用极低，适合用来确认链路。
2. Zotero GPT插件安装与连接配置
Zotero 7安装完成后，需要获取Zotero GPT插件的.xpi文件。该插件通常发布在GitHub Releases页面，选择与Zotero 7兼容的最新版本下载。安装时打开Zotero的“工具”菜单，进入“插件”面板，点击右上角齿轮图标，选择“Install Add-on From File”，定位到刚下载的.xpi文件。安装完成后重启Zotero，插件会出现在设置或工具菜单中。若插件未显示，先检查Zotero版本是否过低，再确认.xpi没有下载损坏。某些版本还需要在Zotero高级设置中开启插件兼容选项，但正常发布版本通常无需额外操作。
进入插件设置后，核心配置项包括API Key、Base URL和Model。Base URL应填写DeepSeek的OpenAI兼容地址，常见写法是://api.deepseek.com/v1，具体取决于插件拼接路径的。API Key填入第一步保存的密钥，模型名填写deepseek-chat。若希望使用推理模型，可以改为deepseek-reasoner，但响应速度和费用会更高。部分插件版本还要求填写“API类型”或“Provider”，选择OpenAI兼容或自定义即可。保存后建议重启Zotero，让配置在插件进程中完整加载。
连接测试阶段最常见的问题是404、401和模型不存在。404通常表示Base URL多了或少了/v1，可以两种写法交替测试；401表示密钥错误、过期或包含空格；模型不存在则说明名称拼写错误，例如把deepseek-chat写成deepseek_chat。若请求超时，检查系统代理、防火墙和Zotero网络设置，必要时在插件中延长超时时间。测试成功后，在文献条目上右键应能看到GPT相关菜单，说明插件已经具备调用DeepSeek的能力。此时不要急于批量处理整库文献，先用一篇论文验证摘要和问答是否正常。
3. 接口参数、计费与兼容性调优
DeepSeek提供OpenAI兼容的Chat Completions接口，因此Zotero GPT这类按OpenAI格式编写的插件可以直接对接。deepseek-chat适合通用文本生成、翻译和摘要，上下文窗口较大，能够容纳多段PDF文本；deepseek-reasoner更偏向复杂推理和数学逻辑，但输出前会有思考过程，延迟与费用更高。在插件中可调的温度参数决定输出随机性，文献摘要建议使用较低温度，翻译和改写可略高。最大输出token要结合插件限制设置，过小会导致回答被截断，过大则可能触发费用上限或接口拒绝。
Zotero GPT读取PDF时不会一次性发送整本论文，而是按文本块抽取并拼接上下文。每篇论文的页数、图表文字和参考文献都会影响token消耗，因此长综述比短论文更贵。DeepSeek的计费按输入与输出token分别计算，缓存命中时输入价格通常更低，但插件是否利用缓存取决于请求前缀是否稳定。为了控制成本，可以在提问时限定范围，例如“只根据摘要和引言回答”，或先让模型生成检索式，再针对具体段落提问。对于需要反复使用的提示词，固定前缀有助于提高缓存命中率。
兼容性方面最需要注意的是embedding与向量检索。DeepSeek当前主要提供聊天补全接口，并不一定提供与OpenAI相同的文本嵌入模型，如果Zotero GPT启用了向量索引或语义搜索，直接沿用DeepSeek的Base URL可能导致嵌入请求失败。稳妥做法是关闭自动向量索引，只使用聊天补全；或者把嵌入服务继续指向OpenAI、本地Ollama等支持embedding的端点，而把聊天模型单独指向DeepSeek。若插件只允许一个Base URL，则优先保证问答可用，再评估是否需要语义检索。并发请求也不宜过高，免费额度或低余额账户容易触发429限流。
4. 文献阅读、翻译与问答工作流
配置完成后，最直接的用法是在Zotero文献列表中选中一篇论文，右键打开GPT菜单，选择针对PDF的问答或聊天。输入提示词时可以要求模型输出研究问题、理论框架、数据来源、方法设计、主要发现和局限，并指定用中文分点归纳。由于模型可能误读图表或参考文献，最好要求它标注依据的原文段落或页码。翻译任务可以限定为摘要、结论或方法部分，避免整篇翻译造成高额token消耗。生成结果可以复制到Zotero笔记，并与条目建立关联，便于后续写作时引用。
跨文献比较是DeepSeek接入Zotero后更有价值的场景。选中多篇同一主题的文献，向插件提问“这些研究在样本、方法、结论上的共同点和差异是什么”，模型会基于抽取的文本块进行归纳。对于系统综述，可以先让模型生成编码表，再人工核对每篇文献是否满足纳入标准。若结果出现虚构引用，应立即回到原文核验，不能把模型输出直接当作文献事实。插件生成的笔记可以打上“待核验”“已核验”标签，形成可追溯的阅读流程。
作为AI指导老师，建议把提示词模板化并分阶段使用。先让模型做术语解释和背景梳理，再针对研究方法提问，最后要求它指出论证薄弱环节。涉及未发表数据、临床隐私或受保密协议约束的文献时，要确认DeepSeek API的数据使用政策与机构合规要求，必要时改用本地模型。批量处理前先估算token成本，设置每日额度，避免月底账单超预期。这样既能把DeepSeek的推理能力嵌入Zotero工作流，又能保持学术研究的严谨与可控。
