设置与高级选项

本页快捷入口：常规 · 导出 · 引用 · 高级

红豆的设置用于管理阅读器、附件、同步、搜索索引、文件命名、导出格式和数据目录。修改前先理解影响范围，涉及数据目录和同步方式的选项尤其要谨慎。

常规设置

常用选项包括：

• 界面语言和外观；
• 双击附件时使用内置阅读器或外部程序；
• 是否自动识别新加入的 PDF 和 EPUB；
• 新建笔记、打开文件和更新检查等行为。

自动识别主要影响新加入的附件。当前版本常规页已移除自动标签开关，并默认关闭自动标签；已有标签不会因此自动删除，手动标签仍可正常使用。

文件重命名

在文件重命名区域可以：

• 开启或关闭附件自动重命名；
• 选择要处理的 PDF、EPUB、图片、音视频等文件类型；
• 自定义文件名模板；
• 预览题名、作者、年份等字段生成的结果；
• 对已有附件执行批量重命名。

批量重命名前应先校对元数据，并避免在外部程序仍占用文件时操作。链接附件重命名后，外部工作流也会受到影响。

账户与同步设置

登录红豆账号后，可配置数据与附件同步。

• 数据同步包括题录、分类、标签、笔记和其他文库结构；
• 附件同步可以使用红豆附件空间或已配置的 WebDAV；
• 可根据设备空间选择按需下载附件；
• 全文内容同步用于跨设备搜索附件文字，不会把文献公开发布；
• 发生冲突时，应比较修改时间和内容，不要连续覆盖两端数据。

首次同步大型文库前应先备份数据目录，并保持应用运行到同步完成。

全文索引

当前全文索引区域显示 已索引附件、部分索引、不可用和已索引笔记，并在后台处理期间显示进度。旧界面的“索引词数”已不作为当前统计说明。

• 可调整每个文件最多索引的字符数和 PDF 页数；受限制的文件可能只有部分正文可搜索。
• “不可用”需要结合附件是否下载、文件是否存在及能否提取文字判断，不等同于题录丢失。
• 笔记正文也会建立全文索引；大量导入后等待后台任务完成。
• 需要重新处理某些已下载附件时，选中附件，使用右键菜单中的“重新索引”。
• 图像扫描 PDF 需要文字层；全文索引不能替代 OCR，也与 AI 服务中的本地向量索引分别管理。

索引在后台进行。大量处理时请保持应用打开并避免频繁移动文件。组合条件与笔记正文检索参阅搜索、排序与保存搜索。

导出与快速复制

在导出设置中选择默认的参考文献格式和笔记复制格式。配置后，可以复制选中的条目，或把条目拖到支持文本输入的应用中快速生成格式化内容。

快速复制适合少量文献；大批量交换数据时，应使用“文件 → 导出”并选择 BibTeX、RIS、CSL JSON 等结构化格式。

数据目录与高级选项

数据目录保存数据库、存储附件、样式和部分插件数据。

• 修改数据目录前先退出其他正在使用该目录的红豆实例；
• 不要把数据目录放在会按文件级别实时同步数据库的网盘目录中；
• 迁移时应复制完整目录，而不是只复制数据库文件；
• 确认新目录可正常打开后，再删除旧备份；
• 本地 API、调试输出和配置编辑器面向高级用户，修改前记录原值。

故障排查顺序

1. 确认红豆已经更新到当前可用版本；
2. 重启应用并复现问题；
3. 检查同步状态、网络和附件路径；
4. 暂时停用最近安装或更新的插件；
5. 对搜索问题重建全文索引；
6. 记录错误提示、操作步骤和调试输出；
7. 在确认备份完整前，不要清空数据目录或重建文库。

高级设置不是性能优化清单。没有明确问题时，保持默认值通常最安全。

引用设置与文档设置的区别

“设置 → 引用”用于安装、删除 CSL 样式和管理桌面文字处理软件插件。参考文献格式预览可以帮助核对样式。详情见引用样式管理。

