feat: 18 引擎驱动全家桶 + 驱动管理/离线包 + 设置中心 + 工作台交互打磨
CI / Go server (push) Canceled after 0s
CI / Web + core packages (push) Canceled after 0s
CI / Desktop (Tauri) cargo check (push) Canceled after 0s

驱动接入(全部本机真实例验收):
- Elasticsearch 原生 SQL API、InfluxDB 原生 HTTP+Flux(官方 JDBC 付费许可,实测弃用)
- ZooKeeper/MongoDB JVM agent(连接时自动下载官方驱动 jar,sha256 钉版本到 ~/.opsxdb/drivers/)
- 达梦 JDBC agent 桥就绪(待厂商 jar+实例);TiDB 真实例验收
- 协议族代码审查放行 PolarDB/TDSQL/OceanBase/Kingbase/GaussDB/Oracle
- 驱动能力模型:按驱动开关对象树分组/右键菜单/行编辑,NoSQL 树拍平(对象直挂库节点)

驱动管理:
- 驱动管理弹框(状态/预装/离线包导入/JDK 检测)+ /api/drivers/* 三接口
- opsxdb-driver 驱动商店仓库(清单/fetch.sh/pack.sh 离线包/import.sh)
- 连接时懒加载:DMG 零 Java 产物,首连自动下载(实测 ZK 九件套 1.35s),离线包自动回退

UI/交互:
- 设置中心(⚙):常规/执行/结果/驱动/快捷键/关于,左导航+右面板(对标 opsxshell)
- 实例级展开箭头(行首 SVG chevron,替代字体回退失真的 Unicode 三角)
- 树内嵌套渲染修复:对象树挂在激活连接下;工具栏窄窗口不断行(按钮 nowrap+整颗换行)
- 侧栏连接行精简(图标+连接名)、SQLite SSH 守卫、Oracle 死参数清理

质量:
- Go 协议层/离线回退单测、E2E 门控测试(ES/ZK/Influx/Mongo/TiDB/JDBC 桥)
- 驱动注册表单一事实来源 connection-types.json,README/BACKLOG/AGENTS 同步
This commit is contained in:
logan committed 2026-09-22 01:07:46 +08:00
1 parent 26f459d1b8
commit a9510235bb
156 files changed
+17200 -2520

No files matched your search

+46
View File
@@ -0,0 +1,46 @@
# OpsxDB 开发指南
数据库**桌面**客户端(连接 / SQL 工作台 / AI 写 SQL)。请使用中文沟通。
## 产品形态(硬边界)
```text
浏览器 → 只看官网 + 文档(Gin :8788)
操作 → 只走桌面 Tauri(./run.sh gui)
apps/web (:5174) → 仅桌面 Vite 源 / 打包 frontendDist,不是浏览器产品
```
- **不要**把工作台做成浏览器 SaaS,或把 `:5174` 当对外入口。
- Gin(`apps/server`)= 官网 / docs / health / 驱动相关 API;**不是**「远程多人协作后端」。
- 连接与查询数据默认在本机;密钥与连接串按现有桌面安全实践处理。
同族:`opsxapi` 同形态;`opsxshell` 同样「浏览器=官网/docs,操作=桌面」(Gin 在 `apps/server`,**无**操作 API,原生全在 Rust)。
## 架构
```text
packages/ui + apps/web → packages/transport(tauri-native | gin) → 桌面 / 本机 Gin
apps/desktop → Tauri 2 壳
apps/server → Gin 官网 + docs + 驱动 API
connection-types/ → 引擎注册表(ready / verified / notes)
agents/ → JDBC agent 桥(Java 单文件桥 + 协议文档;Go 侧在 apps/server/internal/db/agent.go)
```
改驱动能力:先动注册表与 server/desktop 对应路径,再补 UI;未 `ready` 的引擎界面须灰态,勿标成可用。
## 怎么跑
```bash
npm install
./run.sh web # 仅官网 + docs → :8788
./run.sh gui # 桌面(推荐)
./run.sh stop | status | restart
```
改 `apps/server` 后需重编(`./run.sh restart`)。清单与验收见 `docs/BACKLOG.md`。
## 给 AI
- 跟现有 monorepo 分包,勿平行造第二套客户端。
- 需求清楚就直接改;细节以邻近代码与 BACKLOG 为准,不必先扩写长规范。
- 少加「仅 AI 可读」的重复文档;用户可见文案与 docs 内容保持同步即可。