@dbx-tools/shared-model

中文文档
0.9.206发布于 2026/11/11Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 1.3万

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

中文使用文档
文档目录6 节
  1. 格式化模型显示名称
  2. 验证模式搜索请求
  3. 使用分类端点目录
  4. Databricks 拒绝的剥离字段
  5. 运行时边界
  6. 软件包出口

@dbx-工具/共享型号

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

格式化模型显示名称

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 完成信息和工具呼叫合同.

验证模式搜索请求

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

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

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

使用分类端点目录

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 拒绝的剥离字段

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

const dropped = openaiChat.stripUnsupportedChatFields(body);

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

运行时边界

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

软件包出口

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

版本与发布记录

@dbx-tools/shared-model 共发布 364 个版本,首次发布于 2026/07/17;过去 12 个月发布了 364 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.206latest2026/11/11今天
0.9.2052026/11/111 天前
0.9.2042026/11/101 天前
0.9.2032026/11/074 天前
0.9.2022026/11/065 天前
0.9.2012026/11/056 天前

关于 @dbx-tools/shared-model 的常见问题

@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 和提交记录判断。