# @computesdk/sandbox0 中文文档

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

版本：1\.0\.23
npm 元数据更新时间：2026-11-06T16:50:22.296Z
中文译文更新时间：2026-11-10T14:27:41.516Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：5 MB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-07-28T13:08:46.270Z
- 最新版本发布：2026-11-06T16:50:21.983Z
- 近 30 天下载量：9839（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

计算SDK的 Sandbox0 提供者 - 有命令执行和本地文件系统访问功能的快速持久沙盒

## 安装

```sh
npm install @computesdk/sandbox0
```

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

## README

# @computesdk/ sandbox0 (英语)

[沙盒 0](https://sandbox0.ai/) 计算SDK的提供者。 通过官方Sandbox0 JavaScript SDK创建快速持久沙盒,运行 shell命令,并使用本地文件系统操作.

## 安装

```bash
npm install computesdk @computesdk/sandbox0
```

## 设置

创建团队 API 密钥并导出 :

```bash
export SANDBOX0_TOKEN=your_sandbox0_token
```

`SANDBOX0_BASE_URL` 是可选的, 并默认为公共 Sandbox0 API `https://api.sandbox0.ai`对于团队的自动化工作量,设定为团队的 因此,请求直接进入区域网关.

交互访问令牌也可以通过设置两者来使用 `SANDBOX0_TOKEN` 财务报告和审定财务报表 `SANDBOX0_TEAM_ID`。 。 。 .

## 使用量

```typescript
import { compute } from 'computesdk';
import { sandbox0 } from '@computesdk/sandbox0';

compute.setConfig({
  provider: sandbox0({
    token: process.env.SANDBOX0_TOKEN,
    hardTtl: 600,
  }),
});

const sandbox = await compute.instances.create({
  templateId: 'coding-agent',
  memory: 256,
});

const result = await sandbox.runCommand('node --version');
console.log(result.stdout);

await sandbox.filesystem.writeFile('/tmp/hello.txt', 'Hello from Sandbox0');
console.log(await sandbox.filesystem.readFile('/tmp/hello.txt'));

await sandbox.destroy();
```

## 配置

| 选项 | 环境变量 | 默认 | 说明 |
| --- | --- | --- | --- |
| `token` | `SANDBOX0_TOKEN` 或者说 `SANDBOX0_API_KEY` | 所需经费 | Team API 密钥, 或当 `teamId` 设定 |
| `teamId` | `SANDBOX0_TEAM_ID` | 无 | 需要小组身份证明,并有访问脚本认证 |
| `baseUrl` | `SANDBOX0_BASE_URL` | SDK 默认 | Sandbox0 API 端点 |
| `templateId` | `SANDBOX0_TEMPLATE` | `coding-agent` | 新沙盒使用的模板 |
| `ttl` | \- 说吧 | 平台默认 | 以秒计的软运行 TTL |
| `hardTtl` | \- 说吧 | 平台默认 | 硬沙盒 TTL 数秒 |
| `memory` | \- 说吧 | 模板默认 | 包含在 MiB 或数量中 `1Gi` |
| `envs` | \- 说吧 | 无 | 默认环境变量 |
| `commandTimeout` | \- 说吧 | 无 | 以毫秒计的默认命令超时 |

每个创建 `templateId`, (中文(简体) ), `snapshotId`, (中文(简体) ), `memory`, (中文(简体) ), `envs`, (中文(简体) ), `ttl`, (中文(简体) ), `hardTtl`,以及 `autoResume` 选项在适用的情况下推翻提供者的默认。 数字内存值被解释为MiB.

## 特性支持

| 特性 | 支助 |
| --- | --- |
| 创建/ 获取ById / 列表/ 销毁 | 对 |
| 贝壳命令 | 是的,通过 `sh -lc` |
| 命令 `cwd`、环境、超时和背景模式 | 对 |
| 文件系统 | 是的,通过 Sandbox0 的本地文件 API |
| 公开 URL | 是的,对于已经配置在沙盒上的公共服务 |
| 从快照恢复 | 是的,还有 `snapshotId` 创建时间 |
| 快照管理 | 使用本地的 Sandbox0 SDK |

前景 `runCommand` 调用同步启动 Sandbox0 背景, 遵循 其WebSocket终端事件,并从上下文 API 读取最终结果. 如果 WebSocket 断开, 提供者会计算背景直到退出. 命令 `timeout` 也作为上下文 TTL 和超时调用 尝试删除上下文.

`destroy` 重复短命的节奏或服务器故障。 设置 `hardTtl` 仍然建议自动工作量,所以失败的客户端不能无限期地离开沙盒.

用于Sandbox0特定能力,如暂停/恢复、服务、快照、卷和可观察性、调用 `sandbox.getInstance()` 接触当地人 `sandbox0` SDK手柄.

## 许可证

麻省理工学院

## 常见问题

### @computesdk/sandbox0 是什么？

计算SDK的 Sandbox0 提供者 - 有命令执行和本地文件系统访问功能的快速持久沙盒

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

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

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

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

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

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

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

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

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

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

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

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