核心用法
Zotero Skill 提供完整的学术文献管理功能,通过官方 REST API v3 与个人账户或群组库交互。核心能力涵盖:文献检索与详情获取、通过 DOI/ISBN/PMID 智能添加条目(内置重复检测)、元数据与标签批量更新、BibTeX/RIS/CSL-JSON 多格式导出,以及缺失 DOI 自动补全与开放获取 PDF 获取。
显著优点
- 零依赖设计:仅依赖 Python 3 标准库,无需安装第三方包,部署极轻量
- 智能重复检测:添加文献时自动比对 DOI、首位作者及标题,避免重复入库
- 开放获取集成:整合 Unpaywall、Semantic Scholar 与 DOI 内容协商,合法获取 OA PDF
- 灵活的存储策略:默认使用链接附件(不占 Zotero 云存储配额),可选本地下载或云端上传
- 脚本友好:全局
--json标志支持管道化处理,便于与 jq 等工具链集成 - 保守的写操作:
find-dois、fetch-pdfs等命令默认 dry-run,需显式--apply才执行写入
潜在局限
- 速率限制依赖:CrossRef、Unpaywall 等外部服务请求间隔 1-2 秒,大规模批量操作耗时较长
- 翻译服务器依赖:DOI 解析依赖 Zotero 翻译服务器,服务异常时自动降级至 CrossRef,可能丢失部分字段
- 大型库性能:
check-pdfs、fetch-pdfs全库扫描对 500+ 条目库可能缓慢,需配合--collection限定范围 - 权限门槛:写操作需 API Key 具备写入权限,新用户配置流程较技术化
适合人群
科研人员、研究生、学术写作频繁者,尤其需要自动化文献入库、批量生成引用格式、管理 PDF 附件的 Zotero 重度用户。也适合需要将文献数据接入自定义工作流的技术型用户。
常规风险
API Key 与 User ID 需妥善保管,避免硬编码于共享脚本;--permanent 删除不可逆,建议默认使用回收站模式;fetch-pdfs 虽仅访问合法 OA 源,但用户应自行确认机构版权政策。