| name | zotero-library-sync |
| description | 检查 Zotero 索引、精读 notes、分类属性、Publication Tag 与 Obsidian Bases 视图之间的同步状态;生成健康报告、属性补齐 dry-run、期刊等级同步和位置整理。 |
Zotero Library Sync
给 0 代码用户的 Codex 指令
用户可以直接这样说:
请帮我检查 MindCite 的 Zotero 索引、reading_status 和 notes 是否同步。请用自然语言告诉我 notes 总数、orphan notes、缺失 frontmatter 字段、done 但找不到 note 的条目,以及报告文件位置。
如果要修复旧数据,Codex 应先生成 dry-run 或迁移预览,再解释风险,不应直接改 notes。
触发条件
健康检查
检查 Zotero 和 notes 是否同步
补旧 notes 属性
同步 publication tag
同步期刊等级
整理 notes 位置
生成 Obsidian 数据库视图
证据范围
${MINDCITE_ROOT}\indexes
${MINDCITE_ROOT}\logs\reading_status.jsonl
${MINDCITE_ROOT}\notes\zotero_reading
${ZOTERO_DB_PATH}
默认脚本
- 健康检查:
${MINDCITE_ROOT}\_skills\Zotero-Library-Sync\scripts\vault_health_check.py
- 旧 note 分类属性补齐:
${MINDCITE_ROOT}\_skills\Zotero-Library-Sync\scripts\backfill_note_frontmatter.py
- 旧 note 迁移到
_papers:${MINDCITE_ROOT}\_skills\Zotero-Library-Sync\scripts\migrate_legacy_notes_to_papers.py
- Publication Tag 同步:
${MINDCITE_ROOT}\_skills\Zotero-Library-Sync\scripts\sync_publication_tags_to_notes.py
Publication Tag 同步规则
- Zotero 期刊等级信息主要来自条目的
Extra 字段。
- 支持解析:
JCR分区、中科院分区升级版、中科院分区基础版、影响因子、5年影响因子、FT50、UTD24、EI、南农高质量。
- 同步到 note frontmatter:
publication_title
journal_abbreviation
publication_tags
journal_rank_tags
jcr_quartile
cas_partition
cas_partition_basic
impact_factor
impact_factor_5y
elite_journal_tags
publication_sync_status
- 默认先 dry-run;真实写入必须备份。
Obsidian Bases 视图
- 入口:
${MINDCITE_ROOT}\数据库视图\文献数据库入口.md
- 总览:
${MINDCITE_ROOT}\数据库视图\文献总览.base
- 高质量期刊:
${MINDCITE_ROOT}\数据库视图\高质量期刊.base
- 理论/方法/主题:
${MINDCITE_ROOT}\数据库视图\理论方法主题.base
强制规则
- 不写回 Zotero。
- 不删除 notes。
- 真实写入 note 前必须能回滚:需要备份目录或 dry-run 预览。
- 分类以属性表达,不再按文件夹表达。
汇报要求
每轮至少说明:
- notes 总数与
_papers 数量
- orphan notes 数
- 缺失分类属性数量
- Publication Tag 同步数量
- 备份位置