# @cornerstonejs/ai 中文文档

规范地址：https://npmcn.com/package/%40cornerstonejs/ai/

版本：5\.17\.1
npm 元数据更新时间：2026-11-10T20:22:30.298Z
中文译文更新时间：2026-11-10T19:28:28.833Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cornerstonejs/ai
原文对照：https://npmcn.com/package/%40cornerstonejs/ai/?lang=original
项目主页：https://github.com/cornerstonejs/cornerstone3D/blob/main/packages/ai/README.md
源码仓库：https://github.com/cornerstonejs/cornerstone3D

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

- 包体积（解压后）：71.4 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：8 个
- peer 依赖：@cornerstonejs/core 5\.17\.1，@cornerstonejs/tools 5\.17\.1
- 首次发布：2024-12-11T15:43:20.378Z
- 最新版本发布：2026-11-10T20:22:29.968Z
- 近 30 天下载量：46488（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：559（近 12 个月 214 个）

## 中文简介

Cornerstone3D 的AI和ML接口

## 安装

```sh
npm install @cornerstonejs/ai
```

也可以使用：`pnpm add @cornerstonejs/ai`、`yarn add @cornerstonejs/ai`、`bun add @cornerstonejs/ai`

## README

# 角石 AI 客户端软件包

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

## 关键特性

-   **ONNX 运行时网络集成**:软件包可以使ONNX Runtime Web库发挥杠杆作用,使得AI模型可以在浏览器中直接运行而无需依赖服务器侧执行.
-   **初始型号 - 分段任意型号( SAM)**: 我们第一个支持的模型是分块任意模式(SAM) [https://segment-anything.com/ 互联网档案馆的存檔,存档日期2013-12-21](https://segment-anything.com/),用于分割任务.

## 开始

### WASM 文件

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

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

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

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

### 运行示例

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

```bash
yarn run example segmentAnythingClientSide
```

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

### 模型文件

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

基型 (vit b) - 178 MB 压缩

-   [https://ohif-assets-new.s3.us-east-1.amazonaws.com/SAM/sam b.zip 互联网档案馆的存檔,存档日期2013-12-1](https://ohif-assets-new.s3.us-east-1.amazonaws.com/SAM/sam_b.zip)

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

-   [https://ohif-assets-new.s3.us-east-1.amazonaws.com/SAM/sam l.zip (中文(简体) )](https://ohif-assets-new.s3.us-east-1.amazonaws.com/SAM/sam_l.zip)

巨型 (vit h) - 2.38 GB 压缩

-   [https://ohif-assets-new.s3.us-east-1.amazonaws.com/SAM/sam h.zip 互联网档案馆的存檔,存档日期2014-12-11](https://ohif-assets-new.s3.us-east-1.amazonaws.com/SAM/sam_h.zip)

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

#### 模型文件的 URL

```js
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 中, 您可以将模型文件添加到这样的公共文件夹

```js
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 是什么？

Cornerstone3D 的AI和ML接口

### 如何安装 @cornerstonejs/ai？

在项目目录运行 npm install @cornerstonejs/ai，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@cornerstonejs/core（5\.17\.1）、@cornerstonejs/tools（5\.17\.1）。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\.1 发布于 2026/11/11（今天）；至今共发布 559 个版本，其中过去 12 个月发布了 214 个；首次发布于 2024/12/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。