配置 AI
AgileMedic 的 AI 能力（AI 诊断、一键巡检、各面板的「问 AI / AI 解释 / AI 详解」、AI 复核）用的是你自己的 AI API Key。配置一次后，全应用的 AI 入口都会用它。
AI 是可选的
不配 Key 也能用 AgileMedic 的全部基础功能——文件解锁、监控、进程、启动项、服务、网络、大文件、垃圾清理、软件管理，连同 MCP 接入，都在本机完成，不需要模型。AI 只在你主动点「AI 诊断 / AI 解释 / AI 复核」时才会调用你配置的模型。
两笔钱分开算
- AI 功能的授权：AI 功能提供免费试用，到期后输入激活码继续用（在「设置 → 授权 & AI 许可」里购买或输入）。到期只停 AI 功能，基础功能和本机数据不受影响。见 软件许可协议 第三、四条。
- 模型费用：AgileMedic 不提供模型、不含调用额度。你用自己的 API Key 产生的费用，由你和服务商结算，与授权费无关。
- 「测试连通」也算一次 AI 调用，同样需要在试用期内或已授权。
隐私说明
- AI 请求直接发给你填写的服务商（接口地址对应的那家），不经过 AgileMedic 的服务器中转。发出去的是你的问题、对话历史，以及你请求解读的那部分系统信息（进程名与路径、启动项、服务、连接地址与端口、文件名等）。服务商怎么处理这些数据，受你和它之间的条款约束。
- API Key 经 Windows DPAPI 加密后存在
%APPDATA%\AgileMedic\shared\ai-profiles.json（字段apiKeyEnc），只有当前 Windows 用户能解开，界面上默认不显示明文。 - AgileMedic 自己还会联网做授权校验与更新检查，与 AI 无关，见 隐私与数据。
支持的服务商
底层是两种协议，覆盖主流云端和本地模型：
| 协议 | 端点 / 请求头 | 覆盖的服务商 |
|---|---|---|
| Anthropic | /v1/messages，请求头 x-api-key + anthropic-version | Anthropic 官方 Claude，以及兼容 /v1/messages 的转发端点 |
| OpenAI 兼容 | /v1/chat/completions，请求头 Authorization: Bearer | OpenAI、DeepSeek、月之暗面（Kimi）、智谱、Groq、本地 vLLM / Ollama / LM Studio 等 |
界面上不让你直接选协议，而是选一个预设，选中后自动带出协议、端点和候选模型：
| 预设 | 协议 | 预填的 Base URL | 候选模型 |
|---|---|---|---|
| Anthropic 官方 | Anthropic | 官方端点 | claude-opus-4-8、claude-opus-4-7、claude-sonnet-4-6、claude-sonnet-4-5、claude-haiku-4-5 |
| Claude Code 客户端 (自定义 /v1/messages) | Anthropic | 自己填 | claude-opus-4-8、claude-sonnet-4-6、claude-sonnet-4-5、claude-haiku-4-5 |
| DeepSeek (OpenAI 兼容) | OpenAI 兼容 | https://api.deepseek.com | deepseek-chat、deepseek-reasoner |
| Groq (OpenAI 兼容) | OpenAI 兼容 | https://api.groq.com/openai | llama-3.3-70b-versatile 等 |
| 月之暗面 Kimi (OpenAI 兼容) | OpenAI 兼容 | https://api.moonshot.cn | kimi-k2-0711-preview、moonshot-v1-8k 等 |
| 智谱 GLM (OpenAI 兼容) | OpenAI 兼容 | https://open.bigmodel.cn/api/paas | glm-4.6、glm-4.5-air 等 |
| OpenAI 官方 | OpenAI 兼容 | https://api.openai.com | gpt-4o、gpt-4o-mini、gpt-4.1 |
| 其它 OpenAI 兼容 (自定义 Base URL) | OpenAI 兼容 | 自己填 | 自己填 |
Base URL 不要带 /v1
AgileMedic 会在 Base URL 后面自动拼 /v1/messages 或 /v1/chat/completions。所以 Base URL 只填到域名（或域名加前缀），不要自己再加 /v1，否则会变成 /v1/v1/... 请求失败。
默认模型候选
Model 是一个可编辑下拉框——列表里是上表的候选，你也可以直接手动输入任意模型名。
配置步骤
1. 打开 AI 设置
任意一处都能进：
Ctrl+,或右上角齿轮进 设置，找到 AI 模型配置 一节；- 左侧导航进 AI 诊断 面板 → 顶部 AI 设置 按钮；
- 未配置时，AI 诊断面板会显示引导页 → 点 打开 AI 设置。
「AI 模型配置」是设置页里的一组卡片，每张卡是一条配置，右上角有 粘贴导入 和 ＋ 新建配置。
2. 填写表单
点 ＋ 新建配置（或卡片上的 编辑）弹出表单：
| 字段 | 说明 |
|---|---|
| Provider | 选上表的一个预设 |
| 名称 | 用户备注，如「Claude 主力」「本地 DeepSeek」 |
| Base URL | 留空 = 用预设的官方端点；本地模型 / 第三方在这里填 |
| API Key | 密码模式输入，旁边有 显示 / 隐藏 切换；本地模型无 Key 可随便填一个占位（多数本地端点不校验） |
| Model | 可编辑下拉，选候选或手动输入 |
API Key 和 Model 是必填
只有 API Key 和 Model 都填了，配置才算有效，才能保存 / 测试。
3. 测试连通
表单里点 测试连通（或卡片上的 测试）——AgileMedic 会向你填的端点发一句「回一句话证明你在听」的最小请求。
- 成功：显示
✓ 连通成功:+ 模型回复； - 失败：显示
✗ 失败:+ 具体原因（见下方常见错误）。
4. 保存与激活
- 表单底部 保存 存下这条配置，取消 放弃编辑；
- 卡片上的 激活 把这条配置设为 AI 功能实际调用的模型，卡片上会标「☆ 使用中」；
- 卡片上还有 测试、分享、编辑、删除。
激活后，AI 诊断面板顶部会立即切到可用状态，模型徽章显示当前使用中的模型。
多模型与快速切换
可以配置多条模型（如「Claude 主力」+「本地 DeepSeek」备用）：
本地模型（Ollama / LM Studio / vLLM）
本地模型走 其它 OpenAI 兼容 (自定义 Base URL) 这一项：
- Provider 选
其它 OpenAI 兼容 (自定义 Base URL)； - Base URL 填本地端点，例如 Ollama 的
http://localhost:11434（不带/v1）； - API Key 填任意占位字符串（本地端点通常不校验）；
- Model 填你本地已拉取的模型名，如
qwen2.5、deepseek-r1等（手动输入即可）。
本地模型的好处是数据不出机器，适合对隐私特别敏感的场景。用本地模型同样需要 AI 功能在试用期内或已授权。
代理
如果你所在网络需要代理才能访问 Anthropic / OpenAI：
- 用国内的 OpenAI 兼容服务商（预设里的 DeepSeek、Kimi、智谱）绕开跨境访问；
- 或用本地模型，彻底免网络。
导入 / 分享配置
- 粘贴导入：从剪贴板导入
ai.profile分享文本（与 AgileShot / reeve 的分享格式兼容），导入后自动新增并设为使用中； - 分享：卡片上的「分享」把这条配置导出为分享文本复制到剪贴板。
分享文本含明文 API Key
「分享」导出的文本包含明文 API Key，只发给你信任的人——泄露等于泄露你的 AI 账号额度和扣费权限。AgileMedic 会在复制前二次确认。
常见错误
| 提示 | 原因 / 解决 |
|---|---|
API Key 无效或已过期 | HTTP 401：Key 填错或失效，重新生成 |
| 403 / 404 相关提示 | 无权访问该模型，或 Base URL / 模型名写错（常见于 Base URL 多写了 /v1） |
请求过于频繁,请稍后重试 | HTTP 429：触发限流，降低频率或升级套餐 |
服务端错误 (HTTP 5xx) | 服务商临时不可用，稍后重试 |
保存失败 (DPAPI 加密或文件写入错误,见日志) | 凭据加密 / 落盘异常，检查磁盘权限，见日志 |
| 连接超时（60 秒） | 网络不通或需要代理，检查防火墙 / 代理，或换本地模型 |
| 提示试用已到期 | AI 功能的试用结束了，到「设置 → 授权 & AI 许可」输入激活码 |