# @delphi-ai/multi-tenant-chat 中文文档

规范地址：https://npmcn.com/package/%40delphi-ai/multi-tenant-chat/

版本：0\.1\.1
npm 元数据更新时间：2026-06-15T20:42:40.565Z
中文译文更新时间：2026-11-12T00:46:04.729Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40delphi-ai/multi-tenant-chat
原文对照：https://npmcn.com/package/%40delphi-ai/multi-tenant-chat/?lang=original
项目主页：https://github.com/delphi-ai/multi-tenant-chat#readme
源码仓库：https://github.com/delphi-ai/multi-tenant-chat

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

- 包体积（解压后）：47.8 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- peer 依赖：chat ^4\.27\.0
- 首次发布：2026-05-08T18:49:00.668Z
- 最新版本发布：2026-06-15T20:42:40.430Z
- 近 30 天下载量：3475（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

Vercel Chat SDK 多租户运行时间管理器

## 安装

```sh
npm install @delphi-ai/multi-tenant-chat
```

也可以使用：`pnpm add @delphi-ai/multi-tenant-chat`、`yarn add @delphi-ai/multi-tenant-chat`、`bun add @delphi-ai/multi-tenant-chat`

## README

# @delphi-ai/多租户聊天

多租户运行时间管理器 [Vercel 聊天SDK](https://github.com/vercel/chat)。管理每次连接 `Chat` 懒惰制造、LRU驱逐和 `AsyncLocalStorage`\- 基于连接的上下文.

## 安装

```bash
pnpm add @delphi-ai/multi-tenant-chat

# Peer dependency
pnpm add chat
```

## 使用量

```ts
import { MultiTenantChat, type ChatConnection } from "@delphi-ai/multi-tenant-chat";

interface MyConnection extends ChatConnection {
  ownerId: string;
}

const manager = new MultiTenantChat<MyConnection>({
  async resolveConnection({ platform, connectionKey, request }) {
    // Look up connection from your database
    return { id: connectionKey, platform, ownerId: "user-123" };
  },

  async resolveCredentials(connection) {
    // Return platform-specific credentials
    return { botToken: "xoxb-..." };
  },

  state: yourStateAdapter,

  platforms: {
    slack: (credentials) => createSlackAdapter(credentials),
    telegram: (credentials) => createTelegramAdapter(credentials),
  },

  async onDirectMessage(ctx, thread, message) {
    await thread.post("Hello from multi-tenant chat!");
  },
});

// In your webhook handler:
export async function POST(request: Request) {
  return manager.handleWebhook(request, {
    platform: "telegram",
    connectionKey: "connection-id",
  });
}
```

## API 密码

### `MultiTenantChat<T extends ChatConnection>`

主类管理每个连接聊天实例.

**配置 :**

-   `resolveConnection` 解决平台+关键+请求的连接
-   `resolveCredentials` ——返回连接证书
-   `state` a 包括: `StateAdapter` (在所有连接中共享,密钥为自动前缀)
-   `platforms` ——适配器厂站名地图
-   `onDirectMessage` 编号 : `onMention` 编号 : `onSubscribedMessage` ——信息处理器
-   `onError` – 全局错误处理器
-   `runtimeCacheMax` 最大缓存聊天例( 默认 1000)

**方法:**

-   `handleWebhook(request, { platform, connectionKey })` —— 向正确的查特实例传递一个网点
-   `destroyRuntime(connectionId)` ——拆掉缓存运行时间

### `getConnection<T>()`

获取当前连接 `AsyncLocalStorage` 上下文(在处理器内).

### `createPrefixedState(base, prefix)`

环绕任意 `StateAdapter` 与每个连接键名间隔.

### `RuntimeCache`

LRU 活性缓存 `Chat` 出现懒惰制造和驱逐的情况.

## 许可证

麻省理工学院

## 常见问题

### @delphi-ai/multi-tenant-chat 是什么？

Vercel Chat SDK 多租户运行时间管理器

### 如何安装 @delphi-ai/multi-tenant-chat？

在项目目录运行 npm install @delphi-ai/multi-tenant-chat，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：chat（^4\.27\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @delphi-ai/multi-tenant-chat 支持 TypeScript 吗？

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

### @delphi-ai/multi-tenant-chat 支持 ESM 还是 CommonJS？

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

### @delphi-ai/multi-tenant-chat 需要什么版本的 Node\.js？

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

### @delphi-ai/multi-tenant-chat 可以商用吗？

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

### @delphi-ai/multi-tenant-chat 的下载量有多少？

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

### @delphi-ai/multi-tenant-chat 还在维护吗？

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