共计 1867 个字符，预计需要花费 5 分钟才能阅读完成。
一、开发背景
在真实的业务研发与数据运维场景中，数据库查询往往面临极高的门槛。刚入职的新人接手成熟项目时，面对几百上千张数据表却缺乏详细的数据字典，想写一个业务查询都无从下手；项目迭代多年后，表与表之间的关联关系、字段的真实含义散落在代码注释和老员工的记忆里，开发、测试、运维想理清一个业务的数据口径，往往需要翻看大量代码或反复询问他人；即使是临时查个数这种简单需求，也往往需要提需求、等排期，一句 SQL 就能解决的事却要耗费大量沟通成本。
这些痛点的核心在于：传统 SQL 查询要求使用者同时具备数据库表结构知识和 SQL 编写能力，而业务人员往往只具备前者甚至只具备“我想查什么”的业务视角。沐问 MuAsk 正是为解决这一矛盾而生——连上数据库后，工具自动读取真实的表结构、字段注释和主外键关系，用户只需用中文说出想查什么，AI 就会在真实的表结构上下文中生成可执行的 SQL 并直接返回结果——不用找表、不用问人、不用手写 SQL，让新人也能立刻上手查数据。
二、项目介绍
沐问 MuAsk 是一款开源免费的桌面 Text2SQL 工具，基于 PySide6 构建，采用 MIT 协议开源。它将自然语言描述转换为 SQL 语句，在数据库执行后直接展示结果，支持主流数据库和信创数据库，兼容多个主流 AI 大模型。
项目当前版本为 v1.4.0，核心能力包括：
- 读懂真实表结构：基于实际库表、字段和注释生成 SQL，不靠猜测，确保答案对应真实业务数据。
- 生成即可执行：SQL 一键运行，结果以表格形式分页展示，页码和每页条数可自由调整。
- 多数据源管理：一个客户端集中管理开发、测试、生产多套环境连接，支持连通测试和随时切换。
- 模型自由选择：内置 14 类厂商预设，云端本地均可使用；支持 Ollama 本地推理，免 Key、数据不外传。
- 三平台原生桌面：Windows / macOS / Linux 各一个安装包，双击即用，无需安装 Python 和任何依赖。
- 自动版本更新：启动后自动检查 GitHub / Gitee 新版本。
在数据库兼容性方面，沐问内置了 14 种数据库驱动，覆盖 MySQL、MariaDB、PostgreSQL、Oracle、SQL Server、DB2 等主流数据库，并对国产信创数据库提供一等支持，包括 OpenGauss、瀚高 HighGo、海量 Vastbase、人大金仓 KingbaseES、达梦 DM、GBase 8a、OceanBase、TiDB 等。
三、技术栈
[td]
层面 | 技术选型 |
| 桌面应用框架 | PySide6（Qt for Python） |
| 应用类型 | 跨平台桌面应用（Windows / macOS / Linux） |
| 开源协议 | MIT |
| 核心能力 | Text2SQL（自然语言转 SQL） |
| 数据库驱动 | 14 种内置驱动，覆盖主流库与信创库 |
| AI 模型集成 | 14 类大模型预设，支持 DeepSeek、千问、Kimi、Claude 等；支持 Ollama 本地部署 |
| 分发方式 | 各平台原生安装包，无需 Python 环境 |
四、源码地址
[td]
平台 | 地址 |
| GitHub | https://github.com/vfaner/muask |
| Gitee（国内镜像） | https://gitee.com/super_rgh/muask |
五、部署文档 5.1 直接下载可执行文件（推荐）
沐问提供各平台预编译安装包，无需 Python 环境，不依赖任何库：
[td]
平台 | 下载文件 | 使用方式 |
| Windows x64 | muask-windows-x86_64.exe | 单文件，下载后直接双击运行。首次会被 SmartScreen 拦截一次 |
| macOS（Apple Silicon） | muask-macos-arm64.dmg | 挂载 → 拖到「应用程序」→ 双击。首次需放行一次 |
| Linux x64 | muask-linux-x86_64.tar.gz | tar -xzvf …tar.gz → chmod +x muask → ./muask |
5.2 快速配置三步走
第一步：AI 配置
下拉选择厂商、填入 API Key，多套配置随时切换。支持 DeepSeek、千问、Kimi、Claude 等 14 类预设。敏感数据场景可选本地 Ollama，免 Key、数据不出内网。
下拉选择厂商、填入 API Key，多套配置随时切换。支持 DeepSeek、千问、Kimi、Claude 等 14 类预设。敏感数据场景可选本地 Ollama，免 Key、数据不出内网。
第二步：数据源配置
填好连接信息、测试通过即可，驱动不用自己找。14 种数据库驱动全部内置，支持连接参数与自定义类型。
填好连接信息、测试通过即可，驱动不用自己找。14 种数据库驱动全部内置，支持连接参数与自定义类型。
第三步：开口问
在沐问页输入中文问题，生成 SQL 后一键执行。SQL 可检查、可编辑，结果分页展示，每页条数可调。
在沐问页输入中文问题，生成 SQL 后一键执行。SQL 可检查、可编辑，结果分页展示，每页条数可调。
正文完