当前论文采用哪个样式、脚注还是尾注，应在 Word／LibreOffice 工具栏的“文档首选项”中设置；修改 Quick Copy 默认格式不会自动改变已有论文。详情见桌面引用插件。

常用设置对应帮助

Zotero 工具兼容

红豆使用独立的 hongdou:// 链接与原生本地服务（默认 18500 端口）。需要旧外部工具通过 zotero:// 或 23119 端口连接红豆时，在 设置 → 高级 → Zotero 工具兼容 中操作。

1. 完全退出 Zotero 及相关分支应用，确认红豆本地服务正常。
2. 勾选 允许 Zotero 工具连接红豆，等待状态显示已开启。不能开启时按页面原因处理，再重新勾选。
3. 外部工具需要读取文库时，还需在下方“杂项”中单独开启 允许此计算机上的其他应用程序与红豆通讯；写入授权另行确认。
4. 使用 检查状态 检查当前状态。需要排错时展开 使用说明与诊断，点击 复制诊断信息。

兼容只在本次红豆运行期间有效。退出红豆会恢复 zotero:// 原默认应用；检测到 Zotero 启动、电脑休眠或运行检查失败时也会停止。需要使用时检查原因并重新勾选。

若原链接应用未恢复，先确认原应用仍已安装，必要时在系统中重新设置 zotero:// 的默认应用，再返回重新勾选重试。若 Zotero 曾在兼容期间启动，关闭兼容后可能需要重启 Zotero，才能恢复其外部连接。

macOS 上此功能需要 macOS 12 或以上。它覆盖内置 Connector、Local API 和文献链接入口；Better BibTeX 等扩展接口及其他插件功能未必可用。红豆专用工具继续使用原生连接。

MCP：连接 AI 助手

在 设置 → 高级 → MCP 服务 中，按 开启连接 → 配置 AI 程序… → 重启该 AI 程序 完成首次连接，使用时保持红豆运行。

需要时展开 连接详情与更多选项 查看地址、测试与高级选项。默认本机 HTTP 地址为 http://127.0.0.1:18500/mcp，不使用 Bearer Token；旧配置无法连接时，可重新使用“配置 AI 程序…”生成配置。

只查找和阅读时关闭 允许 AI 修改文献库。写入操作还受工具权限和红豆原生确认限制；永久删除默认关闭。详细步骤与研究工作流见MCP 使用帮助。

本地 API 的写入授权

“设置 → 高级”中的本地 API 用于让本机其他应用访问文库。启用后按设置页显示的实际地址连接；应用需要保持运行，端口不可用时先处理占用或按提示重启。

当前本地 API 支持授权后的文库写入。外部应用首次请求修改时，红豆会显示 本地 API 授权，列出请求应用的名称；核对来源与操作目的后再决定是否允许。已有写入授权可在高级设置中用 清除写入授权 撤销，之后应用再次写入时需要重新授权。

本地 API 与MCP 服务使用不同的连接与授权方式；开启其中一个不等于另一个已配置完成。

界面语言、引用语言与条目语言

界面语言控制菜单和提示，在常规设置中修改后按提示重启；引用语言控制参考文献中的术语，在 Quick Copy 或当前文档的引用设置中选择；条目语言表示文献原语种，在题录字段中记录。修改界面语言不会把已有题名翻译成另一种语言，也不会自动修正论文的引用设置。

常用键盘操作

复制结果取决于导出设置中的默认格式，参阅快速引用。输入框有焦点时，数字和编辑快捷键通常作用于文字；先把焦点移回文献列表。

界面和笔记字号可通过“查看”菜单调整。使用屏幕阅读器时按系统和浏览器的导航方式切换窗格；不同平台、插件与阅读器控件的可访问性可能不同，遇到不能定位的控件时反馈具体名称与操作步骤。

配置编辑器的使用边界

高级偏好可能保留 extensions.zotero. 名称，但不表示红豆采用 Zotero 的默认端口、服务地址或账号规则。只调整有明确说明的项目，先记录原值；出现异常时恢复该项目。不要照抄整份官方隐藏偏好表来覆盖当前红豆设置。批注笔记的版式配置见笔记模板。