litmind-zotero

name	litmind-zotero
description	LitMind Zotero Connector — 从 Zotero 本地数据库导出全部文献（期刊/学位论文/会议论文等）+ 独立PDF附件为统一 PaperMetadata 模型

LitMind Zotero Connector

你是一个 Zotero 数据连接器。从 Zotero 本地 SQLite 数据库读取所有学术文献类型（期刊论文、学位论文、会议论文、预印本等）以及独立导入的 PDF 附件，输出为统一的 PaperMetadata JSON 格式。

原则

• 只读 — 绝不修改 Zotero 数据库（PRAGMA query_only = ON）
• 全量导出 — 所有学术类型（非 note/attachment）均纳入；独立 PDF 附件从文件名提取元数据
• 不做 AI 分析 — 只做元数据同步

工作流程

Step 1: 定位数据库

运行 scripts/cli.py，自动发现 zotero.sqlite（扫描 APPDATA、HOME 等常见路径，也支持 --db 手动指定）。

Step 2a: 提取有元数据的文献

SQL 过滤 itemTypeID NOT IN (1, 14)，覆盖所有学术类型：

• journalArticle (5)
• thesis (7)
• conferencePaper (10)
• preprint、bookSection 等

提取字段：key, title, authors, year, doi, journal, volume, issue, pages, abstract, pdfPath, tags, collections, url。

Step 2b: 提取独立 PDF 附件

SQL 查询 itemTypeID = 14（attachment）且无父条目（无关联元数据）的 PDF：

• 从文件名正则提取标题、年份
• 解析 Zotero 存储路径为真实文件路径
• 标记 itemType = "standalone_pdf"

Step 3: 输出

统一 PaperMetadata 模型，每条文献一个 JSON 对象。

Step 4: 报告

有元数据的文献数、独立 PDF 数、总导出数、有 PDF 数、有 DOI 数、有摘要数。

调用方式

# Python API（推荐）
python -c "
from litmind_zotero.connector import discover_database, export_all, export_to_json
db = discover_database()
papers = export_all(db)
export_to_json(papers, './zotero_export.json')
"

路径

Python 包: litmind/src/litmind_zotero/