# @dbx-tools/shared-model-gateway 中文文档

规范地址：https://npmcn.com/package/%40dbx-tools/shared-model-gateway/

版本：0\.9\.206
npm 元数据更新时间：2026-11-10T19:21:26.583Z
中文译文更新时间：2026-11-11T17:27:41.157Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dbx-tools/shared-model-gateway
原文对照：https://npmcn.com/package/%40dbx-tools/shared-model-gateway/?lang=original
项目主页：https://github.com/reggie-db/dbx-tools#readme
源码仓库：https://github.com/reggie-db/dbx-tools

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：237 kB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-10-05T22:24:45.680Z
- 最新版本发布：2026-11-10T19:21:26.073Z
- 近 30 天下载量：10003（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：100（近 12 个月 100 个）

## 中文简介

浏览器安全模式-出道计划和模式发现客户端

## 安装

```sh
npm install @dbx-tools/shared-model-gateway
```

也可以使用：`pnpm add @dbx-tools/shared-model-gateway`、`yarn add @dbx-tools/shared-model-gateway`、`bun add @dbx-tools/shared-model-gateway`

## README

# @dbx-tools/shared-model-gateway (英语)

发现由 dbx-tools 模型网关从浏览器、边缘或 共享应用程序代码 。 软件包在 网络边界,并提供不导入节点的取模合同 或 Databricks AppKit 运行时代码.

## 列出可用的模型

```ts
import { createModelGatewayClient } from "@dbx-tools/shared-model-gateway";

const client = createModelGatewayClient();
const response = await client.listModels({ search: "claude sonnet" });
const modelIds = "data" in response ? response.data.map((model) => model.id) : [];
```

目录包括虚拟 `smart-router` 仅当聊天模式 网关被纪念的"Databricks"智能路由器探测器成功. 内容 `capabilities.smart_router` 字段将其与具体终点区分开来. 成功探测器默认在5分钟后到期, 并被刷新 小时在背景。 路由请求失败, 正探测器无效 所以后来的模型列表回复 停止广告虚拟模型.

在浏览器中,客户端使用活性源. 供应 `baseUrl` 在测试中, 服务器渲染, 或任何运行时间 `globalThis.location`数字 :

```ts
const client = createModelGatewayClient({
  baseUrl: "http://127.0.0.1:4000/",
});
```

## 请求编码目录

当客户端需要特定 Codex 的模型元数据时使用 Codex 目录 推理控件 :

```ts
const response = await client.listModels({ codex: true });
```

设定 `metadata: true` 当调用者需要排序时, 任意一个目录形状 耐久性,综合LMArena质量,来源排名,限制和定价. 客户端发送 `GET /v1/models?metadata=true`; 省略选项的请求收到 兼容有效载荷不变.

通过一个 `AbortSignal` 取消模型发现。 HTTP 失败 `ModelGatewayClientError`,其中包含状态代码和已验证的网关 返回时的错误反应 .

## 验证网关有效载荷

使用导出 Zod 计划与另一个 HTTP 传输 :

```ts
import { ModelListResponseSchema } from "@dbx-tools/shared-model-gateway";

const models = ModelListResponseSchema.parse(await response.json());
```

这个 `models` 模块覆盖 OpenAI、Codex、Anthropic、嵌入和出错 载荷。 这个 `contracts` 模块涵盖模型能力和确定性 路由选择输入和结果.

## 配置网关选项

`ModelGatewayOptionsSchema` 定义服务器默认和验证。 来源 `ModelGatewayCliOptionsSchema` 添加 `runtimeInfo` 并需要一个非零端口 前景和服务命令:

```ts
import {
  ModelGatewayOptionsSchema,
  resolveModelGatewayOptions,
} from "@dbx-tools/shared-model-gateway/options";

const options = resolveModelGatewayOptions({
  smartRouter: "auto",
  smartRouterTimeoutMs: 10000,
  listen: "localhost:4400",
  modelClass: "chat-balanced",
  preferSystemModels: true,
  bodyLimit: "100mb",
});

ModelGatewayOptionsSchema.parse(options);
```

`ModelSelectionOptionsSchema` 定义相互排斥 `model` 财务报告和审定财务报表 `modelClass` 模式门道和Genie代码呼叫器共享的字段。 都让开 选择最佳的聊天模式. `preferSystemModels` 默认为 `false`。 。 。 . 启用时使用非精确请求 `system.ai.*` 服务而不是工作空间 服务端点.

这个 `smartRouter` 模块导出 cononial `smart-router` id, 验证 `routes:select` 以及用于观察《公约》 选定具体模式和 `task_v3` 简介.

## 运行时边界

发现客户端执行 HTTP 请求 `GET /v1/models`计划 选项帮助者不会启动网关、解析 Databricks 证书或引用 模特们 使用 [@dbx-tools/appkit-模范出道道](https://npmcn.com/package/node/appkit-model-gateway) 应用程序 网关运输及 [@dbx-工具/型号](https://npmcn.com/package/node/model) 用于服务器侧 模型发现和选择.

## 软件包出口

-   `client`:创建模型发现客户端并输入了HTTP出错.
-   `models`:验证公用模型,嵌入和出错的有效载荷.
-   `contracts`:验证共享的路由和容量值.
-   `options`:验证共享服务器和CLI配置.
-   `smartRouter`:拥有虚拟模型id,有线计和观测头.

## 常见问题

### @dbx-tools/shared-model-gateway 是什么？

浏览器安全模式-出道计划和模式发现客户端

### 如何安装 @dbx-tools/shared-model-gateway？

在项目目录运行 npm install @dbx-tools/shared-model-gateway，或使用 pnpm add / yarn add / bun add。

### @dbx-tools/shared-model-gateway 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dbx-tools/shared-model-gateway 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dbx-tools/shared-model-gateway 可以商用吗？

@dbx-tools/shared-model-gateway 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @dbx-tools/shared-model-gateway 的下载量有多少？

根据 npm 官方下载统计，@dbx-tools/shared-model-gateway 在 2026/10/12 – 2026/11/10 这 30 天内被下载 10,003 次，日均约 333 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dbx-tools/shared-model-gateway 还在维护吗？

最新版本 0\.9\.206 发布于 2026/11/11（今天）；至今共发布 100 个版本，其中过去 12 个月发布了 100 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。