AI 面板的目标：让「写不出的 SQL」和「看不懂的 SQL」不再阻塞你。

侧栏支持 **Ask | Agent**：Ask 只生成 SQL；Agent 调用与 MCP 同源的只读工具真查库。外部编辑器可用 `npx @rlwj-lab/opsxdb-mcp` 接入（配置方法见 [MCP 接入](/docs/mcp)）。

## 六种动作

| 动作 | 用途 |
| --- | --- |
| 生成 | 自然语言 → SQL（「查最近 7 天下单但未支付的用户」） |
| 解释 | 把一段复杂 SQL 翻译成中文说明 |
| 优化 | 分析慢查询，给出索引 / 改写建议 |
| 修复 | 报错信息 + SQL → 修正版本 |
| 方言 | MySQL ↔ PostgreSQL 等跨方言转换 |
| 样例 | 按表结构生成示例查询 |

## 使用方式

1. 连接库后打开右侧 AI 面板；
2. 选择动作，输入需求或粘贴 SQL（可附上对象树上下文）；
3. 生成结果一键放回编辑器，⌘/Ctrl + Enter 执行。

> **提示**：生成的 SQL 依旧走危险语句确认流程 —— AI 产出与手写 SQL 同等对待，不放宽防护。

## 接入真实模型

AI 面板支持任何 **OpenAI 兼容协议**的服务（OpenAI / DeepSeek / 通义 / 本地 vLLM 等），回复以 **SSE 流式**逐字输出，等待模型时不再面对空白。

配置入口（二选一）：

1. AI 面板右上角「**配置**」：填 Base URL、API Key、模型名，保存后可一键测试；
2. 配置文件 `~/.opsxdb/ai.json`（权限 0600），或环境变量 `OPSXDB_AI_PROVIDER / OPSXDB_AI_BASE_URL / OPSXDB_AI_API_KEY / OPSXDB_AI_MODEL`。

> **说明**：未配置 API Key 时回落本地 stub（离线占位，内容为模板演示）；AI Key 保存后服务端只回显掩码（`sk-***`）。

## 数据流向承诺

- 默认只发送你明确提交的内容（附当前库表结构上下文，不含连接凭据）；
- 可完全关闭 AI 功能（顶栏隐藏面板即可，无后台请求）；
- 使用云端模型时在界面上明确标识，生成 SQL 依旧走危险语句确认流程。