docs: fix locale parity gaps and JRE package naming

This commit is contained in:
dienaso
2026-09-22 16:50:10 +08:00
committed by GitHub
parent 05d3bd0635
commit 15bcf543fa
4 changed files with 16 additions and 2 deletions
+2
View File
@@ -7,6 +7,8 @@ description: 使用原生 DBX CLI 在终端、脚本、CI 和 Codex 中读取连
## 安装
### npm
```bash
npm install -g @dbx-app/cli
```
+7 -1
View File
@@ -85,7 +85,7 @@ RabbitMQ 等消息队列 Agent 还可能同时使用业务协议和管理 API。
所有 Agent 都提供单驱动 ZIP,可直接使用**导入离线包**安装。Java Agent 的单驱动包跨平台,但不重复携带 JRE;KingbaseES、Oracle、Xugu 等原生 Agent 的单驱动包按操作系统和 CPU 架构区分。
如果目标机器尚未安装 Java Agent 所需的托管 JRE,可在**导入离线包**中选择对应平台的 `dbx-jre-21-<platform>.tar.zst`,或者直接使用包含全部驱动和 JRE 的完整离线 ZIP 包。独立 JRE 包仅包含 Java 运行时,不包含数据库驱动,也不需要 `agent-registry.json`。DBX 会验证 Java 的操作系统和 CPU 架构后安装到托管 JRE 目录。
如果目标机器尚未安装 Java Agent 所需的托管 JRE,可在**导入离线包**中选择对应平台的 `dbx-jre-<jre-key>-<platform>.tar.zst`(例如 `dbx-jre-21-macos-aarch64.tar.zst`),或者直接使用包含全部驱动和 JRE 的完整离线 ZIP 包。独立 JRE 包仅包含 Java 运行时,不包含数据库驱动,也不需要 `agent-registry.json`。DBX 会验证 Java 的操作系统和 CPU 架构后安装到托管 JRE 目录。
### Windows 导入 KingbaseES
@@ -93,6 +93,12 @@ Windows x64 下载 `dbx-agent-kingbase-<version>-windows-x64.zip`,Windows ARM6
ZIP 内包含版本信息和对应平台的原生 Agent。DBX 会将其安装为 `%USERPROFILE%\.dbx\agents\drivers\kingbase\agent.exe`,不需要手动解除浏览器下载文件的阻止状态或复制文件。
### 离线导入 JDBC 插件
通用 JDBC 连接(自定义 JDBC URL + 导入的驱动 JAR)通过独立的 **DBX JDBC 插件** 运行,发布为单独的 `dbx-jdbc-plugin-*.zip` 资源,**不会**打进各数据库的 Agent ZIP。请在 **JDBC 驱动** 页签使用 **本地安装** 安装它(不要用内置驱动里的**导入离线包**,那是给 Agent ZIP 用的)。
导入真正的驱动 JAR(例如 Oracle 的 `ojdbc*.jar`)始终是本地操作,不需要这个插件包,也不需要网络——在同一页签使用 **导入 JAR**,无论 JDBC 插件本身是否已安装。
## 插件更新
对于由 [JDBC 插件](/cn/docs/plugins)支持的数据库,当有新插件版本可用时,DBX 会显示更新通知。插件更新遵循与内置 Agent 驱动相同的安装流程。
+1 -1
View File
@@ -85,7 +85,7 @@ This is useful for air-gapped networks, strict firewall environments, or pre-app
Every agent provides a single-driver ZIP that can be installed with **Import offline package**. Java agent packages are platform-independent and do not duplicate the JRE, while native agents such as KingbaseES, Oracle, and Xugu provide separate packages for each OS and CPU architecture.
If the target machine does not already have the managed JRE required by a Java agent, use **Import offline package** to select the matching platform's `dbx-jre-<version>-<platform>.tar.zst`, or use the full offline bundle containing every driver and the JRE. Standalone JRE packages do not require `agent-registry.json`; DBX validates the Java executable's operating system and CPU architecture before installation.
If the target machine does not already have the managed JRE required by a Java agent, use **Import offline package** to select the matching platform's `dbx-jre-<jre-key>-<platform>.tar.zst` (for example `dbx-jre-21-macos-aarch64.tar.zst`), or use the full offline bundle containing every driver and the JRE. Standalone JRE packages do not require `agent-registry.json`; DBX validates the Java executable's operating system and CPU architecture before installation.
### Importing KingbaseES on Windows
+6
View File
@@ -59,6 +59,12 @@ This guide gets you through three things:
flatpak update com.dbxio.dbx
```
On Kylin V10, UnionTech UOS, and similar Chinese desktop distributions, install from the [Spark App Store](https://spk-resolv.spark-app.store/?spk=spk://store/development/dbx) and choose the **APM build**. AmberPM provides a compatible runtime that reduces install/startup failures caused by distro dependency drift; updates are also available from the Spark App Store client.
<Callout type="warn">
The APM build runs DBX inside that compatibility runtime. If you select the host Java for Agent/JDBC drivers, prefix the path with `/host` — enter `/host/usr/bin/java` instead of `/usr/bin/java`.
</Callout>
You can also download a package from [GitHub Releases](https://github.com/t8y2/dbx/releases):
| Format | Use Case |