# @dvmkit/sdk 中文文档

规范地址：https://npmcn.com/package/%40dvmkit/sdk/

版本：0\.37\.0
npm 元数据更新时间：2026-11-13T05:11:54.487Z
中文译文更新时间：2026-11-13T01:09:38.580Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40dvmkit/sdk
原文对照：https://npmcn.com/package/%40dvmkit/sdk/?lang=original
项目主页：https://dvmkit.com/docs/sdk
源码仓库：https://github.com/dvmkit/sdk

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

- 包体积（解压后）：3.5 MB，85 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：17 个
- 首次发布：2026-09-02T12:54:26.316Z
- 最新版本发布：2026-11-13T05:11:54.033Z
- 近 30 天下载量：18252（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：81（近 12 个月 81 个）

## 中文简介

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

## 安装

```sh
npm install @dvmkit/sdk
```

也可以使用：`pnpm add @dvmkit/sdk`、`yarn add @dvmkit/sdk`、`bun add @dvmkit/sdk`

## README

# @dvmkit/ sdk (英语)

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

前 1. 0 阿尔法: 将您安装的版本刻入; 见 [发布注释](https://npmcn.com/package/%40dvmkit/sdk/CHANGELOG.md) 用于打破更改和 [兼容政策](https://npmcn.com/package/%40dvmkit/sdk/docs/PROTOCOL-NOTES.md#compatibility-and-versioning)。 。 。 .

## 所需资源

TypeScript 快速启动的节点.js 22.18 或以后;见 [运行时间支持](https://npmcn.com/package/%40dvmkit/sdk/docs/PROTOCOL-NOTES.md#compatibility-and-versioning)。 。 。 .

## 安装

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

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

## 快速启动: 一个免费的DVDM

另存为 `handler.ts`数字 :

```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`数字 :

```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));
  });
}
```

启动服务器 :

```sh
node server.ts
```

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

```sh
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`](https://npmcn.com/package/%40dvmkit/sdk/examples/quickstart)。参见可运行 [认证自定义路由](https://npmcn.com/package/%40dvmkit/sdk/examples/authenticated-route) 财务报告和审定财务报表 [付款和寿命周期](https://npmcn.com/package/%40dvmkit/sdk/examples/payments-and-lifecycle) 下一步的例子.

## 包裹里有什么

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

生成的 [API 参考](https://npmcn.com/package/%40dvmkit/sdk/docs/API.md) 列出支持的声明.

## 今后的步骤

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

[操作一个DVM](https://npmcn.com/package/%40dvmkit/sdk/docs/OPERATING.md) 包括生产设置,核实的开发支付,信用负债,诊断,留存,内容持有,以及金融出口等. [议定书说明](https://npmcn.com/package/%40dvmkit/sdk/docs/PROTOCOL-NOTES.md) 包括兼容性、工作证明、身份、终端证据、费用和收费卡.

## 捐款

欢迎提出问题和进行讨论。 非邀约拉拉请求已结案;改为 [捐款额](https://npmcn.com/package/%40dvmkit/sdk/CONTRIBUTING.md) 编辑 [行为守则](https://npmcn.com/package/%40dvmkit/sdk/CODE_OF_CONDUCT.md) 在参与之前.

## 警卫

如本报告所述,私下报告脆弱性 [警卫](https://npmcn.com/package/%40dvmkit/sdk/SECURITY.md)。 。 。 .

## 支助

使用 [支助](https://npmcn.com/package/%40dvmkit/sdk/SUPPORT.md) 找到合适的问题和错误报告地点.

## 商标

Apache 许可证在 dvmkit 名称或品牌上不授予任何权利; 在不暗示认可的情况下, 识别自己的产品和叉子 . 许可请求通过 [支助](https://npmcn.com/package/%40dvmkit/sdk/SUPPORT.md#email);“数字自动取款机”或“DVD”的描述性使用不受限制.

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://npmcn.com/package/%40dvmkit/sdk/LICENSE) 财务报告和审定财务报表 [通知](https://npmcn.com/package/%40dvmkit/sdk/NOTICE)。 。 。 .

## 常见问题

### @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 和提交记录判断。