| name | zotero-data-fetcher |
| description | 根据 Zotero Item Key 或标题提取元数据、父条目与 PDF 附件、批注、Notes、.zotero-ft-cache 和本地 PDF 路径，并为全文归档或分析写作提供可追踪的原始数据。此技能不翻译、不总结、不替代全文证据。 |
Zotero Data Fetcher
职责
只负责找到 Zotero 数据、父条目和 PDF；不负责 MinerU 转换、中文分析笔记或用户检索。
统一输出字段
尽可能输出以下字段，并保持同名：
zotero_key、pdf_key、title、author、year、doi、collection、note_path、fulltext_path、pdf_path、annotations、zotero_item、zotero_pdf。
其中 zotero_key 是父条目唯一主键，pdf_key 是 PDF 附件键；标题只作为人工核对或唯一 fallback。
模式 A：首次论文处理
- 读取 Zotero
prefs.js，确认生效的数据目录；按当前可用的 Zotero connector/API 或现有提取脚本查询父条目。
- 获取标题、作者、年份、DOI、所属 Collection、父条目 Key。
- 在子附件中锁定 PDF，记录附件 Key 和真实本地路径；不存在 PDF 时明确失败原因。
- 提取批注、Notes 和
.zotero-ft-cache（若存在），但保持原始语言和原始内容。
- 将
PDF path + metadata 交给 zotero-fulltext-archiver；将原始语料交给 zotero-analytical-writer。
模式 B：已有论文证据查询
- 若分析笔记存在
fulltext_path，先返回并使用该全文路径。
- 精确正文证据优先级为：MinerU Fulltext → Original PDF verification →
.zotero-ft-cache fallback。
- 批注可用于理解阅读重点，但不能替代正文原文。
- 缓存或批注缺失不等于 PDF 缺失；分别记录
cache_found、pdf_found 和 annotations_found。
约束
- 不根据标题猜 Item Key；同名或多条候选必须报告冲突。
- 不修改 Zotero 数据库，不移动原 PDF，不覆盖无关文件。
- 不在 Fetcher 阶段翻译、总结或套用中文模板。
