Zotero Library — Development skill for Claude Code

zotero-library

让你的 AI Agent（DSH / Claude Code / Codex 等）**直接读懂你的 Zotero 文献库**： 元数据搜索、PDF 全文检索、笔记与高亮、按页取正文、一键生成 APA 7 / GB/T 7714 / BibTeX 引用。

**零依赖、只读、离线可用**。不需要 Zotero 客户端开着，不需要 API key，不需要 `zot` / `rak`。

[](https://nodejs.org) [](LICENSE) [](#安全与隐私)

---

它解决什么问题

Zotero 里的 1000 篇文献，对 AI 来说原本是一堆不可见的 PDF。装了本技能之后，你只要说：

「我库里关于培养阴性 PJI 的文献有哪些？」 「这篇里我做过哪些标注？」 「把这几篇按 GB/T 7714 生成参考文献。」 「帮我找找我笔记里提过 IL-10 的地方。」

Agent 就能直接检索、读取、引用你的真实文献库，而不是靠幻觉编造。

能力	命令
元数据搜索（标题/作者/摘要/期刊/标签/DOI/年份）	zotlib search
PDF 正文全文检索（返回页码 + 命中片段）	zotlib fulltext
条目详情 + 你自己的笔记与 PDF 高亮/批注	zotlib read
按页提取 PDF 正文	zotlib text --pages 1-3
引用：APA 7 / GB-T-7714 / BibTeX / RIS / CSL-JSON	zotlib cite / zotlib export
分类、标签、最近添加、关联文献、统计	zotlib collections / tags / recent / related / stats

与 `zotero-cli`（zot + rak）的区别

	本技能	zot/rak 方案
依赖	无（只要 Node ≥ 22.5）	需另装 zot、rak，rak 还要下载嵌入模型建索引
Zotero 运行时	✅ 自动读数据库快照	部分命令受锁影响；新版 Zotero 表结构变化可能报错
全文检索	✅ 用 Zotero 自带全文索引，带页码	依赖自建索引
笔记/标注/引用	✅ 内置	部分支持
语义搜索	❌（关键词 + 全文）	✅ rak 向量检索

两者可以共存：**日常查询用本技能（快、稳、零配置）**，需要语义相似度时再用 `rak`。

---

一键安装

从 GitHub 安装（推荐，任选其一）

# 方式 1：agent skill 管理器（一条命令装进 ~/.agents/skills）
npx skills add yanglin7723/zotero-library -g

# 方式 2：clone 后跑安装器（会探测数据目录、创建 zotlib 命令、自检）
git clone https://github.com/yanglin7723/zotero-library.git
cd zotero-library
powershell -ExecutionPolicy Bypass -File .\install.ps1   # Windows
./install.sh                                              # macOS / Linux

安装器会做四件事：

1. 检查 Node ≥ 22.5；
2. 自动探测你的 Zotero 数据目录（读 Zotero 首选项 prefs.js，支持自定义数据目录如 D:\Zotero）；
3. 把技能复制到 ~/.agents/skills/zotero-library/（DSH / Claude Code 的技能目录）； 4