本地向量索引
本地向量索引把题录、附件正文、笔记和批注分成文本片段并转换为向量，为 AI 搜索提供语义匹配。只有已经下载到本机、能够读取的资料才可处理；扫描 PDF 需要可提取文字或先完成 OCR。
首次启用
- 打开 设置 → AI 服务 → 服务，确认所需服务已启用。
- 在 功能模型 中为“本地向量化”分配向量模型，并为“AI 搜索”选择相同或兼容配置。
- 打开 本地 AI，开启本地向量索引总开关。
- 按需要启用“文献、附件、笔记等变化时自动更新本地向量索引”。
- 保持应用运行，等待后台整理；在状态区查看资料数、可搜索段数、等待、处理中及失败项目。
可处理的内容包括题录、PDF、EPUB、网页及文本附件、笔记和 PDF 批注。附件尚未下载、无法提取文字、文件损坏或受保护时，可能只有题录进入索引。
自动更新与处理状态
自动更新会在题录、附件、笔记和批注变化后维护索引。大量导入或恢复文库后，应等任务处理完成再评估搜索结果。
- 资料数／可搜索段数表示已整理的资料与文本片段，不等于文献库条目总数。
- 等待／处理中表示任务尚未完成；关闭应用、断网或限速可能延迟处理。
- 失败项目需要分别检查来源文件、文字提取、服务和额度。
- 查看最近一次本地向量化明细可查看时间、内容、请求和服务返回的用量；明细仅保存在这台电脑，服务未返回的 Token 不会被估算为精确用量。
备份并同步向量化数据
当前仅 兼容的内置红豆 AI 配置（默认 bge-m3） 支持服务端索引备份。使用第三方向量模型的索引只保存在本机，另一台设备需配置相同模型并建立自己的索引。
- 确认已登录，并选用了支持同步的内置配置。
- 打开“备份并同步向量化数据”。
- 等待本地处理和云端任务；需要时点击 立即同步。
- 如显示等待本地索引完成，先等索引任务结束；显示失败时检查网络、登录和额度，再按界面提供的入口重试。
- 在另一台设备上先同步文献与附件，并使用兼容配置，再观察索引恢复／同步状态。
遇到服务限流或临时故障时，云同步会等待后重试，重启应用仍可能保留等待时间。上传冲突也会重新核对并恢复任务；本地队列仍在时，不要为清除等待而反复重建索引。只有持续报错且无法恢复时，再记录提示排查。
向量同步、题录同步和附件同步分别进行。向量云备份不能代替完整数据目录备份。
更换模型、重建与删除
更换向量配置后，新配置与原索引隔离，并按所选服务和模型重新整理内容。搜索模型也应保持兼容，不能混用不同语义空间。
重新建立本地索引会删除本机索引及当前账号已备份的服务端向量化数据，再重新计算；开启云同步时，新结果会重新上传。重建可能消耗较多 Token 或第三方费用，先确认模型与服务正常，再按确认窗口操作。
删除本地索引会清除本机索引和等待任务，并停用自动更新；已备份的服务端向量化数据不会由这个操作删除。文献条目、附件、笔记和批注不随索引删除。
数据传输与费用
生成向量时，待处理文字会发送给所选服务；AI 搜索会发送查询文字给对应服务。内置服务可能消耗账号 Token，第三方按其规则收费。保存在本机的索引不代表云端模型生成过程离线。API Key 不随索引备份同步。
常见问题
新文献搜索不到：确认总开关、自动更新、附件下载及等待任务；具体题名、DOI 或作者可先用普通搜索。
Token 不足而暂停：先在账户页检查余额和权益，处理后观察队列恢复，避免反复重建。
第三方索引不上传：这是当前配置的行为，需在每台设备独立建立。
失败集中在某几个 PDF：先打开并尝试复制正文，检查扫描、加密或损坏问题。
