logan
a9510235bb
驱动接入（全部本机真实例验收）： - 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 同步
1.9 KiB
1.9 KiB
OpsxDB 开发指南
数据库桌面客户端（连接 / SQL 工作台 / AI 写 SQL）。请使用中文沟通。
产品形态（硬边界）
浏览器 → 只看官网 + 文档（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）。
架构
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 的引擎界面须灰态，勿标成可用。
怎么跑
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 内容保持同步即可。