AI 服务设置
红豆在 设置 → AI 服务 中集中管理服务、功能模型和本地向量索引。当前界面有 服务／功能模型／本地 AI 三个页签，分别解决“连接哪个服务”“各功能用什么模型”“如何维护文库索引”。
使用内置服务
在“服务”页确认内置红豆 AI 可用，然后在“功能模型”页为所需功能选择界面列出的适用模型。更改后自动保存。内置服务需要有效登录及对应权益，额度以账户页实时显示为准。
添加第三方或本机服务
可配置 OpenAI、Gemini、DeepSeek、通义千问、智谱 AI、Kimi、MiniMax、Grok、MiMo、Ollama、LM Studio、Agnes AI，以及自定义 OpenAI 兼容服务。实际模型及能力由服务商与账号权限决定。
- 在“服务”页点击 添加服务，选择类型，填写名称、基础地址和 API Key。
- 使用服务商提供的兼容 API 基础地址；远程地址必须为 HTTPS，本机模型服务可以用本地 HTTP 地址。
- 保存后点击 更新模型。新增服务默认停用，确认配置后手动启用。
- 打开“功能模型”，为所需功能选择该服务和具体模型。
本机服务还需保持 Ollama／LM Studio 运行，并安装适用模型。API Key 仅安全保存在当前设备，不写入设置备份或索引同步数据；换电脑需重新配置。
四项功能模型
| 功能 | 需要的能力 | 用途 |
|---|---|---|
| 本地向量化 | 向量／embedding | 处理题录、附件、笔记和批注，建立本地语义索引 |
| AI 搜索 | 向量／embedding | 将搜索词转为可与索引比较的向量；建议与本地向量化使用相同或兼容配置 |
| AI 对话增强 | 对话／chat | 增强 AI 对话 |
| AI 写作智能体 | 支持工具调用的对话模型 | 与 Markdown 编辑器配合起草、预览和修改内容 |
模型更改后自动保存。已分配给任意功能的服务不能直接停用或删除：先把该功能切换到其他可用服务，再处理旧服务。
模型列表没有适用模型
先更新模型列表。如果服务支持所需接口，但没有明确标注模型能力，可以按界面提供的 手动指定向量模型／对话模型 输入准确名称，再点击“使用此模型”。手动指定不能为模型补上服务端原本没有的能力。
向量功能要求服务支持 embeddings；写作要求兼容对话及工具调用。模型名称相同不等于跨服务的向量索引一定兼容，更换向量配置后应按提示重新整理索引。
本地 AI 与索引
在“本地 AI”页开启本地向量索引，查看处理状态、自动更新、用量明细及云备份。详见本地向量索引和AI 搜索。
PDF 阅读问答详见PDF 智问；Markdown 编辑与修改审阅详见AI 写作工作区。
数据传输与费用
建立索引时，文献文字发送给所选向量化服务；搜索词发送给 AI 搜索服务；对话和写作会发送相应问题、正文或上下文。本地索引保存在本机不表示生成向量时完全离线。
内置服务可能消耗账号 Token，第三方服务按其规则计费；本机模型是否联网取决于服务配置。处理未公开或保密材料前，确认所选服务的数据使用规则。
常见问题
模型为空或服务不能启用：检查基础地址、API Key、网络、模型权限；本机服务确认已启动，然后“更新模型”。
服务不能删除：在功能模型页逐项检查是否仍有功能使用该服务，先切换再删除。
模型不兼容：按上表选择相应能力的模型，不能把向量模型作为写作或问答模型使用。
未授权、余额不足或限速：检查登录、Key、权益及服务商余额，等待限速解除后重试。
地址无法保存：远程服务用 HTTPS；地址不要包含凭证、查询参数或片段。
