设置与高级选项

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

常规设置

常用选项包括：

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

自动识别和自动标签会影响新加入的数据，不一定追溯修改已有条目。

文件重命名

在文件重命名区域可以：

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

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

同步设置

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

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

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

全文索引

全文索引区域会显示已索引、部分索引和未索引文件数量，以及索引词数。

• 调整每个文件最多索引的字符数和 PDF 页数；
• 使用“重建索引”处理搜索结果缺失或索引损坏；
• 使用“清除索引”会移除本地全文缓存，之后需要重新建立；
• 图像扫描 PDF 需要文字层才能被全文搜索。

索引在后台进行。大量重建时请保持应用打开并避免频繁移动文件。

导出与快速复制

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

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

数据目录与高级选项

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

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

故障排查顺序

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

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