沐问 MuAsk
常见问题
下载、安装、使用中的疑问，先看这里
沐问免费吗？开源吗？
完全免费，基于 MIT 协议开源 —— 源代码托管在 GitHub，Gitee 有国内镜像，个人和商业场景均可自由使用。
支持哪些操作系统？需要装 Python 吗？
提供 Windows x64、macOS（Apple Silicon）、Linux x86_64 三个平台的安装包。运行环境（Python、PySide6、全部数据库驱动）都已打包在内，无需安装 Python，双击即用。
Windows 提示「Windows 已保护你的电脑」怎么办？
exe 未做商业代码签名，SmartScreen 首次运行会拦截，属正常现象：
- 弹窗中点左下角「更多信息」，再点「仍要运行」；
- 也可以右键下载好的 exe →「属性」→ 勾选「解除锁定」。
macOS 提示「无法验证开发者」怎么办？
应用未经 Apple 公证，首次打开需手动放行一次：
- 把
muask.app拖入「应用程序」后打开，弹窗点「完成」； - 进入「系统设置 → 隐私与安全性」，点被拦应用旁的「仍要打开」；
- 也可用命令一步放行：
xattr -dr com.apple.quarantine /Applications/muask.app
一定要花钱买 API Key 吗？
不一定。AI 配置里可以选择 Ollama（本地）：在本机运行开源模型，免费、免 API Key。云端厂商（DeepSeek、千问、Kimi 等）也有不同价位，按自己的需求选择即可。
AI 生成的 SQL 安全吗？会不会执行错？
SQL 在执行前会完整展示并可以手动编辑，确认无误后才运行；数据库返回的错误信息也会原样显示，方便修改后重试。
建议给沐问使用只读数据库账号，从数据库权限层面兜底，避免误操作影响生产数据。
我的表结构和查询数据会被上传吗？
生成 SQL 时，表结构与你的问题会发送给所选的 AI 厂商；数据库连接信息、查询结果始终只留在本机。对数据隐私敏感的场景，请选择本地 Ollama 模型，整个过程无需连接外网。
Linux 启动报 could not load the Qt platform plugin "xcb"？
缺少 Qt 依赖的 X11 库，Ubuntu / Debian 执行：
sudo apt-get install -y libgl1 libegl1 libxkbcommon-x11-0 libxcb-cursor0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxcb-xinerama0 libdbus-1-3