# @agentproto/sandbox 中文文档

规范地址：https://npmcn.com/package/%40agentproto/sandbox/

版本：0\.16\.0
npm 元数据更新时间：2026-11-04T00:05:10.065Z
中文译文更新时间：2026-11-06T03:23:22.659Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40agentproto/sandbox
原文对照：https://npmcn.com/package/%40agentproto/sandbox/?lang=original
项目主页：https://agentproto.sh/docs/aip-36
源码仓库：https://github.com/agentproto/ts

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

- 包体积（解压后）：160 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2026-06-20T17:06:35.920Z
- 最新版本发布：2026-11-04T00:05:09.695Z
- 近 30 天下载量：5753（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

@agentproto/sandbox — AIP-36 SANDBOX.md 参考执行. 用于定义 `sandbox` 字段 —— 提供方、 配置、 命令网域、 网络进取、 资源限制 —— 用于为代理机发布的计算环境命名的列表

## 安装

```sh
npm install @agentproto/sandbox
```

也可以使用：`pnpm add @agentproto/sandbox`、`yarn add @agentproto/sandbox`、`bun add @agentproto/sandbox`

## README

# @ agentproto/ sandbox (英语)

AIP-36号 `SANDBOX.md` 参考执行。 用于定义 `sandbox` 字段 — 提供者、 配置、 命令掩码、 网络进取、 资源限制 — 对于任何为代理签发的 shell 命令命名计算环境的显示。 姊妹原始到STORAGE.md (AIP-35);内置或参考,与AIP-17 RUNNER和AIP-19 SECRETS相映.

> **状态:0.1.0-α.** 生成者 `scripts/scaffold-aip.mjs` —— 说 `build()` 财务报告和审定财务报表 `validate()` 尸体是TODO的.

谱: [https://agentproto.sh/docs/aip-36 (中文(简体) )](https://agentproto.sh/docs/aip-36)

## 使用量

```ts
import { defineSandbox } from "@agentproto/sandbox"

const x = defineSandbox({
  id: "my-sandbox",
  description: "Short purpose.",
  // ...
})
```

## 在沙盒内运行代理步骤

`createSandboxAgentSessionHost` 任何转动 `SandboxProvider` 变成 `AgentSessionHost` (单位:千美元)`@agentproto/workflow-runtime`)——接缝 `runWorkflow` 每张 `AgentStep`它把请求的秘密解开 地图, 将沙盒与那个洞连接 `connectDaemonAgentSessionHost` (单位:千美元)`@agentproto/worktree`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}去沙盒那边 曝光代理程序守护进程 – 重用同一守护进程支持的会话主机 a 当地运行将使用,不变.

```ts
import { createSandboxAgentSessionHost } from "@agentproto/sandbox"
import { e2bSandboxProvider } from "@agentproto/sandbox-e2b"

const host = await createSandboxAgentSessionHost({
  provider: e2bSandboxProvider,
  spec: { provider: "e2b", config: {} },
  secrets: { slugs: ["OPENROUTER_API_KEY"] },
})
try {
  // await runWorkflow({ workflow, input, agents: host })
} finally {
  await host.stop()
}
```

## 启动时自动安装适配器

盒子的启动时间 `npm i -g @agentproto/cli` 替换全局安装并 丢失模板封存 `@agentproto/adapter-*` 软件包。 提供商 接受 `config.installPackages` (e2b,框) 安装这些条目于 SAME npm 引用作为 CLI 更新; 当在运行时间产入时 (单位:千美元)`spawnAgentSession`),适配器即将发射——加 `@anthropic-ai/claude-code` 联 合 国 `claude-code` 适配器 - 被注入到那里 自动(呼叫者宣布的接针总是获胜,没有注射用于 非沙盒产卵.

对于被带去的BEYOND 产出适配器, 声明语义性流涕而不是 原始 npm 规格 : `config.installAdapters: ["hermes", "claude-code"]`每发子弹 扩展至 `@agentproto/adapter-<slug>@latest` (加上适配器已宣布) 额外靴子,例如:. `@anthropic-ai/claude-code`合并为 `config.installPackages` 与去杜佩相接——同名的呼叫者明确指针 软件包总是赢。 未知的弹片仍然会扩展( 盒子的 npm 安装为 ; 空出字段不会改变任何东西.

## Billing-auth 自动通道( opt- in)

设定 `env.autoPassthrough: true` 在沙盒光谱上,运行时间添加 产卵体的活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活化活活化活化活化活化活化活化活活化活化活活化活活活活活化活化活化活活活活活化活化活活活化活活活活. `ANTHROPIC_API_KEY`改为: `env.passthrough` 在盒子靴子之前——所以新框继承主机认证 没有呼叫者命名 vars。 仅输入姓名; 值行走 通过正常的通关机制(主机秘密经纪人-盒内),并且是 从来没有读过国旗。 仅计费凭证(无) `GITHUB_TOKEN`; 计 数 通话明确 `env.passthrough` 条目保存并去除。 否时 证明性解决了,或者东道主不能解决 var 问题 注射和产卵收益:旗帜是一种方便,而不是契约.

## 寿命:在会话工作期间重新武装

供货箱有寿命(e2b: `timeoutMs`,45分钟默认,1小时 账户上限)。 它从最后的再武装,而不是从靴子。 虽然其 会话正在运行中, 运行时间会以相同的持续时间重新武装它 : 在每次快速发送时,在串行的盒子事件上(最多每分钟一次) 每10分钟一转 飞行中,甚至一个流无 长期(单长工具呼叫). 闲置的盒子没有更新 按时到期.

在它知道的最后5分钟前 代理机构就行动过一次 再来 如果转弯还在飞行中,它尝试最后一次续航。 如果会议 闲置,或更新失败, 它运行一个最后的检查点 而盒子的 仍然可以到达文件系统。 一个可拆卸的框( 主机- 守护程序重新启动) 遵循它自己的规则:要求它从拆分时刻起1小时.

## 寿命周期: 暂停是默认的拆解

默认关闭会话 `pause({ keepMemory: true })`(中文(简体) ) 而不是杀死它 任何封闭的盒子都通过 `sandbox.reuse` 编号 : `agentproto sandbox attach`。一个被暂停的盒子仍然会死 拥有 `timeoutMs` (默认为45分钟),所以暂停框不会累积 无限期; 声明 `lifecycle.destroy_on` 近距离杀人.

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40agentproto/sandbox/LICENSE)。 。 。 .

## 常见问题

### @agentproto/sandbox 是什么？

@agentproto/sandbox — AIP-36 SANDBOX\.md 参考执行\. 用于定义 sandbox 字段 —— 提供方、 配置、 命令网域、 网络进取、 资源限制 —— 用于为代理机发布的计算环境命名的列表

### 如何安装 @agentproto/sandbox？

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

### @agentproto/sandbox 支持 TypeScript 吗？

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

### @agentproto/sandbox 支持 ESM 还是 CommonJS？

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

### @agentproto/sandbox 可以商用吗？

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

### @agentproto/sandbox 的下载量有多少？

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

### @agentproto/sandbox 还在维护吗？

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