# GoNavi **Repository Path**: LucasDot/GoNavi ## Basic Information - **Project Name**: GoNavi - **Description**: No description available - **Primary Language**: Go - **License**: Apache-2.0 - **Default Branch**: dev - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-04-22 - **Last Updated**: 2026-10-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

GoNavi

一套客户端，航行全部数据源 — 原生性能 · Agent 就绪 · 告别 Electron 膨胀。

基于 Wails（Go）+ React 的跨平台数据库工作台。桌面优先，MCP 原生，安装包约 20–26MB 量级。

语言：English · 简体中文 · 🌐 官网 · ⬇ 下载 · ⚡ 快速开始 · ✨ 特性 · 🤖 MCP

_{赞助商 ·
APISmart
·
華龍算力}

--- ## 为什么是 GoNavi？市面上大量数据库 GUI 仍是 Electron 壳：体积大、启动慢、内存高。GoNavi 换了一条路——谈「轻量」先把三个数字拆开： | 数字 | 含义 | GoNavi（v0.9.8） | |---|---|---| | **安装包体积** | 你下载的是什么 | **约 20–26 MB** 量级（Win / macOS / Linux 发布产物） | | **稳态 RSS** | 跑起来占多少内存 | Linux WebKit 构建、空工作台闲置：主进程约 **429 MB**；含 WebKit 子进程约 **765 MB**（方法见下） | | **UI 栈** | 有没有 Chromium 税 | **Go + 系统 WebView（Wails）**，不是 Electron | | | 常见 Electron 客户端 | **GoNavi** | |---|---|---| | 运行时 | Chromium + Node | **Go + 系统 WebView** | | 安装包 | 动辄数百 MB | **约 20–26 MB 量级** | | 启动 | 偏重 | **更快** | | 内存口径 | 常和安装包混谈 | **RSS 单独测**（见注） | | AI / Agent | 外挂或缺失 | **MCP + 多模型一等公民**（AI 起草 SQL；GUI 仍管 schema / 改行 / EXPLAIN） | | 数据源 | 以 RDBMS 为主 | **SQL · 缓存 · 向量 · 消息 · 搜索 · 时序 · 国产库** | > **安装包 MB ≠ 运行内存。** 上表 RSS 来自一次云电脑 Linux 实测：v0.9.8 WebKit41 包、空工作台、无数据库连接、远程显示、约 30–40 s 稳态。不要拿它和安装包比，也不要和未经核实的「原生 ~80 MB」宣传混比。Windows / macOS 本机结果可能不同——这是带方法学的样本，不是排行榜分数。 > **MySQL、Postgres、Redis、Kafka、Milvus、OceanBase、ClickHouse… 一个工作台打通。** > 查询、编辑、审计、同步；把结构化上下文交给编码 Agent，密码仍留在本机。 --- ## 一眼看懂 ```text ┌──────────────────────────────────────────────────────────────────────┐ │ GoNavi 工作台 │ │ ┌─────────────┐ ┌──────────────────┐ ┌─────────────────────────┐ │ │ │ 连接管理 │ │ Monaco SQL + AI │ │ 虚拟滚动 DataGrid │ │ │ │ SSH / 代理 │ │ 表结构上下文 │ │ 批量编辑 · 导出 │ │ │ │ 驱动代理 │ │ 快捷指令 │ │ 事务提交 / 回滚 │ │ │ └─────────────┘ └────────┬─────────┘ └─────────────────────────┘ │ │ │ │ │ ┌─────────────▼─────────────┐ │ │ │ Go 核心 · 审计 · 同步 │ │ │ │ MCP HTTP · Web Server │ │ │ └───────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────┘ ``` ### 产品截图每张均为 **完整 GoNavi 应用窗口**（1440×900），取自最新 dev 构建，再通过 README 宽度控件等比例缩小展示。

_{工作台 — 连接、已存查询、快捷操作}	_{SQL 编辑器 — 语法高亮、结果表格、对象树}
_{AI 助手 — 感知表结构的对话，生成 SQL 可插入 / 执行 / 预览}	_{AI 设置 — 内置工具与推荐排查流程}
_{新建连接 — 可搜索、分类的数据源选择器}	_{SQL 执行历史 — 筛选、查看详情、一键填回编辑器}
_{SQL 审计中心 — 跨连接的脱敏 SQL 审计证据}	_{设置中心 — 内置主题、字体、工作区等}

