配置 AI

AgileMedic 的 AI 能力（AI 诊断官 / AI 解释官 / AI 决策官）需要你自己的 AI API Key。配置一次后，全应用的 AI 入口都会用它。

AI 是可选的

不配 Key 也能用 AgileMedic 的全部本地功能——进程管理、启动项、网络监控、大文件查找、卸载残留、垃圾清理都完全本地运行，一个字节都不联网。AI 只在你主动点「AI 诊断 / AI 解释 / AI 复核」时才会调用你配置的模型。

隐私承诺

• AI 请求只发给你自己填写的服务商（Anthropic / OpenAI / 你填的兼容端点），AgileMedic 不收集、不转发、不上传任何数据，也没有中转服务器。
• API Key 经 Windows DPAPI 加密后存于 %APPDATA%\AgileMedic\ 下的 AI 配置文件，只绑定当前 Windows 用户帐号，明文永不落盘。
• 数据流：你的电脑 → 你的 API Key → 你选的服务商 → 直接返回。

支持的服务商

AgileMedic 内置两类 Provider，覆盖主流云端和本地模型：

Provider	协议 / 端点	覆盖的服务商
Anthropic Claude	/v1/messages，请求头 x-api-key + anthropic-version	Anthropic 官方 Claude
OpenAI 兼容	/v1/chat/completions，请求头 Authorization: Bearer	OpenAI、DeepSeek、月之暗面（Kimi）、智谱、通义、Groq、本地 vLLM / Ollama / LM Studio 等

为什么只有两个 Provider

凡是「兼容 OpenAI 接口」的服务商——包括绝大多数国内厂商和本地推理引擎——都归到 OpenAI 兼容 这一项，填对 Base URL 和模型名即可，不需要为每家单独适配。

默认模型候选

打开 AI 设置 后，Model 是一个可编辑下拉框——列表里是常见候选，你也可以直接手动输入任意模型名。

• Anthropic Claude：claude-opus-4-8、claude-opus-4-7、claude-sonnet-4-6、claude-sonnet-4-5、claude-haiku-4-5（切到该 Provider 时预填 claude-sonnet-4-5）
• OpenAI 兼容：gpt-4o、gpt-4o-mini、deepseek-chat、deepseek-reasoner、moonshot-v1-8k（切到该 Provider 时预填 gpt-4o）

配置步骤

1. 打开 AI 设置

任意 AI 入口都能进：

• 左侧导航进 AI 诊断 面板 → 顶部 AI 设置 按钮；
• 未配置时，AI 诊断面板会显示「AI 诊断官需要先连接模型」引导页 → 点 打开 AI 设置；
• 也可以从设置里进入。

打开的是一个双栏对话框：左侧是配置列表（可维护多个模型），右侧是表单。

2. 填写表单

右侧表单字段（以真实界面为准）：

字段	说明
Provider	选 Anthropic Claude 或 OpenAI 兼容 (DeepSeek / 月之暗面 / Groq / 本地 vLLM 等)
名称	用户备注，如「Claude 主力」「本地 DeepSeek」；留空则用 Provider 名兜底
Base URL	留空 = 用官方端点（api.anthropic.com / api.openai.com）；本地模型 / 第三方在这里填
API Key	密码模式输入，旁边有 显示 / 隐藏 切换；本地模型无 Key 可随便填一个占位（多数本地端点不校验）
Model	可编辑下拉，选候选或手动输入

API Key 和 Model 是必填

只有 API Key 和 Model 都填了，配置才算有效，才能保存 / 测试 / 设为使用中。

3. 测试连通

填好后点 测试连通——AgileMedic 会向你填的端点发一句「回一句话证明你在听」的最小请求。

• 成功：显示 ✓ 连通成功 + 模型回复的前几个字；
• 失败：显示 ✗ 失败 + 具体原因（见下方常见错误）。

4. 保存 / 设为使用中

• 保存：把当前表单存成一条配置（不关窗）；
• 设为使用中：保存并把这条配置设为 AI 诊断实际调用的模型（列表里标 ✓ … (使用中)）；
• 完成：表单有效时自动保存后关窗，避免忘点保存丢失编辑。

保存后，AI 诊断面板顶部会立即切到可用状态，模型徽章显示当前使用中的模型。

多模型与快速切换

左侧列表支持配置多条模型（如「Claude 主力」+「本地 DeepSeek」备用）：

• 点列表项加载到右侧表单编辑；
• ＋ 新建 清空表单进入新建态；删除 移除当前配置；
• 在 AI 诊断 / AI 对话 页，点顶部模型徽章可以一键在已配置的模型间切换，无需回到设置。

本地模型（Ollama / LM Studio / vLLM）

本地模型完全走 OpenAI 兼容 这一项：

1. Provider 选 OpenAI 兼容；
2. Base URL 填本地端点，例如 Ollama / LM Studio 的 http://localhost:11434/v1；
3. API Key 填任意占位字符串（本地端点通常不校验）；
4. Model 填你本地已拉取的模型名，如 qwen2.5、deepseek-r1 等（手动输入即可）。

本地模型的好处是数据不出机器，适合对隐私特别敏感的场景。

代理

如果你所在网络需要代理才能访问 Anthropic / OpenAI：

• 用国内的 OpenAI 兼容服务商（在 Base URL 填 https://api.deepseek.com 之类）绕开跨境访问；
• 或用本地模型，彻底免网络。

导入 / 分享配置

• 导入配置：从剪贴板导入 ai.profile 分享文本（与 AgileShot / reeve 的分享格式兼容），导入后自动新增并设为使用中；
• 分享配置：把当前配置导出为分享文本复制到剪贴板。

分享文本含明文 API Key

「分享配置」导出的文本包含明文 API Key，只发给你信任的人——泄露等于泄露你的 AI 账号额度和扣费权限。AgileMedic 会在复制前二次确认。

常见错误

提示	原因 / 解决
API Key 无效或已过期	HTTP 401：Key 填错或失效，重新生成
请求过于频繁,请稍后重试	HTTP 429：触发限流，降低频率或升级套餐
服务端错误 (HTTP 5xx)	服务商临时不可用，稍后重试
保存失败 (DPAPI 加密或文件写入错误)	凭据加密 / 落盘异常，检查磁盘权限，见日志
连接超时（60 秒）	网络不通或需要代理，检查防火墙 / 代理，或换本地模型

下一步

• AI 诊断官（主入口）
• AI 对话窗口（多轮）
• 隐私说明
• 常见问题