AI 设置
新版 AI 设置不再只是填写一个 API URL + API Key + Model。
MemoFlow 现在按“服务 -> 模型 -> 默认用途”管理 AI，更适合同时接入多个服务商、本地模型与自定义模型。
1. 现在的结构
我的画像
- 可选填写你的角色、关注主题、写作偏好或分析背景。
- 这部分会作为 AI 分析的背景信息使用。
- 不填也可以正常使用 AI 总结。
服务列表
- 每个服务都保存一组独立配置：服务名称、
Base URL、API Key、额外请求头、校验状态。 - 一个服务下可以挂多个模型。
- 支持打开详情页继续检查连接、复制服务、删除服务、管理模型。
模型能力
Chat：用于 AI 总结 / 分析报告 / 快速提示词等生成类任务。Embedding：用于向量检索与证据召回，不是必填，但推荐配置。- 新增或编辑模型时，可以给同一个模型勾选
Chat、Embedding之一或同时勾选。
2. 添加服务的三步流程
第一步：选择模板
- 可以直接选择内置服务商模板。
- 也可以选择自定义协议接入。
- 当前自定义协议支持：
- OpenAI 兼容
- Anthropic / Claude 风格
- Gemini / Google AI 风格
第二步：配置服务
需要填写或确认：
- 服务名称
Base URLAPI Key（部分服务可不填）Extra Headers（适用于网关、代理或特殊鉴权）
在这一步还能直接打开对应服务商文档。
第三步：配置模型
- 至少添加一个模型。
- 每个模型都可以声明能力：
Chat、Embedding。 - 可以把某个模型设为：
- 生成默认：给 AI 总结 / 分析报告 / 快速提示词使用
- Embedding 默认：给向量检索使用
3. 模型管理能做什么
服务详情页里的模型管理支持：
- 添加自定义模型
- 从内置常用模型预设快速添加
- 对支持模型发现的服务商执行“同步模型”
- 搜索、筛选、排序和启停模型
- 删除模型（如果它正被默认用途绑定，系统会自动解绑或提示影响范围）
4. 默认用途是怎么工作的
当前最重要的两类默认用途是：
- 生成默认：给
AI 总结、分析报告、快速提示词等聊天生成任务使用。 - Embedding 默认：给向量检索与证据召回使用。
实用理解：
- 没有
Chat模型，AI 总结就不能开始。 - 没有
Embedding模型，AI 总结仍然可以运行，但会退回直接阅读模式，分析准确性通常会下降。
5. 与 AI 总结的关系
如果你只想尽快用起来，优先级建议是：
- 先配好一个可用的
Chat模型。 - 再补一个
Embedding模型，提升检索与分析质量。 - 最后根据需要补充“我的画像”和自定义模板。
这也是新版 AI 设置和 AI 总结最大的变化：
先把服务和模型配清楚，再去选择洞察模板做分析。
6. 配置建议
- 云端服务商尽量使用
HTTPS。 - 本地模型服务优先确认地址是否能从当前设备访问。
- 如果网关要求额外认证头，把它写到
Extra Headers。 - 自定义模型时，
Model Key要与服务端实际模型标识一致。 - 如果你要同时测试多个服务商，建议“一家服务商一个服务实例”，后续排查更清楚。
7. 常见问题
添加了服务，但 AI 总结还是不能开始
优先确认：
- 是否至少有一个启用中的
Chat模型； - 是否把模型设为了生成默认；
Base URL、API Key、模型名是否有效。
能总结，但结果总觉得不稳定
常见原因：
- 没有配置
Embedding模型； Embedding模型反复失败；- “我的画像”或当前模板提示词不够清晰。
连接检查失败怎么办
先查这几项：
Base URL是否能访问；API Key是否正确；Extra Headers是否缺失；- 是否存在证书 / 代理 / 网关问题。