# @fnndsc/cumin 中文文档

规范地址：https://npmcn.com/package/%40fnndsc/cumin/

版本：3\.30\.6
npm 元数据更新时间：2026-11-15T01:15:01.072Z
中文译文更新时间：2026-11-15T03:34:51.885Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fnndsc/cumin
原文对照：https://npmcn.com/package/%40fnndsc/cumin/?lang=original
项目主页：https://github.com/HARBOR-Medical-AI/mise/tree/main/packages/cumin#readme
源码仓库：https://github.com/HARBOR-Medical-AI/mise

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

- 包体积（解压后）：1.1 MB，186 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-06-20T08:20:21.600Z
- 最新版本发布：2026-11-15T01:15:00.891Z
- 近 30 天下载量：7703（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

ChILI 和其他与 ChRIS 相关的 JavaScript 应用程序的工具库

## 安装

```sh
npm install @fnndsc/cumin
```

也可以使用：`pnpm add @fnndsc/cumin`、`yarn add @fnndsc/cumin`、`bun add @fnndsc/cumin`

## README

```
  ____                _
 / ___|   _ ___  ____(_)_ __
| |  | | | | '_ \| '_ \| '_ \
| |__| |_| | | | | | | | | | |
 \____\__,_|_| |_|_| |_|_| |_|
```

**Cumin 基本管理基础设施需求**

`cumin` 是ChrIS界面生态系统的基础设施和状态管理层. 它是一个后端库,处理连接到ChRIS,管理认证符和持续用户会话的"脏活".

## 安装

```bash
npm install @fnndsc/cumin
```

要求节点.js 20.12. 有"类型"(TypeScript)类型定义的船舶.

## 使用量

```typescript
import { ChRISConnection, ChrisContext, ChrisIO } from "@fnndsc/cumin";

// The context engine remembers the active user, CUBE URL, and working directory
const context = new ChrisContext();
await context.init();
const cubeURL: string | null = await context.ChRISURL_get();
```

见 [核心特征](https://npmcn.com/package/%40fnndsc/cumin/#readme-core-features) 对于完整的API表面.

## 摘要

`cumin` 将 Chris REST API 集成到一个状态好、面向对象的环境。 它负责:

1.  **连接管理**:处理认证,令牌存储,以及客户端初始化.
2.  **背景持久性**: 执行"Context"引擎,该引擎会记住活跃的用户,CUBE URL,以及工作目录.
3.  **IO 存储( S)**:提供抽象(`IStorageProvider`)用于文件系统访问,允许支持两个节点.js(通过 `fs`其他环境.

## 在生态系统中的作用

在"桑德威克模型"建筑中, `cumin` 是下层(正上方的原始 API 客户端).

-   **消费者**: 首先是 [`salsa`](https://github.com/FNNDSC/salsa) (语法)和 [`chili`](https://github.com/FNNDSC/chili) (CLI状态).
-   **环境**:为Node.js所设计,但设计有支持浏览器环境的接口.

## 核心特征

-   **`ChrisContext`**:用于多租户,多后端会话的状态机.
-   **`ChRISConnection`**: 为低等API客户端所打包.
-   **`IStorageProvider`**: 用于读取/写入配置和数据的抽象接口.
    -   包括 `readBinary` 用于二进制文件上传.
    -   包括递归目录倒转帮助.
-   **`ChrisIO`**: 高级IO操作,包括递归目录上传(`uploadLocalPath`) (中文(简体) ).
-   **`ChRISResource.resources_getAll()`**:普通帕吉能处理器.
-   **`ListCache`** (单位:千美元)`listCache_get()`:会话范围目录列出VFS的缓存.
-   **`ProcCache`** (单位:千美元)`procCache_get()`: 会话范围的工作监测 DAG 有版本,身份范围守护进程检查站. 在CUBE对账运行期间,恢复的地貌仍然可用;终端状态持续存在,正在读取状态更新。 权力 `/proc/jobs/` VFS供应商在萨尔萨.

## 开发者设置

为了建造 `cumin` 来自源代码的库 :

1.  **安装依赖性 :**
    
    ```bash
    npm install
    ```
    
2.  **编译 :**
    
    ```bash
    npm run build
    ```
    

## 许可证

麻省理工学院—— [Chris项目](https://chrisproject.org/)。 。 。 .

* * *

_\- 30岁_

## 常见问题

### @fnndsc/cumin 是什么？

ChILI 和其他与 ChRIS 相关的 JavaScript 应用程序的工具库

### 如何安装 @fnndsc/cumin？

在项目目录运行 npm install @fnndsc/cumin，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cumin，可以用 npx cumin 直接运行。

### @fnndsc/cumin 支持 TypeScript 吗？

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

### @fnndsc/cumin 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @fnndsc/cumin 可以商用吗？

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

### @fnndsc/cumin 的下载量有多少？

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

### @fnndsc/cumin 还在维护吗？

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