# @computesdk/namespace 中文文档

规范地址：https://npmcn.com/package/%40computesdk/namespace/

版本：1\.6\.41
npm 元数据更新时间：2026-11-06T13:39:46.043Z
中文译文更新时间：2026-11-10T14:24:29.530Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40computesdk/namespace
原文对照：https://npmcn.com/package/%40computesdk/namespace/?lang=original
项目主页：https://www.computesdk.com/
源码仓库：https://github.com/computesdk/computesdk

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

- 包体积（解压后）：245 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2025-12-05T18:36:42.610Z
- 最新版本发布：2026-11-06T13:39:45.611Z
- 近 30 天下载量：11094（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：82（近 12 个月 82 个）

## 中文简介

用于计算SDK的命名空间提供者 - 有可选 GPU 支持的云- 内置沙盒

## 安装

```sh
npm install @computesdk/namespace
```

也可以使用：`pnpm add @computesdk/namespace`、`yarn add @computesdk/namespace`、`bun add @computesdk/namespace`

## README

# @ computesdk/ 命名空间

用于计算SDK的命名空间提供商,它能够在“命名空间”的基础设施上创建和管理集装箱化的沙盒.

## 安装

```bash
npm install @computesdk/namespace
```

## 配置

命名空间提供者需要以下环境变量:

```bash
NSC_TOKEN=your_namespace_token
```

## 使用量

```typescript
import { namespace } from '@computesdk/namespace';

const compute = namespace({
  token: 'your_token'
});

// Create a sandbox
const sandbox = await compute.instances.create();
console.log(`Created sandbox: ${sandbox.instanceId}`);

// List all sandboxes
const sandboxes = await compute.instances.list();

// Destroy the sandbox
await sandbox.destroy();
```

### 通过命名空间 API 字段

`create()` 接受原始名称空间 API 字段,将 as-is (snake case) 合并到请求中. `containerOptions` 进入容器的 [`ContainerRequest`](https://buf.build/namespace/cloud/docs/main:namespace.cloud.compute.v1beta#namespace.cloud.compute.v1beta.ContainerRequest),以及 `instanceOptions` 输入 [`CreateInstanceRequest`](https://buf.build/namespace/cloud/docs/main:namespace.cloud.compute.v1beta#namespace.cloud.compute.v1beta.CreateInstanceRequest)字段,提供方自行设置(形状、期限、容器名称/args/env)优先,图像总是由 `image` (单位:千美元)`image_ref`编号 :`known_image_id` 内 `containerOptions` ) (中文(简体).

```typescript
// Inject the instance's workload token into the container at /var/run/nsc
const sandbox = await compute.instances.create({
  containerOptions: { nsc_state_path: '/var/run/nsc' },
});
```

## 目前已执行

### 沙盒操作

-   **创建()** - 创建一个新命名空间计算实例,并配置容器
-   **获取ById ()** - 通过ID获取特定的命名空间实例
-   **列表( )** - 列出账户中的所有命名空间实例
-   **销毁()** - 删除命名空间实例

### 配置选项

-   **符号** - 命名空间 API 认证符

## 页:1

-   创建时自动部署实例
-   自动生成实例名称
-   所有操作都使用“命名空间”的计算 API
-   环境变量优先于配置选项
-   销毁时立即删除实例( 不延迟删除)

## 标准尺寸(当地发现)

`provider.sizes.list()` 编号 : `resolve('sm', context?)` 声明准确 `sm`, (中文(简体) ), `md`, (中文(简体) ), `lg`, (中文(简体) ), 财务报告和审定财务报表 `xl` CPU/RAM 请求 **仅 Linux amd64**。 。 。 . `create({ sizeClass: 'sm' })` 请求 `instanceOptions.shape.virtual_cpu: 1` 财务报告和审定财务报表 `memory_megabytes: 2048`。 。 。 . 每个创建标准请求在保存时覆盖工厂 CPU/RAM 默认 其他实例选项。 将它们与明确的本地 CPU/RAM 字段结合是一种 错误, 即使数字匹配 。 非Linux/未经核实的建筑和 `xs`编号 :`2xl` 保留 `unknown`传统原生外形覆盖不变.

这些是根据Linux机器形状记录的适配器声明的请求 分类,不检查账户/区域提供情况或观察到的资源。 发现 从未读取符号文件或调用“命名空间” 。 成功的标准化创造曝光 冻结 `instance.sizing` 请求元数据.

单位边界: [正式命名空间类型SDK 计算示例](https://namespace.so/docs/reference/typescript-sdk/compute/index.md) 明确描述 4 GiB 使用 `memoryMegabytes: 4 * 1024`因此 解析器向相应的本地发送无变化的 Canonic MiB 数字 `memory_megabytes` 字段 (2048/4096/8192/16384); 小数- MB 转换为 执行。 这是记录在案的请求单位证据,而不是衡量 仅取自机器形状的“GB”标签。 工厂 CPU/RAM 值被默认值所覆盖 `sizeClass`; 明确的每个创建 CPU/RAM选择器,包括模棱两可的别名,则被否决.

标准平台上下文必须使用可假设的数据属性; 存在 `os`编号 :`machine_arch` 选择器必须是字符串,而不是空/未定义。 决心 补丁明确将已验证的 Linux/amd64 平台带入原生平台 请求,所以工厂默认值不能与已宣布的映射相偏离。 遗产 不创建 `sizeClass` 保留他们最初的描述行为.

## 常见问题

### @computesdk/namespace 是什么？

用于计算SDK的命名空间提供者 - 有可选 GPU 支持的云- 内置沙盒

### 如何安装 @computesdk/namespace？

在项目目录运行 npm install @computesdk/namespace，或使用 pnpm add / yarn add / bun add。

### @computesdk/namespace 支持 TypeScript 吗？

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

### @computesdk/namespace 支持 ESM 还是 CommonJS？

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

### @computesdk/namespace 可以商用吗？

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

### @computesdk/namespace 的下载量有多少？

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

### @computesdk/namespace 还在维护吗？

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