SQL Pilot 是一个面向业务 / 分析人员的 NL2SQL 数据分析智能体。用户用中文提问（例如"上个月各品类销售额Top10"），系统自动完成：语义理解 → 生成逻辑查询计划（LQP）→ 编译为目标数据库方言 SQL → 只读执行 → 自动选图 → 生成洞察 → 输出结构化分析报告。
相比"让模型直接写方言 SQL"的粗暴做法，SQL Pilot 引入 LQP 中间表示 + 确定性方言编译器，把"生成正确 SQL"拆成"模型只生成与方言无关的逻辑计划，编译器负责落方言"，显著降低模型出错率，并天然支持跨方言 transpile。
💬 对话式问数：多轮会话，支持澄清反问、下钻、上卷、同比/环比/目标对比。
🧠 多模型接入：仅 OpenAI 兼容协议，预设 DeepSeek / Kimi / 通义 / 智谱 / 混元 / OpenAI / 硅基流动 / Ollama，可开启多模型投票。
🔀 LQP 中间表示：模型只产出 Logic Query Plan JSON，由后端确定性编译为各方言 SQL，避免方言幻觉。
🗄️ 多数据源：9 种方言全部真执行（MySQL / PostgreSQL / SQLite(sql.js) / ClickHouse / Trino / Oracle / BigQuery / Snowflake / DuckDB），执行通道按方言运行时自动探测。
🛡️ 五重安全防护：输入过滤 → 元数据隔离（只传 DDL）→ LLM 仅见元数据 → SQL 只读守卫 → 输出脱敏。
📊 智能图表：规则引擎按结果形态自动推荐 KPI / 折线 / 柱状 / 饼 / 散点。
🔍 Schema RAG + Few-shot：检索相关表结构并注入示例，提升生成准确率。
🛠️ SQL 纠错闭环：执行失败自动走"EXPLAIN 预检 → 报错诊断 → 自动改写"修复链路。
📐 指标三级体系：原子 / 派生 / 复合指标，支持口径版本管理（version）。
📄 数据分析报告：一键生成 Markdown 报告（LLM 撰写 + 本地兜底），支持服务端纯 JS 生成 PDF / 打印 / 复制 Markdown。
🔐 数据权限：表级（allowedTables）/ 列级（deniedColumns）细粒度控制。
🌗 主题切换：深色 / 浅色双主题，设置即生效并持久化。
🏢 企业治理：指标市场（口径版本 / 审批）、语料沉淀、审批中心、BI 网关，支持团队协作与指标复用。
技术架构
┌─────────────────────────────┐
│ 前端 (React + Vite) │ HashRouter（兼容 Electron 直接打开）
│ ChatPage / DataSource / ... │ Monaco + ECharts + react-markdown + TDesign
└──────────────┬──────────────┘
│ REST + SSE(/api/chat)
┌──────────────▼──────────────┐
│ 后端 (Express + tsx) │ 对话管线 / NL2SQL / 编译器 / 安全守卫
│ LQP → 方言编译器 / 纠错闭环 │ Schema RAG / 多模型投票 / 报告生成
└──────────────┬──────────────┘
┌───────┼───────────────────────┐
SQLite MySQL PostgreSQL ClickHouse / Trino (HTTP)
(sql.js) (mysql2) (pg) Oracle / BigQuery / Snowflake / DuckDB（真执行）
存储：刻意放弃 better-sqlite3（Windows/Electron 需 node-gyp 重编译），改用 JSON 文件 + 内存缓存 + 防抖原子落盘，零原生依赖。
评论