MuiseDestiny/zotero-citation · 上手攻略

  • 仓库：MuiseDestiny/zotero-citation
  • 链接：https://github.com/MuiseDestiny/zotero-citation
  • 分类：Zotero 插件 / 学术写作 / Word 加载项
  • 作者：spark
  • 更新：2026-08-15

是什么

zotero-citation 是 Zotero 的一个第三方插件（addon / Word 加载项），目标是让 Zotero 在 Word 里的引文插入与管理工作流"更顺手、更清晰"。作者是 Zotero 插件圈知名的 MuiseDestiny（旗下还有 zotero-attanger、zotero-reference 等面向中文用户的工具链），基于 zotero-plugin-template 构建。

它解决的不是 Zotero 官方加载项做不到的事，而是把"插入引文 + 在 Zotero 里整理引文列"这两件事的体验做了三处优化（README 中用 emoji 标注的核心卖点）：

  1. Word 引文自动归集到一个临时文件夹：插入参考文献时，插件把当前 Word 文档里所有引用条目自动收集到 Zotero 内一个与 Word 文件同名的文件夹下——熟悉 EndNote 的用户会觉得这是 EndNote 的"复制引文到库"动作。
  2. 相邻引用自动合并：[1] 后插入新文献不会变成 [1][2]，而是 [1, 2]。这是 Word 加载项最常见的体感痛点。
  3. 拖拽引用：从 Zotero 拖条目到 Word 任意位置即可插入引用，免去搜索面板来回切窗口。

插件与 Word 加载项版本必须对齐（同一作者维护），否则 Word 提示"整合错误"；Mac 平台当前只完整支持功能 1（自动归集文件夹），其它功能待适配。

解决什么问题

  • Word 引文管理混乱：Zotero 官方加载项插入引文后，库里的"我最近引用过哪些条目"需要靠手动搜。本插件每次开 Word 自动建一个临时文件夹，把当前文档的引用条目汇总进来——一目了然，关闭 Word 即自动销毁（或下次手动清理）。
  • 相邻引用样式丑陋：官方加载项默认 [1][2]，对中文 GB/T 7714、APA、IEEE 等"方括号数字"风格排版非常不友好。本插件自动合并为 [1, 2]，免去手工排版。
  • 搜索 → 插入窗口切换频繁：支持从 Zotero 拖条目直接放进 Word；也支持光标定位后按 ' 单引号键直插。
  • Word 引文序号在 Zotero 里可读：插件会在 Zotero 条目上标注 Word 中的短引用 label（如 [1]），让"Zotero 这边看 Word 里的引文顺序"成为可能。
  • Mac 用户基础可用：功能 1（自动归集文件夹）已在 Mac 工作，但功能 2/3 在 Mac 上的体验仍受限，需关注后续版本。

快速安装

⚠️ 与 Zotero 官方加载项不同，本插件包含两个组件： 1. Zotero 端 addon（.xpi 文件）； 2. Word 端加载项（来自 release 内的 addon/ 目录）。 二者版本必须一致，否则报"整合错误"。

步骤 1：下载 release

进 Releases 页面，下载最新 .xpi 文件（如 zotero-citation-*.xpi）。

步骤 2：装 Zotero addon

打开 Zotero → 工具 → 附加组件 → ⚙️ 齿轮 → Install Add-on From File… → 选刚才的 .xpi。重启 Zotero。

步骤 3：装 Word 加载项

把 release 解压后的 addon/ 目录拷贝到 Zotero profile 目录下的对应路径，并按 Zotero 7 的插件机制加载；或在 Zotero 中通过插件管理界面确认 Word 加载项已注册。具体路径以官方模板 zotero-plugin-template 的 release 流程为准（建议直接看仓库 README 与模板文档）。

步骤 4：验证

  • Zotero 顶部出现新工具条 / 设置项即 Zotero 端成功；
  • Word 功能区出现 Zotero Citation 标签（且与 Zotero 端版本号一致）即 Word 端成功。

🤝 如果报"整合错误"：先卸载 Word 端加载项 → 重启 Word → 再装一遍。版本不对齐是头号常见原因。

核心用法

功能 1：自动归集当前文档的引用到一个临时文件夹

  1. 在 Word 中插入参考文献（用 Zotero 官方加载项或本插件的拖拽 / ' 键均可）；
  2. 插件自动在 Zotero 内创建一个文件夹，名字 = 你打开的 Word 文件名；
  3. 该 Word 文档里所有引用条目会被收进这个文件夹。

⌛ 生命周期：[在 Word 里插入第一条引用 → 关闭 Zotero] 触发删除；每次开 Word 会重新生成。 🪐 Word 里点"刷新"，临时文件夹才会被重命名为 Word 文件名。

🎈 Mac 限制：临时文件夹不能自动改名，可能要手动改。

🎉 自动清理失败时，下次启动 Zotero 手动删除该文件夹即可。

功能 2：相邻引用自动合并

  • 默认行为：[1] 后插新条目 → [1, 2] 而非 [1][2]；
  • 对中文 GB/T 7714、APA、IEEE 等"数字编号"风格尤其友好；
  • 无需额外配置，插件装好后即生效。

