用途：Pyzotero 是 Zotero API v3 的 Python 客户端封装，用于以编程方式管理 Zotero 文献库，包括读取条目与收藏集、创建和更新参考文献、上传附件、管理标签以及导出引用。
认证与配置：需先从 Zotero 密钥页面获取 User ID 与 API Key；群组库的 Library ID 为群组 URL 中 /groups/ 后的整数。凭据可存入环境变量或 .env 文件，如 ZOTERO_LIBRARY_ID、ZOTERO_API_KEY、ZOTERO_LIBRARY_TYPE（user 或 group）。
安装：uv add pyzotero；如需命令行支持则运行 uv add "pyzotero[cli]"。
基本用法：创建实例 Zotero(library_id='123456', library_type='user', api_key='ABC1234XYZ')，一个实例绑定一个用户或群组库，所有方法均作用于该库。条目数据位于 item['data']，可访问 title、creators 等字段。默认返回 100 条，用 zot.everything(zot.items()) 获取全部。写操作成功返回 True，失败抛出 ZoteroError。
常见操作：用 zot.top(limit=10) 取顶层条目，用 zot.items(q='machine learning', limit=20) 按关键词搜索；修改条目时先 zot.item('ITEMKEY')，改 item['data']['title'] 后调用 zot.update_item(item)；创建条目可用 item_template('journalArticle') 模板并填充 creators 后调用 create_items；导出 BibTeX 可先 zot.add_parameters(format='bibtex') 再取条目。本地模式无需 API 密钥，参数 local=True，且为只读。
适用场景：批量整理与检索文献、自动录入或更新元数据、程序化导出引用、整合进研究或写作流程。
限制：本地模式仅支持只读；写操作需要有效凭据并受 Zotero API 权限与配额约束；资料未提供具体价格、平台支持范围与性能数据。