# Zotero Collection Manager

> Zotero Collection Manager is an Agent Skill for apps & automation published in the cheneternity/Zotero-Analytical-Workflow-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

批量处理 Zotero 指定分类下的论文，支持断点续传。读取数据库文献列表，比对本地处理日志后，仅对未完成的条目逐一调用精读流程，实时更新进度。

- Skill name: `zotero-collection-manager`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/cheneternity/Zotero-Analytical-Workflow-Skills/blob/HEAD/skills/zotero-collection-manager/SKILL.md
- Repository: cheneternity/Zotero-Analytical-Workflow-Skills (300 GitHub stars when collected)

## SKILL.md

# Zotero Collection Manager

## 1. 任务初始化与断点读取
- **定位分类与目录**：获取目标 Zotero 分类名称，并设定目标路径为 `D:\ResearchVault\note\<分类名称>\`。
- **读取进度日志（Breakpoint）**：在目标路径下查找 `_ProcessLog_进度记录.md` 或 `.json` 进度缓存文件。
  - 若存在，解析其中已被标记为 `✅ 成功` 或 `⚠️ 跳过` 的论文 `Item Key` 或标题。
  - 若不存在，自动在目标路径下创建该进度文件。

## 2. 数据获取与任务过滤
- **查询数据库**：获取该分类下所有论文的清单（包含 `Item Key` 和 `标题`）。
- **计算差集（过滤）**：
  - 将总清单与进度日志进行比对。
  - 剔除已完成（成功/跳过）的条目，生成本轮的**待处理队列**。
  - 如果待处理队列为空，提示用户“该分类下所有论文已处理完毕”。

## 3. 循环调度引擎（实时存档机制）
针对待处理队列中的每一篇论文，严格串行执行，并且**每处理完一篇必须立即更新日志**：
1. **清理上下文**：强制清空内存变量，重置大模型分析状态。
2. **抓取数据 (Fetcher)**：传递任务给 `zotero-data-fetcher`。
   - *异常捕获*：若抓取失败（如无附件、无缓存），将状态记录为 `❌ 失败（原因）`，写入日志，跳过当前篇。
3. **生成笔记 (Writer)**：传递语料给 `zotero-analytical-writer` 写入 Obsidian。
4. **实时打卡（关键点）**：当前论文写入 Obsidian 成功后，立即打开 `_ProcessLog_进度记录.md`，追加一行记录：
   - 格式要求：`- [x] [时间戳] | 状态 | Item Key | 论文标题`
   - 例如：`- [x] 2024-05-20 14:00 | ✅ 成功 | ABCD123 | From heat to high-tech...`
5. **刷新根 Dataview 索引页（新增论文时强制执行）**：若当前论文对应的 `.md` 文件是首次创建，而不是覆盖旧文件，则在写入成功后立刻刷新 `D:\ResearchVault` 根目录下的 `文献索引.md`、`研究主题索引.md`、`研究方法索引.md` 和 `字段补全检查.md`。

## 4. 输出执行报告
全部循环结束后，向用户输出本轮的执行简报：
- 本轮总计发现未处理文献 [X] 篇。
- ✅ 新增成功：[数量] 篇
- ❌ 新增失败/待确认：[数量] 篇
- *附言：进度已实时同步至 Obsidian 文件夹内的日志文件中，下次执行将自动跳过以上成功条目。*

---

Source: https://www.openparable.com/skill/apps-automation/zotero-collection-manager (OpenParable). Cite the canonical URL above.
