如何在 WPS 中完成 Zotero 的文献插入

Zotero-WPSJS 插件安装与使用完整指南

适用平台：Windows / macOS / Linux

---

引言

对于广大科研工作者而言，Zotero 是一款强大且免费的文献管理工具，它能够帮助我们高效地收集、组织和引用学术文献。然而，很多用户在实际使用中遇到一个常见的困境：Zotero 官方插件主要支持 Microsoft Word，而在国内广泛使用的 WPS 办公软件中却无法直接使用。

这就是 Zotero-WPSJS 插件的价值所在。它是一款开源免费的 WPS 加载项，通过 WPS 提供的 JavaScript API 与 Zotero 进行通信，让用户能够在 WPS 文字中直接插入和管理参考文献，操作体验与 Word 版插件几乎一致。

• 项目地址：gitee.com/wangrui5015…

• 支持平台：Windows、macOS、Linux

---

一、下载插件

在安装插件之前，首先需要从项目仓库获取插件文件。：

1.1 在线安装（推荐）

1. 访问 Gitee 项目页面：gitee.com/wangrui5015…

2. 点击页面上方的「克隆/下载」按钮，将整个项目下载为 ZIP 压缩包

3. 解压到本地目录（注意：路径中不要包含中文字符）

4. 解压后会看到三个文件夹：Win、Mac、Linux，分别对应三个平台

💡 提示：作者还录制了详细的视频教程，建议初次安装时配合视频操作，更加直观。视频地址：www.bilibili.com/video/BV12S…

---

二、Zotero 端配置

在安装 WPS 插件之前，需要先对 Zotero 进行一些基础配置，以确保插件能够正常与 Zotero 通信。

2.1 开启通信权限

这是最关键的一步。插件需要通过 Zotero 的本地 HTTP API（默认端口 23119）与其通信，因此必须先开启这个权限。

**操作步骤： **

1. 打开 Zotero 软件

2. 进入「编辑 → 首选项（Preferences）」

3. 切换到「高级」选项卡

4. 勾选「允许其他程序与 Zotero 进行通信」

⚠️ 重要：如果不勾选这个选项，插件将无法从 Zotero 获取文献数据，导致文献插入功能完全不可用。

2.2 版本要求

平台	WPS 版本	Zotero 版本
Windows	任意支持的版本	任意版本
macOS	≥ 6.15	版本 7
Linux	任意支持的版本	任意版本

Mac 用户请特别注意：必须同时满足 WPS 版本 ≥ 6.15 且使用 Zotero 7。

---

三、WPS 端宏安全设置

这是整个安装过程中最容易被忽略但又至关重要的环节。WPS 默认的安全设置会阻止插件运行，因此需要手动调整。以下 4 步配置适用于所有平台（Windows/macOS/Linux）。

步骤 1：信任 WPS JS 项目访问

1. 打开 WPS 文字

2. 点击顶部菜单栏的「工具」

3. 选择「宏安全性」

4. 切换到「可信发行商」选项卡

5. 勾选「信任对于 WPS JS 项目的访问」

步骤 2：关闭沙箱保护（仅 Windows）

1. 打开 WPS 的「全局设置」

2. 进入「设置」

3. 关闭「沙箱保护」功能

📝 注意：这一步仅针对 Windows 用户。macOS 和 Linux 用户可以跳过此步。

步骤 3：调低宏安全等级

1. 在 WPS 中点击「工具 → 宏安全性」

2. 将安全等级设置为「低」

步骤 4：取消编译参数勾选

1. 点击「工具 → 开发工具 → WPS 宏编辑器」

2. 在宏编辑器中，点击「工具 → 选项」

3. 在「编译」选项卡下，取消勾选两个编译参数选项

💡 说明：这两个编译参数默认会对 JS 代码进行某些优化处理，可能会导致插件运行异常。取消勾选后可以避免这些问题。

---

四、安装插件

完成上述配置后，接下来根据你的操作系统选择对应的安装方式。

4.1 Windows 平台安装

安装步骤

1. 关闭所有 WPS 程序（文字、表格、演示）

2. 打开解压后的「Win」文件夹

3. 右键点击「win安装.exe」，选择「以管理员身份运行」

4. 等待安装完成，重新打开 WPS 文字

⚠️ 安全软件提示：如果杀毒软件拦截了 proxy.exe，请将其添加到信任列表，或临时关闭杀毒软件后再进行安装。proxy.exe 是插件的本地代理服务程序，用于在 WPS 和 Zotero 之间传递数据，完全安全。

安装原理

安装程序会自动完成以下操作：

1. 在 WPS 的 jsaddons 目录下创建插件文件夹

2. 复制插件的 JavaScript 核心文件（ribbon.js、util.js、zclient.js 等）

3. 将 proxy.exe 复制到 Windows 启动文件夹，实现开机自启

4. 在 publish.xml 中注册插件信息

4.2 macOS 平台安装

安装步骤

1. 关闭所有 WPS 程序

2. 打开解压后的「Mac」文件夹

3. 双击运行「Mac安装」应用

4. 由于缺乏证书签名，macOS 会拦截运行。前往「系统设置 → 隐私与安全性」，在「安全性」区域点击「仍要打开」

5. 重新打开 WPS 文字

📝 额外注意：部分 macOS 系统可能还需要手动运行一次 proxy.app，同样需要在「系统设置 → 隐私与安全性」中点击「仍要打开」。

4.3 Linux 平台安装

安装步骤

1. 确保系统已安装 Python 3，且已添加到 PATH 环境变量

2. 关闭所有 WPS 程序

3. 打开终端，进入解压后的「Linux」文件夹

