Skip to content
项目

fj1981/dqex has 87 GitHub stars and 1 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:03 UTC. Last push 2026-10-10.

这些数字如何统计

可以做什么

  • Export - ✅ - export (exp) - Schema + data → SQL file (zip / gzip), conditional & consistent
  • Import - ✅ - import (imp) - SQL / zip file → database, auto create tables, batch inserts
  • Migrate - ✅ - migrate (mig) - Database → database, cross-dialect (e.g. MySQL → PostgreSQL)
  • Compare - ✅ - compare (cmp) - Schema & data diff between two databases

实测星标增长

24小时
0
7天
更新延迟
15天
更新延迟
1个月
更新延迟

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

AI-Native, Offline-First Database Workbench — Import/Export/Migrate/Compare/Snapshot with AI-Assisted SQL (Eino)

数据

README.zh-CN.md

原文

dqex — AI 原生数据库工作台

dqex

AI 原生 · 离线优先的数据库工作台

English · 简体中文

License: MIT Go Version Platform Databases CI

Stars Forks


🚀 一个工具,覆盖所有环境 —— 包括完全隔离的机房

dqex 是一款跨平台数据库工作台,以单个静态二进制交付 —— 没有 JVM、没有 Electron、没有安装器、不需要联网。它把导入、导出、迁移、对比、快照、Excel 数据字典、完整 SQL 终端和 AI 助手集成于一体,同时提供精美的 Web 界面与可脚本化的 CLI。

  • 🪶 零依赖 —— 拷进 U 盘,就能在银行隔离机房跑起来
  • 🏢 为受限网络而生 —— 内置离线 SQL 模板库,审计真正要的东西(Excel 数据字典、快照差异报告、可导出的执行历史)都是原生内置,不是事后补丁
  • 🤖 不会惊到你的 AI —— 先读你真实的表结构再动手,生成符合方言的 SQL,未经确认绝不执行写操作;不配置 AI,入口根本不渲染
  • 🌐 MySQL · PostgreSQL · Oracle —— 跨类型迁移自动做方言转换

AI 辅助写 SQL 演示——Agent 先探索真实表结构,再生成已验证的 SQL


⚡ 快速开始

1. 下载 —— 选你的平台,一键直达,无需编译:

平台 文件 直链
macOS (Apple Silicon) dqex-v1.8.0-darwin-arm64.zip 直接下载
macOS (Intel) dqex-v1.8.0-darwin-amd64.zip 直接下载
Linux (x86_64) dqex-v1.8.0-linux-amd64.zip 直接下载
Linux (ARM64) dqex-v1.8.0-linux-arm64.zip 直接下载
Windows (x86_64) dqex-v1.8.0-windows-amd64.zip 直接下载

需要锁定某个版本?去Releases 页面选 —— latest 永远指向 v1.8.0。

2. 解压并运行

unzip dqex-*.zip && cd dqex && ./start.sh
:: Windows —— 解压后
start.bat

3. 打开 Web 界面

http://127.0.0.1:8181

就这些 —— 加个连接,开始导出、对比或查询。数据不出你的机器。

可选:装到 PATH、后台运行、或停止服务
./install.sh                    # 安装到 /usr/local/bin(可选)
dqex# 启动 Web 界面(127.0.0.1:8181)
./start.sh -d                   # 后台守护
./stop.sh                       # 停止后台服务
install.bat                     :: 安装到 %LOCALAPPDATA%\dqex 并加入 PATH
dqex                            :: 新开终端启动 Web 界面
start.bat -d                    :: 后台运行
stop.bat                        :: 停止后台服务

✨ 功能一览

功能 Web CLI 说明
导出 ✅ export (exp) 结构 + 数据 → SQL 文件(zip / gzip),支持条件过滤与一致性快照
导入 ✅ import (imp) SQL / zip 文件 → 数据库,自动建表、批量插入
迁移 ✅ migrate (mig) 数据库 → 数据库,跨方言(如 MySQL → PostgreSQL)
对比 ✅ compare (cmp) 两个数据库的结构与数据差异
数据字典 ✅ dictionary (dict) 表结构 + 注释 → 精美 Excel(.xlsx),审计就绪
快照 ✅ snapshot (snap) 创建 / 列表 / 查看 / 删除 / 对比 全生命周期
SQL 查询 ✅ sql Web 查询终端 + 表浏览器;CLI 交互式 REPL,支持 JSON 输出
AI 辅助写 SQL ✅ sql 内 \ai 智能体查询真实表结构后生成 SQL(按目标方言),需确认
连接管理 ✅ conn (cn) 保存 / 测试 / 删除数据库连接
任务配置 ✅ task (tk) 一键复用任务配置(--task <ID>)
执行历史 ✅ history (his) 执行记录,故障排查与审计导出
Shell 补全 — completion zsh / bash 补全脚本

🤔 为什么是 dqex,而不是 DBeaver?

如果 DBeaver 在你的环境里能跑,就用 DBeaver。 它更成熟、更免费。dqex 不想在"广度"上赢——它是为DBeaver 结构上进不去的环境而生的。

