# Zotero Data Fetcher

> 根据 Zotero Item Key 或标题提取元数据、父条目与 PDF 附件、批注、Notes、.zotero-ft-cache 和本地 PDF 路径，并为全文归档或分析写作提供可追踪的原始数据。此技能不翻译、不总结、不替代全文证据。

- Skill: `cheneternity/zotero-data-fetcher` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cheneternity/zotero-data-fetcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cheneternity/zotero-data-fetcher/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: cheneternity (https://skillmd.com/u/cheneternity)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cheneternity/zotero-data-fetcher

---


# 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：首次论文处理

1. 读取 Zotero `prefs.js`，确认生效的数据目录；按当前可用的 Zotero connector/API 或现有提取脚本查询父条目。
2. 获取标题、作者、年份、DOI、所属 Collection、父条目 Key。
3. 在子附件中锁定 PDF，记录附件 Key 和真实本地路径；不存在 PDF 时明确失败原因。
4. 提取批注、Notes 和 `.zotero-ft-cache`（若存在），但保持原始语言和原始内容。
5. 将 `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 阶段翻译、总结或套用中文模板。