用途：zot 是面向 Zotero 的一体化 CLI，用于检索、读取、导出和组织文献，并支持基于工作区的 RAG 内容检索。
主要能力：搜索元数据（zot search "transformer attention"）、读取条目详情（zot --json read ABC123）、导出 BibTeX（zot export ABC123）、格式化引用（zot cite KEY --style apa）、批量导入 DOI（zot add --from-file dois.txt）、更新与删除条目、提取 PDF 全文/大纲/指定章节、查找本地 PDF 路径、抓取缺失 PDF、重命名附件、补充期刊指标、集合与重复项管理、库统计，以及工作区创建与 RAG 查询（zot workspace query "RLHF" --workspace my-ws）。
使用方式：读取操作离线可用、零配置；写入操作需 API 凭据（zot config init）。程序化处理建议始终加 --json（stdout 非 TTY 时自动启用）。变更前可用 --dry-run 预览，重试时传 --idempotency-key。大 PDF 先用 --outline 再用 --section N 选择性提取，超过 2 万字符避免拉全文。工作区 RAG 索引不要未经确认就 --force 重建。find-pdf 需 Zotero 桌面端运行并安装桥接插件（zot bridge install）。完整参数可用 zot schema <cmd> 查看。
适用场景：终端内快速查文献元数据、批量导入与导出引用、按工作区做深度内容检索，以及需要带引用键证据包来撰写有依据回答时使用 zot ask。
限制：zot 本身不调用 LLM，ask 返回的是带 Zotero 条目键的片段与 answer_instructions，需自行综合并引用。写入依赖 API 凭据，find-pdf 与重命名依赖桌面端和桥接插件。Windows CJK 环境旧版本或子进程调用需设 PYTHONIOENCODING=utf-8。条目键为 8 位字母数字字符串。其余细节暂未提供。