# @adaline/gateway 中文文档

规范地址：https://npmcn.com/package/%40adaline/gateway/

版本：1\.15\.0
npm 元数据更新时间：2026-04-23T12:35:14.718Z
中文译文更新时间：2026-11-05T17:48:30.372Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.1 MB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：14 个
- 首次发布：2024-09-02T23:01:16.402Z
- 最新版本发布：2026-04-23T12:35:14.561Z
- 近 30 天下载量：137083（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 8 个）

## 中文简介

Adaline 网关

## 安装

```sh
npm install @adaline/gateway
```

也可以使用：`pnpm add @adaline/gateway`、`yarn add @adaline/gateway`、`bun add @adaline/gateway`

## README

# Adaline 网关

![npm bundle size](https://img.shields.io/bundlephobia/minzip/@adaline/gateway) ![npm type definitions](https://img.shields.io/npm/types/@adaline/gateway) ![ESLint](https://img.shields.io/badge/ESLint-passing-brightgreen.svg) ![NPM](https://img.shields.io/npm/l/@adaline/gateway) [![NPM version](https://img.shields.io/npm/v/@adaline/gateway.svg)](https://npmjs.org/package/@adaline/gateway)

唯一一个完全本地生产级的Super SDK为调用超过200+LLMS提供简单,统一和强大的接口.

-   生产准备并被企业使用.
-   完全当地和 _没有_ 一个代理。 你可以部署在任何地方.
-   配有分批,回试,缓存,回调,和OpenTeleometry支持.
-   支持用于缓存,日志,HTTP客户端的自定义插件等. 你可以像LEGO一样使用它,并让它与你的基础设施相配合.
-   支持插件和游戏提供者. 您可以运行完全自定义的提供者, 并仍然利用 Adaline Gateway 的所有好处 .

## 特征

-   QQ 在类型脚本中严格输入
-   Isomorphic - 到处工作
-   100%的本地和私营 _没有_ 代理服务器
-   QQ 工具调用所有兼容的 LLMS 支持
-   QQ 用自定义队列支持处理所有请求
-   QQ 自动重试, 有指数回放
-   QQ 有自定义缓存插件支持的缓存
-   QQ 完整定制仪器和钩子的回调
-   QQ OpenTeleometry 将追踪插入您的现有基础设施
-   本地和自定义模型的插件和游戏自定义提供者

## 快速启动

### 安装软件包

```bash
npm install @adaline/gateway @adaline/types @adaline/openai @adaline/anthropic 
```

### 创建网关对象

网关对象维护队列,缓存,回调,执行OpenTeleometry等等. 你应该在任何地方使用同一个Gateway对象来获得所有特性的好处.

```typescript
import { Gateway } from "@adaline/gateway";

const gateway = new Gateway();
```

### 创建提供者对象

提供方对象存储该提供者内部所有模型的种类/信息. 它暴露了所有聊天的列表 `openai.chatModelLiterals()` 并嵌入 `openai.embeddingModelLiterals()` 模特们.

```typescript
import { Anthropic } from "@adaline/anthropic";
import { OpenAI } from "@adaline/openai";

const openai = new OpenAI();
const anthropic = new Anthropic();
```

### 创建示范对象

模型对象从角色,到配置,到该模型所支持的不同模式,都强制实施类型. 您也可以提供其他密钥,如 `baseUrl`, (中文(简体) ), `organization`等 (中文(简体) ).

模型对象也会暴露功能:

-   `transformModelRequest` 它需要为提供者格式化的请求并将其转换为Adaline超型.
-   `getStreamChatData` 然后用来制作其他提供者的电话。 例如,从贝德罗克调用Anthropic模型.
-   以及更多可以进行深度堆肥 并提供运行时间验证.

```typescript
const gpt4o = openai.chatModel({
  modelName: "gpt-4o",
  apiKey: "your-api-key",
});

const haiku = anthropic.chatModel({
  modelName: "claude-3-haiku-20240307",
  apiKey: "your-api-key",
});
```

### 创建配置对象

Cfig对象提供类型检查,并接受可用于每个模型添加最大值,分数等验证检查的通用.

```typescript
import { Config } from "@adaline/types";

const config = Config().parse({
  maxTokens: 200,
  temperature: 0.9,
});
```

### 创建信件对象

Message对象是Adaline超型,支持200+LLMs的所有角色和模式.

```typescript
import { MessageType } from "@adaline/types";

const messages: MessageType[] = [
  {
    role: "system",
    content: [{
      modality: "text",
      value: "You are a helpful assistant. You are extremely concise.
    }],
  },
  {
    role: "user",
    content: [{
      modality: "text",
      value: `What is ${Math.floor(Math.random() * 100) + 1} + ${Math.floor(Math.random() * 100) + 1}?`,
    }],
  },
];
```

### 使用网关流式聊天

```typescript
await gateway.streamChat({
  model: gpt4o,
  config: config,
  messages: messages,
});
```

### 使用 Gateway 完成聊天

```typescript
await gateway.completeChat({
  model: haiku,
  config: config,
  messages: messages,
});
```

## 常见问题

### @adaline/gateway 是什么？

Adaline 网关

### 如何安装 @adaline/gateway？

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

### @adaline/gateway 支持 TypeScript 吗？

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

### @adaline/gateway 支持 ESM 还是 CommonJS？

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

### @adaline/gateway 需要什么版本的 Node\.js？

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

### @adaline/gateway 可以商用吗？

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

### @adaline/gateway 的下载量有多少？

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

### @adaline/gateway 还在维护吗？

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