zotero-collection-manager

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

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 文件夹内的日志文件中，下次执行将自动跳过以上成功条目。