# sqlkit

**Repository Path**: devai/sqlkit

## Basic Information

- **Project Name**: sqlkit
- **Description**: Tauri（Rust）原生跨平台 AI 智能体数据库 GUI 客户端，开源 Apache-2.0，对标 DBeaver、DataGrip、Navicat。核心差异化：内置原生 AI SQL 智能体、无 Java/JRE/Chromium 臃肿依赖、一站式兼容 70 + 主流 / 国产 / 云数据库，主打轻量原生性能、本地隐私优先，完全免费无付费功能限制。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Rust, tool

## README

<div align="center">

<img src="app-icon.png" width="120" alt="SqlKit Logo"/>

# SqlKit

**Agentic 跨平台 SQL 数据库 GUI 客户端 —— 你的数据库代理，支持 70+ 种数据库。**

**隐私优先。你的数据，你的密钥。开源。**

[![Release](https://img.shields.io/github/v/release/geek-fun/sqlkit?color=orange&label=release&logo=github)](https://github.com/geek-fun/sqlkit/releases)
[![Downloads](https://img.shields.io/github/downloads/geek-fun/sqlkit/total?color=orange&logo=docusign)](https://github.com/geek-fun/sqlkit/releases)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?logo=apache)](LICENSE)
[![Stars](https://img.shields.io/github/stars/geek-fun/sqlkit?logo=github)](https://github.com/geek-fun/sqlkit/stargazers)
[![CI](https://github.com/geek-fun/sqlkit/actions/workflows/node.yml/badge.svg)](https://github.com/geek-fun/sqlkit/actions/workflows/node.yml)

<p>
  <img src="https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=white"/>
  <img src="https://img.shields.io/badge/Windows-0078D6?logo=windows&logoColor=white"/>
  <img src="https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black"/>
  <img src="https://img.shields.io/badge/Tauri-FFC131?logo=tauri&logoColor=black"/>
  <img src="https://img.shields.io/badge/Rust-000000?logo=rust&logoColor=white"/>
</p>

[下载](https://www.geekfun.club/download) · [文档](docs/DISTRIBUTION.md) · [网站](https://www.geekfun.club) · [发布页](https://github.com/geek-fun/sqlkit/releases)

[English](README.md) · 简体中文

</div>

---

SqlKit 是一个 **Agentic 数据库客户端** —— 它不仅执行 SQL，还能理解你的数据库并替你操作。用自然语言描述你的需求，Agent 就会帮你写查询、检查 Schema、优化 SQL 并返回结果。基于 Tauri（Rust）构建，非 Electron，取代 DBeaver、Navicat、DataGrip 等臃肿客户端。

<p align="center">
  <img src="docs/images/sqlkit-client-ui.png" width="800" alt="SqlKit 客户端界面"/>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/PostgreSQL-4169E1?logo=postgresql&logoColor=white" />
  <img src="https://img.shields.io/badge/MySQL-4479A1?logo=mysql&logoColor=white" />
  <img src="https://img.shields.io/badge/Oracle-F80000?logo=oracle&logoColor=white" />
  <img src="https://img.shields.io/badge/SQL%20Server-CC2927?logo=microsoftsqlserver&logoColor=white" />
  <img src="https://img.shields.io/badge/SQLite-003B57?logo=sqlite&logoColor=white" />
  <img src="https://img.shields.io/badge/DuckDB-FFF000?logo=duckdb&logoColor=black" />
  <img src="https://img.shields.io/badge/ClickHouse-FFCC01?logo=clickhouse&logoColor=black" />
  <img src="https://img.shields.io/badge/Firebird-E5402B?logo=firebird&logoColor=white" />
  <br/>
  <img src="https://img.shields.io/badge/MariaDB-003545?logo=mariadb&logoColor=white" />
  <img src="https://img.shields.io/badge/CockroachDB-6933FF?logo=cockroachlabs&logoColor=white" />
  <img src="https://img.shields.io/badge/Snowflake-29B5E8?logo=snowflake&logoColor=white" />
  <img src="https://img.shields.io/badge/DB2-052FAD?logo=ibm&logoColor=white" />
  <img src="https://img.shields.io/badge/H2-004080?logoColor=white" />
  <img src="https://img.shields.io/badge/Trino-DD00A1?logo=trino&logoColor=white" />
  <img src="https://img.shields.io/badge/Redshift-8C4FFF?logo=amazonredshift&logoColor=white" />
  <img src="https://img.shields.io/badge/Teradata-F37440?logo=teradata&logoColor=white" />
  <br/>
  <img src="https://img.shields.io/badge/TiDB-DC150B?logo=tidb&logoColor=white" />
  <img src="https://img.shields.io/badge/OceanBase-006AFF?logoColor=white" />
  <img src="https://img.shields.io/badge/OpenGauss-0052CC?logoColor=white" />
  <img src="https://img.shields.io/badge/Doris-0052CC?logoColor=white" />
  <img src="https://img.shields.io/badge/StarRocks-5C2D91?logoColor=white" />
  <img src="https://img.shields.io/badge/TimescaleDB-F2F2F2?logo=timescale&logoColor=black" />
  <img src="https://img.shields.io/badge/Hive-FDEE21?logo=apachehive&logoColor=black" />
  <img src="https://img.shields.io/badge/Databricks-FF3621?logo=databricks&logoColor=white" />
  <img src="https://img.shields.io/badge/BigQuery-669DF6?logo=googlebigquery&logoColor=white" />
  <img src="https://img.shields.io/badge/and%20more...-555555?logoColor=white" />
</p>

## 安装

<a href="https://www.geekfun.club/download">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/badge/Download-macOS_|_Windows_|_Linux-orange?logo=download&logoColor=white">
    <img src="https://img.shields.io/badge/Download-macOS_|_Windows_|_Linux-orange?logo=download&logoColor=white" alt="下载">
  </picture>
</a>
&nbsp;
<a href="https://github.com/geek-fun/sqlkit/releases">
  <img src="https://img.shields.io/badge/Releases-GitHub-lightgrey?logo=github" alt="Releases">
</a>
&nbsp;
<a href="https://www.geekfun.club/products/sqlkit/">
  <img src="https://img.shields.io/badge/官网-geekfun.club-blue?logo=google-chrome&logoColor=white" alt="官网">
</a>

## 功能特性

### Agentic 数据工作室

用自然语言描述需求 —— Agent 读取你的数据库 Schema，编写查询，优化慢 SQL，可视化执行计划，并自动修复错误。支持 OpenAI、Anthropic、DeepSeek 和 Ollama。自带密钥。

- **AI 查询生成** — 自然语言转 SQL，感知 Schema 上下文
- **SQL 优化** — 重写慢查询，可视化执行计划
- **错误修复** — Agent 自动诊断并修复 SQL 错误
- **安全机制** — 破坏性操作需确认；凭据不暴露给 LLM

### 轻量级原生性能

基于 Rust + Tauri v2 构建 —— 无 Electron 臃肿，无需 JRE，无捆绑 Chromium。原生性能，体积小巧，一个安装包即可在 macOS、Windows、Linux 上运行。别人需要 Java 运行时或 JetBrains 授权才能做的事，SqlKit 一个下载就搞定。

### 所有数据库，一个应用

SqlKit 支持 **70+ 种数据库**，通过四种适配策略覆盖：

| 策略 | 数据库 |
|------|--------|
| **原生** (Rust) | PostgreSQL、MySQL、SQL Server、SQLite |
| **PG 协议兼容** | CockroachDB、Redshift、YugabyteDB、TimescaleDB、QuestDB、Vastbase、YashanDB、KingbaseES、GaussDB、HighGo、UXDB、OpenGauss、GBase8c、Greenplum、EnterpriseDB、CrateDB、Materialize、AlloyDB、CloudSQLPG、FujitsuPG |
| **MySQL 协议兼容** | MariaDB、TiDB、OceanBase、TDSQL、PolarDB、Doris、SelectDB、StarRocks、Databend、GoldenDB、ManticoreSearch、SingleStore、CloudSQLMySQL |
| **JDBC 桥接** | Oracle、DuckDB、Firebird、DB2、H2、Snowflake、TDengine、Derby、Hive、Databricks、Hana、Teradata、Vertica、Exasol、BigQuery、Informix、Kylin、Cassandra、Iris、Access、Dameng、XuguDB、GBase8a |
| **HTTP 桥接** | ClickHouse、Trino、Presto、RQLite、Turso |

### 专业级编辑器

基于 Monaco（VS Code 引擎）的全功能 SQL 编辑器，支持语法高亮、自动补全和多标签页。可视化浏览数据库结构、查看 DDL、跨库搜索对象。

- **Monaco 编辑器** — VS Code 级别的 SQL 编辑体验
- **多标签页** — 同时处理多个查询
- **Schema 浏览器** — 数据库、Schema、表、列、索引的树形结构浏览
- **查询历史** — 自动保存、可搜索、可回放
- **结果表格** — 分页、排序、行内编辑，支持 CSV/JSON/Markdown 导出
- **DDL 查看器** — 查看任意对象的 CREATE 语句
- **对象搜索** — 跨 Schema 快速查找表、视图和存储过程

### 大规模数据传输

在任何支持的引擎之间移动数据 —— PostgreSQL 到 ClickHouse、Oracle 到 SQL Server、MySQL 到 BigQuery。无需中间文件。

- **跨引擎传输** — 不同类型数据库之间迁移数据，自动映射数据类型
- **导入 / 导出** — CSV、JSON、JSONL 格式
- **批量操作** — 处理数百万条记录

### 安全与连接

- **SSH 隧道** — 支持密钥和密码认证的安全连接
- **加密存储** — 凭据经系统密钥链加密（macOS Keychain、Windows Credential Manager、Linux Secret Service）
- **SSL/TLS** — 支持数据库加密连接
- **自动重连** — 弹性连接管理

### 跨平台

- **macOS**（Apple Silicon 和 Intel）— 原生 `.dmg` 安装包
- **Windows** — `.exe` 安装包
- **Linux** — `.AppImage` 和 `.deb` 安装包

## 开发

### 环境要求

- [Node.js](https://nodejs.org/) >= 18
- [Rust 工具链](https://www.rust-lang.org/tools/install)

**Linux (Ubuntu/Debian):**

```bash
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libssl-dev
```

**macOS:**

```bash
xcode-select --install
```

**Windows:** 安装 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)

### 快速开始

```bash
npm install
npm run tauri dev
```

### 脚本

| 命令 | 说明 |
|------|------|
| `npm run dev` | 启动 Vite 开发服务器 |
| `npm run build` | 构建前端生产版本 |
| `npm run lint:check` | 运行 ESLint 检查 |
| `npm run lint:fix` | 自动修复 lint 问题 |
| `npm test` | 运行前端测试 |
| `npm run tauri dev` | 启动 Tauri 开发模式 |
| `npm run tauri build` | 构建 Tauri 应用 |

### 构建说明

详细构建要求请参考 [BUILD.md](BUILD.md)。

## 技术栈

| 层 | 技术 |
|----|------|
| 框架 | [Tauri v2](https://tauri.app/) (Rust) |
| 前端 | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
| UI | [shadcn-vue](https://www.shadcn-vue.com/) + [UnoCSS](https://unocss.dev/) |
| 编辑器 | [Monaco Editor](https://microsoft.github.io/monaco-editor/) |
| 数据库 | [sqlx](https://github.com/launchbadge/sqlx) + 各引擎驱动 |

## 常见问题

<details>
<summary><strong>SqlKit 是免费的吗？</strong></summary>
是的。SqlKit 采用 Apache 2.0 许可证开源，所有功能免费使用。
</details>

<details>
<summary><strong>SqlKit 会上传用户数据吗？</strong></summary>
不会。SqlKit 不收集任何遥测数据。自动更新功能会检查 GitHub 上的新版本 —— 你可以在设置中关闭。你的凭据和查询记录始终留在本地。
</details>

<details>
<summary><strong>SqlKit 可以在离线环境下使用吗？</strong></summary>
可以。桌面应用完全离线可用。AI 功能需要网络访问模型端点（或通过 Ollama 使用本地模型）。
</details>

<details>
<summary><strong>SqlKit 和 DBeaver、TablePlus、DataGrip 有什么不同？</strong></summary>
SqlKit 是基于 Tauri（Rust）的原生应用 —— 无需 Java 运行时，没有 Electron 的开销。AI 功能内建而非插件形式，支持 70+ 数据库，一套二进制文件即可在 macOS、Windows 和 Linux 上运行。隐私优先，凭据经本地加密存储。
</details>

<details>
<summary><strong>SqlKit 支持哪些数据库？</strong></summary>
PostgreSQL、MySQL、Oracle、SQL Server、SQLite、DuckDB、ClickHouse、Firebird、MariaDB、CockroachDB、Redis、TiDB、OceanBase、Snowflake、DB2、H2、Trino 等 20+ 种。完整列表请参见<a href="#多数据库支持">多数据库支持</a>章节。
</details>

<details>
<summary><strong>如何报告 Bug 或请求新功能？</strong></summary>
请在 <a href="https://github.com/geek-fun/sqlkit/issues">GitHub Issues</a> 提交。
</details>

## 社区

<p align="center">
  <img src="https://www.geekfun.club/wechat-group.jpg" width="140" alt="微信群">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  <img src="docs/images/wechat_official.png" width="300" alt="微信公众号">
</p>

<p align="center">
  <a href="https://discord.gg/5NSUyPK2E"><img src="https://img.shields.io/badge/Discord-加入-5865F2?logo=discord&logoColor=white" alt="Discord" /></a>
  &nbsp;&nbsp;&nbsp;
  <a href="https://x.com/geekfun_club"><img src="https://img.shields.io/badge/X-关注-000000?logo=x&logoColor=white" alt="X / Twitter" /></a>
  &nbsp;&nbsp;&nbsp;
  <a href="https://www.youtube.com/@geekfun-club"><img src="https://img.shields.io/badge/YouTube-订阅-FF0000?logo=youtube&logoColor=white" alt="YouTube" /></a>
  &nbsp;&nbsp;&nbsp;
  <a href="https://github.com/geek-fun"><img src="https://img.shields.io/badge/GitHub-关注-181717?logo=github&logoColor=white" alt="GitHub" /></a>
</p>

## 赞助

<p align="center">
  <img src="docs/images/wechat_ponsor.jpg" width="140" alt="微信赞赏码">
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
  <a href="https://github.com/sponsors/geek-fun"><img src="https://img.shields.io/badge/GitHub_Sponsors-%E2%9D%A4_支持-EA4AAA?logo=githubsponsors&logoColor=white" alt="GitHub Sponsors" /></a>
</p>

## Star 历史

<a href="https://www.star-history.com/?repos=geek-fun%2Fsqlkit&type=date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=geek-fun/sqlkit&type=date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=geek-fun/sqlkit&type=date" />
    <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=geek-fun/sqlkit&type=date" />
  </picture>
</a>

## 许可证

[Apache 2.0](LICENSE) © GEEKFUN