# AI 助手

接入 **OpenAI 兼容协议**的大模型，为接口调试与自动化测试提供 AI 能力。密钥只保存在本机（localStorage），请求直连供应商，不经过任何第三方中转。

## 配置模型供应商

**设置 → AI 助手 → 模型供应商**，点「添加供应商」，内置常用预设：

| 供应商 | Base URL | 模型示例 |
| --- | --- | --- |
| DeepSeek | `https://api.deepseek.com/v1` | `deepseek-chat` |
| 智谱 GLM | `https://open.bigmodel.cn/api/paas/v4` | `glm-4-flash` |
| Moonshot Kimi | `https://api.moonshot.cn/v1` | `moonshot-v1-8k` |
| OpenAI | `https://api.openai.com/v1` | `gpt-4o-mini` |
| Ollama 本地 | `http://127.0.0.1:11434/v1` | `qwen2.5:7b` |

- **API Key**：Ollama 等本地服务可留空；
- **测试连接**：保存前先发一条 ping 验证地址 / 密钥 / 模型名；
- 多个供应商时可切换「当前使用」的模型。

## AI 生成场景用例

自动化测试视图 →「**AI 生成**」：

1. 选择集合（AI 读取其中全部 HTTP 接口：方法、URL、Body 示例）；
2. 可选填写一句要求，如「覆盖下单 → 支付 → 查询流程，重点断言金额字段」；
3. 模型按业务依赖编排步骤，输出断言与变量提取（如 `$.data.token → token`，后续步骤用 `{{token}}`）；
4. 预览生成的步骤清单（未识别的接口会自动跳过并提示），确认后保存为正式用例。

生成结果只是起点 —— 步骤、断言、提取规则都可再手动调整。

## 隐私与边界

- API Key 仅存本机，随工作区数据一起持久化；导出全量备份时会包含，分享备份文件前请注意；
- 供应商收到的内容为接口清单摘要（方法 / URL / Body 片段）与你的指令，**不含**环境变量值与 API Key；
- 未配置供应商时，Mock 数据、环境变量等离线功能不受影响。

## 常见问题

**生成失败？** 依次检查：Base URL 是否带 `/v1`、模型名是否属于该供应商、Key 是否有效（用「测试连接」验证）、本机能否直连该域名（内网代理环境注意放行）。

**想用公司内网模型？** 添加自定义供应商，Base URL 填内网网关地址即可（需兼容 OpenAI Chat Completions 协议）。