桌面 Word、WPS 与 LibreOffice 引用插件

本页快捷入口：安装 · 页码与定位 · 文档首选项 · 安装排错 · LibreOffice · 文档转换 · 引文取消链接

桌面引用插件连接正在运行的红豆桌面端与本机 Word、WPS 或 LibreOffice，用于插入可更新的引文、参考文献表和笔记。它与 红豆云端 Word 写作助手 是不同的集成方式；本文介绍桌面端的引用工具栏。

安装与首次使用

1. 完全关闭 Word、WPS 或 LibreOffice，保持红豆桌面端运行。
2. 打开“设置 → 引用”，找到文字处理软件区域，点击安装或重新安装对应插件。
3. 重新打开文字处理软件，确认引用工具栏出现。红豆专用插件通常显示“红豆”，部分通用集成按钮仍可能沿用 Zotero 名称。
4. 在空白测试文档中点击“添加/编辑引文”，选择样式、语言及文档选项，再搜索本地文库中的条目。
5. 插入一条引文和参考文献表，确认更新正常后再处理已有论文。

桌面插件需要对应的桌面版文字处理软件。Word 网页版应使用云端写作助手；不同系统、Office 版本和发布包的插件支持情况，以设置页实际显示的安装入口为准。

插入引文与参考文献表

把光标放到正文引用位置，点击“添加/编辑引文”。输入题名、作者或年份，选中检索结果后可继续添加其他文献，最后按 Enter 确认。编辑已有引文时，先把光标放入该引文，再点击同一按钮。

点击“添加/编辑参考文献表”可生成文末列表。通常只需添加正文引文，插件就会根据当前样式维护列表。需要加入未在正文引用的条目时，通过参考文献表编辑窗口操作。

先在红豆里修正作者、年份、卷期、页码等题录字段，再点击工具栏的“刷新”。直接在 Word 生成的引文文字里修改，可能导致后续更新覆盖修改或停用该引文的自动更新。

页码与其他定位信息

在引文选择框中点击已选文献的气泡，打开引文选项。选择“页码”“章节”“卷”等定位类型，再填写值，例如“34–38”。

填写页码时通常只输入数字或范围，如“34”或“34–38”；前缀“p.”、“pp.”等由引用样式生成。这里的页码仅作用于这一次引文，不会改写文献条目的完整页码字段。一个多文献引文中的各条文献可以分别设置定位信息。

引文选择框的文库、预览与笔记

新版选择框除了搜索，还可切到 文库 浏览分类与条目，查看 已选 或当前 打开 的资料；先选择文献，再加入引注。多篇文献一起引用时，在确认前核对已选顺序和各自页码；排序开启时，最终顺序由样式控制。

选择框中的预览可查看当前样式将生成的引注。需要把研究笔记或 PDF 注释插进文档时，使用 添加笔记 对应的选择界面；可从条目或附件下选择注释。插入笔记内容与插入普通引注的作用不同，之后仍需核对来源和引用格式。

前缀、后缀和省略作者

• “前缀”填写引文前的说明，例如“参见”；“后缀”填写引文后的补充说明。
• 作者—年份样式中，如果正文已经写出作者，可在引文选项中勾选“省略作者”，让括号中只保留年份等内容。
• 优先通过引文选项设置这些内容，保留插件更新能力。

文档首选项

“文档首选项”管理当前文档的引用样式、输出语言，以及注释型样式的脚注或尾注位置。切换样式后，正文引文和参考文献表会一起更新。

如界面提供 Fields／字段与 Bookmarks／书签选项，普通 Word 文档优先使用字段。需要在 Word 与 LibreOffice 间协作时，先在文档副本中验证兼容方式。复制粘贴、格式转换及其他插件处理可能损坏引用字段，协作前应保存可编辑原稿。

“取消引文链接”会将引文和参考文献表变为普通文字，之后无法由红豆自动更新。只在提交用副本上执行，保留包含引用字段的原稿。

引注和参考文献表的字体、英文术语

从桌面插件打开当前文档的 引用样式 窗口。支持字体设置的 Word 插件会显示以下选项；没有这些选项时，先检查插件版本与当前平台的支持情况。

