mirror of
https://github.com/Syngnat/GoNavi.git
synced 2026-05-12 05:19:40 +08:00
087578693e
- 引入 TDengine 数据源能力并补齐运行时配置与标识符处理 - 侧栏对 schema.table 数据源统一展示短表名 - 表节点悬停显示完整 schema.table，降低重名识别成本 - 更新文档与验证用例，保证改动可追踪可回归
164 lines
6.8 KiB
Markdown
164 lines
6.8 KiB
Markdown
# GoNavi - 现代化的轻量级数据库管理工具
|
||
|
||
[](https://go.dev/)
|
||
[](https://wails.io)
|
||
[](https://reactjs.org/)
|
||
[](LICENSE)
|
||
[](https://github.com/Syngnat/GoNavi/actions)
|
||
|
||
**GoNavi** 是一款基于 **Wails (Go)** 和 **React** 构建的现代化、高性能、跨平台数据库管理客户端。它旨在提供如原生应用般流畅的用户体验，同时保持极低的资源占用。
|
||
|
||
相比于 Electron 应用，GoNavi 的体积更小（~10MB），启动速度更快，内存占用更低。
|
||
|
||
<h2 align="center">📸 项目截图</h2>
|
||
|
||
<div align="center">
|
||
<img width="25%" alt="image" src="https://github.com/user-attachments/assets/341cda98-79a5-4198-90f3-1335131ccde0" />
|
||
<img width="25%" alt="image" src="https://github.com/user-attachments/assets/224a74e7-65df-4aef-9710-d8e82e3a70c1" />
|
||
<img width="25%" alt="image" src="https://github.com/user-attachments/assets/ec522145-5ceb-4481-ae46-a9251c89bdfc" />
|
||
<br />
|
||
<img width="25%" alt="image" src="https://github.com/user-attachments/assets/330ce49b-45f1-4919-ae14-75f7d47e5f73" />
|
||
<img width="14%" alt="image" src="https://github.com/user-attachments/assets/d15fa9e9-5486-423b-a0e9-53b467e45432" />
|
||
<img width="25%" alt="image" src="https://github.com/user-attachments/assets/f0c57590-d987-4ecf-89b2-64efad60b6d7" />
|
||
</div>
|
||
|
||
---
|
||
|
||
## ✨ 核心特性
|
||
|
||
### 🚀 极致性能
|
||
- **零卡顿交互**：采用独创的 "幽灵拖拽" (Ghost Resizing) 技术，在包含数万行数据的表格中调整列宽，依然保持 60fps+ 的丝滑体验。
|
||
- **虚拟滚动**：轻松处理海量数据展示，拒绝卡顿。
|
||
|
||
### 🔌 多数据库支持
|
||
- **MySQL**：完整支持，涵盖数据编辑、结构管理与导入导出。
|
||
- **PostgreSQL**：数据查看与编辑支持，事务提交能力持续完善。
|
||
- **SQLite**：本地文件数据库支持。
|
||
- **Oracle**：基础数据访问与编辑支持。
|
||
- **Dameng（达梦）**：基础数据访问与编辑支持。
|
||
- **Kingbase（人大金仓）**：基础数据访问与编辑支持。
|
||
- **TDengine**：时序数据库连接、库表浏览与 SQL 查询支持。
|
||
- **Redis**：Key/Value 浏览、命令执行、视图与编码切换。
|
||
- **自定义驱动**：支持配置 Driver/DSN 接入更多数据源。
|
||
- **SSH 隧道**：内置 SSH 隧道支持，安全连接内网数据库。
|
||
|
||
### 📊 强大的数据管理 (DataGrid)
|
||
- **所见即所得编辑**：直接在表格中双击单元格修改数据。
|
||
- **批量事务操作**：支持批量新增、修改、删除，一键提交或回滚事务。
|
||
- **大字段编辑**：双击大字段自动打开弹窗编辑器，避免卡顿。
|
||
- **右键上下文菜单**：快速设置 NULL、复制/导出等操作。
|
||
- **智能上下文**：自动识别单表查询，解锁编辑功能；复杂查询自动切换为只读模式。
|
||
- **批量导出/备份**：支持表与数据库的批量导出/备份。
|
||
- **数据导出**：支持 CSV、Excel (XLSX)、JSON、Markdown 等格式。
|
||
|
||
### 🧰 批量导出/备份
|
||
- **数据库批量导出**：支持结构导出与结构+数据备份。
|
||
- **表批量导出**：支持多表一键导出/备份。
|
||
- **智能上下文检测**：自动判断目标范围，避免误操作。
|
||
|
||
### 🧩 Redis 视图与编码
|
||
- **视图模式切换**：自动/原始文本/UTF-8/十六进制多模式显示。
|
||
- **智能解码**：针对二进制值进行 UTF-8 质量判定与中文字符识别。
|
||
- **命令执行**：内置命令面板快速操作。
|
||
|
||
### 🔄 数据同步与导入导出
|
||
- **连接配置导入/导出**：支持配置 JSON 导入导出，便于团队共享。
|
||
- **数据同步**：内置数据同步面板，支持跨库同步任务配置。
|
||
|
||
### 🆙 在线更新
|
||
- **自动更新**：启动/定时/手动检查更新，自动下载并提示重启完成更新。
|
||
|
||
### 🧾 可观测性
|
||
- **SQL 执行日志**：实时查看 SQL 与执行耗时，便于排障与优化。
|
||
|
||
### 📝 智能 SQL 编辑器
|
||
- **Monaco Editor 内核**：集成 VS Code 同款编辑器，体验极佳。
|
||
- **智能补全**：自动感知当前连接上下文，提供数据库、表名、字段名的实时补全。
|
||
- **多标签页**：支持多窗口并行操作，像浏览器一样管理你的查询会话。
|
||
|
||
### 🎨 现代化 UI
|
||
- **Ant Design 5**：企业级 UI 设计语言。
|
||
- **暗黑模式**：内置深色/浅色主题切换，适应不同光照环境。
|
||
- **响应式布局**：灵活的侧边栏与布局调整。
|
||
|
||
---
|
||
|
||
## 🛠️ 技术栈
|
||
|
||
* **后端 (Backend)**: Go 1.24 + Wails v2
|
||
* **前端 (Frontend)**: React 18 + TypeScript + Vite
|
||
* **UI 框架**: Ant Design 5
|
||
* **状态管理**: Zustand
|
||
* **编辑器**: Monaco Editor
|
||
|
||
---
|
||
|
||
## 📦 安装与运行
|
||
|
||
### 前置要求
|
||
* [Go](https://go.dev/dl/) 1.21+
|
||
* [Node.js](https://nodejs.org/) 18+
|
||
* [Wails CLI](https://wails.io/docs/gettingstarted/installation): `go install github.com/wailsapp/wails/v2/cmd/wails@latest`
|
||
|
||
### 开发模式
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git clone https://github.com/Syngnat/GoNavi.git
|
||
cd GoNavi
|
||
|
||
# 启动开发服务器 (支持热重载)
|
||
wails dev
|
||
```
|
||
|
||
### 编译构建
|
||
|
||
```bash
|
||
# 构建当前平台的可执行文件
|
||
wails build
|
||
|
||
# 清理并构建 (推荐发布前使用)
|
||
wails build -clean
|
||
```
|
||
|
||
构建产物将位于 `build/bin` 目录下。
|
||
|
||
### 跨平台编译 (GitHub Actions)
|
||
|
||
本项目内置了 GitHub Actions 流水线，Push `v*` 格式的 Tag 即可自动触发构建并发布 Release。
|
||
支持构建：
|
||
* macOS (AMD64 / ARM64)
|
||
* Windows (AMD64)
|
||
|
||
---
|
||
|
||
## ❓ 常见问题 (Troubleshooting)
|
||
|
||
### macOS 提示 "应用已损坏，无法打开"
|
||
|
||
由于本项目尚未购买 Apple 开发者证书进行签名（Notarization），macOS 的 Gatekeeper 安全机制可能会拦截应用的运行。请按照以下步骤解决：
|
||
|
||
1. 将下载的 `GoNavi.app` 拖入 **应用程序** 文件夹。
|
||
2. 打开 **终端 (Terminal)**。
|
||
3. 复制并执行以下命令（输入密码时不会显示）：
|
||
```bash
|
||
sudo xattr -rd com.apple.quarantine /Applications/GoNavi.app
|
||
```
|
||
4. 或者：在 Finder 中右键点击应用图标，按住 `Control` 键选择 **打开**，然后在弹出的窗口中再次点击 **打开**。
|
||
|
||
---
|
||
|
||
## 🤝 贡献指南
|
||
|
||
欢迎提交 Issue 和 Pull Request！
|
||
|
||
1. Fork 本仓库
|
||
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
|
||
3. 提交你的改动 (`git commit -m 'feat: Add some AmazingFeature'`)
|
||
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
||
5. 开启一个 Pull Request
|
||
|
||
## 📄 开源协议
|
||
|
||
本项目采用 [Apache-2.0 协议](LICENSE) 开源。
|