@afterquery/compute

中文文档
0.6.1发布于 2026/09/17MITTypeScriptES Module近 30 天下载 4.9万

TypeScript SDK for the AfterQuery compute API — AI代理管线的孤立沙盒

中文使用文档

查询后计算类型SDK

Node.js 18+客户端用于AfterQuery 计算 API.

import { Compute, GpuCreateError } from '@afterquery/compute'

const compute = new Compute({ apiKey: '...' })

try {
  const sandbox = await compute.create(
    {
      image: 'registry.example.com/team/image:tag',
      resources: { gpu: { type: 'l4', count: 1 } },
    },
    { idempotencyKey: 'job-42-attempt-1' },
  )
} catch (error) {
  if (error instanceof GpuCreateError) {
    // Preserve these values when reconciling an ambiguous create outcome.
    console.error(error.idempotencyKey, error.sandboxId)
  }
  throw error
}

GPU创建需要稳定的一等能键. 如果一个不提供, SDK 生成一个并曝光通过 GpuCreateError 任何创建或准备 失败。 GPU 批量创建是有意不支持的.

对于一个模糊的失败,没有沙盒ID,拨打 cancelGpuCreate(error.idempotencyKey) 请求使用稳定键进行清理. SDK用同一个键重审一个运输矛盾的取消请求. Deleted 财务报告和审定财务报表 Failed 不可改变的终点站历史; CleanupPending 表示 清理工作还在进行中,所以打电话 cancelGpuCreate 直到一个终端 状态返回。 一样的钥匙 create 重试也可以返回终端控件 没有开始或等待一个新的沙盒.

见 仓库 aPI 设置和 整个SDK表面.

从沙盒里清理

代码运行 内部 一个沙盒可以删除它自己的沙盒作为其最终的 行动,所以完成的一发工作 永远不会停留(和库伯内斯永远不会 重新启动它 :

import { Compute } from '@afterquery/compute'

// ... do the work ...
await new Compute().selfDelete()   // remove me; nothing left running

不需要 API 密钥: 平台注入 COMPUTE_SELF_TOKEN 财务报告和审定财务报表 COMPUTE_API_URL 输入每个沙盒,而该符号只能删除 它属于沙盒。 电话在沙盒外.

版本与发布记录

@afterquery/compute 共发布 7 个版本,首次发布于 2026/07/08;过去 12 个月发布了 7 个版本。

版本发布日期距今
0.6.1latest2026/09/171 个月前
0.6.02026/09/171 个月前
0.5.02026/09/161 个月前
0.4.12026/09/151 个月前
0.4.02026/08/112 个月前
0.2.02026/07/093 个月前

关于 @afterquery/compute 的常见问题

@afterquery/compute 是什么?

TypeScript SDK for the AfterQuery compute API — AI代理管线的孤立沙盒

如何安装 @afterquery/compute?

在项目目录运行 npm install @afterquery/compute,或使用 pnpm add / yarn add / bun add。

@afterquery/compute 支持 TypeScript 吗?

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

@afterquery/compute 支持 ESM 还是 CommonJS?

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

@afterquery/compute 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@afterquery/compute 可以商用吗?

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

@afterquery/compute 的下载量有多少?

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

@afterquery/compute 还在维护吗?

最新版本 0.6.1 发布于 2026/09/17(1 个月前);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2026/07/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。