pp-zotero-research-library

用途：在需要用户自有研究库时，用本地缓存做研究取证——先搜本地，未命中再回退在线 API 或开放网络。主要能力：ground 对标题、摘要、作者、标签及附件全文做离线排名全文检索，返回片段与可引用元数据；items recent 按 dateAdded 列出近期新增，支持 --days 截断；collections tree 一次输出完整集合层级及各节点条目数；cite 从本地缓存解析 Better BibTeX citekey 并导出对应 BibTeX（桌面端可用时经本地 JSON-RPC 回填 citekey）；cache status 查看同步游标、行数与 FTS 计数、上次同步时间，cache reindex 可零网络重建 FTS 索引。用法：先安装 CLI，验证 zotero-research-library-pp-cli --version，报告目录需在 PATH 上；npx 安装失败时可回退 Go 安装（需 Go 1.26.5 及以上）。在 zotero.org/settings/keys 创建 API key 并设置 ZOTERO_API_KEY（或 auth set-token），CLI 会自动解析 userID，运行 doctor 验证。任意命令可用 --agent 展开为 --json --compact --no-input --no-color --yes，并用 --select 精简字段。--data-source local 不刷新，live 直读 API 且不改本地库，auto 可能做有界刷新，设 ZOTERO_RESEARCH_LIBRARY_NO_AUTO_REFRESH=1 可跳过刷新钩子。限制：对 API 只读，不能创建、修改、删除条目；不下载 PDF 或取附件文件，只索引已提取文本；不做开放网络文献检索，只覆盖用户自己的库；缓存新鲜度仅代表已覆盖命令路径的当前状态，不保证完整历史回填。