Zotsidian

Zotero 插件：右键选中文献条目，一键生成并联动 Obsidian 文献笔记。当前版本 1.0.0。

功能

• 创建笔记：右键菜单 创建并联动笔记到 Obsidian，按选中文献逐条生成 Markdown 笔记
• 字段同步：右键菜单 更新 Obsidian 笔记（同步 Zotero 字段），把 Zotero 里改动过的字段增量同步回已建笔记，只改 frontmatter，正文一字不动
• 创建标记：生成笔记后自动给 Zotero 条目打一个标签（默认 Obsidian笔记），方便在库里区分哪些文献已建过笔记
• 可视化受保护字段：设置页里从当前模板自动提取 frontmatter 字段，勾选的字段在同步时不会被 Zotero 值覆盖（保留你手填的内容）
• 刷新笔记索引：扫描整个 vault 的 Markdown，根据 zotero://select 链接反向重建索引，并顺带为匹配到的条目补打标签
• 可编辑模板：设置页可直接编辑 Better BibTeX 风格的 <% %> 模板

设置项

设置页（Zotero 设置 → Zotsidian）可配置：

• Obsidian vault 路径（默认 E:\Peng_XoYaObsidian）
• 创建笔记后添加的 Zotero 标签（默认 Obsidian笔记，留空则回退默认）
• 同步时受保护的字段（默认勾选 Project Status Affair cssclasses）
• 笔记模板

默认行为

• 生成路径默认是 E:\Peng_XoYaObsidian
• 文件名使用 年份 - 最后一位作者 - 标题.md
• 已存在文件不会覆盖；重复检测走三重保险：索引文件 → 文件名命中 → 读内容比对 zotero://select 链接
• 同步字段时只在字段确实变化时才写盘，无变化会提示「无需更新」

安装方式

1. 关闭 Zotero。
2. 在 Zotero profile 的 extensions 目录里新建一个文本文件，文件名写成插件 ID：zotsidian@pengxoya.github.io
3. 文件内容只写这个仓库的绝对路径：F:\File folder\文档\ZotToObsNote
4. 重启 Zotero。

或直接安装打包好的 Zotsidian-1.0.0.xpi（Zotero → 工具 → 插件 → 从文件安装）。

插件 ID：

zotsidian@pengxoya.github.io

构建

powershell -ExecutionPolicy Bypass -File build.ps1

会按 manifest.json 里的版本号生成 Zotsidian-<version>.xpi。加 -Tag <名称> 可生成带后缀的调试包，例如 build.ps1 -Tag test 生成 Zotsidian-1.0.0-test.xpi。

说明

模板会把 Zotero 条目映射成 it.items，所以你可以直接继续写 Better BibTeX 那种 <% %> 模板。受保护字段列表来自模板实际渲染出的 frontmatter 顶层键，改了模板后可在设置页点「从模板重新提取字段」刷新。