# @computesdk/gravixlayer 中文文档

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

版本：1\.0\.17
npm 元数据更新时间：2026-11-06T13:39:33.805Z
中文译文更新时间：2026-11-10T14:51:02.207Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：138 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：3 个
- 首次发布：2026-10-02T14:44:44.300Z
- 最新版本发布：2026-11-06T13:39:33.636Z
- 近 30 天下载量：8456（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

GravixLayer 计算SDK 的提供者—— 带有本地文件系统的云运行时间、 实时命令流和快照

## 安装

```sh
npm install @computesdk/gravixlayer
```

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

## README

# @ computesdk/ gravixlayer (帮助)

[重力激光器](https://gravixlayer.ai/) 计算SDK的提供者——云运行时间 带有本地文件系统 API,实时命令流,端口发布,模板, 还有快照.

```bash
npm install @computesdk/gravixlayer
```

要求节点.js 20或更晚.

```ts
import { gravixlayer } from '@computesdk/gravixlayer'

const compute = gravixlayer({
  apiKey: process.env.GRAVIXLAYER_API_KEY,
})

const sandbox = await compute.instances.create({
  templateId: 'base-small',
})
const result = await sandbox.runCommand('node --version')
console.log(result.stdout)
await sandbox.destroy()
```

获取 API 密钥 [https://gravixlayer.ai (英语)](https://gravixlayer.ai/)。脚本 SDK 是 [`gravixlayer`](https://www.npmjs.com/package/gravixlayer); 产品文件为 [https://docs.gravixlayer.ai 页面存档备份,存于互联网档案馆](https://docs.gravixlayer.ai/)。 。 。 .

## 配置

| 选项 | 环境变量 | 说明 |
| --- | --- | --- |
| `apiKey` | `GRAVIXLAYER_API_KEY` | GravixLayer API 密钥(必需). |
| `baseUrl` | `GRAVIXLAYER_BASE_URL` | API来源. 默认为 `https://api.gravixlayer.ai`。 。 。 . |
| `cloud` | `GRAVIXLAYER_CLOUD` | 云为运行时间和模板放置. 默认为 `aws`。 。 。 . |
| `region` | `GRAVIXLAYER_REGION` | 运行时间和模板设置区域。 默认为 `us-east-1`。 。 。 . |
| `timeout` | —— 说 | 请求超时, 以毫秒计 . |
| `maxRetries` | —— 说 | 重新计算预算。 默认为 `0`。 。 。 . |
| `http2` | —— 说 | 使用 HTTP 2. 默认为 `true`。 。 。 . |

`create` 带 `templateId` (现有模板),或 `snapshotId`附加时 `envs`, (中文(简体) ), `timeout`, (中文(简体) ), `metadata`, (中文(简体) ), `cloud`,以及 `region`. 弃权 `templateId` 靴子 `base-small`. 弃权 `cloud` 财务报告和审定财务报表 `region` 用途 `aws` 财务报告和审定财务报表 `us-east-1`。 。 。 . 大小来自模板. `image` 不被接受:从 一个图像带有 `template.create({ name, fromImage })`,然后通过名称为 `templateId`。 。 。 . `sandbox.getInstance()` 返回 GravixLayer 键 `Runtime` 用于文件系统、服务和其他SDK API的控件.

抓图需要 `name` 打开 `snapshot.create` 默认为 `hot` (文件系统和内存,所以 `/tmp` 恢复); 通过 `metadata: { kind: 'cold' }` 仅用于文件系统快照。 模板构建需要 `fromImage` 或者说 `dockerfile` 打开 `template.create`; 选择已有模板 与 `templateId` 当创建沙盒时.

## 常见问题

### @computesdk/gravixlayer 是什么？

GravixLayer 计算SDK 的提供者—— 带有本地文件系统的云运行时间、 实时命令流和快照

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

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

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

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

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

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

### @computesdk/gravixlayer 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

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

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

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

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

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

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