logan
40b9bdcc8c
- 落地页下载卡「Tauri 2」价格位改「原生桌面」；sidecar/Go 二进制/monorepo 脚手架等内部表述改用户语言 - 文档删「打印/导出 PDF」与「是否有帮助」摆设组件及未使用图标 - MCP 页 H1 与页面标题去重（npm 安装命令为用户操作步骤，保留） - homepage dist 同步重建
40 lines
1.9 KiB
Markdown
40 lines
1.9 KiB
Markdown
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 依旧走危险语句确认流程。
|