引用样式管理
红豆使用 Citation Style Language（CSL）生成引文和参考文献表。不同期刊、学校和出版社的格式要求通常通过选择不同 CSL 样式实现。
查看和管理样式
打开“设置 → 引用 → 样式”，可以查看已安装样式、删除不需要的样式，并设置引用语言等选项。
红豆默认包含常用样式，同时兼容广泛使用的 CSL 样式生态。当前内置三种 GB/T 7714—2025 双语变体：顺序编码、著者-出版年，以及注释（重复引用不省略），这些变体均按名称设置为不输出 URL／DOI。是否适用仍以学校、期刊和投稿要求为准，不能由样式名称推断所有国标格式均应省略 DOI。
安装额外样式前，确认样式名称、期刊或机构要求以及最近更新时间。
安装样式
常见方式包括：
- 在样式管理器中选择“添加更多样式”；
- 打开本地 .csl 文件进行安装；
- 把可信来源提供的 CSL 样式导入红豆。
安装后可在创建参考文献表、Quick Copy 和文字处理软件插件中选择该样式。
搜索和批量添加公共样式
- 打开 设置 → 引用 → 样式管理器 → 添加更多样式。
- 左侧列出本地已有样式，可选中查看效果；“从文件添加…”用于安装已有的
.csl文件。 - 右侧输入期刊或样式名称，按需要使用 按学科筛选；“加载更多样式”继续显示结果。
- 点击一个样式行查看 引注 与 参考文献 预览，再勾选需要的样式。支持同时选择多个样式。
- 点击 添加到我的样式 安装到本地。之后在参考文献生成窗口或文档首选项中选择新样式，已有文档需刷新。
公共样式仓库需要有效的红豆登录状态。明确提示会话失效时先登录原账号；无权限、网络或服务异常、以及搜索没有结果应按不同提示处理。恢复后使用“刷新”重试，不要为此删除已安装样式。本地已有样式在离线时仍可使用。
公共仓库预览通常采用示例文献；从条目“参考文献速览”调整复制格式时，可使用当前选中的文献预览。正式使用前还应检查自己的中文、外文及不同条目类型。
选择正确样式
- 同一出版社的不同期刊可能使用不同样式；
- “作者—年份”和数字编号样式不能混用；
- 学位论文应优先使用学校或学院指定版本；
- 样式名称相同但更新时间不同，输出细节可能有差异；
- 中文标准样式应检查作者缩写、文献类型标识、标点和中英文混排。
修改和调试 CSL
高级用户可以使用样式编辑器预览和修改 CSL。修改第三方样式时建议：
- 复制为新的本地样式；
- 修改样式标题和唯一标识；
- 保留原始样式作为对照；
- 使用多种文献类型测试；
- 不要直接覆盖仍需自动更新的官方样式。
如果输出错误来自条目字段，应该先修正元数据，而不是通过样式隐藏错误。
引用设置页的其他入口
“设置 → 引用”还包含文字处理软件插件的安装或重新安装入口；故障步骤见桌面引用插件安装排错。样式编辑器修改的是 CSL 格式规则，文档首选项则控制当前论文使用的样式，二者不要混淆。
找不到样式时，先在样式列表确认是否安装，再到文档首选项重新选择。个别条目输出错误时，优先检查题录的类型、语言、作者姓名与日期；不要通过手改生成的参考文献表掩盖错误数据。
自定义样式无效
自定义 CSL 必须是完整、结构正确的 XML，并符合 CSL 规范。先在样式编辑器中查看错误位置，再按 CSL 样式验证说明验证。修复前可切换到已经验证的内置样式继续工作。
修改已有样式时保留原副本，使用新的标题和标识，避免被更新覆盖。验证通过之后，仍应使用期刊文章、书籍、章节和中文条目检查实际输出。
创建个人引文样式
- 在“设置 → 引用 → 样式”选中一个基础样式。
- 点击 将选中样式另存为个人样式…。
- 填写新的副本名称，选择输出语言，按需要设置作者省略词。
- 比较“当前样式”和“个人副本预览”，确认中英文条目输出符合要求。
- 点击 另存并安装。如需在其他设备使用，可“导出个人样式”，再从文件添加。
- 在现有 Word／WPS 文档中重新选择这个个人样式并刷新引文，才会应用新设置。
个人副本与基础样式分开保存。基础样式升级后，可在个人样式窗口按提示使用新版基础样式另存新副本，并再次核对输出。
语言与“等／et al.”
输出语言控制样式术语；条目语言表示文献语种。只有样式支持按条目语言输出时，才会在中文“等”和英文 et al. 之间切换。按语言切换省略词需要 citeproc-js；当前 citeproc-rs 不支持这个选项。
“语言缺失时，根据标题和摘要推断引用语言”仅用于有足够线索的引用生成，不会自动写回文库。译文标题、混合语种或文本过短时应人工核对。
检查并保存条目语言
先在主窗口选择条目，再在引用设置中点击 检查主窗口选中条目的语言…。比较现有字段、判断依据与待保存代码，可以填写 en、zh、ja、fr 等，勾选确认后才写入。保存后可在主窗口通过“编辑 → 撤销”恢复。
已有文档应重新选择样式并刷新。中英文字体还受 Word／WPS 文档与插件的字体设置影响，应结合正文和参考文献预览检查。
常见输出差异的判断顺序
同姓作者出现名字首字母：作者—年份样式可能为了区分不同作者而添加首字母。这也可能来自同一人的名字写法不一致，例如 Jeff Smith 与 J. Smith；先统一题录姓名，再刷新文档。不要通过删掉作者的名来掩盖格式问题。
年份后出现 a／b：同一作者在同一年有多篇被引用作品时，样式可能添加区分字母。先检查是否误存重复条目、是否引用了不同副本，再核对样式的消歧规则。
参考文献里有 DOI 或 URL：这是样式规则，DOI 用于长期定位资料。不要为了隐藏显示而删除题录中的有效 DOI；确需不同格式时，选择符合投稿要求的样式或另存个人样式。
期刊简称不符合要求：先校对“出版物”和“期刊简称”字段。在桌面插件的文档首选项中，如启用自动期刊缩写，生成结果可能来自内置缩写表；关闭自动缩写时使用条目中的简称。学校或期刊要求不同缩写体系时，应按目标要求检查，而不是只比较简称长度。
标题大小写变化：语言字段、原始题名和样式都可能影响输出。英文题名建议保存句首大写形式并保留专名；非英文条目填写正确语言。需要斜体、上标、下标或保留局部大小写的题名，可使用支持的 <i>、<sup>、<sub> 或 <span class="nocase"> 标记，先预览确认；普通字段不应混入完整网页 HTML。
“Harvard”指一类作者—年份规则，并不是唯一统一的样式；Chicago 的作者—年份和脚注变体也不同。法律引用应选择适用法域的规则并逐项核对，不能仅凭支持 CSL 就保证任何专用法律引文插件兼容。
