用途：在 Claude Code 中操作 Zotero 文献库，覆盖元数据检索、全文与语义搜索、引用导出、PDF 提取、问答和库管理。
主要能力：zot 负责 CRUD、阅读、导出、PDF 与统计，基于本地 SQLite，速度即时；rak 负责语义/混合检索与问答，使用向量加 BM25，约 2 秒。处理结果时建议始终加 --json。
用法要点：按标题/作者/标签搜索用 zot --json search "transformer"；按论文内容或全文搜索用 rak --json search "query" --hybrid；相似论文用 rak --json similar KEY；纯关键词检索可用 rak --json search "query" --bm25；阅读用 zot --json read KEY；导出引用用 zot export KEY；PDF 全文用 zot --json pdf KEY；统计用 zot --json stats；问答用 rak ask "question" --hybrid。原则是元数据与所有写操作走 zot，涉及内容、语义或问答的搜索走 rak，不确定时优先 rak --hybrid。若未安装 rak（用 which rak 检查），全部回退到 zot。
常用命令：zot add --doi "..."、zot add --url "..."、zot --no-interaction delete ITEMKEY、zot collection create/move/rename/delete、zot config init、zot config profile set lab、zot config cache stats/clear。全局标志包括 --json、--limit N、--detail minimal/full、--no-interaction、--profile NAME、--verbose。rak 首次搜索前需执行 rak index，另有 rak index --full、rak reindex、rak status、rak clear --yes；导出可用 rak export "query" --format csv 或 --format bibtex --output refs.bib。
适用场景：文献发现与阅读、语义检索、引用导出、PDF 文本提取、库统计、基于文献库的问答，以及借助 AI 整理分类文献库。
限制：zot 读操作可离线零配置，写操作需通过 zot config init 配置 API 凭据；rak 首次搜索前必须建索引；条目键为 8 位字母数字字符串（如 K853PGUG）；写入后需 Zotero 桌面端同步，再执行 rak index 更新搜索索引。其余收费、价格、平台与效果信息暂未提供。