zoterolisted

# Zotero Read-write bridge to the user's local Zotero library via the `zotron` CLI and Zotero-side XPI plugin. **Dependency:** The `zotron` CLI must be on PATH, and Zotero desktop must be running with the XPI plugin installed. Before your first CLI call, check: 1. `command -v zotron` — if missing, run `/zotron:setup` which handles the full install chain (cargo-binstall → GitHub Releases → mirror fallback → cargo install from source). 2. `zotron ping` — if it fails, ask the user to start Zotero; if the XPI was never installed, run `/zotron:setup` Do not curl HTTP endpoints directly; always use the `zotron` CLI. ## Pick a workflow | User intent | Workflow | Sub-file | |---|---|---| | Find / read papers, browse collections, get fulltext or annotations | search | [search.md](search.md) | | Add by DOI/URL/ISBN/file, update metadata, manage collections & tags, dedupe | manage | [manage.md](manage.md) | | Generate references in GB/T 7714, BibTeX, RIS, CSL-JSON | export | [export.md](export.md) | | OCR scanned/Chinese PDFs into hidden per-PDF raw/block/chunk sidecars | ocr | [ocr.md](ocr.md) | | RAG retrieval hits for literature review / academic-zh span provenance | rag | [rag.md](rag.md) | A typical session chains them: `search` to locate papers → `manage` to organize → `ocr` + `rag` for literature review → `export` for citations. ## CLI conventions All commands use the `zotron` CLI with noun-verb structure: ```bash zotron <namespace> <verb> [args] [--flags] ``` **Typed