常见问题

安装版和免安装 ZIP 版均已内嵌 JRE，无需单独安装 Java。使用 ZIP 版时请先完整解压，再从解压目录运行程序。

两个版本功能一致，均内置后端服务和 Java。安装版会创建桌面与开始菜单快捷方式；免安装 ZIP 版完整解压后即可运行，适合无管理员权限、临时使用或并行测试不同版本。ZIP 版不是完全 USB 便携模式，配置、日志和用户数据仍保存在 %USERPROFILE%\.magic-sql-ai，删除解压目录不会删除这些数据。

在「系统设置 → 隐私与安全性」中选择「仍要打开」，或在终端执行 xattr -cr /Applications/MagicDB\ Studio.app 后重试。

这是内测版尚未签名公证导致的 Gatekeeper 误报（Apple Silicon 机型常见），文件并未损坏，不要点「移到废纸篓」。在「终端」执行 sudo xattr -rd com.apple.quarantine /Applications/MagicDB\ Studio.app 后重新打开即可。

内测版暂未购买代码签名证书，被拦截属正常情况：Edge / Chrome 下载栏提示「不常见」时选择「保留」；SmartScreen 蓝色弹窗点「更多信息」→「仍要运行」。安装包无任何恶意行为，可放心使用。

Ubuntu 22.04+ 等新发行版默认不带 FUSE 运行时，先执行 sudo apt install libfuse2（Ubuntu 24.04 为 libfuse2t64），再 chmod +x 赋予执行权限后运行。

可以。驱动中心收录 34 个 JDBC 驱动模板，其中仅 4 个经过 Registry 审核的 curated 模板支持在线安装；其他模板仅支持上传自己的 .jar 驱动，按模板填写连接参数即可。详见 连接管理 · 驱动中心。

在连接中心选择「导入」，支持 Navicat .ncx 导出文件、DBeaver 与 DataGrip 的连接配置，导入后补充密码即可使用。

AI 功能需要访问你配置的模型服务（OpenAI / 通义千问 / DeepSeek 等）。API Key 仅保存在本地，使用 AES-256-GCM 加密存储，不会上传到任何第三方服务器。

连接凭据全部加密存储在本机数据目录中，加密算法为 AES-256-GCM，不会同步到云端。更多见 安全与审计。