用途：通过 pyzotero 从 Zotero 文库中检索、获取和分析论文，用于论文查找、文库搜索、附件处理、BibTeX 与草稿引用。默认使用 Zotero Desktop 本地 API，本地不可用时回退到 Zotero Web API。
主要能力：元数据搜索与全文搜索；查看单条目、子条目与附件；获取附件全文；获取或下载 PDF 路径；列出文库、集合与标签；DOI 到 key 索引；BibTeX 导出并与 master .bib 同步；向草稿插入引用并同步 .bib；渲染格式化参考文献（默认 APA）；健康检查。所有命令输出 JSON。
使用方式：运行 uv run --script <skill-dir>/scripts/zotero_tool.py，其中 <skill-dir> 为包含 SKILL.md 的目录。常用子命令包括 libraries、search "query"、search "query" --fulltext、item ITEM_KEY、children ITEM_KEY、fulltext ATTACHMENT_KEY、pdf ATTACHMENT_KEY、collections、tags、doiindex、bibtex、cite、bibliography、health。默认作用于个人文库，操作群组文库需先运行 libraries 获取 group id，再传 --library <group-id>。
论文阅读流程：先搜索，检查命中项的 data.itemType 确定顶层条目，全文搜索命中附件需通过 data.parentItem 补全父条目；多个匹配时展示简要元数据，无法推断时询问用户；用 children 找到 contentType 为 application/pdf 的子附件；用 pdf 获取路径；调用 mistral-pdf-to-markdown 技能转换为 Markdown，保存到 Notes/PaperInMarkdown/Author_Year_ShortTitle.md；分段阅读分析，先摘要与引言，再读目标章节。
引用与 BibTeX：bibtex、cite、bibliography 默认复用 Better BibTeX 的 citekey，BBT 不可用时回退到 Zotero 内置转换器并给出 key 不匹配警告；共享 --item-key / --query / --doi 选择参数、--library 目标与去重追加式 .bib 同步。
配置与限制：凭据从环境变量或 Notes/.env 读取，不打印到对话记录；Web API 模式需要 ZOTERO_LIBRARY_ID、ZOTERO_LIBRARY_TYPE（默认 user）、ZOTERO_API_KEY，本地模式无需凭据。详细回退规则、凭据设置与故障排查见 references/access-modes.md；完整工作流见 references/paper-reading.md；引用命令细节见 references/bibtex-citations.md。脚本通过 PEP 723 内联元数据固定 pyzotero 1.13.0。