# @gea-ai/computer-e2b 中文文档

规范地址：https://npmcn.com/package/%40gea-ai/computer-e2b/

版本：0\.1\.261111-alpha\.1
npm 元数据更新时间：2026-11-12T06:00:52.903Z
中文译文更新时间：2026-11-16T01:28:08.622Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40gea-ai/computer-e2b
原文对照：https://npmcn.com/package/%40gea-ai/computer-e2b/?lang=original
项目主页：https://musegea.com/developers
源码仓库：https://github.com/bmrlab/gea

弃用说明：This package is deprecated and will no longer receive updates\.

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

- 包体积（解压后）：16.6 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-09-08T11:27:33.335Z
- 最新版本发布：2026-11-12T02:24:45.092Z
- 近 30 天下载量：3682（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：73（近 12 个月 73 个）

## 中文简介

E2B 用于 GEA 工人本地装订的计算机声明

## 安装

```sh
npm install @gea-ai/computer-e2b
```

也可以使用：`pnpm add @gea-ai/computer-e2b`、`yarn add @gea-ai/computer-e2b`、`bun add @gea-ai/computer-e2b`

## README

# GEA E2B 计算机

工厂在开发商代码中选择了E2B. 现有工人 `COMPUTER` 本地语言 绑定直接连接到E2B的API和envd. 没有额外的 GEA 服务或 Pod 需要; API 密钥和 envd 证书仍在代理 JavaScript 之外.

```ts
import { defineAgent } from "@gea-ai/agent-sdk";
import { secret } from "@gea-ai/agent-sdk/computer";
import { e2b } from "@gea-ai/computer-e2b";

export default defineAgent({
  name: "E2B Agent",
  slug: "e2b-agent",
  model: "gea-model-1",
  computer: e2b({
    apiKey: secret("E2B_API_KEY"),
    template: "base",
    timeoutMs: 300_000,
    filesystem: { durability: "ephemeral", files: { "hello.txt": "Hello" } },
    async onSession({ use }) {
      const computer = await use();
      const result = await computer.exec({ command: "python --version" });
      if (result.exitCode !== 0) throw new Error("Python is required");
    },
  }),
});
```

在 Studio 或本地的 CLI 环境中设置引用的环境密钥 . 别在特工中公开这个秘密 `environment` 除非代理代码 它本身需要它。 一揽子计划载有宣言;本土执行 船与工人运行时间,没有 `/host` 进入点.

每次引用都会得到一个麻风沙盒. 种子和只读技能 `onSession`。关闭引用会释放沙盒;配置的 E2B 生命范围在崩溃或网络故障后进行清理。 文件无法幸存 引用,工人重启或沙盒过期. 保留文件时使用Artiffacts . 未知的创造或突变结果在引用中永远不会被重播.

模板需要 Linux shash, Python 3, creautils `timeout`, (中文(简体) ), `useradd`,则 无特权 `gea-agent` 没有密码的用户 。 技能是根属的. 命令有120秒的最后期限和2个 MiB 输出限制;取消终止 过程组,包括后人。 这个 `base` 模板正在测试.

公共流/二进制/文本和目录方法使用与 命令。 缓冲读取限制为16个 MiB。 Stream 写作使用四个边框 每个文件上传槽和最多10个GiB,在嵌入器前在工人磁盘上运行 上传和原子出版 沙盒内部。 没有部分目的地 在一个失败的来源上发布。 私人集散地和目的地必须共享 相同的 sandbox 文件系统; 父解析拒绝同义链接 .

Artifact copy使用已存在的单文件票和8 MiB多段协议. 对象存储 URL 仍为原生 。 在工作盘上测量并散列下载 发布到 E2B 之前; 上传已读入的源流并检查源身份 在完成艺术之前。 没有独立的传输服务或目录 引入了同步.

从此寄存器, 设置 `E2B_API_KEY` 在测试过程中运行:

```sh
pnpm --dir packages/computer-e2b test:live
```

这次选入测试创造了一个付费的沙盒 并验证了创建,种子,20个米B 二进制 I/O,只读技能,突变收据,后人取消和 确认删除。 它被排除在默认测试套件之外。 其他模板, npm的出版和制作部署仍然是单独的核查步骤.

见 [E2B 生命周期文件](https://docs.e2b.dev/sandbox) 与公众 [代理开发指南](https://musegea.com/developers/agent-development)。 。 。 .

## 常见问题

### @gea-ai/computer-e2b 是什么？

E2B 用于 GEA 工人本地装订的计算机声明注意：该包已被作者标记为弃用——This package is deprecated and will no longer receive updates\.

### 如何安装 @gea-ai/computer-e2b？

在项目目录运行 npm install @gea-ai/computer-e2b，或使用 pnpm add / yarn add / bun add。

### @gea-ai/computer-e2b 支持 TypeScript 吗？

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

### @gea-ai/computer-e2b 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @gea-ai/computer-e2b 可以商用吗？

@gea-ai/computer-e2b 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @gea-ai/computer-e2b 的下载量有多少？

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

### @gea-ai/computer-e2b 还在维护吗？

最新版本 0\.1\.261111-alpha\.1 发布于 2026/11/12（3 天前）；至今共发布 73 个版本，其中过去 12 个月发布了 73 个；首次发布于 2026/09/08。作者已将其标记为弃用，新项目建议寻找替代方案。

