dsh-zotero-wiki

中文 | English

DeepSeekHarness（dsh）× Zotero 插件：自动同步 Zotero 文献库，用 MinerU 解析 PDF、用 DeepSeek 阅读全文，把文献编译成可检索的 Obsidian Wiki，并让 Agent 在回答时附带可追溯的文献引用。

---

项目定位（范围）

是什么：一个 Node/Cordis 风格的 dsh 插件 + 独立 CLI。它把你的 Zotero 文献库变成一座持续更新的 Obsidian 知识库，并暴露原生工具供 Agent 检索。

完整链路：

Zotero（本地库 / Web API）
  └─ sync：增量同步元数据 → .zotero-sync/sync.db（SQLite 状态库）
      └─ parse：MinerU 官方平台解析 PDF → raw/ 源文件 + DeepSeek 全文笔记 → wiki/ 单篇页
          └─ compile：主题综述、索引、交叉链接、归档标记
              └─ query：Agent 通过 query_zotero_wiki 检索，回答附 [Zotero key, §章节] 引用

明确不做（保持轻量）：向量数据库、自动聚类、多用户服务端、定时后台服务、Web UI、Zotero 注释（高亮/批注）同步、引用页码提取。

---

特性

能力	说明
双源同步	本地 zotero.sqlite（临时副本只读打开，不干扰 Zotero 进程）或 Zotero Web API（version 游标增量）
交互式范围	全部 / 指定 Collection（含子级）/ 标签过滤，选择结果持久化，启动时静默复用
PDF 智能解析	MinerU 官方开放平台（上传→轮询→Zip），解析产物落为 raw/ bundle（Markdown + images/），原始 PDF 不落盘
DeepSeek 全文笔记	deepseek-chat 全文直读（100K token 上限、尾部截断），产出中文结构化笔记（摘要/方法/结论/创新点/局限/关键引用）
优雅降级	无 PDF 或解析失败 → 基于标题+摘要生成简版笔记；后续补 PDF 自动升级全文笔记
配额与并发	单轮解析上限 MAX_PARSE_PER_SYNC（默认 50），并发 3，失败记库、下轮可重跑
Wiki 编译	主题综述（LLM 增量改写）、index/authors/years 索引、See Also 交叉链接、归档标记（不删页）、追加式 log
Agent 查询	minisearch 内存全文检索 + 中文 bigram 分词，返回片段与 [key, §章节] 章节级引用；无命中明确告知，不编造

---

架构

┌────────────────────┐      ┌─────────────────────────────────────────┐
│  Zotero 桌面端      │ ───▶ │ dsh-zotero-wiki                          │
│  / Zotero Web API  │      │                                          │
└────────────────────┘      │  sync 引擎 ──▶ SQLite 状态库             │
                            │  parse 管道 ─▶ MinerU + DeepSeek        │
┌────────────────────┐      │  compile 器 ─▶ 综述/索引/链接/归档       │
│ MinerU 官方平台     │ ◀──▶ │  query 索引 ─▶ minisearch + bigram      │
│ DeepSeek API       │      │                                          │
└────────────────────┘      │  dsh 工具：query / sync / parse          │
                            └────────────────┬────────────────────────┘
                                             ▼
                            ┌─────────────────────────────────────────┐
                            │ Obsidian Vault                           │
                            │  raw/（解析源文件） wiki/（笔记与索引）   │
                            │  references/（模板） .zotero-sync/（状态）│
                            └─────────────────────────────────────────┘