AI 面板的目标:让「写不出的 SQL」和「看不懂的 SQL」不再阻塞你。
侧栏支持 Ask | Agent:Ask 只生成 SQL;Agent 调用与 MCP 同源的只读工具真查库。外部编辑器可用 npx @rlwj-lab/opsxdb-mcp 接入(见应用内《AI 助手》文档)。
六种动作
| 动作 | 用途 |
|---|---|
| 生成 | 自然语言 → SQL(「查最近 7 天下单但未支付的用户」) |
| 解释 | 把一段复杂 SQL 翻译成中文说明 |
| 优化 | 分析慢查询,给出索引 / 改写建议 |
| 修复 | 报错信息 + SQL → 修正版本 |
| 方言 | MySQL ↔ PostgreSQL 等跨方言转换 |
| 样例 | 按表结构生成示例查询 |
使用方式
- 连接库后打开右侧 AI 面板;
- 选择动作,输入需求或粘贴 SQL(可附上对象树上下文);
- 生成结果一键放回编辑器,⌘/Ctrl + Enter 执行。
提示:生成的 SQL 依旧走危险语句确认流程 —— AI 产出与手写 SQL 同等对待,不放宽防护。
接入真实模型
AI 面板支持任何 OpenAI 兼容协议的服务(OpenAI / DeepSeek / 通义 / 本地 vLLM 等),回复以 SSE 流式逐字输出,等待模型时不再面对空白。
配置入口(二选一):
- AI 面板右上角「配置」:填 Base URL、API Key、模型名,保存后可一键测试;
- 配置文件
~/.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 依旧走危险语句确认流程。