功能 3：拖拽引用

  1. 在 Zotero 里选中要引用的条目（支持多选）；
  2. 拖到 Word 中需要插入的位置，松手即插入；
  3. ⚠️ 必须开启"引用列"才能用——在插件设置里打开；若想禁用拖拽引用，关闭引用列即可。

功能 4：快捷键 ' 直插

  1. Word 里把光标定位到待插入引用的位置；
  2. Zotero 里选中条目；
  3. 按键盘上的 '（单引号）键——直接插入引用。

功能 5：Word 引文序号在 Zotero 中显示

插件会在 Zotero 条目上标注 Word 文档里的短引用 label（如 [1]），让你在 Zotero 侧就能看到"这篇 Word 里把它列为第几条"。这对按引文顺序回查、调整引文位置非常有帮助。

典型适用场景

  • 中文学术论文写作：GB/T 7714、APA 中文版、IEEE 等数字编号风格——[1, 2] 自动合并比 [1][2] 干净得多。
  • 大型综述 / 学位论文：文档可能跨数十次写作会话，自动归集临时文件夹让你随时可见"这篇当前用了哪些文献"。
  • 多人合作同一 Word：每个 Word 文件名即对应一个临时文件夹，跨机器同步只要同步 Word 文件本身（zotero 库同步另算）。
  • 从 EndNote 迁移过来的用户：临时文件夹即 EndNote 的"复制引文到库"功能——快速上手。
  • Mac 用户：至少功能 1 完整可用；若只用 Word 里"插入后自动归集 Zotero"这一项，已满足基本工作流。

坑与注意

  • Word 加载项与 Zotero addon 版本必须一致：不一致即报"整合错误"，需重装。
  • Mac 不支持临时文件夹自动改名：Mac 用户要么接受默认名，要么每次手动改；功能 2/3 在 Mac 上的兼容性滞后于 Windows。
  • .xpi 必须从 release 装：git clone 出的源码不能直接装——需 npm run build 后再用 build/addon/*.xpi，参考 zotero-plugin-template。
  • 拖拽引用依赖"引用列"开关：忘了开启时拖动无反应，记得去插件设置检查。
  • 临时文件夹自动删除依赖"关闭 Zotero"：如果 Zotero 崩溃或被 kill，残留文件夹下次启动手动清理。
  • 与其它 Zotero 插件冲突：同族（MuiseDestiny 自家）插件可能共享快捷键；如果与官方加载项冲突，停用其一。
  • GB/T 7714 样式合并规则：本插件只做"数字编号相邻合并"，不做"作者-年份"APA 风格合并；按需开启 Zotero 官方 APA 输出。
  • 文档模板里的占位引用：用 LaTeX / Markdown 中转时本插件无能为力——它只覆盖 Word 工作流。
  • 同步策略：Word 文件本身 + Zotero 库同步（Zotero 自带或 ZotFile 等插件）是两件事；临时文件夹只存在于本地 Zotero 库，不随 Word 文件走。

与同类对比

工具 类型 关键差异
MuiseDestiny/zotero-citation（本项目） Zotero addon + Word 加载项 自动归集文件夹 + [1,2] 自动合并 + 拖拽 + ' 键；中文 UI / 文档；面向中文用户最顺
Zotero 官方 Word 加载项 内置 仅做"插入 / 编辑 / 取消链接 / 切换样式"；不归集临时文件夹，不做合并
MuiseDestiny/zotero-attanger Zotero addon 同一作者姊妹插件，专做"Zotero 附件整理"（recent downloads 归档）；与本插件正交互补
MuiseDestiny/zotero-reference Zotero addon 同一作者姊妹插件，专做"参考文献提取 / 解析"；可在 PDF 中读出 ref 列表并导入 Zotero
Word 内置"引用"功能 Microsoft 原生 不连 Zotero；适合不引文管理的轻量文档
EndNote / Mendeley Word 加载项 商业 / 学术 与 Zotero 库格式不同；本插件是 Zotero 生态内的优化，不是替代品

按工作流组合推荐：zotero-reference（提取 PDF 内的 ref）+ zotero-citation（Word 内引用管理）+ zotero-attanger（PDF 归档） —— MuiseDestiny 系的论文写作"三件套"。

一句话推荐结论

写论文、长期被 Zotero 官方加载项的"不归集、不合并、不拖拽"困扰的中文学术用户，首选本插件；只要确认 Word 加载项与 Zotero addon 版本对齐，并接受 Mac 上功能 2/3 的滞后，体验提升立竿见影。

⚠️ 不确定项 - 当前最新 release 版本号与发布日：本次抓取未单独取出 releases/latest 的 tag；建议进 Releases 页 直接看。 - Word 加载项具体安装路径：README 未给绝对路径细节；建议按 zotero-plugin-template 的 release flow 走 npm run build，产物一般在 build/addon/。 - Mac 上功能 2/3 的最新状态：README 写明"目前 Mac 用户只能使用功能 1"，但未给具体哪一个 minor 版本起恢复；操作前以仓库最新 release note 为准。 - 当前 GitHub Stars 数字：web_search 二手缓存显示 1.3k stars（GitHub 页缓存），可能与实时数略差。

来源：仓库 README（GitHub，中英双语）、tavily web_search（Zotero Forums 讨论、OSU / ISU 学术写作 LibGuide）。