dqex DBeaver Navicat DataGrip
交付形式 单静态二进制 JVM + 驱动 jar 安装器,需授权 IDE,需授权
隔离网部署 拷贝即跑 手动配 JVM + jar 授权受限 授权受限
首次查询耗时 1 分钟内 数分钟 安装 + 激活 安装 + 激活
跨方言迁移 内置,自动 无 有 部分支持
Excel 数据字典 一条命令 插件 有 无
快照差异对比 内置 无 无 无
AI 辅助写 SQL 内置,离线兜底 无 有限 有限
数据库广度 MySQL / PostgreSQL / Oracle 非常广 广 广
价格 免费,MIT 免费 按席位付费 付费

dqex 的短板: 它只支持三种数据库,不是二十种。如果你需要 SQL Server、ClickHouse、MongoDB 或 MySQL / PostgreSQL / Oracle 之外的东西,今天 DBeaver 是更好的答案。更多驱动非常欢迎作为贡献提交。

完整对比(含 Bytebase 与已知限制):docs/COMPARISON.md。


🧑‍💻 CLI 30 秒上手

# 连接只需保存一次,随处复用
dqex conn add --name 生产库 --type mysql --host 10.20.16.170 --port 3317 --un root --pw 'xxx'

# 条件导出 + gzip,带回家调试
dqex exp camunda -s 生产库 -o backup.sql.gz --table-cond "orders:created_at >= '2026-01-01'"

# 还原到本地测试库
dqex imp -t 本地测试库 -i backup.sql.gz --reset drop-and-create

# 交互式 SQL 终端(按目标库方言原生执行)
dqex sql -c 生产库
dqex sql -c 生产库 --json "SELECT id, name FROM users LIMIT 10"   # 智能体友好 JSON

# 快照对比 —— 故障排查的杀手级特性
dqex snapshot create -c 生产库 -n 基线
dqex snapshot compare -c 生产库 --a 基线 --b 部署后

# 合规审计:一条命令生成精美 Excel 数据字典
dqex dict camunda -s 生产库 -o 数据字典.xlsx

🤖 AI 辅助写 SQL(可选模块,离线安全)

  • 基于真实表结构,杜绝凭空想象 —— 生成前自动查询库表结构(Web 端实时显示查询进度)
  • 生成 ≠ 执行 —— AI 只产出 SQL 文本;写操作需二次确认、危险语句被拦截,可 \e 编辑后再执行
  • 完整辅助闭环 —— \ai continue 基于上文续写;Web 端支持生成 / 解释 / 优化 / 修复,diff 预览后一键应用到编辑器
  • 密钥不出本机 —— API Key 存本地,界面仅显示掩码后的端点与模型名
  • 未配置无入口 —— BaseURL / API Key / Model 三项齐全才启用,不影响任何既有功能
  • 离线兜底 —— 内置 SQL 模板库(\template top_n orders amount 10),完全隔离网络也能用

🛠️ 从源码构建

make dev                # Go :8181 + Vite :5281,热重载 + 调试
make build              # 单二进制 ./dqex(内嵌前端)
make release            # 跨平台打包 → release/
make install            # → /usr/local/bin

🧱 技术栈

  • 后端:Go + infrakit(数据库方言适配)、Gin、内嵌 SQLite
  • 前端:React + TypeScript + Vite + Tailwind CSS + shadcn/ui + Monaco Editor
  • Excel:excelize(纯 Go,无 CGO)
  • 交付:单静态二进制内嵌前端,支持深色模式与中英双语

📚 文档

  • CLI 使用手册 —— 每个命令、参数与元命令
  • Agent 集成指南 —— JSON 输出、脚本化与 CI 流水线(中英双语)
  • 常见问题 —— 端口占用、跨机器访问、连接保存等(中英双语)
  • 项目概览 —— 设计哲学、用户画像与深度场景
  • 竞品对比 —— 与 DBeaver、Navicat、DataGrip、Bytebase 的逐项对比
  • 离线运维指南 —— 在隔离网络中运行 dqex
  • 开发约定 —— 状态建模与数据流规范(贡献前必读)

🤝 贡献指南

开源因贡献而伟大 —— 而每一次贡献,都会让你离 star 榜更近一步!⭐

我们欢迎:

  • 🐛 Bug 修复(最高优先级)
  • 📝 文档改进(中英文皆可)
  • 🧩 新的 SQL 模板(丰富离线模板库)
  • 🗄️ 更多数据库驱动支持
  • 🎨 UI/UX 优化

贡献流程:

  1. Fork 本仓库
  2. 创建分支:git checkout -b feature/your-feature
  3. 提交更改:git commit -am 'feat: add something awesome'
  4. 推送分支:git push origin feature/your-feature
  5. 发起 Pull Request

代码规范:Go 遵循 gofmt;TypeScript 遵循 ESLint + Prettier;提交信息遵循 Conventional Commits。


📄 许可证

MIT © 2026 fj1981

给 dqex 点个 ⭐ —— 这是对我们最大的鼓励,也让更多开发者发现这个工具。Fork 它、玩它、拆它,然后给我们发个 PR!