核心用法
Zotero Scholar 是一款面向学术研究者的文献入库自动化工具，通过命令行脚本将论文信息批量保存至 Zotero 个人文库。用户需提供 ZOTERO_CREDENTIALS（格式：userID:apiKey）完成身份认证，随后可通过 uv run 执行 save_paper.py 脚本，传入论文标题、作者、URL、摘要、AI生成总结及自定义标签等参数。脚本基于 PEP 723 标准实现自管理依赖，执行时自动安装 pyzotero 库，无需手动配置 Python 环境。
显著优点
1. 自动化入库：支持元数据、PDF链接、AI总结的一站式保存，省去手动复制粘贴的繁琐操作；
2. 去重机制：通过 --url 参数实现链接级排重，避免重复添加同一文献；
3. 零依赖管理：uv 运行时自动解析并安装依赖，降低环境配置门槛；
4. 标签体系灵活：支持自定义标签分类，便于后续文献检索与整理。
潜在缺点与局限性
- 环境变量敏感：
ZOTERO_CREDENTIALS以明文形式存储，存在凭证泄露风险； - 功能边界单一：仅支持新增入库，缺乏更新已有条目、附件下载、同步状态查询等高级功能；
- CLI 交互门槛：需熟悉命令行操作，对非技术背景用户不够友好；
- 网络依赖：依赖 Zotero Web API，国内访问可能受网络条件限制。
适合人群
- 需要批量导入文献的研究生、科研人员；
- 已使用 Zotero 作为主力文献管理工具的用户；
- 熟悉命令行操作、追求自动化工作流的技术型学者。
常规风险
- API 密钥泄露：若
ZOTERO_CREDENTIALS被误提交至公共仓库，可能导致文库数据被恶意篡改或删除； - 元数据质量依赖：自动抓取的摘要、作者信息可能存在格式不统一问题，需人工二次校验；
- 服务可用性：Zotero 官方 API 的稳定性与速率限制可能影响大规模批量操作。