模型与服务商
MailAgent 不绑定某一家模型服务。你在设置里配置自己的服务商与密钥，对话、邮件分类、报告、记忆抽取等所有用到 AI 的地方，都从这份配置里选模型。
设置 → AI →「模型服务」内置了 18 家服务商、约 480 个模型的资料——每个模型的名称、介绍、上下文长度、最大输出、价格与能力标记（是否支持视觉、工具调用、推理）。这份目录每天通过云端自动同步一次更新，应用启动时检查一次，此后每 6 小时再检查一次；下载成功的资料会保存在本地，离线时继续使用上一份。
目录只是资料参考，不代表你已经配置了这家服务；要用某个模型，仍然需要添加对应的服务商并填入密钥。
添加一个服务商
Section titled “添加一个服务商”点「添加」，从模板里选一个：
- 官方直连：Anthropic、OpenAI、Google Gemini、DeepSeek、OpenRouter——协议原生支持，留空即用官方默认端点。
- 国内 OpenAI 兼容中转：通义千问 DashScope、智谱 GLM、Moonshot Kimi、MiniMax、豆包方舟、SiliconFlow——已预填好对应的接口地址。
- 完全自定义：自定义 OpenAI 兼容、自定义 Anthropic 兼容——填自己的接口地址，接入任何符合这两种协议的服务（比如自建中转网关）。
服务商的连接协议一共五种：Anthropic、OpenAI、OpenAI 兼容、Google、DeepSeek，另加 OpenRouter 单独一档。密钥加密保存在本机，界面上只显示末 4 位掩码，不会在任何日志或接口里回显明文。
添加后可以点「测试连接」，几秒内看到连接是否正常。模型列表可以点「拉取模型列表」从上游自动获取；中转服务不透传模型列表时，也可以手动添加模型 ID，并补上上下文长度、最大输出这些参数。
模型选择器按服务商分组，显示品牌图标、能力标注（视觉 / 工具调用 / 推理）与上下文长度，悬停可以展开更详细的能力卡（限制、价格、发布日期、知识截止日期）。
每个会话记住自己的模型：换一个会话，模型选择独立生效，互不影响；同一个对话里也可以随时换模型，简单问题用快的，复杂梳理换更强的。
全局默认模型与备用模型
Section titled “全局默认模型与备用模型”设置 → AI 里有一个「全局默认模型」，对话和没有单独配置模型的后台任务都用它。它下面是一条「Fallback 链」——如果这个默认模型失败（不可用、凭证缺失、上游直接拒绝），会按顺序依次尝试链上的备用模型。每个自定义 Agent、每个事项的跟进配置，都可以选择跟随这条全局链，或者单独指定自己的模型与备用模型。
自定义 Header
Section titled “自定义 Header”需要给某个服务商的请求额外带上自定义 Header 时，在该服务商的配置里添加即可，值出于安全考虑不会被回显，需要改动时重新输入。有些服务商本身会自动附加需要的 Header（比如 OpenCode 要求的会话头，MailAgent 已经自动生成），如果你自己也配置了同名的 Header，会以你填的值为准。
对话里的画图与改图功能（generate_image 工具）需要单独指定一个图像模型，只能选 OpenAI 或 OpenAI 兼容协议的服务商——目前只有这两类协议实现了图像接口。候选集是「模型服务」里已启用的对应服务商及其已启用的模型（比如 gpt-image-1）。没有配置时，对话里请求画图会提示先来这里设置。
报错时怎么查
Section titled “报错时怎么查”模型调用失败时，界面会显示具体原因，而不是一句笼统的「出错了」——HTTP 状态码和服务商返回的内容都会展示出来。同样的信息也写进了后端日志 ai-gateway.log，排查上游限流、密钥失效这类问题时可以直接翻这个文件。