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

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

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

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

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

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

- 包体积（解压后）：178 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-07-17T15:27:54.879Z
- 最新版本发布：2026-11-10T19:18:17.327Z
- 近 30 天下载量：12802（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：364（近 12 个月 364 个）

## 中文简介

浏览器安全模式选择合同和分类器

## 安装

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

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

## README

# @dbx-工具/共享型号

在UI、路由、工具以及 测试不导入 Databricks 客户端。 使用浏览器安全模式 选择、能力、推理和OpenAI 聊天完成合同 客户端和服务器边界. 服务器端的正常化、分类、排名和模糊分辨率 [@dbx-工具/型号](https://npmcn.com/package/node/model)。 。 。 .

## 格式化模型显示名称

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

display.toModelDisplayName("databricks-claude-sonnet-4-6"); // "Claude Sonnet 4.6"
display.toModelDisplayName("system.ai.bge_large_en"); // "BGE Large En"
display.toModelDisplayName("x", "Claude 4.6 (Preview)"); // provided name wins
```

`ServingEndpointSummary.displayName` 是此选项的友好标签 拣取者. `name` 保留引用的ID。 Databricks 提供的名胜 。 否则, 纯助推字条引导销售商前缀和标题大小写通过 `@dbx-tools/shared-core`说明器.

软件包还包括生成 `ModelClass`,结束点,查询,状态, 配置、排名和推理-努力合同,加上浏览器安全 OpenAI Chat 完成信息和工具呼叫合同.

## 验证模式搜索请求

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

const query = model.ModelQuerySchema.parse({
  search: "claude sonnet",
  modelClass: "chat-balanced",
  requiresTools: true,
  limit: 5,
});
```

使用 `model.ModelQuerySchema` 用于路由查询/机构验证和代理工具 投入。 它保留客户端模型拾取器和后端解析端点 相同的请求形状.

## 使用分类端点目录

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

const fast = endpoints.filter((endpoint) => endpoint.class === model.ModelClass.ChatFast);
const agentModels = endpoints.filter((endpoint) => endpoint.supportsTools);
```

返回前的服务器邮票类和能力字段 `/models`。 。 。 . 浏览器客户端直接消耗这些字段 。 示范家庭政策没有执行 在浏览器中.

## Databricks 拒绝的剥离字段

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

const dropped = openaiChat.stripUnsupportedChatFields(body);
```

Databricks Model Service 验证恰克完成机构严格. `stripUnsupportedChatFields` 删除已知的不支持字段,并 返回已删除的名称,以便调用者记录差异.

## 运行时边界

此软件包不会发现端点、 读取证书、 排序模型或发送 模式服务请求。 使用 [@dbx-工具/型号](https://npmcn.com/package/node/model) 页:1 服务器侧模型的发现和选择。 使用 [@dbx-tools/shared-model-gateway (英语)](https://npmcn.com/package/%40dbx-tools/model-gateway) 用于浏览器安全模型 网关响应和发现客户端.

## 软件包出口

-   `model`:示范课,推理-努力计划,终点摘要,取景 请求,并排序结果.
-   `display`:人可读取的端点标签.
-   `openaiChat`:聊天补全消息和工具调用类型,内容助手, 和拒绝的疗养.

## 常见问题

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

浏览器安全模式选择合同和分类器

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

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

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

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

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

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

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

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

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

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

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

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