mirror of https://github.com/Syngnat/GoNavi.git synced 2026-08-12 01:24:12 +08:00

Go to file

辣条 1cb112bcdf 1. 收口多语言能力 2. 修复查询编辑器、侧边栏、DDL 展示等业务问题 (#589 )

## 主要改动

### 1. 多语言能力收口
- 收口 6 种语言下的业务文案与交互文案
- 覆盖连接驱动、查询编辑器、导出流程、部分 AI 工具面板等场景
- 补齐多语言回归测试，减少语言切换后文案残留中文或不同步的问题

### 2. 查询编辑器相关修复
- 修复新建查询标签页在语言切换后标题不同步的问题
- 修复查询结果集不展示、总数长期停留在“正在统计中”的问题
- 修复有限分页场景下仍可继续翻到不存在页码并展示异常数据的问题
- 修复 SQL 编辑器挂起事务内执行后续查询时，无法读到未提交修改的问题
- 修复 SQL Server 单条查询尾随 `affectedRows` 结果被误渲染为额外结果页签的问题
- 补齐 SQL Server 多结果集归属与过滤逻辑，避免冗余结果干扰展示

### 3. 侧边栏与视图相关修复
- 修复数据库连接下视图节点展开/滚动后渲染错乱、内容铺满侧栏的问题
- 修复收起视图栏后页面仍残留视图内容的问题
- 修复视图元数据重复导致的侧边栏树结构异常问题
- 补齐相关测试桩与回归测试

### 4. Oracle / DDL 相关修复
- 修复 Oracle 建表 DDL 追加注释时缺少语句结束分号与空行分隔的问题
- 避免 `CREATE TABLE` 与 `COMMENT ON TABLE/COLUMN` 粘连，提升复制后可直接执行的稳定性

### 5. 其他界面修复
- 修复语言设置面板选项显示截断问题
- 收口部分 dev 合并后的多语言遗漏与提示文案不一致问题

## 验证情况

已完成的本地验证包括：

- 前端定向测试
- `npm test -- QueryEditor.external-sql-save.test.tsx
sqlEditorTransaction.test.ts`
- `npm test -- QueryEditor.results-and-drop.test.tsx
QueryEditor.external-sql-save.test.tsx sqlEditorTransaction.test.ts
useSqlEditorTransactionController.test.tsx`
- `npm test -- QueryEditor.results-and-drop.test.tsx ddlFormat.test.ts`

- 后端定向测试
- `go test ./internal/app -run
'TestDBQueryMultiTransactionalKeepsDMLTransactionOpenUntilCommit|TestDBQueryMultiInTransactionReusesPendingManagedSessionForReadQueries'`
- `go test ./internal/db -run 'Test.*GetCreateStatement|Test.*Oracle.*'`

## 已知说明

- `internal/app` 下部分 SQL Server 相关定向测试在当前机器上受“SQL Server 纯 Go
驱动未启用”环境限制，失败原因为本地驱动依赖，不是本次改动引入的问题
- 本 PR 改动面较大，建议合并前重点关注：
  - 多语言切换后的查询编辑器与侧边栏行为
  - SQL Server 结果集展示
  - Oracle DDL 预览与复制执行
  - 挂起事务中的查询结果一致性

## 风险点

- 查询编辑器结果集合并、分页、事务复用逻辑改动较集中
- 多语言文案收口涉及范围较广，建议合并后做一次核心路径冒烟验证

2026-06-24 14:15:31 +08:00

.github

🐛 fix(update): 修复桌面端更新安装与重启流程

2026-06-23 22:18:07 +08:00

build

…

cmd

🐛 fix(sqlserver): 修复可选驱动查询消息透传缺失

2026-06-23 08:48:42 +08:00

docs

✨ feat(connection): 支持生产连接多项保护策略

2026-06-23 17:42:54 +08:00

frontend

🐛 fix(query-editor): 补齐SQL Server冗余结果集过滤

2026-06-24 13:58:12 +08:00

internal

🐛 fix(query-editor): 补齐SQL Server冗余结果集过滤

2026-06-24 13:58:12 +08:00

shared/i18n

Merge branch 'dev' into feature/20260602_connection_driver_i18n

2026-06-23 23:34:16 +08:00

third_party

…

tools

✨ feat(trino): 新增 Trino 可选驱动接入并补齐查询支持

2026-06-21 13:54:42 +08:00

version

…

.gitignore

🔧 chore(gitignore): 忽略 optional-driver-agent 构建产物

2026-06-19 12:07:33 +08:00

AI_EXTENSIONS_ROADMAP.md

…

assets_dev.go

…

assets_prod.go

…

build-driver-agents.sh

…

build-release.sh

…

CONTRIBUTING.md

…

CONTRIBUTING.zh-CN.md

…

go.mod

✨ feat(trino): 新增 Trino 可选驱动接入并补齐查询支持

2026-06-21 13:54:42 +08:00

go.sum

✨ feat(trino): 新增 Trino 可选驱动接入并补齐查询支持

2026-06-21 13:54:42 +08:00

LICENSE

…

logo.svg

…

main_test.go

…

main_windows_webview_userdata_stub.go

…

main_windows_webview_userdata.go

…

main.go

🐛 fix(memory): 修复大数据量导出导致进程内存飙升至 16G 的问题

2026-06-19 12:05:02 +08:00

optional-driver-agent

…

README.md

📝 docs(readme): 补充 Trino 联邦查询支持说明

2026-06-21 14:11:36 +08:00

README.zh-CN.md

📝 docs(readme): 补充 Trino 联邦查询支持说明

2026-06-21 14:11:36 +08:00

wails.json

…

README.md

GoNavi - A Modern Lightweight Database Client

Language: English | 简体中文

GoNavi is a modern, high-performance, cross-platform database client built with Wails (Go) and React. It delivers native-like responsiveness with low resource usage.

Compared with many Electron-based clients, GoNavi is typically smaller in binary size (around 10MB class), starts faster, and uses less memory.

Project Overview

GoNavi is designed for developers and DBAs who need a unified desktop experience across multiple databases.

Native-performance architecture: Wails (Go + WebView) with lightweight runtime overhead.
Large dataset usability: virtualized rendering and optimized DataGrid workflows for high-volume tables.
Unified connectivity: URI build/parse, SSH tunnel, proxy support, and on-demand driver activation.
Production-oriented workflow: SQL editor, object management, batch export/backup, sync tools, execution logs, and update checks.

Supported Data Sources

Built-in: available out of the box.
Optional driver agent: install/enable via Driver Manager first.

Category	Data Source	Driver Mode	Typical Capabilities
Relational	MySQL	Built-in	Schema browsing, SQL query, data editing, export/backup
Relational	PostgreSQL	Built-in	Schema browsing, SQL query, data editing, object management
Relational	Oracle	Built-in	Query execution, object browsing, data editing
Cache	Redis	Built-in	Key browsing, command execution, encoding/view switch
Relational	MariaDB	Optional driver agent	Querying, object management, data editing
Relational	Doris	Optional driver agent	Querying, object browsing, SQL execution
Columnar Analytics	StarRocks	Optional driver agent	Querying, object browsing, SQL execution
Search	Sphinx	Optional driver agent	SphinxQL querying and object browsing
Relational	SQL Server	Optional driver agent	Schema browsing, SQL query, object management
File-based	SQLite	Optional driver agent	Local DB browsing, editing, export
File-based	DuckDB	Optional driver agent	Large-table query, pagination, file-DB workflow
Domestic DB	Dameng	Optional driver agent	Querying, object browsing, data editing
Domestic DB	Kingbase	Optional driver agent	Querying, object browsing, data editing
Domestic DB	HighGo	Optional driver agent	Querying, object browsing, data editing
Domestic DB	Vastbase	Optional driver agent	Querying, object browsing, data editing
Document	MongoDB	Optional driver agent	Document query, collection browsing, connection management
Time-series	TDengine	Optional driver agent	Time-series schema browsing and querying
Columnar Analytics	ClickHouse	Optional driver agent	Analytical query, object browsing, SQL execution
Federated Query	Trino	Optional driver agent	Cross-source SQL via multiple catalogs, `catalog.schema` browsing, SQL execution
Search	Elasticsearch	Optional driver agent	Index browsing, mapping inspection, JSON DSL / query_string search
Extensibility	Custom Driver/DSN	Custom	Extend to more data sources via Driver + DSN

📸 Screenshots

Key Features

AI Assistant (New)

Multi-provider Support: OpenAI, Google Gemini, Anthropic Claude, and custom API support.
Context-Aware Chat: Attach table schemas to the AI context for accurate SQL generation and assistance.
Slash Commands: Quick commands for generating SQL, explaining queries, optimizing performance, and reviewing schema designs.

Performance

Smooth interaction under load: optimized table interaction (including column resize workflow on large datasets).
Virtualized rendering: keeps large result sets responsive.

Data Management (DataGrid)

In-place cell editing.
Batch insert/update/delete with transaction-oriented submit/rollback.
Large-field popup editor.
Context actions (set NULL, copy/export, etc.).
Smart read/write mode switching based on query context.
Export formats: CSV, Excel (XLSX), JSON, Markdown.

SQL Editor

Monaco Editor core.
Context-aware completion for databases/tables/columns.
Multi-tab query workflow.

Batch Export / Backup

Database-level and table-level batch export/backup.
Scope-aware operation flow to reduce mistakes.

Connectivity

URI generation/parsing.
SSH tunnel support.
Proxy support.
Config import/export (JSON).
Optional driver management and activation.

Redis Tools

Multi-view value rendering (auto/raw text/UTF-8/hex).
Built-in command execution panel.

Observability and Update

SQL execution logs with timing information.
Startup/scheduled/manual update checks.

UI/UX

Ant Design 5 based interface.
Light/Dark themes.
Flexible sidebar and layout behavior.

Tech Stack

Backend: Go 1.24 + Wails v2
Frontend: React 18 + TypeScript + Vite
UI: Ant Design 5
State Management: Zustand
Editor: Monaco Editor

Installation and Run

Prerequisites

Go 1.21+
Node.js 18+
Wails CLI: go install github.com/wailsapp/wails/v2/cmd/wails@v2.11.0

Development Mode

# Clone
git clone https://github.com/Syngnat/GoNavi.git
cd GoNavi

# Start development with hot reload
wails dev

# Faster local startup when exported Go method signatures are unchanged
node tools/wails-fast-dev.mjs

# Refresh Wails JS bindings after changing exported Go method signatures
node tools/wails-fast-dev.mjs --refresh-bindings

# Windows PowerShell low-memory visual mode: disables transparent WebView/Acrylic backdrop
$env:GONAVI_LOW_MEMORY_MODE="1"; node tools/wails-fast-dev.mjs

Build

# Build for current platform
wails build

# Clean build (recommended before release)
wails build -clean

Artifacts are generated in build/bin.

Cross-Platform Release (GitHub Actions)

The repository includes a release workflow. Push a v* tag to trigger automated build and release. Release notes are generated automatically from merged pull requests and categorized by .github/release.yaml.

Target artifacts include:

macOS (AMD64 / ARM64)
Windows (AMD64)
Linux (AMD64, WebKitGTK 4.0 and 4.1 variants)

Troubleshooting

macOS: "App is damaged and can’t be opened"

Without Apple notarization, Gatekeeper may block startup.

Move GoNavi.app to Applications.
Open Terminal.
Run:

sudo xattr -rd com.apple.quarantine /Applications/GoNavi.app

Or right-click the app in Finder and choose Open with Control key flow.

Linux: missing `libwebkit2gtk` / `libjavascriptcoregtk`

GoNavi depends on WebKitGTK runtime libraries.

# Debian 13 / Ubuntu 24.04+
sudo apt-get update
sudo apt-get install -y libgtk-3-0 libwebkit2gtk-4.1-0 libjavascriptcoregtk-4.1-0

# Ubuntu 22.04 / Debian 12
sudo apt-get update
sudo apt-get install -y libgtk-3-0 libwebkit2gtk-4.0-37 libjavascriptcoregtk-4.0-18

If you use Linux artifacts with the -WebKit41 suffix, prefer Debian 13 / Ubuntu 24.04+.

Linux: Chinese text appears as square boxes

Minimal Ubuntu 24.04 LTS desktop/server environments may not include Chinese CJK fonts. Install Noto / WenQuanYi fonts and restart GoNavi:

sudo apt-get update
sudo apt-get install -y fonts-noto-cjk fonts-wqy-microhei
fc-cache -fv

Contributing

Issues and pull requests are welcome.

For the full workflow, branch model, and maintainer sync rules, see:

CONTRIBUTING.md

External contributors should branch from dev and open pull requests against dev.

Star History

License

Licensed under Apache-2.0.

Languages

TypeScript 54.4%

Go 40.4%

CSS 2.2%

Python 1.2%

HTML 0.6%

Other 1.2%

README.md Unescape Escape

GoNavi - A Modern Lightweight Database Client

Project Overview

Supported Data Sources

📸 Screenshots

Key Features

AI Assistant (New)

Performance

Data Management (DataGrid)

SQL Editor

Batch Export / Backup

Connectivity

Redis Tools

Observability and Update

UI/UX

Tech Stack

Installation and Run

Prerequisites

Development Mode

Build

Cross-Platform Release (GitHub Actions)

Troubleshooting

macOS: "App is damaged and can’t be opened"

Linux: missing libwebkit2gtk / libjavascriptcoregtk

Linux: Chinese text appears as square boxes

Contributing

Star History

Links

License

README.md

Linux: missing `libwebkit2gtk` / `libjavascriptcoregtk`