@computesdk/gravixlayer

中文文档
1.0.17发布于 2026/11/06MITTypeScriptESM + CJS近 30 天下载 8456

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

中文使用文档

@ computesdk/ gravixlayer (帮助)

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

npm install @computesdk/gravixlayer

要求节点.js 20或更晚.

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 (英语)。脚本 SDK 是 gravixlayer; 产品文件为 https://docs.gravixlayer.ai 页面存档备份,存于互联网档案馆。 。 。 .

配置

选项环境变量说明
apiKeyGRAVIXLAYER_API_KEYGravixLayer API 密钥(必需).
baseUrlGRAVIXLAYER_BASE_URLAPI来源. 默认为 https://api.gravixlayer.ai。 。 。 .
cloudGRAVIXLAYER_CLOUD云为运行时间和模板放置. 默认为 aws。 。 。 .
regionGRAVIXLAYER_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 共发布 17 个版本,首次发布于 2026/10/02;过去 12 个月发布了 17 个版本。

版本发布日期距今
1.0.17latest2026/11/064 天前
1.0.162026/11/046 天前
1.0.152026/10/2813 天前
1.0.142026/10/2318 天前
1.0.132026/10/2318 天前
1.0.122026/10/2219 天前

关于 @computesdk/gravixlayer 的常见问题

@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 和提交记录判断。