一个基于 React 和 Node.js 的智能数据库查询助手，支持自然语言转 SQL 查询，并提供数据库表关系可视化功能。
- 🔍 自然语言转 SQL：支持使用自然语言描述来生成 SQL 查询语句
- 📊 数据库可视化：自动生成数据库表关系图，直观展示表结构
- 🤖 多模型支持：集成 Ollama，支持多种 AI 模型
- 💾 数据库连接：支持 MySQL 数据库连接和管理
- 🎨 美观的界面：基于 TailwindCSS 的现代化 UI 设计
- 📝 SQL 语法高亮：集成 Prism.js 实现代码高亮
- 📋 便捷操作：支持 SQL 复制、执行等快捷功能
- Node.js >= 16
- MySQL 数据库 8.0.40
- Ollama
- 从 Ollama官网 下载并安装
- 模型：
-
克隆项目
-
安装前端依赖
npm install- 安装后端依赖
cd server
npm install- 启动服务
# 启动前端服务
npm run build && npm run dev- 配置 HuggingFace
- 注册 HuggingFace 账号
- 在 Access Tokens 页面生成 API Token
- 将 Token 配置到 .env 文件的 HUGGINGFACE_API_TOKEN 字段
- 配置模型:
- 在 .env 文件中配置 HUGGINGFACE_MODELS 字段
- 多个模型使用逗号分隔,例如:
HUGGINGFACE_MODELS=Qwen/Qwen2.5-Coder-32B-Instruct,Qwen/Qwen2.5-72B-Instruct
- 配置代理（可选）
- 如果需要使用代理访问 HuggingFace API，可以在 .env 文件中配置代理设置:
# 代理设置 PROXY_HOST=127.0.0.1 # 代理服务器地址 PROXY_PORT=7890 # 代理服务器端口 PROXY_PROTOCOL=http # 代理协议(http/https) PROXY_ENABLED=true # 是否启用代理 HTTPS_PROXY=http://127.0.0.1:7890 # HTTPS 代理地址 - 常见代理软件端口:
- Clash: 7890
- V2Ray: 10809
- Shadowsocks: 1080
- 如果需要使用代理访问 HuggingFace API，可以在 .env 文件中配置代理设置:
-
连接数据库
- 点击右上角数据库图标
- 输入数据库连接信息
- 选择要操作的数据库
-
查看数据库结构
- 连接成功后，点击"生成数据库关系图"按钮
- 可以通过拖拽、缩放来调整视图
-
使用自然语言查询
- 在输入框中输入自然语言描述
- 选择合适的 AI 模型
- 系统会自动生成并显示对应的 SQL 语句
-
执行查询
- 点击生成的 SQL 语句旁的执行按钮
- 查看查询结果
- React 18
- TypeScript
- Vite
- TailwindCSS
- React Markdown
- Prism.js
- Redux (状态管理)
- Axios (HTTP 请求)
- D3.js (数据可视化)
- Socket.io-client (WebSocket 客户端)
- Node.js
- Express
- MySQL2
- Sequelize (ORM)
- WebSocket (Socket.io)
- HuggingFace API (AI 模型集成)
- IndexedDB (本地数据存储)
- Jest (单元测试)
- Swagger/OpenAPI (API 文档)
- 0.1.0 (2024-10)
- 初始版本发布
- 支持基本的数据库连接和查询功能
- 实现数据库表关系可视化
- 集成 Ollama AI 模型
- 0.2.0 (2024-11)
- 支持 HuggingFace API
- 支持多模型
- 支持代理
- 0.3.0 (2024-12)
- 增加sql 查询结果可视化
- 增加可视化图表下载
- 修复 bug
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情