zotero-openai-plugins

1. 基本信息

项目	内容
名称	zotero-openai-plugins
项目自述名称	`Zotero`（`.codex-plugin/plugin.json` 内 `interface.displayName` 原值）
作者/维护者	OpenAI 官方编写并托管于官方仓库 `openai/plugins`；技能操作的对象 Zotero Desktop 由 Corporation for Digital Scholarship 开发维护
来源链接	https://github.com/openai/plugins/tree/main/plugins/zotero
许可证	MIT（`plugin.json` 明确声明）
GitHub Stars/Forks	所属仓库 openai/plugins 4,948 / 671（GitHub API 实测；该仓库是 170+ 插件的合集，星数不直接归属本插件）
最新版本	`plugin.json` 声明 0.1.2；子目录提交历史 API 实测最近一次提交时间为 2026-06-08
安装方式	Codex CLI/App 内插件市场（Plugins/Connected Apps）搜索并安装，或直接引用插件目录 URL；本机需已安装并运行 Zotero Desktop

2. 功能介绍与亮点

让 Codex 直接操作用户本地的 Zotero Desktop 文献库：搜索条目/集合/标签、导出 BibTeX、把引用键插入 LaTeX 或 Markdown 草稿、按需读取已索引的全文内容，并通过 Zotero 的 connector 服务器导入 BibTeX/RIS 记录。

核心是一个纯标准库（stdlib-only）的 Python 脚本，通过本机 HTTP 接口 http://127.0.0.1:23119 与 Zotero Desktop 通信，不依赖任何云端账号或第三方 API Key
提供 status/probe 只读诊断命令，先确认本地 API 是否已开启，未开启时可一键 enable --restart
明确区分 Zotero 条目键（如 PXW99EKT）与导出的 BibTeX 键（如 vaswani_attention_2023），避免混淆
对“写入类”操作（导入新文献记录）要求先确认具体来源与目标，而非静默执行

3. 适用场景

固定分类：集成与工作流自动化。适合已经用 Zotero 管理文献、同时用 Codex 撰写论文、技术报告或研究简报的学生、研究者与技术写作者——尤其是需要频繁在 LaTeX 或 Markdown 草稿里插入引用、维护 references.bib 文件、又不想在 Zotero 界面和编辑器之间来回切换的场景。

4. 跨 Agent 兼容性

Codex：✅ 原生支持——.codex-plugin/plugin.json 为标准 Codex 插件清单，OpenAI 官方仓库直接维护
Claude Code：⚠️ 需自行接入——SKILL.md 明确说明核心脚本“不依赖 Codex 专属运行时发现机制”，理论上可将 skills/zotero 目录整体复制进 Claude Code 的技能目录直接调用；但未见任何官方或第三方针对 Claude Code 的适配说明，未经实测验证
OpenClaw：❓ 未验证——抓取材料未提及
Hermes Agent：❓ 未验证——抓取材料未提及

（未为兼容性单独发起搜索，以上判断仅基于已抓取材料。）

5. 推荐理由

Zotero 是学术界最广泛使用的开源免费文献管理工具之一，这个官方 Codex 插件把“搜文献、导出引用、往论文草稿里插引用”这套研究写作场景里每天都要重复的劳动交给 Agent。相比同类围绕云端知识库运作的技能，它完全在本机运行、不需要任何账号或订阅，安全边界清晰（只连本机端口），且核心脚本本身就是可以脱离 Codex 专属机制运行的标准 Python，迁移成本相对较低。

6. 评分

维度	分数	说明
受欢迎程度	7.0	OpenAI 官方编写并收录进官方插件目录（`plugin.json` 声明 `developerName: OpenAI`）；未见针对本插件本身的独立第三方评价或采用数据；所属合集仓库 4,948 星是整个 openai/plugins 仓库（170+ 插件合集）的数字，不代表本技能自身热度
可用性	8.0	Codex 插件市场一键安装；文档含 Fast start / Workflow / Common commands 完整分层说明；子目录最近一次提交时间为 2026-06-08；唯一前置条件是本机已安装免费开源的 Zotero Desktop 并开启本地 API（脚本提供一键开启），无付费依赖
安全性	9.0	见下方安全检查清单
综合	8.0	三项均值，超过 7.0 达标线，安全性远超一票否决线

