zotero-cli

zotero-cli Skill 是一套针对 Zotero 文献管理器的命令行增强工具集，它将 Zotero 的图形界面功能延伸到终端环境，为学术研究人员提供高效的文献管理解决方案。

核心用法：该 Skill 基于 Python 开发的 zotero-cli 开源项目，通过一系列辅助脚本（Bash 和 Python）实现终端化文献管理。用户可通过 zotcli query 快速检索个人文献库，使用 add-note 和 edit-note 管理研究笔记，利用 read 命令直接查看 PDF 附件。配套的 Helper Scripts 提供自动化配置检查（setup_and_check.sh）、配置备份恢复（backup_restore.sh）、版本更新检查（update_check.sh）以及批量查询处理（batch_process.sh）等功能。支持 BibTeX、RIS 等学术引用格式导出，兼容 Boolean 逻辑检索和短语搜索，满足复杂文献筛选需求。

显著优点：首先，命令行操作显著提升效率，研究人员无需离开终端即可完成文献检索和笔记管理，特别适合喜欢键盘操作的高级用户。其次，批量处理能力强大，通过 batch_process.sh 可自动化处理多个查询任务，export_citations.py 支持一键导出格式化引用，大幅减少重复劳动。第三，数据安全有保障，备份脚本自动管理配置文件历史版本，防止误操作导致数据丢失。第四，代码质量过硬，所有脚本遵循安全最佳实践，使用 set -euo pipefail 确保健壮性，subprocess 调用采用列表传参防止注入攻击。

潜在缺点与局限性：该工具要求用户已拥有 Zotero 账户并配置 API 凭证，对非 Zotero 用户无价值。命令行界面对不熟悉终端操作的用户存在学习门槛，需要掌握基本的 shell 命令和环境变量配置。作为 T3 级社区项目，虽然代码质量良好，但缺乏大型企业或基金会的长期维护承诺。此外，功能依赖 Python 3 环境和 pip/pipx 包管理器，在某些受限环境中部署可能遇到依赖冲突。

适合的目标群体：主要面向学术研究人员、研究生和博士生，特别是计算机科学、工程技术等习惯使用命令行工具的学科领域。适合需要频繁检索文献、管理大量读书笔记、撰写学术论文时快速插入引用的用户。对于构建自动化文献工作流（如结合 CI/CD 生成参考文献列表）的技术型研究者尤为适用。

使用风险：常规风险主要包括：1) 版本检查脚本会连接 PyPI 和 GitHub API，虽然为只读操作，但在高度保密的离线环境中可能需要禁用；2) 脚本需要读写用户主目录下的配置文件（~/.config/zotcli/）和备份目录，若权限设置不当（未遵循建议的 chmod 600）可能导致配置信息泄露；3) 作为社区维护项目，更新频率和长期支持存在不确定性，建议用户定期手动检查上游 zotero-cli 项目的安全更新。