本文对应 OpenAI 插件中的 Zotero Skill，2026年10月11日核对其公开源码。该实现连接本机 Zotero Desktop，不是填一个团队库网址就自动获得云端访问权。原文献条目与附件需要先在本地库中可用。
先准备桌面库与插件助手
打开 Zotero Desktop，确认能手工找到一条你已收录的文献。客户端还需要加载 Zotero 插件，并有 Python 3 可执行。让 Codex 定位已安装插件的 skills/zotero/SKILL.md；插件根目录是其上两级目录，不要照抄其他用户的缓存路径。
检查本地API连接
以下命令中的 <plugin-root> 是实际插件绝对路径，必须替换。Windows若使用python而不是python3，先用python --version确认是Python 3，再相应替换启动器。
python3 <plugin-root>/skills/zotero/scripts/zotero.py status --json
状态应能指出本地API是否开启和连接是否可达；服务端口是localhost:23119。没有启动Zotero就先启动；显示API未启用时，可以明确要求Codex“启用本地API并按需要重启Zotero”，先保存正在编辑的内容。不要把端口拒绝连接误判为库中没有文献。
用库里已有题名验证检索
先选择一条你能在Zotero看到的题名关键词，运行搜索。以transformer为查询示例：
python3 <plugin-root>/skills/zotero/scripts/zotero.py search "transformer" --json
也可直接给Codex：“使用Zotero Skill，搜索本地库中题名含transformer的条目，只列题名、作者、年份、Zotero条目键；不要修改库或读取附件。”自然语言条件可能还需要对返回结果做筛选，不能假定每个条件都是助手的命令参数。
预期输出是一份真实命中清单，或者明确空结果。教学整理表可以用“库中实际题名／实际作者／实际年份／返回的条目键”四列；本文不虚构一篇论文冒充连接成功记录。若已知题名也搜不到，先检查当前本地库、同步状态和关键词，再缩小条件。
导出与引用前核对
搜索正确后，可要求Codex把选中条目导出到项目的references.bib，并报告绝对路径和条目数量。导出后打开文件，核对作者顺序、年份、题名及DOI。Zotero条目键与BibTeX引用键是两种标识：前者定位库内条目，后者用于文稿引用；不能直接互换。
附件全文读取是另一项操作，只有确需阅读全文时再提出，并检查本机附件是否存在及索引可用。未访问全文时，只能称“检索到条目或摘要”，不能写“已读完论文”。导入、删除或修改条目还会改变文献库，应明确目标后再做。
资料来源
- OpenAI Plugins：Zotero Skill
用于核对 Skill 的公开来源、连接前置条件和研究资料整理范围；仓库内容以当前页面为准。
- Zotero 官方文档
用于核对 Zotero 库、集合、条目和附件的基础概念；账号与同步状态以用户当前设置为准。
FAQ
Zotero Skill 能替我读完整篇论文吗？
它可以帮助搜索条目、读取可访问的元数据和组织研究材料。是否能读取附件取决于连接权限和文件状态，不能把摘要或笔记当作全文阅读。
为什么检索结果缺少一部分文献？
先检查当前库、集合、标签和查询词，再确认连接账号是否有权限读取团队库。必要时记录未访问范围，不要用空结果推断库中不存在。
可以直接让 Skill 生成论文引用吗？
可以先生成候选引用，但要回到 Zotero 条目和原文核对作者、年份、版本、DOI、页码及引用格式，再用于正式写作。
下一步
继续阅读与你当前问题相关的教程：
