本地向量索引
本地向量索引是红豆 1.0.8 的语义检索基础。它会把文献题录、附件正文、笔记和批注切分为可检索的内容片段，并转换为向量保存在当前设备中。完成索引后，AI 搜索才能根据“研究主题、方法、对象或结论”等自然语言含义查找文献，而不只依赖题名和关键词完全匹配。
使用前准备
- 打开“设置 → AI 服务 → 服务”，确认至少有一个可用的 AI 服务。
- 打开“AI 服务 → 模型”，为“本地向量化”选择服务和向量模型。
- 如果使用第三方服务，确认基础地址、API Key、模型权限和余额均正常。
- 返回“AI 服务 → 本地 AI”开始建立索引。
向量模型决定索引的维度和语义表示。更换模型后，原索引通常不能继续用于新的模型配置，建议按界面提示重新建立索引。
可以索引哪些内容
红豆可以将以下本地资料纳入索引：
- 文献基础信息，例如题名、作者、摘要、关键词等；
- PDF 附件；
- EPUB 附件；
- 网页附件；
- 文本附件；
- 文献笔记；
- PDF 批注。
只有已经下载到当前设备、能够正常读取的附件才可以处理。扫描版 PDF 如果没有可提取文字，需要先进行 OCR；受密码保护、损坏或格式异常的文件也可能处理失败。
首次建立索引
- 打开“设置 → AI 服务 → 本地 AI”。
- 确认当前显示的向量化服务和模型正确。
- 按需要开启“自动更新”。建议日常使用时保持开启。
- 点击开始建立或重新建立索引。
- 保持红豆运行并等待处理。文献较多、附件较大或服务限速时可能需要较长时间。
- 在状态区域观察资料数、搜索段数、等待项目和失败项目。
建立索引时，红豆会逐步读取本地资料、分段并请求所选向量化服务。这个过程可以在后台继续，但关闭应用、网络中断、服务达到频率限制或额度不足会使部分项目等待或失败。
自动更新
启用自动更新后，红豆会在资料发生变化时维护索引，例如：
- 新增或删除文献；
- 添加、替换或删除附件；
- 修改题录信息；
- 新建或编辑笔记；
- 新增、修改或删除批注。
自动更新用于保持索引与本地文库一致。大量导入文献或迁移数据库后，建议等待处理完成再使用 AI 搜索。
查看索引状态
状态页会显示索引规模和处理进度，常见指标包括：
- 状态：当前索引是否可用、是否正在处理；
- 资料数：已经纳入索引的文献或资料数量；
- 搜索段数：可用于语义匹配的内容片段数量；
- 等待项目：尚未处理或等待重试的项目；
- 失败项目：本次处理未成功的项目；
- 最近一次向量化：最近处理内容、时间和结果明细。
如果等待数量持续不下降，先检查网络和所选 AI 服务；如果只有个别项目失败，检查对应附件能否正常打开和提取文字。
重新建立与删除索引
什么时候需要重新建立
出现以下情况时可重新建立索引：
- 更换了向量化服务或向量模型；
- 大批量导入、迁移或恢复文献后，索引状态与文库不一致；
- AI 搜索长期漏掉已经存在且可读取的资料；
- 状态页持续出现无法自动恢复的异常；
- 应用提示当前索引与模型不兼容。
重新建立会重新处理资料，可能耗费较多时间、Token 或第三方服务费用。建议先确认服务配置和模型，再开始操作。
删除本地索引
“删除本地索引”只移除当前设备上的向量索引，不会删除文献条目、附件、笔记或批注。删除后，AI 搜索将无法使用，直到重新建立索引。
索引备份与多设备
- 使用红豆内置兼容模型建立的索引，可使用服务端备份与同步能力；
- 使用第三方向量模型建立的索引只保存在当前设备；
- 在另一台设备上使用第三方模型时，需要在该设备重新建立索引；
- 向量索引不能替代文献数据库和附件备份。
数据传输、隐私与费用
虽然索引结果主要保存在本地，但生成向量时，待处理的文字内容会发送到你选择的向量化服务。请注意：
- 内置服务可能消耗红豆账号 Token；
- 第三方服务可能产生 API 调用费用；
- 第三方服务如何记录、保留或使用请求内容，取决于其服务条款；
- API Key 仅保存在当前设备；
- 处理保密资料、未公开论文、患者数据或受协议限制的内容前，应确认组织的数据合规要求。
常见问题
索引一直处于等待状态
检查是否已经为“本地向量化”分配模型，并确认服务已启用、网络正常且额度充足。本机模型服务还需保持运行。
部分 PDF 没有进入索引
确认附件已经下载到本机并能正常打开。扫描版 PDF 需先 OCR；加密、损坏或没有文字层的 PDF 可能无法处理。
AI 搜索找不到刚添加的文献
查看自动更新是否开启，以及等待项目是否已处理完成。必要时手动触发更新。
更换模型后搜索结果异常
不同向量模型的索引不能混用。重新建立索引后再搜索。
失败项目很多
先暂停大规模重建，检查 API Key、服务地址、模型权限、频率限制和余额。修复后重新处理。