1. 在 正文及脚注/尾注引注字体 中分别选择西文字体和中文字体。每条引注统一使用一种字体：含中文等东亚文字时采用中文字体，否则采用西文字体。
2. 在 参考文献表字体 中分别设置两类字体；默认“与引注相同”跟随上面的设置。每条参考文献按其主要语言选择字体，作者、题名、数字和网址统一使用该条目的字体。
3. 需要中英混排时，可勾选 英文条目用英文术语，让英文参考文献中的“等”、月份、文献类型等可本地化术语使用英语；引注仍使用文档语言。先校对条目的语言字段，译文或自动判断结果尤其需要复核。
4. 比较引注与参考文献预览，确认并等待文档更新，再检查已有和新插入的引注。插件会保留斜体、上标等格式。

“不修改字体”不会自动还原以前已应用的字体。字体与术语设置应以学校或期刊要求为准，不能代替条目语言校对和正确的 CSL 样式。

安装失败或工具栏未出现

1. 完全退出文字处理软件后重新安装，再重新启动。
2. 如果安装按钮未出现，先确认当前发布包包含对应集成，并核对软件版本和平台支持。
3. Word 中检查加载项、禁用项目以及启动模板目录。安装成功后没有工具栏，通常需要确认模板已被 Word 加载；不要为排错全局启用所有宏。
4. macOS 中检查系统是否允许 Word 与红豆进行所需的自动化通信；出现权限提示时按提示核对应用名称。
5. Windows 中检查模板目录是否可写、模板是否被安全软件阻止或被其他 Word 实例占用。
6. 保留安装错误原文、系统版本、Word／WPS／LibreOffice 版本及红豆版本，提交至 红豆反馈区。

LibreOffice

关闭所有 LibreOffice 窗口（包括后台快速启动）后重装插件。在 LibreOffice 的扩展管理器中确认集成扩展已启用；如安装向导提示 Java 不可用，按该 LibreOffice 版本的要求安装并选择兼容的 Java 运行环境。重启后用空白文档测试。

只有某个文档出错

如果空白文档可正常插入引文，先复制出问题的文档，在副本中缩小出错段落范围，检查复制粘贴或格式转换损坏的引用字段。记录出错按钮和提示；不要直接删除原稿全部字段。若所有文档都失败，则优先排查安装、应用运行状态和通信权限。

相关帮助：引用样式管理、快速引用与参考文献表。

在不同文字处理软件之间转换文档

先保存保留引用字段的原稿，再在副本中转换格式并测试刷新。Word、LibreOffice、Google Docs 和不同引用插件使用的字段或书签机制可能不同，复制生成的文字并不等于转移动态引文。不要假定 Word 的 .docx 在 Google Docs 中直接编辑后仍能保留可更新引文。

需要长期协作时，先约定文字处理软件、插件和文档格式；从其他软件迁来的文档，应抽查引文能否打开编辑以及参考文献表能否刷新。

引文已经取消链接

如果引文已被转换为普通文字，后续修改文库元数据不会再更新文档。优先回到保留字段的原稿；没有原稿时通常需要重新插入动态引文，不能只靠“刷新”恢复。复制、导出或解除链接前保留原文档副本。

当前 Word／WPS 安装与更新入口

在 设置 → 引用 查看 Word 和 WPS 的安装状态、已安装版本与可用版本，按需使用安装、更新、重新安装或卸载。操作前先关闭对应软件与文档。安装失败时记录页面提示，确认当前平台的软件版本与安装路径。

在 WPS 的“红豆”选项卡中点击 添加/编辑引注，首次选择样式，搜索并插入文献；随后添加参考文献表、刷新引文。“更多样式”会打开红豆的样式搜索与添加窗口。具体按钮与平台支持以当前安装的插件为准。

个人样式、按条目语言使用“等／et al.”、语言检查及导出详见引用样式管理。在文档中选定个人样式并刷新后才会生效，中英文字体应结合插件和文档设置检查。

文档引用管理与引文管理器

在提供该功能的 Word／WPS“红豆”工具栏中打开 引文管理器／文档引用管理。弹出的“文档引用管理”分为“引注管理”和“参考文献表管理”，用于集中检查当前文档中的动态引注及其文献来源。

