1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | upstash-box-js-upstash-skills |
| 作者/维护者 | Upstash(Box 云沙箱服务的所有者) |
| 来源链接 | https://github.com/upstash/skills/tree/main/skills/upstash-box-js |
| 许可证 | MIT |
| GitHub Stars / Forks | 31 / 7(属 upstash/skills 整个仓库,非本技能独有;GitHub API) |
| 配套 SDK | @upstash/box v0.7.9(2026-10-06 发布;npm API);upstash/box 仓库 42 stars,近一月 npm 下载约 42,900(GitHub API / npm API) |
| 技能安装量 | skills.sh 显示约 1,200 次安装 |
| 最近更新 | 本技能目录最近修改于 2026-09-22(GitHub API) |
| 安装方式 | npx skills add https://github.com/upstash/skills --skill upstash-box-js |
2. 功能介绍与亮点
教 agent 用 @upstash/box TypeScript SDK 创建并操作云端沙箱容器,把不可信或 agent 生成的代码隔离到远程机器里跑。
- 容器生命周期:选运行时(node / python / golang / ruby / rust)与规格,支持 keepAlive、initCommand、标签、快照与
Box.fromSnapshot()恢复 - 内置 AI agent:在盒内运行 Claude Code、Codex、OpenCode 等,支持
responseSchema结构化输出与自定义 harness - Shell、文件系统与 git:执行命令、交互式会话、读写下载文件、克隆仓库、提交、开 PR
- 浏览器与定时任务:可选无头 Chromium(observe / act / extract);盒内 cron 任务(UTC)
- 网络与公开地址:出站网络策略、自定义出站请求头、端口公开 URL
- Gotchas 清单:列出默认工作目录、
EphemeralBox能力边界、已移除 API 等易踩的坑
3. 适用场景
所属分类:DevOps 与基础设施。
- 为 agent 搭建隔离的云端开发环境,运行不可信代码
- 并行拉起多个盒子,把一批任务变成一批 PR
- 在盒内做浏览器自动化与截图
- 保存、复用快照,定时跑巡检脚本
适合在服务端用 TypeScript 构建 agent 产品的开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md,含 license、metadata 字段 |
| Codex | 原生支持 | 同上;Codex 需手动引用技能目录 |
| OpenClaw | 未验证 | 技能为 SKILL.md + SDK 代码示例,未见官方说明 |
| Hermes Agent | 未验证 | 同上 |
5. 推荐理由
Box SDK 的接口面很大(生命周期、agent、浏览器、快照、网络策略),凭记忆或猜测写很容易调用已移除的 API。这份技能由厂商随 SDK 同步更新,近期还同步过 git.createIssue、附件与批量删除等新接口,并明确标出“没有 box.fork()”“没有 tab.run()”之类的坑。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 厂商出品;skills.sh 约 1,200 次安装;SDK 月下载约 4.3 万;仓库自身 stars 较少 |
| 可用性 | 8 | npm install 即用,文档含完整示例与踩坑清单;需 Box API Key 与付费云服务;2026-09 仍在更新 |
| 安全性 | 7 | 见下方检查清单 |
综合 7.33(三项均值)。
安全检查清单:
- ① 执行范围:代码在远程沙箱内执行,不在本机;盒内可跑任意 shell,由使用者的代码决定
- ② 联网:访问 Upstash Box API;SDK 默认发送匿名遥测头,可用
UPSTASH_DISABLE_TELEMETRY或enableTelemetry: false关闭 - ③ 凭据:
UPSTASH_BOX_API_KEY,另可传 GitHub token 与 LLM key,示例用环境变量传入 - ④ 无可疑指令或混淆内容
- ⑤ 作者为 Upstash 官方组织
- ⑥ MIT 许可证
- ⑦ 近期持续维护
- 第三方审计:Gen Agent Trust Hub、Socket 为 Pass;Snyk 为 Warn(skills.sh 未列出具体原因)
7. 跟同类 Skills 相比的优势
| 对象 | 定位 | 差异 |
|---|---|---|
| Cloudflare Sandbox SDK 技能 | Cloudflare Workers 上的沙箱 | 绑定 Cloudflare 平台;Box 自带内置 agent 与浏览器 |
| E2B 等沙箱 SDK | 通用 agent 代码沙箱 | 各自平台;Box 的卖点是内置多种 coding agent 与快照 |
| upstash-box-py | 同一 API 的 Python 版 | 语言不同,接口对应 |
| upstash-box-cli | 终端 box 命令 |
面向命令行操作而非 SDK 编程 |
8. 用户评价
- 该技能目前在第三方平台尚无具名的使用评价。
- upstash/box 仓库的维护提交与发版记录密集(近期持续添加模型与 harness 示例),可见该 SDK 处于活跃迭代。
10. 安装使用方式
npx skills add https://github.com/upstash/skills --skill upstash-box-js
npm install @upstash/box
export UPSTASH_BOX_API_KEY=... # 在 console.upstash.com/box 创建
触发方式:提到 Upstash Box、云端沙箱、让 agent 在容器里跑代码等。
11. 注意事项
- 需要 Box API Key,盒子运行按 Upstash 计费,用完记得
box.delete()(不可逆,先做快照) EphemeralBox不支持 agent、git、skills、浏览器与公开 URL- 传给盒子的 GitHub token 与 LLM key 权限应尽量收窄
- 仓库整体 stars 较少,热度主要体现在安装量与 npm 下载量