数据库开发者工具桌面应用CLIMCP 服务AI 应用【免费下载链接】dbx15MB轻量级跨平台数据库客户端、数据库管理工具。支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server 等。15MB, lightweight, cross-platform database client. Supports MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server and more.项目地址https://gitcode.com/t8y2/dbx点击查看免费下载导读DBX 是一个轻量级跨平台数据库客户端支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server 等数十种数据源。面对如此多的连接目标如何让连接类型在 Rust 内核、前端表单、驱动商店与 MCP 服务之间保持一致答案就在plugins/connection-types/目录这里的 YAML 描述符是 DBX 连接类型注册的单一事实来源source of truth。本文以 plugins/connection-types/README.md 为骨架结合仓库中的真实描述符与生成器源码完整讲解连接类型的定义字段、能力矩阵、前端 profile 绑定、代码生成链路以及何时新增连接类型、何时只加 profile的决策准则。一、连接类型描述符注册体系的单一事实来源plugins/connection-types/*.yaml是整个 DBX 连接类型注册的权威数据源。它覆盖的范围远超数据库本身从 README 原文可以归纳为五类类别覆盖目标示例描述符SQL 数据库传统关系型数据库mysql.yaml、postgres.yaml、sqlserver.yaml、oracle.yaml文档与向量存储Document / Vector Storemongodb.yaml、elasticsearch.yaml、qdrant.yaml、milvus.yaml、weaviate.yaml、chromadb.yaml键值与配置服务KV / Config Serviceredis.yaml、etcd.yaml、zookeeper.yaml、nacos.yaml、consul.yaml消息队列与 MQTTMQ / MQTT Brokermq.yamlKafka / RocketMQ / RabbitMQ profile、mqtt.yaml通用 JDBC 目标Generic JDBCjdbc.yaml、plugin.yaml除描述符外profiles/catalog.yaml 保存前端连接选择器connection picker所需的 product profile把产品名称、默认端口、默认用户与稳定连接类型绑定在一起。需要特别说明两个命名细节README 明确提示dbType与DatabaseType保留了历史名称。即使某些目标并非数据库如 ZooKeeper、MQTT其序列化 API 字段仍沿用dbType名称以保证 API 兼容性。SQL 语法、DDL 模板、类型目录与元数据查询细节不在本目录它们位于plugins/dialects/*.yaml。连接类型只管连接与能力不管SQL 方言细节这是模块边界清晰的设计。二、描述符字段全解析一个连接类型描述符由顶层元数据 能力矩阵组成。以下结合真实文件逐字段说明。2.1 顶层字段身份、运行模式与连接默认值以最典型的 mysql.yaml 为例schemaVersion: 1 order: 10 dbType: mysql rustVariant: Mysql label: MySQL dialect: MySQL runtimeMode: native mcpMode: direct singleConnectionPool: false metadataConnectionScoped: true skipTcpProbe: false defaultPort: 3306 traits: diagramSql: true supportLevel: operate字段语义如下字段说明示例取值schemaVersion描述符格式版本当前为 11order稳定展示顺序正数且在有效 driver key 间唯一10、70、710dbType稳定连接类型 IDAPI 序列化使用mysql、mq、jdbcrustVariant生成的 Rust 枚举变体名Mysql、MessageQueue、Jdbc、MongoDb、Mqttlabel展示名称MySQL、Message Queuedialect绑定的 SQL 方言可选MySQLruntimeMode运行模式native原生实现、agent走 Agent、external外部驱动/进程native/agent/externalmcpModeMCP 模式direct直连、bridge桥接、unsupported不支持direct/bridge/unsupportedagentKey绑定的 Agent 键用于 Agent 驱动映射仅 agent 模式mongodb、kafka、rocketmqsingleConnectionPool是否使用单连接池MySQLfalseJDBCtruemetadataConnectionScoped元数据是否按连接作用域管理MySQLtrueMQfalseskipTcpProbe是否跳过 TCP 连通性探测MQtrue非 TCP 服务defaultPort默认端口MySQL3306、MQTT1883、MQ8080traits特性开关如diagramSql、schemaAware见下方说明supportLevel支持级别operate完整运维/browse浏览/connect仅连接operate/browse/connectformKind连接表单种类有限编码值而非任意表单引擎mq、mqtt、jdbc对比几个真实描述符可以看到不同目标差异巨大redis.yamlmcpMode: bridgesupportLevel: connect只开启queryExecution元数据浏览、对象浏览器、表格编辑全部关闭——Redis 是非关系型键值存储能力矩阵与 MySQL 截然不同。mongodb.yamlruntimeMode: agent绑定agentKey: mongodb并在driverStoreVisible: truedriverStoreOrder: 41声明其在驱动商店中的展示顺序。jdbc.yamlruntimeMode: external、singleConnectionPool: true、formKind: jdbctraits开启schemaAware/treeSchema/databaseObjectTree——通用 JDBC 目标能力保守但保留查询、元数据浏览与 SQL 文件执行。2.2 capabilities能力矩阵共享能力模型每个描述符的capabilities字段用布尔值声明该连接类型支持的产品能力。完整能力清单如下综合 mysql.yaml、mq.yaml、redis.yaml 等文件能力键含义MySQLMQRedisJDBCMQTTqueryExecutionSQL/命令查询执行✅❌✅✅❌metadataBrowse元数据浏览✅✅❌✅❌objectBrowser对象浏览器✅✅❌✅❌objectSource对象源码/DDL 查看✅❌❌❌❌schemaSearch模式搜索✅❌❌❌❌diagramER 图✅❌❌❌❌tableDataEdit表格数据编辑✅❌❌❌❌tableStructureEdit表结构编辑✅❌❌❌❌tableImport数据导入✅❌❌❌❌dataTransfer数据传输✅❌❌❌❌sqlFileExecutionSQL 文件执行✅❌❌✅❌databaseCreate数据库创建✅❌❌❌❌fieldLineage字段血缘✅❌❌❌❌sqlExplainSQL 执行计划✅❌❌❌❌userAdmin用户管理✅❌❌❌❌driverManagement驱动管理入口❌✅❌❌❌注意 mq.yaml 的能力矩阵queryExecution: false但metadataBrowse与objectBrowser: true、driverManagement: true——消息队列没有 SQL 查询但有 Topic/队列浏览与驱动管理。这说明能力矩阵不是一刀切而是与产品形态精确对齐。2.3 specializedSurface专用管理面README 给出了明确规则只有产品使用共享能力矩阵无法表达的专用管理界面时才设置specializedSurface: true否则至少启用一项产品能力。MQTT 描述符 正是该规则的实例specializedSurface: true且全部 16 项 capability 均为false。原因是 MQTT 采用完全不同的协议、配置模型与 UI 工作流发布/订阅而非查询它依赖独立的管理界面无法用通用能力矩阵表达。2.4 driverProfiles 与驱动商店排序连接类型可包含多个运行时 profile。README 给出的经典例子是 mq.yamldbType: mq rustVariant: MessageQueue formKind: mq driverProfiles: - profile: kafka label: Apache Kafka agentKey: kafka storeVisible: true storeOrder: 44 - profile: rocketmq label: Apache RocketMQ agentKey: rocketmq storeVisible: true storeOrder: 45 - profile: rabbitmq label: RabbitMQ agentKey: rabbitmq storeVisible: true storeOrder: 46Kafka、RocketMQ、RabbitMQ 共享同一个 DBX 连接模型与管理界面因此是mq类型的三个 profile而 MQTT 由于协议、配置模型和 UI 工作流均不同保持为独立连接类型。字段说明profileprofile 标识与前端 catalog 的id对应agentKey绑定到独立 Agent仓库agents/drivers/下分别有kafka、rocketmq、rabbitmq驱动storeVisible/storeOrder该 profile 是否在驱动商店可见及展示顺序。驱动商店排序另有约定README 强调driverStoreOrder用于描述符的主 Agentprimary AgentstoreOrder用于可见 profile 或被托管的驱动两者必须是正数且在有效 driver key 范围内唯一。MongoDB 描述符中的driverStoreOrder: 41就是主 Agent 排序的实例。三、前端 profile连接选择器如何绑定产品profiles/catalog.yaml 定义前端连接选择器connection picker的产品级 profile。每个 profile 绑定dbType、产品label、图标、默认端口、默认用户与分类。核心字段字段说明示例idprofile 唯一 IDmysql、tidb、kafkadbType绑定的稳定连接类型mysql、mqlabel产品展示名TiDB、Apache Kafkaicon/pickerIcon图标资源名mysql、pulsarport默认端口3306、4000、9092user默认用户名root、postgres、sahost默认主机云端服务常见dynamodb.us-east-1.amazonaws.comurlParams默认 URL 参数authNONE、authnoSaslcategory分类sql/analytics/domestic/document/graph_ai/lightweight/timeseries/mq/registry_configsqlcatalog 充分体现了一个连接类型对应多个产品的复用模式MySQL 家族mysql、mariadb、tidb、oceanbase、tdsql、polardb、greatsql、doris、selectdb、starrocks、dolt、custom_mysql全部绑定dbType: mysql仅默认端口/用户不同TiDB 4000、OceanBase 2883、Doris/StarRocks 9030PostgreSQL 家族postgres、cloudberry、opentenbase、cockroachdb、custom_postgres绑定dbType: postgresMQ 家族mqPulsar、kafka、rocketmq、rabbitmq绑定dbType: mq各有独立图标与默认端口国产数据库dm达梦、kingbase金仓、highgo瀚高、uxdb优炫、yashandb崖山、vastbase海量、goldendb、gbase、sundb、oscar、xugu、kwdb、opengauss、gaussdb等归入domestic分类特殊 profilemongodb-legacy、h2-legacy、etcd-v2、gbase8a/gbase8s、influxdb3、jdbcx等对同一dbType提供旧版本或变体入口。四、代码生成YAML 如何驱动 Rust 与 TypeScript描述符不是运行时被解析的配置而是编译期生成代码的输入。整条链路如下4.1 生成命令与衍生文件README 给出显式命令用于故障排查或手动刷新日常开发无需手动执行pnpm generate:connection-types该命令实际执行node scripts/sync-connection-types.mjs见 package.json校验 YAML 并重写以下衍生文件衍生文件内容crates/dbx-core/assets/database-drivers.manifest.json嵌入式驱动清单apps/desktop/src/types/generated/databaseTypes.ts前端dbType类型列表apps/desktop/src/types/generated/connectionProfiles.ts前端连接 profile 类型这些衍生文件是提交进仓库的产物禁止直接手改——任何改动都会在下次生成时被覆盖。4.2 自动触发生成普通 Vite 开发/构建、前端 typecheck、前端测试会自动重新生成衍生文件Vite 在开发期间会监听描述符目录YAML 变化后自动重新生成README 明确说明package.json中pretypecheck与pretest都声明了pnpm generate:connection-types保证校验前产物最新。4.3 只读校验CI 兜底pnpm check:connection-types # 同校验但不修改文件 pnpm check # 顶层 check自动包含只读校验pnpm check:connection-types执行相同校验但不修改任何文件pnpm check会在 CI 中自动运行该只读检查。这意味着如果仓库中提交的衍生文件过期与 YAML 不一致CI 校验会直接失败——从机制上杜绝改 YAML 忘生成的遗漏。4.4 Rust 侧生成DatabaseType 枚举Cargo 在构建时读取同一份 YAML 描述符。虽然crates/dbx-core下没有build.rs实际生成发生在 crates/dbx-types/build.rs其中调用generate_connection_type_registry读取../../plugins/connection-types目录在构建输出目录生成DatabaseType枚举及其实现pub enum DatabaseTypeimpl DatabaseType。由此可以推断前端与 Rust 两端共享同一份 YAML 事实来源dbType与rustVariant的对应关系保证序列化 API 与类型安全的双重稳定README 中dbType与DatabaseType保留历史名称正是为了这条编译链路上的兼容性约束。五、何时新增连接类型决策准则README 最后给出了清晰的边界判断这是实际开发中最重要的部分大多数情况下只需要一个 catalog 条目 图标即兼容产品 profile。例如 MariaDB、TiDB、Doris、StarRocks 都不需要新代码只需在 profiles/catalog.yaml 中添加 profile 并绑定dbType: mysql。连接类型本身需要新代码当且仅当其以下任一维度与既有实现不同协议protocol认证方式authentication连接字段connection fields元数据提供者metadata provider查询执行器query executorUI 工作流UI workflow三条硬性约束README 原文要点formKind是有限编码的连接表单种类不是任意 YAML 表单引擎——新增表单必须先有对应代码实现协议兼容的产品应绑定既有 dialect复用最近的 connector 或 Agent而不是再引入一套独立实现specializedSurface: true仅当产品使用共享能力矩阵之外的专用管理面时设置否则至少启用一项产品能力。仓库中大量描述符正是这一准则的实践mq.yaml一个类型承载三个消息队列产品mysql.yaml被十几个产品复用而mqtt.yaml因协议/配置/UI 全不同而独立成类型。六、总结DBX 的连接类型注册体系可以概括为一份 YAML三端共享两处生成一份 YAMLplugins/connection-types/*.yaml是连接类型注册的单一事实来源profiles/catalog.yaml负责前端产品绑定三端共享Rust 内核DatabaseType枚举与 manifest、前端databaseTypes.ts/connectionProfiles.ts、Agent/驱动商店agentKey/driverStoreOrder共享同一份描述符语义两处生成pnpm generate:connection-types生成前端类型与 manifest JSONCargo 构建时由 crates/dbx-types/build.rs 生成 Rust 枚举且pnpm check:connection-types保证提交的衍生产物永不失真。对于想要为 DBX 扩展新数据源的开发者正确的路径是先在 plugins/connection-types 下评估现有连接类型是否可复用优先以 catalog profile 图标完成接入只有在协议、认证、连接字段、元数据、查询执行或 UI 工作流确实不同的场景下才新增独立描述符并同时考虑方言绑定plugins/dialects与 Agent/驱动实现agents/drivers。这套先复用、后新建的约束正是 DBX 在保持轻量约 15MB的同时支撑数十种数据源的架构基础。赞分享数据库开发者工具桌面应用CLIMCP 服务AI 应用【免费下载链接】dbx15MB轻量级跨平台数据库客户端、数据库管理工具。支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server 等。15MB, lightweight, cross-platform database client. Supports MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server and more.项目地址https://gitcode.com/t8y2/dbx点击查看免费下载相关推荐DBX 连接类型注册体系详解从 YAML 描述符到三端生成的连接注册链路DBX 连接类型注册体系详解从 YAML 描述符到三端生成的连接注册链路 plugins/connection types/ .yaml 是 DBX 项目连接数据库客户端数据库桌面应用CLI后端MCP 服务AI 应用dbx 桌面端 tauri-plugin-updater 权限体系详解从权限标识符到前端命令的完整链路dbx 桌面端 tauri plugin updater 权限体系详解从权限标识符到前端命令的完整链路 本文以 tauri plugin updater 权限数据库开发者工具桌面应用CLIMCP 服务AI 应用Open SWE 模型、Profile 与指令体系全解从模型注册表到线程快照的完整决策链Open SWE 模型、Profile 与指令体系全解从模型注册表到线程快照的完整决策链 在 Open SWE 中一次 hosted agent 运行的启动人工智能AI Agent代码智能体后端前端桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
