mirror of
https://github.com/Syngnat/GoNavi.git
synced 2026-05-07 08:03:04 +08:00
8df9ea717c
- DuckDB 驱动迁移至官方 duckdb-go/v2 并按平台条件编译 - 修复 Windows/arm64 与 macOS/arm64 的构建失败链路 - 修复 macOS 10.13 下窗口材质可用性告警导致的打包问题 - 统一发布包命名规则（去掉版本前缀 v，架构统一 Amd64/Arm64） - Windows 同时产出 exe/zip，在线更新优先匹配 exe 并保留 zip 兼容
GoNavi - 现代化的轻量级数据库管理工具
GoNavi 是一款基于 Wails (Go) 和 React 构建的现代化、高性能、跨平台数据库管理客户端。它旨在提供如原生应用般流畅的用户体验，同时保持极低的资源占用。
相比于 Electron 应用，GoNavi 的体积更小（~10MB），启动速度更快，内存占用更低。
📸 项目截图
✨ 核心特性
🚀 极致性能
- 零卡顿交互：采用独创的 "幽灵拖拽" (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
📦 安装与运行
前置要求
开发模式
# 克隆项目
git clone https://github.com/Syngnat/GoNavi.git
cd GoNavi
# 启动开发服务器 (支持热重载)
wails dev
编译构建
# 构建当前平台的可执行文件
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 安全机制可能会拦截应用的运行。请按照以下步骤解决：
- 将下载的
GoNavi.app拖入 应用程序 文件夹。 - 打开 终端 (Terminal)。
- 复制并执行以下命令（输入密码时不会显示）：
sudo xattr -rd com.apple.quarantine /Applications/GoNavi.app - 或者：在 Finder 中右键点击应用图标，按住
Control键选择 打开，然后在弹出的窗口中再次点击 打开。
🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建你的特性分支 (
git checkout -b feature/AmazingFeature) - 提交你的改动 (
git commit -m 'feat: Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启一个 Pull Request
📄 开源协议
本项目采用 Apache-2.0 协议 开源。