_{演示数据来自本地实验库 · 连接地址、密钥与供应商配置均未展示}

--- ## 💖 赞助商 > **欢迎赞助 GoNavi！** 我们欢迎个人与企业通过赞助或合作支持项目持续开源发展；有意赞助请通过微信 `ygf1140302783`（备注「GoNavi」）联系维护者沟通。

APISmart
_{统一 AI 模型 API · OpenAI 兼容}

華龍算力
_{AI API Gateway · 多模型统一接入 · 国内直连高速端点}

特别感谢 **[APISmart](https://www.apismart.ai/)** 与 **[華龍算力](https://gonavi.hualong.online/)** 赞助 GoNavi 开源开发。 | 赞助商 | 提供什么 | 为什么适合 GoNavi | |---|---|---| | **[APISmart](https://www.apismart.ai/)** | APISmart 通过一个 API 提供对主流 AI 模型的统一访问。开发者只需一个 API Key，即可通过兼容 OpenAI 的接口接入大语言模型、图像和视频模型，无需分别管理多个服务商。智能路由与自动故障切换有助于提升可靠性，集中式账单使使用管理更加轻松。借助 APISmart，开发者能以更精简的平台更快构建并扩展 AI 应用。 | 开发者和 Agent 工作流无需分别接入各家服务商，也能使用多种 AI 能力。 | | **[華龍算力](https://gonavi.hualong.online/)** | 華龍算力是一家面向重度 AI 开发者、专注官方直连的高品质模型 API 中转服务商。主要营业 Codex 系列模型，100% 官方源直供，不掺假不注水，欢迎检验。计费透明，Token 级账单可逐笔核验。同时支持企业级高并发，并为企业客户提供专业的管理平台；企业客户可签订正式合同并开具发票，更多详情请进入官网获取联系方式。GPT 系列最低至 0.08 倍率，更有 0.15 倍率的 Pro 稳定分组；邀请好友双向赠送，邀请奖励无上限。 | 稳定的模型通道是 GoNavi 的 AI 助手、MCP 与日常开发工作流的基础设施。 | - APISmart：[https://www.apismart.ai/](https://www.apismart.ai/) — 统一 AI 模型 API，兼容 OpenAI 接口。 - 華龍算力：[https://gonavi.hualong.online/](https://gonavi.hualong.online/) — 控制台、文档与国内高速端点。 > 華龍算力另向本仓库赞助了 **共享 500 亿（50B）token** 额度，供 GoNavi **共建者** 以 **API Key** 方式协作开发使用（非整库人均 50B）。申请与规则见共建入口：[Issue #671](https://github.com/Syngnat/GoNavi/issues/671)。 --- ## ✨ 核心能力

### 🤖 懂表结构的 AI - OpenAI · Gemini · Claude · 自定义 OpenAI 兼容 API - 将当前库表结构注入对话上下文 - 快捷指令：生成 SQL、解释、优化、表设计评审 - MCP：一键装到 Claude Code / Codex，或 Streamable HTTP 给远端 Agent - 连接与密码留在运行 GoNavi 的主机上	### ⚡ 大数据仍流畅 - 虚拟滚动 DataGrid，扛住大结果集 - 单元格编辑 · 批量增删改 · 事务提交/回滚 - 大字段弹窗 · 按查询智能切换读写 - 导出：CSV · XLSX · JSON · Markdown - Monaco + 库/表/字段上下文补全
### 🔌 连接与驱动 - URI 生成 / 解析 - SSH 隧道 · 代理 - 连接配置 JSON 导入导出 - 可选驱动代理按需安装 - Custom Driver + DSN 扩展	### 🛡️ 可观测 & 可交付 - SQL 执行日志（含耗时） - 审计中心（默认脱敏、保留策略、导出） - 桌面端 + 实验性 Web Server - Docker / K8s / Helm / Podman - 更新检查 · 多架构发布

### 🧩 技术栈 `Go 1.24` · `Wails v2` · `React 18` · `TypeScript` · `Vite` · `Ant Design 5` · `Zustand` · `Monaco` --- ## 🗄 支持的数据源 > **内置**：开箱即用 · **可选驱动代理**：在驱动管理中安装启用 | | | |---|---| | **内置** | MySQL · GoldenDB · PostgreSQL · Oracle · Redis · Chroma · Qdrant · Milvus · RocketMQ · MQTT · Kafka · RabbitMQ | | **可选** | MariaDB · Doris · StarRocks · Sphinx · SQL Server · SQLite · DuckDB · OceanBase · 达梦 · 人大金仓 · 瀚高 · 海量 · openGauss · GaussDB · IRIS · Caché · MongoDB · TDengine · IoTDB · ClickHouse · Trino · Elasticsearch · TiDB · CockroachDB · KWDB · TimescaleDB · GBase 8a · GBase 8c · GBase 8s · 崖山 · Firebird · QuestDB · GreptimeDB · InfluxDB · Presto · OpenSearch · Weaviate · Meilisearch · Typesense · etcd · ZooKeeper · Custom Driver/DSN |

完整能力矩阵

| 类别 | 数据源 | 驱动模式 | 典型能力 | |---|---|---|---| | 关系型 | MySQL | 内置 | 库表浏览、SQL 查询、数据编辑、导出/备份 | | 国产数据库 | GoldenDB | 内置 | MySQL 兼容查询工作流、分布式事务场景 | | 关系型 | PostgreSQL | 内置 | 库表浏览、SQL 查询、数据编辑、对象管理 | | 关系型 | Oracle | 内置 | 连接查询、对象浏览、数据编辑 | | 缓存 | Redis | 内置 | Key 浏览、命令执行、编码/视图切换 | | 向量数据库 | Chroma | 内置 | Collection 浏览、向量检索、元数据过滤 | | 向量数据库 | Qdrant | 内置 | Collection 浏览、向量搜索、Payload 过滤 | | 向量数据库 | Milvus | 内置 | Collection 浏览、向量搜索、标量过滤 | | 消息队列 | RocketMQ | 内置 | Topic 浏览、消费组检查、消息型工作流 | | 消息队列 | MQTT | 内置 | Broker / Topic Filter 工作流与 QoS 连接配置 | | 消息队列 | Kafka | 内置 | Topic 浏览、Broker 元数据、消费组工作流 | | 消息队列 | RabbitMQ | 内置 | Queue / Exchange 浏览、Virtual Host 检查、Management API 工作流 | | 关系型 | MariaDB | 可选驱动代理 | 连接查询、对象管理、数据编辑 | | 关系型 | Doris | 可选驱动代理 | 连接查询、对象浏览、SQL 执行 | | 列式分析 | StarRocks | 可选驱动代理 | 连接查询、对象浏览、SQL 执行 | | 搜索 | Sphinx | 可选驱动代理 | SphinxQL 查询与对象浏览 | | 关系型 | SQL Server | 可选驱动代理 | 库表浏览、SQL 查询、对象管理 | | 文件型 | SQLite | 可选驱动代理 | 本地文件库浏览、编辑、导出 | | 文件型 | DuckDB | 可选驱动代理 | 大表查询、分页浏览、文件库管理 | | 国产数据库 | OceanBase | 可选驱动代理 | MySQL / Oracle 租户接入、对象浏览、查询工作流 | | 国产数据库 | Dameng | 可选驱动代理 | 连接查询、对象浏览、数据编辑 | | 国产数据库 | Kingbase | 可选驱动代理 | 连接查询、对象浏览、数据编辑 | | 国产数据库 | HighGo | 可选驱动代理 | 连接查询、对象浏览、数据编辑 | | 国产数据库 | Vastbase | 可选驱动代理 | 连接查询、对象浏览、数据编辑 | | 国产数据库 | OpenGauss | 可选驱动代理 | 类 PostgreSQL 的库表浏览、SQL 查询、对象管理 | | 国产数据库 | GaussDB | 可选驱动代理 | 类 PostgreSQL 的库表浏览、SQL 查询、对象管理 | | 多模型数据库 | InterSystems IRIS | 可选驱动代理 | Namespace 浏览、SQL 查询、对象管理 | | 多模型数据库 | InterSystems Caché | 可选驱动代理 | Namespace 浏览、Caché SQL 查询、对象管理 | | 文档型 | MongoDB | 可选驱动代理 | 文档查询、集合浏览、连接管理 | | 时序 | TDengine | 可选驱动代理 | 时序库表浏览、查询分析 | | 时序 | Apache IoTDB | 可选驱动代理 | Storage Group / Device / Timeseries 浏览与查询 | | 列式分析 | ClickHouse | 可选驱动代理 | 分析查询、对象浏览、SQL 执行 | | 联邦查询 | Trino | 可选驱动代理 | 跨多数据源联邦 SQL、`catalog.schema` 浏览、SQL 执行 | | 搜索 | Elasticsearch | 可选驱动代理 | 索引浏览、Mapping 检查、受控 REST 控制台、JSON DSL / query_string 查询 | | 关系型 | TiDB | 可选驱动代理 | 兼容 MySQL 的查询、TiDB 执行计划、数据编辑、同步与迁移 | | 关系型 | CockroachDB | 可选驱动代理 | PostgreSQL 协议查询、SHOW CREATE 建表语句、数据编辑、同步与迁移 | | 时序 | KWDB | 可选驱动代理 | PostgreSQL 协议下的关系库与时序库、数据编辑、同步与迁移 | | 时序 | TimescaleDB | 可选驱动代理 | 超表与连续聚合、分块统计、PostgreSQL 工作流、同步与迁移 | | 国产数据库 | GBase 8a | 可选驱动代理 | MySQL 协议的 MPP 查询、HASH 索引、按类分批提交、同步与迁移 | | 国产数据库 | GBase 8c | 可选驱动代理 | openGauss 内核（A / B / PG 兼容模式）、sha256 认证、对象管理、同步与迁移 | | 国产数据库 | GBase 8s | 可选驱动代理 | 经用户自备的 GBase 8s CSDK 接入（Informix SQLI）、对象浏览、数据编辑、SQL 备份恢复 | | 国产数据库 | 崖山 YashanDB | 可选驱动代理 | 经用户自备的崖山客户端接入、兼容 Oracle 的查询与 PL/SQL 对象、执行计划、同步与迁移 | | 关系型 | Firebird | 可选驱动代理 | Firebird 2.5 / 3.0 / 4–5、存储过程 / 触发器 / 包、数据编辑、SQL 备份恢复 | | 时序 | QuestDB | 可选驱动代理 | 分区时序表、SQL 查询、执行计划、追加导入 | | 时序 | GreptimeDB | 可选驱动代理 | MySQL 协议查询、TIME INDEX / Tag 元数据、追加导入 | | 时序 | InfluxDB | 可选驱动代理 | InfluxDB 1.x（InfluxQL）/ 2.x（Flux）/ 3.x（SQL）、行协议写入、网格编辑 | | 联邦查询 | Presto | 可选驱动代理 | PrestoDB / PrestoSQL 多目录、SQL 执行与取消、作为迁移源 | | 搜索 | OpenSearch | 可选驱动代理 | OpenSearch 1.x / 2.x / 3.x 索引、受控 REST 控制台、SQL / PPL | | 向量数据库 | Weaviate | 可选驱动代理 | Class 与租户、基于 GraphQL 的网格浏览与编辑、向量列 | | 搜索 | Meilisearch | 可选驱动代理 | 索引即表、过滤 / 排序下推、文档编辑、REST 控制台 | | 搜索 | Typesense | 可选驱动代理 | 集合即表、filter_by 下推、文档编辑、REST 控制台 | | 键值 | etcd | 可选驱动代理 | 前缀树浏览、键与租约编辑、etcdctl 风格控制台（v2 / v3 API） | | 协调服务 | ZooKeeper | 可选驱动代理 | Znode 树浏览、数据与 ACL 查看、节点编辑、zkCli 风格控制台 | | 扩展接入 | Custom Driver/DSN | 自定义 | 通过 Driver + DSN 接入更多数据源 |

### Elasticsearch REST 控制台 Elasticsearch 连接复用查询工作区，并按服务端版本提供受控 REST 控制台： - 支持 Dev Tools 风格的 `METHOD /path` 与 JSON body；`_bulk`、`_msearch` 使用 NDJSON。可运行光标所在请求、完整选区或按编辑器顺序执行整个批次。 - 搜索命中可切换为表格查看，同时保留完整 HTTP 原始 JSON / 文本响应。 - 后端白名单仅开放受支持的查询、文档、索引、Mapping、Settings、Alias、健康检查及有限 CAT API；未知端点和高权限端点默认拒绝。 - 删除等危险操作必须使用有时效的一次性确认；连接保护始终优先，并阻止写请求及包含脚本的只读请求。 - 写操作仅允许明确的物理索引，并要求 Elasticsearch `view_index_metadata`（或 `manage`）权限，以便 GoNavi 在发送数据前校验真实目标；Alias 与 Data Stream 不能作为写目标。 - 请求模板会根据 Elasticsearch 6、7、8 自动适配文档、Mapping 与 Bulk 路径。 > 控制台面向 Elasticsearch 6/7/8，不承诺兼容 OpenSearch；同时明确不开放 reindex、安全、快照、节点、集群设置、模板、Pipeline、生命周期及其他无限制管理 API。 --- ## 🚀 快速开始 ### 前置要求 - [Go](https://go.dev/dl/) 1.25+ - [Node.js](https://nodejs.org/) 18+ - [Wails CLI](https://wails.io/docs/gettingstarted/installation) - 仅 Linux：C 编译器、pkg-config，以及 GTK3 / WebKitGTK 开发包 ```bash go install github.com/wailsapp/wails/v2/cmd/wails@v2.15.0 ``` ### 开发 ```bash git clone https://github.com/Syngnat/GoNavi.git cd GoNavi wails dev # 完整热重载 node tools/wails-fast-dev.mjs # Go 导出签名未变时更快 node tools/wails-fast-dev.mjs --refresh-bindings # 修改导出方法签名后刷新绑定 ``` ### 构建 ```bash wails build wails build -clean # 发布前推荐 ``` 产物位于 `build/bin`。 Linux 上请先安装构建依赖（按发行版任选其一）： ```bash # Debian 12+ / Ubuntu 22.04+ sudo apt-get install -y build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev # Fedora / OpenCloudOS 9 sudo dnf install -y gcc pkgconf-pkg-config gtk3-devel webkit2gtk4.1-devel # RHEL / Rocky / AlmaLinux 9（仅提供 WebKitGTK 4.0） sudo dnf install -y gcc pkgconf-pkg-config gtk3-devel webkit2gtk3-devel # Arch Linux sudo pacman -S --needed base-devel gtk3 webkit2gtk-4.1 ``` 构建会自动识别本机装的是 WebKitGTK 4.1 还是 4.0。前端编译峰值约需 3 GB 内存。 ### 只想直接用？前往 **[Releases](https://github.com/Syngnat/GoNavi/releases)** 下载（macOS AMD64/ARM64 · Windows AMD64 · Linux WebKitGTK 4.0/4.1）。 ### 独立 CLI 独立 CLI 发布链正在首发。dev 构建已经包含无界面的 `gonavi` 归档；首个稳定 CLI Release 将使用 `gonavi-cli_${VERSION}_${GOOS}_${GOARCH}` 命名空间，并附带对应的 `gonavi-cli_${VERSION}_checksums.txt`。稳定版首发前请只将 dev 归档用于测试。解压归档后可直接运行： ```bash gonavi list-connections gonavi query --conn CONNECTION_ID --sql 'SELECT * FROM orders LIMIT 10' gonavi export --conn CONNECTION_ID --output orders.csv --sql 'SELECT * FROM orders' gonavi batch --conn CONNECTION_ID --file migration.sql --allow-write ``` 首个稳定 CLI Release 发布后，经过校验的 npm 平台包装器会按当前平台下载对应归档，并先验证独立的 checksum 文件。在 npm 包实际出现前，请改用 Release 归档安装；npm 包发布后可执行： ```bash npm install -g @syngnat/gonavi-cli ``` 稳定发布工作流还会生成并保留使用同一 checksum 的 WinGet manifest artifact，包 ID 为 `Syngnat.GoNavi.CLI`。该 manifest 还需通过 WinGet 社区仓库审核后才可安装；它与既有桌面版 GoNavi 包相互独立。审核通过后可执行： ```powershell winget install --id Syngnat.GoNavi.CLI -e ``` CLI 与桌面版共用活动数据根，优先级为：`GONAVI_DATA_ROOT`、 `~/.gonavi/storage_root.json`、`~/.gonavi`。临时凭据只能放在属主可读的 `0600` `--connection-file` 中，不能通过命令行参数传入。查询默认输出 JSONL，诊断信息输出到 stderr。变更类 SQL 还必须同时通过已保存的 AI 安全级别、连接保护和 `--allow-write` 确认。 Linux 容器可复制 `docker.cli.env.example`，设置宿主数据目录及 UID/GID，再通过同一个挂载到 `/data` 的目录运行： ```bash cp docker.cli.env.example docker.cli.env docker compose --env-file docker.cli.env -f docker-compose.cli.yml run --rm gonavi-cli list-connections ``` --- ## 🌐 Web Server（实验中）同一套 Go 后端 + React 前端提供浏览器访问（**不是**把 Wails 桌面窗口容器化）。 ```powershell go build . .\GoNavi-Wails.exe web-server --addr 127.0.0.1:34116 ``` - 首次访问进入 `/setup`（管理员密码；可选 Google Authenticator） - 桥接：`window.go.*` / `window.runtime.*` → HTTP / SSE - Session、恢复码、登录限流 #### Docker / Podman ```bash cp docker.web-server.env.example docker.web-server.env # 设置 GONAVI_HOST_DATA_ROOT 为绝对路径 # 可选：GONAVI_WEB_PASSWORD（至少 6 位） docker compose --env-file docker.web-server.env -f docker-compose.web-server.yml up -d ``` 打开 `http://127.0.0.1:34116`。将活动数据目录挂载到 `/data` （`connections.json`、`daily_secrets.json`，可选 `drivers/`）。认证状态写入 `web_auth.json`。 > **不要把未加固的 Web 入口直接暴露到公网。** 生产环境请配合反向代理与 HTTPS。健康检查：`GET /__gonavi/healthz` 本地源码构建：叠加 `-f docker-compose.web-server.local.yml --build`。修改 env 密码后需重建容器： ```bash docker compose --env-file docker.web-server.env -f docker-compose.web-server.yml up -d --force-recreate ``` （`docker restart` **不会**重新加载 env 文件。） --- ## 🤖 MCP & Agents 把结构工具交给 Agent，而不是把密钥交出去： ```bash cp docker.mcp-server.env.example docker.mcp-server.env docker compose --env-file docker.mcp-server.env -f docker-compose.mcp-server.yml up -d ``` | 形态 | 入口 | |---|---| | MCP 容器 | `docker-compose.mcp-server.yml` → `ghcr.io/syngnat/gonavi-mcp-server` | | Web UI 容器 | `docker-compose.web-server.yml` → `ghcr.io/syngnat/gonavi-web-server` | | Podman / Quadlet | [deploy/podman/gonavi-mcp-server](deploy/podman/gonavi-mcp-server) | | Kubernetes | [deploy/k8s/gonavi-mcp-server](deploy/k8s/gonavi-mcp-server) | | Helm | [deploy/helm/gonavi-mcp-server](deploy/helm/gonavi-mcp-server) | | 仅构建镜像 | `Dockerfile.build-env` → `ghcr.io/syngnat/gonavi-build-env` | 镜像 tag（四个镜像规则一致）： | Tag | 含义 | |---|---| | `latest` | 最新稳定版 | | `0.9.8` / `v0.9.8` | 精确版本，例如 `ghcr.io/syngnat/gonavi-web-server:0.9.8` | | `0.9` / `v0.9` | 该次版本线的最新补丁 | | `dev-latest` | `dev` 分支滚动构建，每次推送都会移动 | 集群不希望版本漂移时请锁定精确版本；`dev-latest` 是移动指针，不是稳定锚点。版本 tag 同时发布带 `v`（`v0.9.8`）与不带 `v`（`0.9.8`）两种形式，指向同一 digest，按习惯任选一种即可。安全默认：远端 `schema-only` 不暴露 `execute_sql`；开放后与内置 AI 助手共用安全控制，调用 `execute_sql` 即视为确认。详见：[cmd/gonavi-mcp-server/README.md](cmd/gonavi-mcp-server/README.md)。 ### 仅 Linux 构建环境 ```bash docker build -f Dockerfile.build-env -t gonavi-build-env:local . docker run --rm -it -v "$PWD:/workspace" -w /workspace gonavi-build-env:local bash ``` --- ## 📦 发布流水线推送 `v*` Tag → GitHub Actions 自动多架构构建。 Release 说明按 `.github/release.yaml` 从已合并 PR 生成。 --- ## 🛠 常见问题

Windows：缺少 Microsoft Edge WebView2 运行时（内网常见）

GoNavi 桌面版在 Windows 上依赖 **Microsoft Edge WebView2 Runtime**（系统级组件，不是完整 Chrome）。部分内网 / 精简镜像 / Windows Server / LTSC 机器未预装，会出现： - 双击后窗口一闪即关、白屏、空白窗口 - 提示找不到 WebView2 / WebView2 Runtime - 杀软或组策略拦截了运行时安装 ### 1. 先确认是否已安装在 **PowerShell** 中执行： ```powershell # Evergreen Runtime 常见安装目录（64 位系统） Test-Path "${env:ProgramFiles(x86)}\Microsoft\EdgeWebView\Application" # 注册表（有显示名称通常表示已安装） Get-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" ` -ErrorAction SilentlyContinue | Select-Object pv, name ``` 若路径不存在且注册表无 `pv` 版本号，需要安装运行时。 ### 2. 有外网：在线安装（最简单） 1. 打开微软官方下载页： [Microsoft Edge WebView2](https://developer.microsoft.com/microsoft-edge/webview2/) 2. 下载 **Evergreen Bootstrapper**（体积小，安装时联网拉完整运行时） 3. 右键「以管理员身份运行」安装完成后，**重新打开 GoNavi** ### 3. 内网 / 离线：独立安装包（推荐企业分发） Bootstrapper 在完全断网环境会失败。请改用 **Evergreen Standalone Installer**： 1. 在一台能上网的电脑打开同一下载页，下载对应架构的独立安装包，例如： - `MicrosoftEdgeWebView2RuntimeInstallerX64.exe`（绝大多数 64 位 Windows） - `…X86.exe` / `…ARM64.exe`（按机器架构选择） 2. 将安装包拷贝到内网（U 盘、软件中心、文件共享均可） 3. 在目标机 **管理员权限** 安装： ```powershell # 交互安装 .\MicrosoftEdgeWebView2RuntimeInstallerX64.exe # 静默安装（便于 IT 批量推送） .\MicrosoftEdgeWebView2RuntimeInstallerX64.exe /silent /install ``` 4. 安装完成后重新启动 GoNavi。若仍异常，注销/重启一次 Windows 再试。 ### 4. 组策略 / 权限受限时 - 需要本地管理员或由 IT 通过 SCCM / 软件中心推送 Standalone 安装包 - 确认未禁用 Edge / WebView2 相关更新与安装策略 - 企业可固定使用 [Fixed Version](https://developer.microsoft.com/microsoft-edge/webview2/) 运行时并由管理员统一维护（一般用户优先 Evergreen） ### 5. 临时绕过：Web Server 模式（仍需能跑 GoNavi 后端）若桌面 WebView 短期无法装上，可在本机用浏览器访问实验性 Web Server（**不是**把桌面窗口容器化）： ```powershell # 以发布包中的可执行文件为例 .\GoNavi.exe web-server --addr 127.0.0.1:34116 ``` 浏览器打开 `http://127.0.0.1:34116`。详见上文「Web Server」章节。注意：未加固的 Web 入口不要直接暴露到公网。更多说明与反馈入口见 Issue：[#672](https://github.com/Syngnat/GoNavi/issues/672)。

macOS Gatekeeper

下一稳定版 macOS DMG 的发布门禁包含 Developer ID 签名和 Apple 公证。请从对应 GitHub Release 下载，移到「应用程序」后正常打开；不要移除 Gatekeeper 的隔离属性。

Linux：缺少 WebKitGTK

```bash # 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 ``` 带 `-WebKit41` 后缀的产物更适配 Debian 13 / Ubuntu 24.04+。

Linux：中文显示为方框

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

--- ## 🤝 贡献欢迎 Issue 与 PR。请从 **`dev`** 拉分支，并向 **`dev`** 提 PR。 - [CONTRIBUTING.zh-CN.md](CONTRIBUTING.zh-CN.md) - 共建邀请（含赞助 token 池说明）：[Issue #671](https://github.com/Syngnat/GoNavi/issues/671) ## 🤝 共建者

--- ## 💬 联系与反馈 | 渠道 | 说明 | |---|---| | **GitHub Issues** | Bug、功能建议、文档问题优先在此提交，便于跟踪与复现 | | **微信** | `ygf1140302783`（备注「GoNavi」）— 可拉交流群，适合使用讨论与快速沟通 | > 技术问题尽量附版本号、系统与复现步骤；内网 Windows 启动白屏/闪退见 [WebView2 说明](https://github.com/Syngnat/GoNavi/issues/672)。 --- ## ⭐ Star History

--- ## 友情链接 - [APISmart](https://www.apismart.ai/) — 统一 AI 模型 API（GoNavi 赞助商） - [華龍算力](https://gonavi.hualong.online/) — AI API Gateway（GoNavi 赞助商） - [linux.do](https://linux.do/) - [AI全书](https://aibook.ren/) ## 开源协议 [Apache-2.0](LICENSE)

_{为泡在 SQL、表结构与 Agent 循环里的人而造。}