OpsxDB 文档 v0.1

AI 助手

更新于 2026-09-23

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

侧栏支持 Ask | Agent:Ask 只生成 SQL;Agent 调用与 MCP 同源的只读工具真查库。外部编辑器可用 npx @rlwj-lab/opsxdb-mcp 接入(见应用内《AI 助手》文档)。

六种动作

动作 用途
生成 自然语言 → 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 依旧走危险语句确认流程。