沙滩银行

快速开始

```bash

安装推荐 provider

pnpm add @sandbank.dev/core @sandbank.dev/cloud

或使用 x402 按次付费

export WALLET_PRIVATE_KEY=0x...

const provider = createProvider( new SandbankCloudAdapter({ apiToken: process.env.SANDBANK_API_TOKEN }) )

// 创建沙箱 const sandbox = await provider.create({ image: 'node:22', resources: { cpu: 2, memory: 2048 }, autoDestroyMinutes: 30, })

// 执行命令 const { stdout } = await sandbox.exec('node --version')

// 文件操作 await sandbox.writeFile('/app/index.js', 'console.log("hi")') await sandbox.exec('node /app/index.js')

// 清理 await provider.destroy(sandbox.id) ```

运行全部单元测试

pnpm test

运行跨 Provider 一致性测试

pnpm test:conformance

运行集成测试

集成测试会调用真实 API，通过环境变量控制开关：

```bash

配置 Provider

export SANDBANK_API_TOKEN=your-key

DB-native Harness API

sandbank CLI 和 Worker entrypoint 暴露了公开的 Sandbank harness API，底层由 Agent Supervisor、db9 Workspace storage 和 DeepSeek V4 Pro 驱动：

DB9_DATABASE_ID=... DB9_TOKEN=... DEEPSEEK_API_KEY=... \
  vas dev sandbank-harness pnpm --filter ./packages/sandbank exec tsx src/cli/index.ts harness-api --host 0.0.0.0 --port 8789

Routes:

• GET /health
• GET /api/db-native-agent-harness/capabilities
• POST /api/sandbank-agent-harness/stream
• POST /api/db-native-agent-harness/stream

stream 会发送通用 Sandbank SSE events，把 run input/output 持久化到 /runs/...，把 supervisor state/audit data 写入 /agents/...，并在 Workspace 后端支持时创建 checkpoint。默认模型是 deepseek-v4-pro。它还会把 Agent memory 存在 /agents/{agentId}/memory/memories.jsonl，将 active pinned / insight / session 记忆注入模型 prompt，并把显式的 remember / 记住 请求写成 pinned memory。Worker-compatible entrypoint 导出为 sandbank/harness-worker；Node CLI 用于通过 vas dev 或等价部署路径托管服务，不是 localhost-only preview。模型、Workspace、provider 和镜像要求见 Sandbank Agent Configuration。

用一个 prompt 对线上 harness 做 benchmark：

pnpm --filter ./packages/sandbank exec tsx src/cli/index.ts harness-benchmark \
  --base-url https://your-sandbank-worker.example \
  --question "@agent run a Sandbank harness health check" \
  --json

运行默认 benchmark suite：

SANDBANK_HARNESS_BASE_URL=https://your-sandbank-worker.example pnpm bench:harness -- --json

benchmark 会把每个 case POST 到 /api/db-native-agent-harness/stream，记录 SSE timeline，并按 HTTP/SSE transport、harness lifecycle、Workspace persistence、Dynamic Worker capsule execution、model streaming、case expectations 和 latency 计分，满分 100。

Provider 特性对比