安全检查清单：

Shell 命令：有，但范围明确——仅用于启动/重启本机 Zotero Desktop 进程（如 macOS 上的 open -a Zotero），未见 shell=True 或拼接用户输入执行任意命令
联网外发：仅连接本机 http://127.0.0.1:23119（Zotero Desktop 本地 API/connector 服务器），未发现与任何外部服务器通信
API Key/凭据：无——不依赖任何云账号或 API Key，纯本地调用
可疑指令：完整审阅 SKILL.md 全文及核心脚本（约 300 行），未发现要求执行流程外操作的可疑指令；脚本对“写入类”操作（import-bibtex/import-ris）明确要求先确认
作者/组织信誉：OpenAI 官方仓库编写并维护，plugin.json 声明作者与开发者均为 OpenAI，无造假迹象
License：MIT，plugin.json 明确声明
最近维护时间：子目录最近一次提交时间为 2026-06-08

7. 跟同类 Skills 相比的优势

项目	核心场景	运行方式	与本技能的差异
notion-openai-plugins（同仓库）	团队知识库沉淀、研究简报、会议纪要	云端 Notion 官方远程 MCP 服务器，需 OAuth 授权	面向团队协作知识库而非个人文献引用管理；需联网授权，本技能纯本地运行、无需任何账号
zotero-mcp（社区项目，54yyyu/zotero-mcp）	把 Zotero 库接入支持 MCP 的助手，用于讨论论文、生成摘要、分析引用关系	需自行搭建并运行独立 MCP Server	定位偏“和文献聊天”的问答场景；本技能更偏“引用工作流”（导出 BibTeX、往草稿插引用），且直接打包为 Codex 官方插件，无需额外起 MCP Server
llm-for-zotero（社区项目）	基于 Zotero 库的深度研究 Agent，产出文献综述	需自行配置多种 LLM 后端	定位为独立研究助手应用而非轻量技能包，安装与维护成本明显更高，非开箱即用

核心差异化：(1) 纯本地运行，不依赖任何云端账号或订阅；(2) 官方直接维护并随 Codex 插件市场分发，无需额外搭建 MCP Server 或配置多个 LLM 后端；(3) 专注“引用工作流”这一具体场景（搜索→导出→插入草稿），而非泛化的“和文献库聊天”。

8. 用户评价

本技能作为 Codex 官方插件目录的收录条目，目前在第三方平台尚无专门针对它本身的具名用户评价；仅在第三方插件聚合站点（如 explainx.ai、skillvault.md）查到目录页转载信息，不构成独立评价。

9. 安装使用方式

Codex CLI/App：在插件市场（Plugins / Connected Apps）中搜索并安装「Zotero」
手动安装：直接引用插件目录 https://github.com/openai/plugins/tree/main/plugins/zotero 加入本地或团队插件目录
首次使用：需已安装并运行 Zotero Desktop；首次调用 status 命令若发现本地 API 未开启，运行 enable --restart 即可一键开启并重启 Zotero
注意事项：无需重启 Codex 本身，但改动 Zotero 本地设置后需要重启 Zotero 应用才能生效

10. 注意事项

已知限制：依赖 Zotero Desktop 本机进程与本地 HTTP 服务，若 Zotero 未安装、未运行或本地 API 被禁用，所有功能均不可用
兼容性：官方打包面向 Codex 插件市场；虽然核心脚本本身不绑定 Codex 专属机制，但迁移到其他 Agent 需自行处理插件清单与调用入口，非开箱即用
潜在风险：涉及“写入类”操作（向 Zotero 库导入新文献记录）时应仔细核对来源与目标集合，避免误导入污染个人文献库