4. 执行安装命令：

   ```bash

   python3 install.py

   ```

1. 等待安装完成，重新打开 WPS 文字

---

五、验证安装

安装完成后，按照以下步骤验证插件是否正常工作：

1. 打开 WPS 文字，新建一个空白文档

2. 查看功能区是否出现了「Zotero」选项卡

3. 确保 Zotero 已经在后台运行

4. 在 WPS 中点击 Zotero 选项卡的「Add/Edit Citation」按钮，测试文献插入功能

如果一切正常，你应该能够看到 Zotero 的引文搜索对话框弹出，可以搜索并插入文献引用。

---

六、使用方法

安装成功后，WPS 中的 Zotero 插件使用方法与 Word 版插件基本一致。以下是常用功能的简要说明：

按钮名称	功能说明
Add/Edit Citation	在光标位置插入或编辑文献引用
Add/Edit Bibliography	在光标位置插入或更新参考文献列表
Document Preferences	设置当前文档的引文格式（如 APA、GB/T 7714 等）
Refresh	刷新所有引文，更新参考文献信息
Unlink Citations	断开引文与 Zotero 的链接，转为纯文本

典型工作流

**插入单条引文： **

1. 将光标放在需要插入引文的位置

2. 点击「Add/Edit Citation」

3. 在弹出的搜索框中输入关键词搜索文献

4. 选择目标文献，点击确认即可插入

**生成参考文献列表： **

1. 将光标放在文档末尾（或需要放置参考文献的位置）

2. 点击「Add/Edit Bibliography」

3. 系统会自动根据文档中的所有引文生成参考文献列表

**切换引文格式： **

1. 点击「Document Preferences」

2. 在弹出的对话框中选择目标引文格式（如 GB/T 7714-2015）

3. 点击确认，文档中的所有引文和参考文献会自动更新

---

七、常见问题与解决方案

问题 1：安装后 WPS 中不显示 Zotero 选项卡

这是最常见的问题，通常是因为 WPS 的宏安全设置未正确配置。请按照以下顺序排查：

1. 确认已完成第三节中的全部 4 步宏安全设置

2. 完全关闭所有 WPS 程序后重新打开

3. 检查插件文件是否正确安装到 jsaddons 目录

如果以上方法均无效，可以尝试将 Zotero 的 Word 插件文件 Zotero.dotm 复制到 WPS 的 startup 文件夹作为补救方案：

**Zotero 7 用户： **

将 [Zotero安装目录]\integration\word-for-windows\Zotero.dotm 复制到 %APPDATA%\kingsoft\wps\startup\

**Zotero 6 及更早版本用户： **

将 [Zotero安装目录]\extensions\[email protected]\install\Zotero.dotm 复制到 %APPDATA%\kingsoft\wps\startup\

💡 提示：AppData 文件夹默认是隐藏的。如果看不到，请在文件资源管理器中点击「查看」，勾选「隐藏的项目」。

问题 2：出现多个 Zotero 选项卡

如果你之前尝试过将 Word 的 Zotero 插件强行安装到 WPS，可能会出现多个 Zotero 选项卡的情况。解决方法如下：

1. 打开路径 C:\Users\[你的用户名]\AppData\Roaming\kingsoft\wps

2. 找到 startup 目录

3. 删除其中的 Zotero.dotm 文件

4. 重启 WPS

这个 Zotero.dotm 文件是从 Word 插件直接复制过来的，需要 WPS 的 VBA 环境才能运行。现在已经不再需要，可以安全删除。

问题 3：点击按钮后 Zotero 不会自动弹出

使用中可能会遇到点击引文按钮后，Zotero 的窗口不会自动弹出的情况。这是一个已知的小问题，解决方法很简单：

手动点击任务栏中的 Zotero 图标，让 Zotero 窗口跳到最前即可。之后的引文操作就能正常进行了。

问题 4：杀毒软件拦截 proxy.exe（Windows）

插件的代理程序 proxy.exe 可能会被部分杀毒软件误报。解决方法：

1. 将 proxy.exe 添加到杀毒软件的信任列表/白名单

2. 或者在安装时临时关闭杀毒软件

---

八、卸载插件

如果不再需要该插件，可以通过以下三种方式卸载：

方式	操作说明	适用平台
方式 1：自动卸载	关闭 WPS，运行对应平台的卸载程序（winUninstall.exe / macUninstall.app）	Win / Mac
方式 2：插件界面卸载	在 WPS 中打开插件的 About 面板，点击「卸载插件」按钮	全平台
方式 3：手动删除	前往 jsaddons 目录，删除插件相关文件夹（请谨慎操作）	全平台

**Linux 卸载额外方式： **

执行命令 python3 install.py -u 或 ./install.py -u 即可完成卸载。

⚠️ 警告：方式 3（手动删除 jsaddons 目录）会删除所有 WPS 加载项，而不仅仅是 Zotero 插件。如果你还安装了其他 WPS 插件，请勿使用此方法。

---

九、总结

通过 Zotero-WPSJS 插件，WPS 用户也能够享受与 Word 一样便捷的文献管理体验。整个安装过程可以概括为以下几个关键步骤：

1. 下载插件：从 Gitee 项目仓库获取最新版本

2. 配置 Zotero：开启「允许其他程序与 Zotero 通信」

3. 设置 WPS：完成 4 步宏安全配置

4. 安装插件：根据平台运行对应的安装程序

5. 验证使用：在 WPS 中插入第一条文献引用

---

附录：相关资源

资源	链接
项目仓库	gitee.com/wangrui5015…
视频教程	www.bilibili.com/video/BV12S…
Zotero 中文社区	zotero-chinese.com/user-guide/