用途：让 agent 把用户的自然语言 Zotero 任务落到正确执行路径，操作本机已有 Zotero 库或 reading workspace。zot 是唯一执行面，ref/ 里的旧 Python 实现与 zot mcp serve 都不是当前主路径。
主要能力：库内检索、列表翻页、统计、citekey 直达、collection 读取；单篇条目详情、children、引用、导出；PDF 全文、outline、批注与 note 检索；workspace 新建、索引、关键词检索与问答、导出 markdown/json/bibtex；saved search 管理；附件下载；BibTeX/RIS 导入；note、tag、collection、annotation 等写入；merge/dedupe；Scite 撤稿与引用质量检查；版本增量、回收站、preprint 状态同步；doctor 诊断与 config profile 管理。
使用方式：优先 zot --json ...，开发仓库且 zot 不在 PATH 时用 cargo run -q -p zot-cli -- ...。--json 是全局 flag，须放在子命令前。首次接触环境、任何写操作、PDF 相关任务等先跑 zot --json doctor。导入用 item import --file/--text 先 dry-run，确认目标、可写性、记录数和格式后再加 --confirm。workspace 名须为 kebab-case。
边界与限制：本地 SQLite 与 Zotero Local HTTP 只读，禁止直接修改 zotero.sqlite。connector 仅在本机向 Zotero UI 当前选中目标新增 BibTeX/RIS 条目，不支持 update、tag、note、collection、merge/dedupe，且不经 Web API 回退。其他 mutation 走 Web API，需 ZOT_LIBRARY_ID 与 ZOT_API_KEY。高风险删除、合并、批量写与 sync update-status --apply 须先 preview 再确认；low-confidence 组默认跳过，需另行明确授权。item annotation create 仅适用于 application/pdf 附件。缺少 Better BibTeX、Pdfium 或 embedding 时相应能力降级。Scite 依赖外部服务，不可用时应如实说明。收费、价格与平台支持暂未提供。