共计 1308 个字符，预计需要花费 4 分钟才能阅读完成。
📌 项目描述
Text2SQL_Assistant 是一款面向开发者和数据分析人员的效率工具。你只需用自然语言描述数据查询需求（例如 “查询销售额大于 1000 的客户名称和订单总额”），工具就会调用 AI 大模型自动生成对应的 SQL 语句，并可在你配置的数据库上执行，结果以表格 + 分页形式清晰展示。
主要特性
- 智能生成 SQL：对接阿里百炼、豆包、DeepSeek、千问、OpenAI 等主流 AI 引擎，将自然语言转为准确 SQL。
- 多数据库支持：内置 MySQL、PostgreSQL、Oracle、SQL Server、OpenGauss、达梦（DM）、人大金仓（KingbaseES）、南大通用（GBase）、神通（ShenTong）等，并可自定义扩展。
- 可视化执行：查询结果自动分页显示，插入 / 更新 / 删除等操作返回受影响行数，类似 DBeaver 的交互体验。
- 配置持久化：数据源和 AI 配置保存至 config.json，下次启动自动加载。
- 现代化界面：无边框标题栏、圆角卡片、柔和配色，操作反馈采用 Toast 通知。
🚀 使用说明 第一步：配置 AI（菜单“AI 配置”）
- 选择 AI 厂商（如 OpenAI、千问、DeepSeek 等）。
- 填写 API 地址（通常自动填充）、API Key 和模型名称（可留空使用默认模型）。
- 点击“测试调用”验证配置是否正确，成功后点击“保存配置”。
第二步：配置数据源（菜单“数据源配置”）
- 点击“新建”，选择数据库类型（MySQL / PostgreSQL / Oracle / 达梦 / 金仓等）。
- 填写主机、端口、数据库名、用户名、密码等信息。
- 点击“测试连接”确认可以连通，然后点击“保存当前”。
第三步：开始使用（菜单“Text2SQL”）
- 在顶部下拉框中选择一个已配置的数据源。
- 在“自然语言描述”输入框中用中文描述你的查询需求。
- 点击“生成 SQL”，稍等片刻，生成的 SQL 会出现在中间编辑区（支持手动修改）。
- 点击“执行 SQL”，结果将在下方区域展示：
- 查询语句（SELECT）：以表格形式展示，支持分页浏览。
- 非查询语句（INSERT/UPDATE/DELETE/DDL）：显示执行状态和影响行数。
若未配置数据源，“执行 SQL”按钮将处于禁用状态，并提示用户先完成配置。
[td]
📦 软件获取 |
无需安装 Python 环境，下载即用！
前往 Releases 页面 下载对应操作系统的打包文件：
前往 Releases 页面 下载对应操作系统的打包文件：
[td]
| 平台 | 下载文件 | 使用方式 |
| Windows x64 | Text2SQL_Assistant-windows-x86_64.zip | 解压后双击 Text2SQL_Assistant.exe |
| macOS (Apple Silicon) | Text2SQL_Assistant-macos-arm64.zip | 解压后双击应用；若遇安全拦截，右键 → 打开 → 允许 |
| Linux x64 | Text2SQL_Assistant-linux-x86_64.tar.gz | 解压后 chmod +x Text2SQL_Assistant 并运行 |
若你需要 Intel Mac 或其他架构版本，或想自行编译，请参考源码仓库说明。
🔗 源码地址
项目开源托管于 GitHub：
https://github.com/vfaner/Text2SQL_Assistant
https://github.com/vfaner/Text2SQL_Assistant
正文完
