Zotero 配置教程#
在 Zotero 中通过支持 OpenAI 兼容接口的 AI 插件接入 Crazyrouter,并明确区分可直接接入与不可直接接入的插件类型
Zotero 本身是文献管理工具,不直接内置 Crazyrouter 配置入口。实际接入方式通常是:先安装一个支持 AI 调用的 Zotero 插件,再在该插件里填写 Crazyrouter 的 OpenAI 兼容地 址、API Key 和模型名。这页最重要的原则不是“随便找个 Zotero AI 插件就能接”,而是先区分插件类型:可直接接入:插件支持自定义 Base API URL / API URL / Endpoint
不可直接接入或不适合作为公开主线:插件只支持填写官方 OpenAI Key,没有自定义上游地址入口
先说结论#
Crazyrouter 在 Zotero 里的公开推荐接法是:选择一个支持自定义 OpenAI 兼容地址的 Zotero AI 插件
把基础地址填为 https://api.crazyrouter.com/v1
Warning: 不是所有 Zotero AI 插件都支持自定义上游地址。如果某个插件只有“填 OpenAI API Key”的入口、没有 Base URL 或 API URL 设置,那么它通常不能直接把请求改走 Crazyrouter。这类插件不应作为公开默认教程。
为什么这样写#
Zotero 官方文档说明,插件是社区生态,安装方式统一,但能力并不统一
也有一些插件公开文档里只写了填 OpenAI API Key
因此 Crazyrouter 的公开文档应优先教用户选择“支持自定义 OpenAI 兼容地址”的插件,而不是默认所有插件都能直接接。适合谁用#
想在 Zotero 里做论文摘要、翻译、问答的用户
想把文献阅读和 Crazyrouter 模型调用放到一个工作流里的人
想在文献条目、PDF 阅读、笔记整理环节加入 AI 辅助的人
不想自己写脚本,希望直接在 Zotero 图形界面里完成配置的人
前置条件#
| 项目 | 说明 |
|---|
| Crazyrouter 账号 | 先在 crazyrouter.com 注册 |
| Crazyrouter token | 建议单独为 Zotero 创建一个 token |
| Zotero 桌面版 | 插件主要运行在桌面端 |
| AI 插件 | 需要支持自定义 OpenAI 兼容地址 |
| 文献或 PDF | 至少准备一篇可测试的条目 |
安装 Zotero#
Windows#
macOS#
Linux#
Note: 根据 Zotero 官方文档,插件主要安装在桌面版里。这类 AI 插件通常不适合从移动端作为首轮配置入口。
如何选择 Zotero AI 插件#
能填写 Base API URL、API URL 或 Endpoint
推荐的公开判断方法#
如果插件文档里明确写了下面这类能力,通常更适合接 Crazyrouter:例如,zotero-chatgpt 的公开 README 明确提到支持自定义 base API URL;而 Aria 的公开 README 重点写的是填写 OpenAI API Key 和模型偏好,公开说明里没有把“自定义上游地址”作为主线能力。因此在 Crazyrouter 文档里,更稳妥的主线应是“选择支持自定义 OpenAI 兼容地址的插件”。推荐配置格式#
不同插件字段名可能不同,但第一次建议按下面思路填写:| 插件字段 | 推荐值 |
|---|
| Base API URL / API URL | https://api.crazyrouter.com/v1 |
| Full Endpoint | https://api.crazyrouter.com/v1/chat/completions |
| API Key | sk-xxx |
| Model | gpt-5.5 |
Tip: 如果插件让你填写的是“基础地址”,优先填 https://api.crazyrouter.com/v1。只有在插件明确要求“完整聊天接口地址”时,再填 https://api.crazyrouter.com/v1/chat/completions。
配置步骤#
第 1 步:创建 Zotero 专用 Crazyrouter token#
按你的系统安装 Zotero,并确认可以正常导入或查看一篇论文条目。第 3 步:下载并安装 AI 插件#
根据 Zotero 官方插件安装文档,先下载插件的 .xpi 文件,然后在 Zotero 中:不同插件位置可能不同,但核心是找到 API 与模型配置区域。第 5 步:填写 Crazyrouter 地址、Key 和模型#
Base API URL: https://api.crazyrouter.com/v1
Endpoint: https://api.crazyrouter.com/v1/chat/completions第 6 步:如插件要求,重启 Zotero#
某些插件在修改 API Key、模型或首选项后需要重启 Zotero 才生效。第一次配置完成后,建议主动重启一次。第 7 步:用最小学术场景做首轮验证#
Summarize this paper in 3 bullet points.
推荐验证顺序#
推荐模型#
| 场景 | 推荐模型 | 原因 |
|---|
| 首轮链路验证 | gpt-5.5 | 2026 年 3 月 23 日已在生产环境实测成功,最适合先验证插件到 Crazyrouter 的基础链路 |
| 深度分析与解释 | claude-opus-4-8 | 更适合复杂总结、方法比较、长文解释 |
| Gemini 备用档 | gemini-3.1-pro | 适合作为第二条兼容性验证路径 |
适合 Zotero 的使用方式#
单篇论文摘要#
最适合作为首轮验证,因为上下文简单、结果容易判断。PDF 翻译#
多文献对比#
不建议作为第一步。等单篇摘要和翻译已经稳定后,再尝试多篇对比、综述提纲、研究空白提取等更复杂任务。笔记整理#
如果插件支持把结果写回 Zotero 笔记,建议先从短摘要开始,不要一开始就批量生成长笔记。Token 最佳实践#
| 设置 | 建议 | 说明 |
|---|
| 专用 token | 必须 | Zotero 不要和 IDE、自动化流程共用 token |
| 模型白名单 | 强烈建议 | 先只放行 1 到 2 个模型 |
| 配额上限 | 强烈建议 | 长 PDF、多轮总结会放大消耗 |
| 分场景 token | 建议 | 个人学术使用与团队共享分开 |
| 泄露处理 | 立即轮换 | 演示、录屏、共享设置页暴露后应立刻换 key |
验证清单#
常见错误与修复#
| 现象 | 常见原因 | 修复方式 |
|---|
| 插件里只有 OpenAI Key,没有 Base URL | 插件不支持自定义上游 | 换成支持自定义 Base API URL 或 Endpoint 的插件 |
| 401 unauthorized | token 错误、复制不完整或失效 | 重新生成 token 并重新填写 |
| 404 | 基础地址或完整接口地址填错 | 基础地址改回 https://api.crazyrouter.com/v1,或完整地址改回 https://api.crazyrouter.com/v1/chat/completions |
| 403 / model not allowed | token 没放行当前模型 | 在 Crazyrouter token 设置中放行该模型 |
model not found | 模型名写错 | 先改回 gpt-5.5 做最小验证 |
| 插件没反应或设置改了不生效 | 插件需要重启 Zotero | 重启 Zotero 后重试 |
| 摘要失败但接口没报错 | 当前条目没有摘要、PDF 没附件或插件没拿到上下文 | 先换成带摘要或带 PDF 的条目测试 |
| 长文处理很慢 | PDF 太长或任务过重 | 先缩小到单段、单页或单篇摘要 |
FAQ#
Zotero 能直接配置 Crazyrouter 吗?#
通常不是直接在 Zotero 本体里配置,而是通过支持 OpenAI 兼容接口的 AI 插件配置。哪类插件最适合接 Crazyrouter?#
优先选择支持 Base API URL、API URL 或 Endpoint 自定义的插件。如果插件只能填 OpenAI API Key 怎么办?#
这类插件通常不能直接改成 Crazyrouter 上游,不适合作为公开默认方案。更建议换一个支持自定义地址的插件。基础地址应该填什么?#
优先填 https://api.crazyrouter.com/v1。第一个模型填什么?#
什么时候再做多篇分析或复杂综述?#
等单篇摘要和单篇翻译已经稳定后,再逐步升级任务复杂度。Note: 如果你的目标是“先让 Zotero 跑通 Crazyrouter”,最关键的不是一开始就追求最强插件,而是先确认你选的插件真的支持自定义 OpenAI 兼容地址,然后用 gpt-5.5 跑通单篇摘要。
Modified at 2026-09-28 08:55:34