用途：zot 是 Zotero 的一体化 CLI，用于搜索、读取、导出和组织文献，并处理 PDF 全文。读取操作基于本地 SQLite，离线零配置；写入操作需要 Zotero Web API 凭据（zot config init）。
主要能力：搜索元数据与全文（zot search "query"）；读取条目详情（zot --json read KEY）；导出 BibTeX/RIS/JSON（zot export KEY --format bibtex）；生成格式化引用（zot cite KEY --style apa）；批量导入 DOI（zot add --from-file dois.txt）或单个 DOI（zot add --doi "10.1038/..."）；更新与删除条目；提取 PDF 全文、大纲与指定章节（zot --json pdf KEY、--outline、--section N）；获取本地 PDF 路径（zot attachment path KEY）；查找并附加缺失 PDF（zot find-pdf KEY，需 Zotero 桌面端与 bridge 插件，先执行 zot bridge install）；重命名附件（zot rename KEY --dry-run）；补充期刊指标（zot enrich KEY --set "JCR=Q1"）；集合管理、查重、最近条目与库统计；集合内排序深度检索（zot --json search --ranked "q" --collection COLL）；证据包问答（zot --json ask "question" --collection COLL，返回带条目 key 的片段与 answer_instructions，zot 不调用 LLM，需自行综合并引用）；全文语料导出供 grep（zot text --dir ~/zot-text）；相似度网络图（zot net，离线 TF-IDF，需 [net] 额外依赖）。
使用方式：程序化处理始终加 --json（stdout 非 TTY 时自动启用）；用 --detail minimal/full 控制输出量；用 --limit 限制结果；自动化时加 --no-interaction；写入前用 --dry-run 预览，重试时传 --idempotency-key。大 PDF 先用 --outline 再用 --section N 选择性提取，超过 20k 字符避免拉全文。条目 key 为 8 位字母数字。Windows CJK 环境旧版本或子进程调用需设 PYTHONIOENCODING=utf-8。可用 zot schema <cmd> 查看完整参数与安全等级。
限制：写入需 API 凭据；find-pdf 与 rename 依赖 Zotero 桌面端和 bridge 插件；net 需额外依赖；ask 不生成答案，仅提供证据。其余细节资料未提供。