AI 服务设置

红豆 1.0.8 将 AI 能力集中到“设置 → AI 服务”中管理。你既可以使用红豆提供的内置 AI，也可以接入自己的第三方服务，再分别为本地向量化和 AI 搜索选择合适的模型。

使用 AI 前，请先完成服务配置和模型分配。不同服务的可用模型、上下文长度、速度、配额与计费规则可能不同，请以服务商说明为准。

打开 AI 服务设置

1. 打开红豆主界面。
2. 进入“编辑 → 设置”（macOS 中从应用菜单进入“设置”）。
3. 选择左侧的“AI 服务”。
4. 在右侧切换“服务”“模型”“本地 AI”三个页面。

三个页面的作用分别是：

• 服务：添加、启用、停用或删除 AI 服务，并获取服务可用的模型；
• 模型：把已经启用的服务和模型分配给本地向量化、AI 搜索等功能；
• 本地 AI：建立和维护本机文献向量索引，查看索引状态和处理记录。

使用内置 AI

“红豆 AI”是应用内置服务，适合希望直接使用 AI 功能、减少额外配置的用户。

1. 在“服务”页找到“红豆 AI”。
2. 确认服务处于启用状态。
3. 切换到“模型”页，为需要的功能选择红豆 AI 及相应模型。
4. 保存或确认选择后，即可开始建立本地向量索引并使用 AI 搜索。

内置服务的部分操作可能消耗账号 Token。开始大规模向量化或连续提问前，建议确认账号配额。

添加第三方 AI 服务

红豆目前可配置 OpenAI、Gemini、DeepSeek、通义千问、智谱 AI、Ollama、LM Studio、Agnes AI，以及自定义 OpenAI 兼容服务。实际可用模型由所选服务和账号权限决定。

1. 在“服务”页点击“添加服务”。
2. 选择服务类型，并填写便于识别的服务名称。
3. 检查或填写“基础地址”。使用服务商托管接口时应使用 HTTPS；Ollama、LM Studio 等本机服务可以使用本地 HTTP 地址。
4. 填写该服务的 API Key。没有密钥的本机服务按界面要求留空。
5. 保存服务。新添加的服务默认不会立即启用。
6. 在服务卡片中执行“更新模型”，等待红豆读取模型列表。
7. 模型更新成功后，手动启用该服务。
8. 前往“模型”页，将服务和具体模型分配给需要的功能。

基础地址填写建议

• 使用服务商官方地址或其文档指定的兼容接口地址；
• 自定义服务需要提供与 OpenAI API 兼容的接口；
• 远程服务必须使用 HTTPS，以避免密钥和文献内容在传输中暴露；
• 只有运行在本机的服务才建议使用 HTTP；
• 如果通过代理、网关或中转服务访问，请确认其支持所选模型和接口格式。

API Key 仅保存在当前设备。使用第三方服务时，相关请求会发送到你配置的服务端，可能产生服务商费用。

为功能分配模型

打开“AI 服务 → 模型”，可以分别为不同功能指定服务和模型。目前可见的分配项目包括：

• 本地向量化：把文献题录、附件、笔记和批注转换为可检索的向量；
• AI 搜索：理解自然语言查询，并在当前文库或分类的本地向量索引中查找相关文献。

建议先配置“本地向量化”，完成索引后再使用 AI 搜索。为某项功能分配模型后，对应服务不能直接停用或删除；如需更换，请先在“模型”页把该功能改到其他服务。

数据与费用说明

• 本地向量索引保存在当前设备上；
• 建立索引时，待处理的文献文字会发送到你选择的向量化服务；
• 使用内置兼容模型时，可使用服务端备份与同步索引；第三方模型建立的索引仅保存在本机；
• 内置服务可能消耗 Token，第三方服务可能按请求量、字符数或 Token 收费；
• API Key 仅保存在本机，但文献内容如何处理和保留取决于所选服务商的政策；
• 对保密材料、未公开研究和受协议约束的文献，请先确认数据使用要求。

常见问题

更新模型后列表仍为空

检查基础地址、API Key、网络连接和账号权限。本机服务还需确认 Ollama 或 LM Studio 已启动，并且至少安装了一个可用模型。

服务无法启用

先执行“更新模型”。如果读取模型失败，请修正服务配置后重试。

服务无法停用或删除

该服务可能已经分配给本地向量化或 AI 搜索。先在“模型”页改用其他服务，再返回“服务”页操作。

请求提示未授权或额度不足

重新核对 API Key、账号余额、模型权限和服务商的地域限制。

远程 HTTP 地址无法保存

远程 AI 服务需要 HTTPS。只有本机服务地址可以使用 HTTP。