@cornerstonejs/ai

中文文档
5.17.0发布于 2026/11/10MITTypeScriptES Module构建来源已验证近 30 天下载 4.6万

Cornerstone3D 的AI和ML接口

中文使用文档
文档目录5 节
  1. 关键特性
  2. 开始
  3. WASM 文件
  4. 运行示例
  5. 模型文件

角石 AI 客户端软件包

这个软件包提供了AI接口,用于Cornerstone在客户端应用中的应用. 它旨在支持使用ONNX模型,确保服务器侧AI处理与与Cornerstone绑定的客户端特定功能之间的清洁分离.

关键特性

开始

WASM 文件

ONNX跑时Web要求WASM文件在浏览器中运行. 这些文件需要复制到您的应用程序的公共目录中 。 文件应放在 /ort/ 在您的公共文件夹中设置目录 .

在 Webpack 中, 您可以将 WASM 文件添加到这样的公共文件夹 :

new CopyPlugin({
  patterns: [
    {
      from: '../../../node_modules/onnxruntime-web/dist',
      to: '${destPath.replace(/\\/g, '/')}/ort',
    },
  ],
}),

这将从 ONNX Runtime Web 软件包中复制所有必要的 WASM 文件到您的应用程序的公共目录 。 确保您的构建系统配置用于处理 WASM 文件,并确保 asyncWebAssembly 在您的构建配置中启用了实验 .

运行示例

要看到套件与分块任意模式一起运行,请使用以下命令:

yarn run example segmentAnythingClientSide

这将在浏览器中加载 SAM 模型并允许您在图像上执行分区任务 .

模型文件

软件包因尺寸而不包括模型二进制,并给予用户使用自己模型的灵活性. 您可以从以下链接下载预选的模型二进制 :

基型 (vit b) - 178 MB 压缩

大型号 (vit l) - 1.16 GB 压缩

巨型 (vit h) - 2.38 GB 压缩

举例来说,我们正在使用模型url并从网上取出。 如果你看到我们的代码:

模型文件的 URL

const models = {
  sam_b: [
    {
      name: 'sam-b-encoder',
      url: 'https://huggingface.co/schmuell/sam-b-fp16/resolve/main/sam_vit_b_01ec64.encoder-fp16.onnx',
      size: 180,
      key: 'encoder',
    },
    {
      name: 'sam-b-decoder',
      url: 'https://huggingface.co/schmuell/sam-b-fp16/resolve/main/sam_vit_b_01ec64.decoder.onnx',
      size: 17,
      key: 'decoder',
    },
  ],
};

const ai = new ONNXSegmentationController({
  listeners: [mlLogger],
  models,
  modelName: 'sam_b',
});

给模型文件以url.

二进制模型

你可以下载模型文件,通过将其移动到公共文件夹来将其下线.

在 Webpack 中, 您可以将模型文件添加到这样的公共文件夹

new CopyPlugin({
  patterns: [
    {
      from:
        '../../../externals/sam_l',
      to: '${destPath.replace(/\\/g, '/')}/sam_l',
    },
    {
      from:
        '../../../externals/sam_h',
      to: '${destPath.replace(/\\/g, '/')}/sam_h',
    },
  ],
}),

其他建筑系统可能有不同的方法来做到这一点.

版本与发布记录

@cornerstonejs/ai 共发布 558 个版本,首次发布于 2024/12/11;过去 12 个月发布了 214 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
5.17.0latest2026/11/10今天
5.16.02026/11/10今天
5.15.22026/11/047 天前
5.15.12026/11/047 天前
5.15.02026/11/037 天前
5.14.02026/10/2813 天前

其他发布通道:beta → 5.0.0-beta.1。

关于 @cornerstonejs/ai 的常见问题

@cornerstonejs/ai 是什么?

Cornerstone3D 的AI和ML接口

如何安装 @cornerstonejs/ai?

在项目目录运行 npm install @cornerstonejs/ai,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@cornerstonejs/core(5.17.0)、@cornerstonejs/tools(5.17.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cornerstonejs/ai 支持 TypeScript 吗?

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

@cornerstonejs/ai 支持 ESM 还是 CommonJS?

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

@cornerstonejs/ai 可以商用吗?

@cornerstonejs/ai 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cornerstonejs/ai 的下载量有多少?

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

@cornerstonejs/ai 还在维护吗?

最新版本 5.17.0 发布于 2026/11/10(今天);至今共发布 558 个版本,其中过去 12 个月发布了 214 个;首次发布于 2024/12/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。