# @ductape/sdk 中文文档

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

版本：0\.5\.10
npm 元数据更新时间：2026-11-05T12:49:43.336Z
中文译文更新时间：2026-11-12T23:45:45.659Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40ductape/sdk
原文对照：https://npmcn.com/package/%40ductape/sdk/?lang=original

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

- 包体积（解压后）：11.1 MB，1232 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：38 个
- 首次发布：2025-04-20T14:01:29.521Z
- 最新版本发布：2026-11-05T12:49:43.172Z
- 近 30 天下载量：3484（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：332（近 12 个月 281 个）

## 中文简介

用于建造胶带产品

## 安装

```sh
npm install @ductape/sdk
```

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

## README

# @ putape/ sdk (英语)

将您的 Node.js app 连接到数据库, 消息经纪人, 存储, 会话, 预定任务, 以及更多 —— 全部通过单个访问密钥 .

## 安装

```sh
npm install @ductape/sdk@latest
```

## 快开始

```ts
import Ductape from '@ductape/sdk';

const ductape = new Ductape({
  accessKey: 'your-access-key',
  product: 'my-product',
  env: 'prd',
});
```

过 `product` 财务报告和审定财务报表 `env` 一旦输入; 每个服务电话自动继承它们.

## 实例

### 会议

```ts
const session = await ductape.sessions.start({
  tag: 'user-session',
  data: { userId: 'u1', email: 'user@example.com' },
});
// session.token, session.refreshToken, session.sessionId

await ductape.sessions.verify({ token: session.token });
await ductape.sessions.revoke({ token: session.token });
```

### 信件经纪人

```ts
await ductape.events.produce({
  event: 'order-events:order-created',
  message: { orderId: '123', amount: 99.99 },
});

await ductape.events.consume({
  event: 'order-events:order-created',
  callback: async (msg) => console.log(msg),
});
```

支持Kafka,RabbitMQ,Redis,SQS,Google Pub/Sub,和NATS.

### 存储

```ts
await ductape.storage.upload({
  storage: 'main-storage',
  fileName: 'reports/q1.pdf',
  buffer: fileBuffer,
  mimeType: 'application/pdf',
});

const file = await ductape.storage.download({ storage: 'main-storage', fileName: 'reports/q1.pdf' });
const url  = await ductape.storage.getSignedUrl({ storage: 'main-storage', fileName: 'reports/q1.pdf' });
```

支持AWS S3,谷歌云存储和Azure Blob存储.

### 数据库

```ts
const rows = await ductape.databases.query({
  database: 'main-db',
  table: 'orders',
  where: { status: 'pending' },
});
```

支持PostgreSQL,MySQL,马里亚DB,和卡桑德拉.

### 特征

```ts
await ductape.feature.execute({
  tag: 'process-order',
  data: { orderId: '123' },
});
```

## 还有什么

| 命名空间 | 说明 |
| --- | --- |
| `ductape.sessions` | JWT会话——开始,核实,刷新,撤销 |
| `ductape.events` | 消息经纪人——制作,消费,管理话题 |
| `ductape.storage` | 文件存储——上传,下载,删除,签名的URL |
| `ductape.databases` | 关系数据库——查询、迁移 |
| `ductape.graph` | 图表数据库-查询和交易(Neo4j) |
| `ductape.vector` | 矢量搜索——上行和查询(Pinecone,Qdrant,Weviate) |
| `ductape.warehouse` | 跨关系、图和向量的统一查询 |
| `ductape.caches` | 快取——得到,设定,无效 |
| `ductape.feature` | 特性——执行多步骤的产品流动 |
| `ductape.agents` | 有工具和内存的 LLM 代理 |
| `ductape.models` | LLM推论(开放AI、Anthropic等) |
| `ductape.jobs` | 背景任务——安排和运行 |
| `ductape.notifications` | 电子邮件、短信、推接和回调通知 |
| `ductape.secrets` | 秘密——储存和解决每个环境 |
| `ductape.quota` | 限制税率和执行配额 |
| `ductape.fallback` | 退缩政策 |
| `ductape.health` | 健康检查的定义和状况 |
| `ductape.cloud` | 云连接管理 |
| `ductape.api` | 综合第三方应用程序的呼叫行动 |

## 所需资源

节点.js 18+. 仅服务器侧- 不支持浏览器环境 .

## 文档

[(原始内容存档于2018-09-29) (英语). docs.putape.app](https://docs.ductape.app/)

## 常见问题

### @ductape/sdk 是什么？

用于建造胶带产品

### 如何安装 @ductape/sdk？

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

### @ductape/sdk 支持 TypeScript 吗？

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

### @ductape/sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ductape/sdk 可以商用吗？

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

### @ductape/sdk 的下载量有多少？

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

### @ductape/sdk 还在维护吗？

最新版本 0\.5\.10 发布于 2026/11/05（8 天前）；至今共发布 332 个版本，其中过去 12 个月发布了 281 个；首次发布于 2025/04/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。