引注管理

• 按引注内容搜索，选择一条引注后用“定位到文档”查看正文位置；“编辑内容”可添加、移除或调整这条引注中的文献。
• 在“当前文档使用的文献”中按题名、作者或年份查找，用“在红豆中显示”回到本地条目。
• “未关联的文档条目”只保留文档内的题录副本，不能随本地文库更新。先确认本地对应文献，再用“重新关联条目”建立正确关联。
• 删除引注会修改当前文档；操作前保存副本，并核对选中数量。这个管理窗口本身不提供删除引注的撤销。

参考文献表管理

可以在当前光标处插入参考文献表、加入只列在文末而未在正文引用的文献，或把选中文献从文末列表排除。从列表移除不会同时删除正文中的引注。文末顺序仍由引用样式控制。

选择某条参考文献后，可预览及编辑文字、粗体、斜体和下划线，点击“确定”后生效。手动修改可能影响以后同步文库与样式变化；需要回到样式生成结果时，用“恢复所选格式”。“恢复默认参考文献表”会清除全部自定义格式、手动添加及排除设置。“移除整个参考文献表”保留正文引注。

管理窗口打开期间如果在文字处理软件中改变了引注，应关闭并重新打开管理窗口，让列表与当前文档保持一致。

文档检查与引用检查

Word／WPS 工具栏中的 文档检查 会打开 引用检查 窗口，检查引注、关联条目、元数据和参考文献表。这是引用结构检查，不能用来判断论文文本相似率。

1. 保存当前文档，打开文档检查，查看错误、警告、提醒和“正常多处引用”的汇总。
2. 展开问题，使用定位按钮跳到具体引注，或打开文档引用管理处理关联。
3. 根据问题修正后关闭窗口，再次运行检查，确认当前文档状态。

检查包括：同一复合引注内重复添加同一文献、不同条目疑似重复、未关联本地文献、关联条目位于回收站、引注手工修改、必要元数据缺失、撤稿文献，以及参考文献表缺失、多份或有自定义内容等。

同一文献在不同段落多次引用通常属于 正常多处引用，无需自动删成只剩一处。对同一引注中可安全移除的后续重复项，窗口会列出拟移除内容，确认后才修改文档；疑似重复的不同本地条目，应人工核对后在文库合并或重新关联。不同页码、前后缀或引用用途应先检查，不能仅凭题名相同批量删除。

检查期间如果继续编辑文档，原检查结果可能失效，需重新打开检查。LibreOffice 或其他平台的通用工具栏若没有这些按钮，按实际提供的功能使用基础引用流程。

引文灰底、虚线与域代码

• 灰色背景通常是 Word／LibreOffice 显示引用字段的位置，正常打印或导出 PDF 时不会输出这层字段底色。先预览打印结果，无需取消引文链接来去掉它。
• 虚线下划线可能表示已关闭自动更新；通过工具栏的“刷新”更新全文，并在“文档首选项”检查自动更新选项。长文档为加快插入而临时停用自动更新后，提交前必须刷新并检查编号、消歧字母和参考文献表。
• 如果显示 ADDIN ZOTERO_ITEM 等代码，而不是格式化引文，通常开启了文字处理软件的“显示域代码”。恢复显示域结果即可，不要直接删改代码中的条目标识。

修改题录后引文仍不更新

先执行“刷新”。仍无变化时，检查是否曾手工修改引文并选择保留修改，以及引文是否只剩文档内题录副本。当前提供“文档引用管理”的 Word／WPS 插件可查看 未关联的文档条目，确认对应文献后使用“重新关联条目”；其他插件入口按实际提供的编辑与重新插入流程处理。

文库中合并重复条目比删除再导入更能保留引用关联。迁移文库不要把导出再导入当作原数据库的完整替换；新导入记录通常有新的标识，旧文档可能继续使用嵌入的元数据。

Word 启动目录应是 Word 实际加载模板的目录，不是红豆安装目录。工具栏未出现时在 Word 的文件位置和模板／加载项中核对；优先由红豆设置页重新安装匹配插件。卸载插件不会主动删除论文里的引文，但应保留论文副本；要继续编辑动态引文，需要重新安装兼容插件。