@dvmkit/sdk

中文文档
0.37.0发布于 2026/11/13Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 1.8万

SDK用于构建 Digital Vending Machines : 付费使用 HTTPS 服务 AI 代理可以找到,支付,并拨打无账户或API 密钥

中文使用文档
文档目录10 节
  1. 所需资源
  2. 安装
  3. 快速启动: 一个免费的DVDM
  4. 包裹里有什么
  5. 今后的步骤
  6. 捐款
  7. 警卫
  8. 支助
  9. 商标
  10. 许可证

@dvmkit/ sdk (英语)

构建数字变换机:人工智能代理可以找到,支付,并拨打无账户或API密钥的付费HTTPS服务.

前 1. 0 阿尔法: 将您安装的版本刻入; 见 发布注释 用于打破更改和 兼容政策。 。 。 .

所需资源

TypeScript 快速启动的节点.js 22.18 或以后;见 运行时间支持。 。 。 .

安装

创建工程并安装当前发行, 记录其准确版本 :

mkdir hello-dvm && cd hello-dvm
npm init -y
npm pkg set type=module
npm install --save-exact @dvmkit/sdk

快速启动: 一个免费的DVDM

另存为 handler.ts数字 :

import { configureDVM, z } from "@dvmkit/sdk";

export const inputSchema = z.object({ text: z.string().min(1) });

export default configureDVM({
  name: "hello",
  description: "Return the supplied text",
  capability: "echo",
  input: inputSchema,
  example: { text: "hello" },
  async onJob(ctx) {
    ctx.artifact({ mime_type: "text/plain", data: ctx.input.text });
    ctx.complete("Echoed the input");
  },
});

另存为 server.ts数字 :

import { serve } from "@dvmkit/sdk/server";

import dvm from "./handler.ts";

const server = await serve(dvm, { devMode: true });

for (const signal of ["SIGINT", "SIGTERM"]) {
  process.once(signal, () => {
    void server.close().then(() => process.exit(0));
  });
}

启动服务器 :

node server.ts

让它运行。 在另一个终端,提交工作:

curl -sS http://localhost:8080/v1/job \
  -H 'content-type: application/json' \
  --data '{"capability":"echo","data":{"text":"hello"}}'

反应包括生成 job_id 财务报告和审定财务报表 job_token, (中文(简体) ), "status":"completed",以及 "summary":"Echoed the input"。服务器在 http://localhost:8080;用Ctrl-C停止使用. devMode 让此自由示例不使用 Postgres 运行 .

以上文件是逐字复制自 examples/quickstart。参见可运行 认证自定义路由 财务报告和审定财务报表 付款和寿命周期 下一步的例子.

包裹里有什么

导入目的
@dvmkit/sdkDVM 描述器、 处理器上下文、 捆绑 Zod 、 定价、 签名、 和安全的帮助
@dvmkit/sdk/server节点托管、Postgres商店、签名请求认证和付款基础设施
@dvmkit/sdk/testing决定式处理器上下文和内存

生成的 API 参考 列出支持的声明.

今后的步骤

  • SDK 指南: 添加认证,自定义路线,支付,和持久性.
  • 礼宾指南:理解HTTP合同呼叫器的使用.
  • 构建器指南:脚手架并部署一个服务;用 npm install --global @dvmkit/dvmctl。 。 。 .

操作一个DVM 包括生产设置,核实的开发支付,信用负债,诊断,留存,内容持有,以及金融出口等. 议定书说明 包括兼容性、工作证明、身份、终端证据、费用和收费卡.

捐款

欢迎提出问题和进行讨论。 非邀约拉拉请求已结案;改为 捐款额 编辑 行为守则 在参与之前.

警卫

如本报告所述,私下报告脆弱性 警卫。 。 。 .

支助

使用 支助 找到合适的问题和错误报告地点.

商标

Apache 许可证在 dvmkit 名称或品牌上不授予任何权利; 在不暗示认可的情况下, 识别自己的产品和叉子 . 许可请求通过 支助;“数字自动取款机”或“DVD”的描述性使用不受限制.

许可证

阿帕奇2.0 (英语). 见 自由主义 财务报告和审定财务报表 通知。 。 。 .

版本与发布记录

@dvmkit/sdk 共发布 81 个版本,首次发布于 2026/09/02;过去 12 个月发布了 81 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.37.0latest2026/11/13今天
0.36.02026/11/13今天
0.35.22026/11/121 天前
0.35.12026/11/112 天前
0.35.02026/11/112 天前
0.34.02026/11/103 天前

其他发布通道:bootstrap → 0.0.0,next → 0.12.0-rc.1。

关于 @dvmkit/sdk 的常见问题

@dvmkit/sdk 是什么?

SDK用于构建 Digital Vending Machines : 付费使用 HTTPS 服务 AI 代理可以找到,支付,并拨打无账户或API 密钥

如何安装 @dvmkit/sdk?

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

@dvmkit/sdk 支持 TypeScript 吗?

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

@dvmkit/sdk 支持 ESM 还是 CommonJS?

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

@dvmkit/sdk 需要什么版本的 Node.js?

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

@dvmkit/sdk 可以商用吗?

@dvmkit/sdk 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dvmkit/sdk 的下载量有多少?

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

@dvmkit/sdk 还在维护吗?

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